本页面提供了各种使用搜索元素回调的示例。它们是对 Custom Search Element API 文档的
“回调”部分中的示例的补充。
搜索启动回调函数示例
搜索开始回调可以在将查询用于搜索之前修改查询。可编程搜索引擎可配置为在查询中包含预先确定的字词,但此回调可以根据回调函数可用的任何信息修改查询。
以下 search start 回调使用星期几装饰每个查询。
呈现的结果回调示例
结果渲染回调适用于在填充结果后对网页进行修改。该库旨在让您可以轻松修改结果的显示方式,而无需回调完全负责呈现结果。
以下示例展示了不会对结果执行操作的两个结果渲染回调应用。
结果就绪回调示例
词云
results ready 回调的明显应用是:使用 resultsRendering 回调函数调整 HTML,以一种难以到达的格式显示搜索结果。results ready 回调以空的 div
开头。Search Element API 文档中的一个示例展示了如何使用回调来呈现非常简单版本的结果。
另一个示例展示了如何保存来自 results ready 回调的结果数据,并将其传递给 resultsRendering 回调,在回调函数中可以使用这些数据来装饰标准结果显示界面。
以下 results ready 回调显示搜索结果不必是结果列表。它会将搜索结果的正常显示替换为在结果标题和内容中找到的字词的字词云。当结果列表只是用户的中间步骤时,这样的回调可以绕过该阶段,并使用结果呈现用户想要的报告。
两部分回调示例
您可以结合使用 results ready 和 resultsresults 回调,将两者中的信息从前者传递到后者。例如,结果对象数组中的信息可用于 results ready 回调,但不能由 results render 回调函数使用。
通过将这些信息作为 results ready 回调的一部分保存到数组中,我们可以让 resultsresults 回调函数访问这些信息。
例如,要绕过点击图片结果时显示的预览面板,通过两部分回调,我们可以将图片结果直接链接到相应的网站,而不是在用户点击时显示图片预览。