Esta página contém uma variedade de exemplos de como usar callbacks do elemento de pesquisa. Elas complementam os exemplos encontrados na seção "Callbacks" do documento da API Custom Search Element.
Exemplos de chamada de retorno de pesquisa iniciada
O callback que iniciar a pesquisa pode modificar a consulta antes que ela seja usada na pesquisa.
O Mecanismo de Pesquisa Programável pode ser configurado para incluir termos predeterminados na consulta, mas
esse callback pode modificar a consulta com base em qualquer informação disponível para a função
de callback.
O callback de início de pesquisa a seguir decora cada consulta com o dia da semana atual.
Exemplos de callback renderizados de resultados
O callback dos resultados renderizados é bom para modificar a página depois que ela é preenchida com os resultados.
Ele foi projetado para facilitar a modificação da exibição de resultados sem exigir que o callback
assuma total responsabilidade pela renderização dos resultados.
Os exemplos a seguir ilustram duas aplicações do callback dos resultados renderizados que não operam nos resultados.
Exemplos de callback prontos para resultados
Nuvem de palavras
A aplicação óbvia do retorno de chamada resultados prontos é exibir os resultados da pesquisa em um formato difícil de alcançar usando o retorno de chamada resultados renderizados para ajustar o HTML. O callback results Ready é iniciado com um div vazio.
Um exemplo no documento da API Search Element
mostrou como usar o callback para renderizar uma versão muito simples dos resultados.
Outro exemplo mostrou como armazenar os dados dos resultados do callback results Ready e transmiti-los para o callback results renderizados, em que eles podem ser usados para decorar a exibição de resultados padrão.
O callback results Ready a seguir mostra que os resultados da pesquisa não precisam ser uma lista de resultados. Ela substitui a exibição normal dos resultados da pesquisa
por uma nuvem das palavras encontradas nos títulos e no conteúdo dos resultados. Quando a lista de resultados é apenas uma etapa intermediária para o usuário, um callback como esse pode ignorar esse estágio e usar os resultados para apresentar o relatório que o usuário quer.
Exemplo de callback em duas partes
Os callbacks resultados prontos e resultados renderizados podem ser usados em combinação para transmitir informações do primeiro para o segundo.
Por exemplo, as informações na matriz de objetos de resultado estão disponíveis para o callback results Ready, mas não o callback results renderizados.
Ao salvar essas informações em uma matriz como parte do callback results Ready, podemos torná-las acessíveis ao callback results renderizados.
Um exemplo disso é ignorar o painel de visualização mostrado quando um resultado de imagem é clicado.
Com um callback em duas partes, os resultados de imagem podem ser vinculados diretamente aos sites correspondentes, em vez de mostrar uma visualização de imagem quando clicados.