Więcej przykładów wywołań zwrotnych elementu wyszukiwania
Na tej stronie znajdziesz wiele przykładów użycia wywołań zwrotnych elementu wyszukiwania. Uzupełniają one przykłady z sekcji wywołań zwrotnych dokumentu dotyczącego interfejsu Custom Search Element API.
Wywołanie zwrotne rozpoczynające wyszukiwanie może zmodyfikować zapytanie, zanim zostanie ono użyte do wyszukiwania.
Wyszukiwarka niestandardowa można skonfigurować tak, aby uwzględniała w zapytaniu wstępnie zdefiniowane hasła, ale to wywołanie zwrotne może modyfikować zapytanie na podstawie wszelkich informacji dostępnych dla funkcji wywołania zwrotnego.
Poniższe wywołanie zwrotne wyszukiwania dekoruje każde zapytanie bieżącym dniem tygodnia.
Wyrenderowane wyniki – przykłady wywołań zwrotnych
Wyrenderowane wywołanie zwrotne to dobry sposób na zmodyfikowanie strony po wypełnieniu wyników.
Został on opracowany w taki sposób, aby ułatwić modyfikowanie wyświetlania wyników bez konieczności stosowania wywołania zwrotnego do pełnej odpowiedzialności za ich renderowanie.
Poniższe przykłady obrazują 2 zastosowania wyrenderowanych wyników wywołania zwrotnego, które nie działają na tych wynikach.
Przykłady gotowych wywołań zwrotnych wyników
Chmura słów
Oczywistym zastosowaniem wywołania zwrotnego gotowych wyników jest wyświetlanie wyników wyszukiwania w formacie, który byłby trudny do uzyskania przy użyciu wywołania zwrotnego wyrenderowanych wyników do dostosowania kodu HTML. Wywołanie zwrotne results ready rozpoczyna się od pustego pola div.
Jeden z przykładów w dokumencie Search Element API pokazuje, jak użyć wywołania zwrotnego do renderowania bardzo prostej wersji wyników.
Inny przykład pokazał, jak przechowywać dane o wynikach z wywołania zwrotnego gotowych wyników i przekazywać je do wywołania zwrotnego wyrenderowanych wyników, gdzie można ich używać do dekorowania standardowego panelu wyników.
Widoczne poniżej wywołanie zwrotne dotyczące gotowych wyników wskazuje, że wyniki wyszukiwania nie muszą być listą wyników. Zastępuje one normalne wyświetlanie wyników wyszukiwania chmurą słów znalezionych w tytułach i treściach wyników. Gdy lista wyników jest dla użytkownika tylko etapem pośrednim, takie wywołanie zwrotne może pominąć ten etap i wykorzystać wyniki do przedstawienia użytkownikowi oczekiwanego raportu.
Przykład dwuczęściowego wywołania zwrotnego
Wywołania zwrotne gotowe i wyrenderowane mogą być używane w połączeniu do przekazywania informacji z pierwszego do drugiego.
Na przykład informacje w tablicy obiektów wyników są dostępne dla wywołania zwrotnego results ready, ale nie dla wywołania zwrotnego wyrenderowanych wyników.
Zapisując te informacje w tablicy w ramach wywołania zwrotnego gotowych wyników, możemy udostępnić je wywołaniu zwrotnemu wyrenderowanych wyników.
Przykładem może być pominięcie panelu podglądu wyświetlanego po kliknięciu wyniku z obrazem.
Dzięki dwuczęściowemu wywołaniu zwrotnym wyniki wyszukiwania grafiki mogą kierować bezpośrednio do odpowiednich witryn, zamiast wyświetlać podgląd obrazu po kliknięciu.