模板

模板

演示文稿模板标签

网站搜索/促销标签和演示文稿模板属性的列表。

演示文稿模板是包含站点搜索/促销所定义的演示文稿模板标记的HTML文件。 这些标记指示客户查看的搜索结果的格式。

请参阅关于模板。

您可以从以下演示文稿标记组中进行选择：

声明

声明是特殊的指引式声明标记，您可以在顶级演示文稿模板的顶部设置这些标记。 将忽略任何后续声明，包括包含的模板中的声明。

标记

描述

1

<guided-content-type-header content="content-type">

默认情况下，演示文稿模板会以MIME类型的text/html发回。 您可以更改此标记使用的内容类型。

在演示文稿模板中尽可能高地声明此标记。 请勿在此标签的同一行上添加其他文本。

2

<guided-xml-declare>

如果要返回XML，则可以使用此标签创建XML声明。 使此标记成为演示文稿模板中的第一行。 使用此标记时，content-type将自动设置为text/xml，除非在第一行中用 <guided-content-type-header> 覆盖它。 如果未指定字符集，则默认为UTF-8。 此标签在您的XML文档中生成以下输出：

<?xml version="1.0" encoding="charset-name" standalone="yes" ?>

结果

标记

描述

1

<guided-results></guided-results>

向导结果标签定义结果循环的边界。 通过指定 gsname 属性，可以访问任何结果集。 如果未提供 gsname ，则显示默认的搜索结果。

2

<guided-result-link></guided-result-link>

要创建指向给定结果的链接，请使用 guided-result-link 标签。 通过定义 gsname 属性，您可以使用索引中的字段，而不是引用“search-url”的标准“loc”标记。 任何其他属性(如类和目标)也可以传递，这些属性在生成的锚点标签中输出。

3

<guided-result-img gsname="fieldname">

<guided-result-img> 标记有助于创建图像标记，而不是将变量嵌入原始 img 标记中。

在 gsname 属性中指定用于图像路径的字段。 结果是一个 img 标记，其中包含您定义并传递的任何标准HTML属性。 因此，以下示例：

<guided-result-img gsname="thumbnail"  class="thumb" border="0"/>

becomes:

<img src="prod8172.jpg" class="thumb"  border="0"/>

4

<guided-result-field gsname="fieldname">

结果中显示的任何信息都将显示为 <guided-result-field> 标记(使用自动生成标记（如 <guided-result-img> 标记）除外)。

在 gsname 中指定“搜索索引”字段的名称。 传递的确切字符串是在模板中输出的。

如果希望此字段以不同方式转义，则可以指定转义选项。

在传输模板中指定的编码之上应用此编码。

5

<guided-if></guided-if-result-field>

如果特定字段中存在要显示的内容，则此条件标签集为true。 如果不存在内容，则条件为false。 如果某个值不存在，或者显示了其他图像，依此类推，则可以使用这些标签决定是否显示周围的HTML。

<guided-if-result-field gsname="thumbnail">     <guided-result-img gsname="thumbnail" class="thumb" /> <guided-else-result-field>     <img src="nothumb.jpg" class="nothumb" /> </guided-if-result-field>

6

<guided-if[-not]-result-wrap> <guided-else-result-wrap> </guided-if[-not]-result-wrap>

在列中显示结果时，此标签用于标识当前结果是否标记列的结尾。

当布尔条件为true时，将HTML添加到结果的末尾，以结束行并开始新行。 如果是最后一行，则不启动新行。

请参阅 <guided-if-not-last> 以了解有关该标签的更多信息。

<guided-if-result-wrap>      </div>      <guided-if-not-last>          <div>      </guided-if-not-last>  </guided-if-result-wrap>

7

<guided-results-found>

如果后端搜索请求返回结果，则返回1；如果未返回，则返回0。 如果未指定 gsname ，则标记将采用主搜索。 此标签有助于将逻辑传递给JavaScript例程。

8

<guided-results-total>

返回指定结果集中的结果总数。 未给出 gsname 时，假定默认搜索。

9

<guided-results-lower>

返回指定结果集页上较低结果的结果编号。 未给出 gsname 时，假定默认搜索。

10

<guided-results-upper>

返回指定结果集页上上结果的结果编号。 未给出 gsname 时，假定默认搜索。

11 

&lt;/guided-if[-not]-results-found&gt;   &lt;/p>  &lt;/td>

在找到结果时显示内容。 或者，在找不到结果时不显示结果HTML。

<guided-if-results-found gsname="products">     <guided-results gsname="products">         ...     </guided-results> <guided-else-results-found>      No results were found. </guided-if-results-found>

12

<guided-result-title />

<guided-result-title> 标签提供了使用 <title> 传输标签指定的标题传输模板字段的值。

13

<guided-result-description />

<guided-result-description> 标签提供了使用 <description> 传输标签指定的描述传输模板字段的值。

14

<guided-result-loc />

guided-result-loc> 标签提供了使用 <loc> 传输标签指定的loc传输模板字段的值。

15 

&lt;/guided-if-result-field&gt;   &lt;/p>  &lt;/td>

如果特定字段中有要显示的内容，则为true。 如果不存在内容，则条件为false。 使用标签来决定是否显示周围的HTML（如果不存在值，或是否显示其他图像等）。

<guided-if-result-field gsname="thumbnail">      <guided-result-img gsname="thumbnail" class="thumb"/> <guided-else-result-field>      <img src="nothumb.jpg" class="nothumb"/> </guided-if-result-field>

16

<guided-result-attribute-table gsname="tablename">

此标签提供在传输模板中定义的具有 <attribute_table> 传输标签的遍历属性表。 有 <guided-result-attribute-table-field> 标签用于显示属性表字段值。 也可以在循环内使用plain guided-result-field 标签来显示其他结果字段。

17

<guided-result-attribute-table-field gsname="fieldname">

显示在传输模板中定义的属性表字段。 

...

&lt;ul&gt;

&lt;guided-result-attribute-table&nbsp;gsname=&quot;downloads&quot;&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nhref;a&nbsp;&lt;guided-rest-table-field-nsp;gsp;gs=&nsp;gs&quot;download-link&quot;&nbsp;/&gt;&quot;&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;guid-result-attribute-table-field&nbsp;gsname=&quot;download-title&quot;&nbsp;/&gt;
&nbsp;&nbsp;&nbsp;&n;&nbsp;&n;&n;&nbsp;&nbsp;/a&gt;&nbsp;(&lt;gsname=&quot;title&quot;/&gt;)
&nbsp;&lt;/li&gt;






&lt;/guided-result-attribute-gt&gt;

&lt;/guided results&gt;   &lt;/p>  &lt;/td>

18

<guided-trace>

输出在给定搜索的传输模板输出的JSON数据的常规部分内跟踪数据中找到的跟踪信息。

如果未提供搜索名称，则假定为默认。

19

<guided-result-trace />

输出当前搜索结果的传输模板在JSON数据输出的结果>跟踪信息中找到的JSON内容。

此标记仅在 <guided-results></guided-results> 循环中有效。

彩块化

Facet是可导航的组件，可让您深入搜索结果。 您可以使用facet标签在您的演示文稿模板上显示各种facet。 您可以按名称引用彩块化。

请参阅关于Facets。

请参阅关于 Facet Rail。

请参阅关于动态彩块化。

标记

描述

3

<guided-dynamic-facets></guided-dynamic-facets>

给定搜索的任何动态彩块化的循环上下文。

编辑 <guided-facet> 演示文稿模板标签，以便 <guided-dynamic-facets> 循环上下文自动提供gsname属性。

2

<guided-facet-display-name gsname=" facetname " />

返回facet的显示标签。

如果facet在传输模板上使用 <display-name> 标记，则该标记的内容将成为标签。

1

<guided-facet-rail></guided-facet-rail>

在表示模板上定义一个部分，该部分用作facet边栏中每个facet的重复图案。

属于facet边栏的每个facet都使用此部分来评估其输出。

以下是彩块化边栏的示例：

<guided-facet-rail>   <guided-facet>     <guided-facet-display-name/>     ...     </guided-facet>   </guided-facet-rail>

请注意，当 <guided-facet-rail> 标签内的值在搜索时动态确定并正确替换时，以下标签不需要 gsname 属性：

  • 向导小平面
  • 向导 — facet-display-name
  • 向导 — facet-total-count
  • 向导 — facet-undo-link
  • 向导 — facet-undo-path
  • 向导 — facet-behavior

彩块化边栏页面上的排序标准确定彩块化的位置。 您可以从“排序彩块化方法”下拉式列表中选择排序顺序。

此标记可以选择接受_dynamic_facets的gsname 属性值， 为此搜索的任何动态彩块化提供循环上下文。此预定义的facet边栏也会在Business Rules用户界面中显示，以便在facet边栏“_dynamic_facets”中执行推ffacet X以定位Y ”。

请参阅关于 Facet Rail。

另请参阅关于动态彩块化。

4

<guided-facet gsname=" facetname " height=" 60px " width=" 120px "></guided-facet>

使用导向facet 标签可定义一个区域，其中所有facet标签都与特定facet相关。 此标签也是一个布尔标签，如果facet中不存在值，则隐藏所有内容。 在这种情况下，没有输出小平面值的点)。

高度和宽度属性是可选的，尺寸以像素(px)为单位指定。 可视规则生成器(VRB)使用这两个属性，并在隐藏facet时将虚线框显示为交互式占位符。

当显示名称位于facet中且facet处于隐藏状态时，该名称也会隐藏。 但是，如果名称位于facet之外，则仅当区域标签或 guided-if-facet-visible 标签绕在facet周围时，才可隐藏该名称。

5

<guided-if></guided-if>

当facet值的数量超过配置中定义的长度阈值时，此条件标签为true。 当列表过长时，使用它将facet显示为其他UI元素(如截断的列表或滚动框)。

<guided-facet name="category">     <guided-if-facet-long>         <select>             <guided-facet-values>                 <guided-facet-option />             </guided-facet-values>         </select>     <guided-else-facet-long>         <guided-facet-values>             <guided-facet-value-link><guided-facet-value /></guided-facet-link>         </guided-facet-values>     </guided-if-facet-long> </guided-facet>

您还可以在名为的向导facet 块的上下文之外使用此条件，方法是通过使用 gsname 属性直接引用特定facet。

<guided-if-facet-long gsname="category">     The category facet is very long! </guided-if-facet-long>

6

<guided-if></guided-if>

当点击facet至少一次且当前已选择facet值时，此条件标签为true。 它用于显示或隐藏HTML或gs标记，具体取决于是否单击了facet。

<guided-facet name="category">     <guided-if-facet-selected>         This facet has been selected.  You can no longer refine it.     <guided-else-facet-selected>     <guided-facet-values>         <guided-facet-value-link><guided-facet-value /></guided-facet-link>     </guided-facet-values>     </guided-if-facet-selected> </guided-facet>

您还可以在名为的向导facet 块的上下文之外使用此条件，方法是通过使用 gsname 属性直接引用特定facet。

<guided-if-facet-selected gsname="category">     The category facet is selected! </guided-if-facet-selected>

7

<guided-if></guided-if>

当只有一个facet值时，此条件标签为true。 当无法优化结果时，使用标记更改facet的显示。

<guided-facet name="category">     <guided-if-facet-single>         Facet is not refinable.     <guided-else-facet-single>         <guided-facet-values>             <guided-facet-value-link><guided-facet-value /></guided-facet-link>         </guided-facet-values>     </guided-if-facet-single> </guided-facet>

您还可以在名为的向导facet 块的上下文之外使用此条件，方法是通过使用 gsname 属性直接引用特定facet。

<guided-if-facet-single gsname="category">     There is only one value in the category facet! </guided-if-facet-single>

8

<guided-if></guided-if>

当facet为多选时，此条件标签为true。 使用标签可更改 <guided-facet-rail> 或 <guided-dynamic-facets> 标签内facet的显示。 

&nbsp;&nbsp;&nbsp;&nbsp;&lt;guided-if-facet-multiselect&gt;
&nbsp;...
&nbsp;&lt;guided-else-facet-multiselect&gt;
&nbsp;...
&nbsp;&lt;/guided-if-facet-multiselect&gt;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;...
&nbsp;&nbsp;&nbsp;&nbsp;&lt;/guided-facet&gt;
&nbsp;&nbsp;&lt;/guided-facet-rail&gt;   &lt;/p>  &lt;/td>

9

<guided-facet-values> facetname "]></guided-facet-values>

这是facet value循环迭代器标签。 您可以在名为的向导facet 块的上下文中定义它，在这种情况下，可以省略 gsname 。 或者，您可以在任何导向facet 块外部定义它，但它需要 gsname 属性来标识显示哪组facet值。

您还可以使用此标记在名为的guided-facet 块的上下文外显示facet值。 使用 gsname 属性直接引用特定facet。

<script>      registerFacetValues('category', '<guided-facet-values gsname="category"><guided-facet-value/>,</guided-facet-values>'); </script>

10

<guided-facet-value>

输出当前facet值的字符串。

默认情况下，该值为HTML转义。 您可以使用转义选项更改转义值的方式。

11

<guided-facet-count />

输出与当前facet值匹配的结果数。

12

<guided-facet-value-link></guided-facet-value-link>

为要单击的站点访客在facet值字符串周围创建链接。 将自动生成路径，以按当前facet值缩小结果。 它支持将任何属性直接传递给锚点标签。

<guided-facet-values>     <guided-facet-value-link class="facetlink"><guided-facet-value /></guided-facet-value-link> </guided-facet-values>

13

<guided-if-facet-value-selected> <guided-else-facet- value-selected> </guided-if-facet-value-selected>

更改当前选定的facet值时的显示。 如果已经选择，在大多数情况下，它不再可链接。

<guided-facet-values>      <guided-if-facet-value-selected>          <b><guided-facet-value/></b>      <guided-else-facet-value-selected>          <guided-facet-link><guided-facet-value/></guided-facet-link>         </guided-if-facet-value-selected> </guided-facet-values>

14 

&lt;/guided-if[-not]-facet-value-ghost&gt;   &lt;/p>  &lt;/td>

当facet值为重影值时，更改其显示。 当facet值是重影值时，它通常以斜体文本显示，以指示该值缺失或“重影”。

以下代码摘录是facet块的示例：

<guided-facet-values>     <guided-if-facet-value-selected>         <b><guided-facet-value /> (<guided-facet-count />)</b>             <guided-else-facet-value-selected>                 <guided-if-facet-value-ghost>                     <i><guided-facet-value /> (0)</i>                 <guided-else-facet-value-ghost>             <guided-facet-link class="link"><guided-facet-value /></guided-facet-link> (<guided-facet-count />)         </guided-if-facet-value-ghost>     </guided-if-facet-value-selected> </guided-facet-values>

15

<guided-facet-undo-link gsname=" facetname "></guided-facet-undo-link>

显示给定小平面的撤消链接。 如果存在多选彩块化，则此链接将取消选择给定彩块化的所有值。 为facet指定名称。 如果当前未选择facet，则链接是当前路径。

以下是此标记用法的示例：

<guided-if-facet-selected gsname="category">     <guided-facet-undo-link gsname="category">Undo Category</guided-facet-undo-link> </guided-if-facet-selected>

16

<guided-if-facet-long [gsname="facetname"]> <guided-else-facet-long></guided-if-facet-long>

当facet值的数量超过配置中定义的长度阈值时，此条件标签为true。 当列表过长时，使用它将facet显示为其他用户界面元素(如截断的列表或滚动框)。

<guided-facet gsname="category">      <guided-if-facet-long>          <div class="long_facet">              <guided-facet-values>                  <guided-facet-link><guided-facet-value/></guided-facet-link>              </guided-facet-values>          </div>      <guided-else-facet-long>          <div class="facet">              <guided-facet-values>                  <guided-facet-link><guided-facet-value/></guided-facet-link>              </guided-facet-values>          </div>      </guided-if-facet-long>  </guided-facet>

您还可以在名为的向导facet 块的上下文之外使用此条件，方法是通过使用 gsname 属性直接引用特定facet。

<guided-if-facet-long gsname="category">      The category facet is very long! </guided-if-facet-long>

17

<guided-if-facet-selected [gsname="facetname"]> <guided-else-facet-selected></guided-if-facet-selected>

当点击facet至少一次且当前已选择facet值时，此条件标签为true。 它可用于显示或隐藏HTML或gs标记，具体取决于是否单击了facet。

<guided-facet gsname="category">      <guided-if-facet-selected>          This facet has been selected.  You can no longer refine it.      <guided-else-facet-selected>          <guided-facet-values>              <guided-facet-link><guided-facet-value/></guided-facet-link>          </guided-facet-values>      </guided-if-facet-selected> </guided-facet>

您还可以在名为的向导facet 块的上下文之外使用此条件，方法是通过使用 gsname 属性直接引用特定facet。

<guided-if-facet-selected gsname="category">      The category facet is selected! </guided-if-facet-selected>

18

<guided-if-facet-single [gsname="facetname"]> <guided-else-facet-single></guided-if-facet-single>

当只有一个facet值时，此条件标签为true。 当无法优化结果时，它可用于更改facet的显示。

<guided-facet gsname="category">      <guided-if-facet-single>          Facet is not refinable.      <guided-else-facet-single>          <guided-facet-values>              <guided-facet-link><guided-facet-value/></guided-facet-link>          </guided-facet-values>      </guided-if-facet-single> </guided-facet>

您还可以在名为的向导facet 块的上下文之外使用此条件，方法是通过使用 gsname 属性直接引用特定facet。

<guided-if-facet-single gsname="category">      There is only one value in the category facet! </guided-if-facet-single>

19

<guided-if-facet-has-values [gsname="facetname"]> <guided-else-facet-has-values></guided-if-facet-has-values>

此条件允许您检查指定的facet是否具有任何值。 您可以使用它来显示另一个facet而不是空的facet。

20

<guided-facet-total-count gsname=" facetname " />

输出给定方面内的结果总数。

21

<guided-facet-value gsname=" associated custom facet value ">

输出与facet关联的值的字符串。 您可以有0个或多个与facet关联的字段。 具有关联字段非常罕见，为了支持这样，您需要配置传输模板。

22

<guided-if-facet-value gsname=" associated custom facet value " /><guided-else-facet-value></guided-if-facet-value>

测试facet值是否具有关联的字段值。

23

<guided-facet-link> value "]+></guided-facet-link>

在facet值字符串周围创建一个链接，供客户单击。 将自动生成路径，以按当前facet值缩小结果。 它支持将任何属性直接传递给锚点标签。

<guided-facet-values>      <guided-facet-link class="facetlink"><guided-facet-value/></guided-facet-link> </guided-facet-values>

24

<guided-facet-value-path>

创建指向facet值的您自己的链接。

<guided-facet-values>      <guided-lt/>a href="<guided-facet-value-path/>"<guided-gt/><guided-facet-value/></a> </guided-facet-values>

默认情况下，该值为URL转义。 但是，可以通过通过转义参数指定要使用的转义模式来添加另一个编码层。

25

<guided-facet-value-children></guided-facet-value-children>

当 <guided-facet-values> 迭代每个facet值时，此标签迭代嵌套facet的所有子值。 在此标记中，使用典型的facet标记创建链接、创建撤消链接和显示facet值。 此标签必须位于 <guided-facet-values> 内，因为它确实进行嵌套循环。

使用此标记的示例如下：

<guided-facet-values>   <guided-facet-link title='<guided-facet-value />'><guided-facet-value /> (<guided-facet-count />)</guided-facet-link>   <guided-if-facet-value-has-children>    <guided-facet-value-children>     <guided-facet-link title='<guided-facet-value />'><guided-facet-value /> (<guided-facet-count />)</guided-facet-link>    </guided-facet-value-children>   </guided-if-facet-value-has-children> </guided-facet-values>

26

<guided-if-facet-value-has-children> <guided-else-facet- value-has-children> </guided-if-facet-value-has-children>

测试当前facet值是否具有子值。 建议在使用 <guided-facet-value-children> 标签之前使用。 “else”子句是可选的。

27 

&lt;guided-else[-not]-facet-value-abote-length-threshold&gt;

&lt;/guided-if[-not]-facet-value-abote-length-threshold&gt;   &lt;/p>  &lt;/td>

确定facet-values循环中的当前facet值是否高于长度阈值。 它通常用于仅在长facet上显示低于阈值的值（除非用户先前选择了facet下方显示的“查看更多”链接）。

28 

&lt;guided-else[-not]-facet-value-equals-length-threshold&gt;

&lt;/guided-if[-not]-facet-value-equals-length-threshold&gt;   &lt;/p>  &lt;/td>

确定facet-values循环中的当前facet值是否等于长度阈值。

29

<guided-facet-value-undo-link></guided-facet-value-undo-link>

显示给定选定facet值的撤消链接。 使用它可在选定的facet值旁边显示撤消链接。 由于此撤消链接仅取消选择该特定的选定值，因此它与取消选择所有选定值的 <guided-facet-undo-link> 不同。

注意： 如果facet没有多选行为，则两个撤消链接具有相同的行为。 即，facet只能有一个选定值。

如果当前未选择facet，则链接是当前路径。 仅在 guided-facet-values 循环中使用此标签。

30

<guided-facet-value-undo-path />

创建您自己的facet值撤消链接。

31

<guided-facet-undo-path gsname=" facetname " />

创建您自己的facet撤消链接。

与 <guided-facet-undo-link> 标签类似，只是它为您提供了构建您自己的撤消链接的原始路径。

32

<guided-if-facet-value-matches facetname="facetname" value="value"><guided-else-facet-value-matches> </guided-if-facet-value-matches>

当给定facet具有选定值或单个值“value”时，有条件显示HTML。 此标签集通常用于根据在另一个facet中选定的值显示facet。

33

<guided-facet-behavior gsname=" facetname " />

确定小平面的行为，如正常、粘滞或多选。 对于收到XML结果并希望根据facet行为动态更改facet显示方式的客户而言，此功能非常有用。

34 

&lt;/guided-if-facet[-not]-visible&gt;   &lt;/p>  &lt;/td>

此标记所包裹的内容会根据facet的可见性状态进行隐藏或显示。 如果业务规则直接隐藏或显示facet，则facet内的任何内容将隐藏或显示。 不需要这些标签绕排facet。

此标记的常用用途是当名称位于facet外部时隐藏显示名称。 将此标记环绕在显示名称周围会使名称在facet隐藏时消失。

此标签替换区域，具有与使用区域相同的许多性能优势。

痕迹导航

请参阅关于痕迹导航。

标记

描述

1

<guided-breadcrumb> breadcrumbname "></guided-breadcrumb>

痕迹导航的循环标签。 对于当前状态的每个查询数，在开始和结束标签之间的任何内容都会重复。

如果省略 gsname ，则使用名为“default”的痕迹导航。

2

<guided-breadcrumb-link></guided-breadcrumb-link>

在痕迹导航中创建链接。 默认行为是“goto”行为。 如果链接的行为不同，请使用 gsname 可选属性指定“remove”或“drop”。 标记中包含的任何属性都会传递到生成的锚点标记。

<guided-breadcrumb>      <guided-breadcrumb-link gsname="remove" class="bc_link">          <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>

1

<guided-breadcrumb-value />

value标签将打印出当前痕迹导航小版本的转换值。 它仅用于导向痕迹导航块的上下文。

<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>

4

<guided-breadcrumb-label />

标签标签输出一个标签，用于描述已选择哪个facet来生成该痕迹导航项的痕迹导航值。 它仅用于导向痕迹导航块的上下文。

<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-breadcrumb-label/>: <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>

5

<guided-if-breadcrumb-label> <guided-else- breadcrumb-label> <guided-if-breadcrumb-label />

如果当前痕迹导航值具有标签，则此条件标签用于有条件地显示内容。 当标签实际存在时，它仅用于显示标签和相关内容。 它仅用于导向痕迹导航块的上下文。

<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-if-breadcrumb-label>              <guided-breadcrumb-label/>:          </guided-if-breadcrumb-label>      <guided-breadcrumb-value/></guided-breadcrumb-link> </guided-breadcrumb>

6

<guided-breadcrumb-path>

用于构建您自己的痕迹导航链接。

菜单

请参阅关于菜单。

标记

描述

1

<guided-menu gsname="menuname"></guided-menu>

这是菜单值循环迭代器标签。 使用 gsname 属性可标识显示的菜单项集。

2

<guided-menu-item-link></guided-menu-item-link>

为您提供用于优化当前菜单项搜索的URL。

1

<guided-menu-item-option>

通常，菜单显示在模板的选择控件中。 此标签使构建选择控件变得更简单，因为它生成用于为选择控件生成选项的HTML。

例如，以下代码块：

<select name="sort" onchange="gcGo(this);"> <guided-menu gsname="sort"> <guided-menu-item-option/> </guided-menu> </select>

可以生成如下HTML:

<select name="sort" onchange="gcGo(this);">   <option value="?sort=relevance;sp_sfvl_field=product-type|category|size;" selected="selected">Sort by Relevance</option>   <option value="?sort=avail-code;sp_sfvl_field=product-type|category|size;">Sort by Availability</option>   <option value="?sort=price;sp_sfvl_field=product-type|category|size;">Sort by Price</option> </select>

4

<guided-menu-item-value />

返回与菜单关联的值的字符串。

5

<guided-menu-item-label />

返回与菜单关联的标签的字符串。

6

<guided-menu-item-path />

返回路径字符串。 如果要向路径添加参数并创建自定义链接，请使用标记。

7

<guided-if-menu-item-selected> <guided-else-menu- item-selected> </guided-if-menu-item-selected>

返回1或0，指示是否选择了当前菜单项。

Pagenav

页面导航标签可用于构建一组链接，允许用户通过搜索结果进行页面。

标记

描述

1

<guided-pages></guided-pages>

页面导航的循环标签。 每个页面都会重复显示开始标记和结束标记之间的任何内容。

2

<guided-page-link></guided-page-link>

在页面导航中创建链接。

1

<guided-page-link gsname="first|prev|next|last|viewall|viewpages"></guided-page-link>

创建指向第一页、上一页、下一页或最后一页的链接。 它还可以创建一个链接，用于视图一个页面上的所有页面。

4

<guided-page-number />

返回具有当前页码的字符串。

5

<guided-if-page-selected> <guided-else-page- selected> </guided-if-page-selected>

如果选择了当前重复的页面，则此条件标签集为true。 它通常用于在页面导航控件中以不同方式显示页码。

6

<guided-if[-not]-page-prev> <guided-else-page- prev> </guided-if[-not]-page-prev>

如果当前页面有上一页，则此条件标记集为true。 它通常用于在有意义时显示页面导航中的上一个链接。

7

<guided-if[-not]-page-next> <guided-else-page- next> </guided-if[-not]-page-next>

如果当前页面有下一页，则此条件标记集为true。 它通常用于在有意义时显示页面导航中的上一个链接。

8

<guided-if[-not]-page-viewall> <guided-else-page- viewall> </guided-if[-not]-page-viewall>

当搜索返回大的结果集时，您可能不想优惠视图所有结果的功能。 因此，您可以使用这组条件标签来确定何时显示“全部视图”链接。

9

<guided-if[-not]-page-viewpages> <guided-else-page- viewpages> </guided-if[-not]-page-viewpages>

您可以使用这组条件标签来确定何时显示视图页链接。 它通常用于允许客户视图特定页面。

10 

&lt;guided-else-page-link&gt;
&lt;/guided-if[-not]-page-link&gt;   &lt;/p>  &lt;/td>

测试页面导航是否包含第一页、上一页、下一页等。

11

<guided-page-total />

返回包含搜索结果总页数的字符串。

12

<guided-pagination gsname= "pagination_name"></guided-pagination>

使用导向分页标签可定义一个区域，在您定义的页面导航设置很少的情况下，所有分页标签都与特定分页设置相关。

13 

next|last|viewall|viewpages&rbrack;/&gt;   &lt;/p>  &lt;/td>

在页面导航中创建您自己的链接。

14

<guided-if-page-high-eq-last> <guided-else-page- high-eq-last> </guided-if-page-high-eq-last>

测试页面导航中的最高页面是否等于页面总数。

15

<guided-if-page-low-eq-first> <guided-else-page-low-eq-first> </guided-if-page-low-eq-first>

测试页面导航中的最低页面是否等于该页面。

16

<guided-if-page-is-multipage> <guided-else-page-is-multipage> </guided-if-page-is-multipage>

测试是单页结果还是多页结果。

最近搜索

您可以使用最近搜索标记来构建一组链接，让用户快速运行以前的搜索，如下例所示：

<guided-if-recent-searches> 
    <span>Recent Searches</span><br/> 
    <guided-recent-searches> 
        <guided-recent-searches-link><guided-recent-searches-value></guided-recent-searches-link><br/> 
    </guided-recent-searches> 
    <guided-recent-searches-clear-link>Clear Recent Searches</guided-recent-searches-clear-link> 
</guided-if-recent-searches>

请参阅配置最近搜索。

标记

描述

1

<guided-recent-searches></guided-recent-searches>

最近搜索的循环标签。 每个页面都会重复显示开始标记和结束标记之间的任何内容。

2

<guided-recent-searches-link [attr="value"]+> </guided-recent-searches-link>

允许您构建指向最近搜索的链接。 它支持将任何HTML属性直接传递到锚点标签。

3

<guided-recent-searches-path />

允许您在向导 — 最近搜索循环中获取最近搜索的相对URL路径。 通常，您会使用 guided-recent-search-link 。 但是，如果您想构建自己的链接，可以使用此标签。 以下是一个示例：

<guided-lt/>a href="<guided_recent_searches_path>"><guided-recent-searches-value></a>

4

<guided-recent-searches-value>

允许您获取与最近搜索关联的查询词。

5

<guided-recent-searches-clear-link></guided-recent-searches-clear-link>

允许您优惠客户清除最近保存的搜索的功能。

6

<guided-recent-searches-clear-path />

返回 <guided-recent-searches-clear-link> 使用的路径，以便您能够构建自己的链接。

7 

&lt;/guided-if-recent-searches&gt;   &lt;/p>  &lt;/td>

允许您在客户执行最近搜索时显示最近搜索。

Did You Mean

当搜索未返回任何结果且搜索词未在帐户的词典中时，您可以使用“您的意思是”标记来构建指向建议的链接集。 以下是使用“您是错误”标记的示例：

<guided-if-suggestions> 
    <span>Did You Mean?</span><br/> 
    <guided-suggestions> 
        <guided-suggestion-link><guided-suggestion/></guided-suggestion-link><br/> 
    </guided-suggestions> 
</guided-if-suggestions>

请参阅关于 Did You Mean。

标记

描述

1

<guided-suggestions></guided-suggestions>

这是循环播放建议的循环标签。

2

<guided-suggestion-link></guided-suggestion-link>

创建指向给定建议的链接。

1

<guided-suggestion-value />

4

<guided-if[-not]-suggestions><guided-else[-not]- suggestions></guided-if[-not]-suggestions>

允许您测试是否有任何建议。

5

<guided-suggestion-path />

返回建议的路径字符串。 您可以使用它构建自己的锚点标签。 通常，使用 guided-succement-link 。

6

<guided-suggestion />

建议。

7

<guided-suggestion-result-count />

建议的结果计数。

8

<guided-if[-not]-suggestion-autosearch> <guided-else[-not]-suggestion-autosearch> </guided-if[-not]-suggestion-autosearch>

允许您测试是否执行了基于建议的自动搜索（在此功能处于开启状态时），结果为零。

9

<guided-suggestion-original-query />

如果执行了自动搜索，则返回原始查询。

使用示例：

<guided-if-suggestion-autosearch>     Search for <guided-query-param gsname="q" /> instead of <guided-suggestion-original-query /> </guided-if-suggestion-autosearch>

10

<guided-if[-not]-suggestion-low-results> <guided-else[-not]-suggestion-low-results> </guided-if[-not]-suggestion-low-results>

如果由于结果计数较低而有建议，则此条件为true，如果此功能已打开。

以下是使用此标记的示例：

<guided-if-suggestion-low-results>    You have a low result count for <guided-query-param gsname="q" />.    Did you mean: <guided-suggestions>        <guided-suggestion-link>           <guided-suggestion />        </guided-suggestion-link><guided-if-not-last>, </guided-if-not-last>    </guided-suggestions> </guided-if-suggestion-low-results>

自动完成

以下标记可用于向搜索表单添加自动完成功能。 需要头内容和表单内容标签才能正确实现自动完成功能。 建议您使用这些标记，而不是将自动完成的Javascript和CSS硬编码到演示文稿模板中。 原因是，每当您更改自动完成设置时，标记使模板能够拾取任何新的失败缓存ID，而无需手动更新模板。

请参阅关于自动完成。

标记

描述

1

<guided-if-autocomplete> <guided-else-autocomplete> </guided-if-autocomplete>

检测是否启用自动完成功能。 您可以使用标记（可选）拾取自动完成所需的头部和表单内容。 反过来，这又可让您打开和关闭功能，而不必更改演示文稿模板。

2

<guided-ac-css />

在演示文稿模板的头中使用，并替换为相应的CSS脚本，以便自动完成。

1

<guided-ac-form-content />

在演示文稿模板的搜索表单（在 <form> 和 </form> 标签之间）中使用，而不是硬编码表单中的自动完成标签。 标签将替换为完成自动完成工作所需的相应HTML。

4

<guided-ac-javascript />

生成指向自动完成JavaScript的链接。 为获得最佳性能，建议将此标签放在页面底部附近的结束“body”标签之前。

存储

使用以下标签来测试和显示用户当前所在的商店。

标记

描述

1

<guided-store />

输出当前存储。

2

<guided-if-store-defined> <guided-else-store-defined> </guided-if-store-defined>

检测用户是否在商店中。

3

<guided-if-store gsname="store"> <guided-else-store> </guided-if-store>

检测用户是否在存储中， gsname 参数指定。

区域

标记

描述

3

<guided-zone gsname="zone area">

您可以用区域标签中的任何内容换行，以创建该区域之外的区域。 这样，您就可以使用业务规则根据需要显示区域。 默认情况下，始终显示区域。 您可以使用可选的搜索和facet参数来指示与区域关联的搜索或facet。 此类功能可让软件在隐藏区域时跳过搜索或彩块化，从而提高搜索时间性能。 高度和宽度属性是可选的，用于配置在删除区域时占位符在可视规则生成器中的显示方式。

使用 guided-if-facet[-not]-visible 标记，而不是尽可能使用区域。 它简化了演示文稿模板。

2

<guided-if-zone gsname="zone area"> <guided-else-zone> </guided-if-zone>

这组标记允许测试当前是否显示区域。 当您在页面上的其他位置有您仅希望在显示区域时显示的内容时，此功能非常有用。

循环指示器

您可以在以下任何循环块中使用以下每个循环指示符：

  • 导向结果
  • 向导化彩块化值
  • 向导式痕迹导航
  • 向导菜单项
  • 向导页面

标记

描述

1

<guided-if[-not]-first><guided-else[-not]-first> </guided-if[-not]-first>

当当前迭代是循环的第一次迭代时，此条件为true。 这不一定意味着第一个结果或第一页，而是显示的第一个结果。 如果站点访客位于每页10的结果集的第2页，则第一次迭代为结果11。

2

<guided-if[-not]-last><guided-else[-not]-last> </guided-if[-not]-last>

当当前迭代是循环的上次迭代时，此条件为true。 这不一定意味着最后一个结果或最后一页，而是当前上下文（页面）中显示的最后一个结果。 如果站点访客位于包含200个结果但每页仅有10个结果的结果集的第1页，则上次迭代的结果是结果10而不是结果200。

3

<guided-if[-not]-odd><guided-else[-not]-odd> </guided-if[-not]-odd>

当当前迭代是循环的奇数迭代时（与偶数迭代相比），此条件为true。 这对于显示不同的行颜色很有帮助。

4

<guided-if[-not]-even><guided-else[-not]-even> </guided-if[-not]-even>

当当前迭代为循环的偶次迭代时（与奇次迭代相比），此条件为true。 这对于显示不同的行颜色很有帮助。

5

<guided-if[-not]-alt><guided-else[-not]-alt> </guided-if[-not]-alt>

当当前迭代为循环的偶次迭代时，此条件为true。 这对于显示不同的行颜色很有帮助。

6

<guided-if[-not]-inner><guided-else[-not]-inner> </guided-if[-not]-inner>

如果当前小版本不是第一个小版本或最后一个小版本，则包括它们之间的文本。

7

<guided-if[-not]-outer><guided-else[-not]-outer> </guided-if[-not]-outer>

如果当前小版本是第一个或最后一个，则包括它们之间的文本。

8

<guided-loop-index>

一个整数（从0开始），其值为循环的每次迭代递增。

9

<guided-loop-counter>

一个整数（从1开始），其值为循环的每次迭代递增。

其他语言

以下标签可用于让您使用模板执行更高级的操作，例如构建自己的微型facet。

标记

描述

3

<guided-current-path>

为您提供当前使用的路径。 通常，它用于创建一个链接，将新参数添加到现有搜索。 默认情况下，路径为URL转义。 您可以通过转义参数指定要使用的转义模式。

示例：

<a href="<guided-current-path />&lang=fr"> French Version

在此示例中，搜索处理规则使用lang来选择法语版本。

当前路径始终至少具有一个查询参数。 如果不存在其他查询参数，则将其设置为 q=* ，以便更轻松地添加更多参数。

2

基本路径

如果要使用基路径创建链接，请在 href 开始使用 / 并添加参数。

<a href="/">All Products</a> Would create a link "All Products" to your basepath, for example https://search.mycompany.com/

1

<guided-query-param gsname="query_parameter">

允许您获取URL上的查询参数的现有值。 如果参数不存在，则此标签返回空字符串。 如果未指定转义选项，则返回的字符串将自动转义为HTML转义，则可以指定HTML转义或URL转义。

示例： 

&lt;guided-查询-param&nbsp;gsname=&quot;q&quot;&nbsp;/&gt;
给&nbsp;&amp;nbsp；值&nbsp;pants

&lt;guid-查询-param&n;gsname=&quot;lang&quot;&nbsp;/&amp;gt；给&nbsp;
给&nbsp;nbsp;en

&lt;gsname=&quot;test&quot;&nbsp;/&gt;
提供&nbsp;&amp;nbsp；空&amp;nbsp；字符串
&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;   &lt;/p>  &lt;/td>

4

<guided-query-param-name gsname="param#" offset="offset_number" />

“导向搜索”具有查询号的概念，该编号用于痕迹导航控件。 guided-查询-param-name允许您将参 数定义为演示文稿模板中链接的一部分，在该链接中，“向导搜索”会为您绘制出正确的查询编号。 gsname 中有一个“x”，“向导式搜索”将替换为正确的数字。 偏移值可以是0 - 15，其中0表示使用下一个可用查询号。 A 1表示您要向它添加1，依此类推。

与 gived-current-path 相结合，您可以构建自己的微型facet链接或允许额外的向下钻取级别。

示例：

<a href="<guided-current-path         />&<guided-query-param-name gsname="q#" offset="0"         />=mens&<guided-query-param-name gsname="x#" offset="0"         />=category" >Category:Men</a>        

<a href="<guided-current-path         />&<guided-query-param-name gsname="sp_q_exact_#" offset="0"         />=mens&<guided-query-param-name gsname="sp_x_#" offset="0"         />=category&<guided-query-param-name gsname="sp_q_exact_#" offset="1"         />=Jeans&<guided-query-param-name gsname="sp_x_#" offset="1"         />=product-type" >Cat:Men - Product:Jeans</a>

5

<guided-include gsfile="filename" />

允许您包含其他模板文件。 此功能意味着您可以使用子模板作为模块创建多个模板。

在以下示例中，包含痕迹导航和 facets 文件：

<guided-include gsfile='breadcrumbs.tmpl' /> <guided-include gsfile='facets.tmpl' />

不支持动态包含。 换句话说， gsfile 不能是变量。

6

<guided-search-time>

确定搜索所花的时间。 返回的搜索时间值以毫秒为单位指定。

7

<guided-fall-through-searches>

返回用于生成搜索结果页面的核心搜索计数。

8

<guided-if-fall-through-search></guided-if-fall-through-search>

测试核心搜索的计数是否大于1。

9

<guided-if[-not]-even><guided-else[-not]-even> </guided-if[-not]-even>

当当前迭代为循环的偶次迭代时（与奇次迭代相比），此条件为true。 这对于显示不同的行颜色很有帮助。

10

<guided-if[-not]-alt><guided-else[-not]-alt> </guided-if[-not]-alt>

当当前迭代为循环的偶次迭代时，此条件为true。 这对于显示不同的行颜色很有帮助。

11

<guided-if[-not]-inner><guided-else[-not]-inner> </guided-if[-not]-inner>

如果当前小版本不是第一个小版本或最后一个小版本，则包括它们之间的文本。

12

<guided-if[-not]-outer><guided-else[-not]-outer> </guided-if[-not]-outer>

如果当前小版本是第一个或最后一个，则包括它们之间的文本。

13

<guided-if-first-search><guided-else-first-search> </guided-if-first-search>

允许您检查是否进行初始搜索(查询是搜索框中搜索的结果)。

14

<guided-search-url />

您可以在模板中使用此标记，以免硬编码搜索表单的操作。 它会检测您何时处于“暂存”或“实时”环境，并相应地进行更改。

15

<guided-if-query-param-defined gsname="query_parameter"> <guided-else-query-param-defined> </guided-if-query-param-defined>

这组标签允许您测试在搜索路径中定义的CGI参数。 只有在定义了参数的值时，才能测试这些参数的值。

16

<guided-next-query-number>

驱动模板的引导式搜索引擎的概念是浮动查询号，引擎生成的每个新链接都使用下一个可用查询号。 通过此标签，您可以获取下一个查询号或偏移，以便构建可钻取到结果集的自定义链接。 偏移允许您偏移到下一个查询编号。 例如，如果您选择了一个彩块化，则下一个查询编号为2，偏移量为1，则返回的查询编号为3。

17

<guided-custom-var gsname="custom_variable">

允许您获取处理规则定义的自定义变量的现有值。 如果未指定转义选项，则返回的字符串将自动转义为HTML转义，则可指定 html 、 url 、 js 或 0 。 如果您使用处理规则将传入的CGI参数复制到自定义变量，然后在模板中显示或使用该变量，并将转义设置为none或js，那么您可以在搜索中创建XSS漏洞。

18

<guided-if-custom-var-defined gsname="custom_variable"> <guided-else-custom-var-defined> </guided-if-custom-var-defined>

在处理规则(查询清除、搜索前处理和搜索后处理)中定义自定义变量时启用测试。

19

<guided-general-field gsname="searchname" field="fieldname">

允许您显示传输模板中定义的常规字段的内容。 如果未指定转义选项，则返回的字符串将按照您在该字段的传输模板中指定的格式进行编码。 指定转义选项适用于编码字段的任何格式（如传输模板中）。 您可以指定 html 、 url 、 js 、 json 或 0 。

20

<guided-if-general-field gsname="searchname" field="fieldname"> <guided-else-general-field> </guided-if-general-field>

启用测试，如果传输模板中定义的常规字段的内容存在。

21

<guided-cookie-value gsname="cookie_name">

允许您获取Cookie的值（假定Cookie可用）。 如果未指定转义选项，则返回的字符串将自动转义为HTML转义，则可指定 html 、 url 、 js 、 json 或 0 。

22

<guided-if-cookie gsname="cookie_name"> <guided-else-cookie> </guided-if-cookie>

如果Cookie存在，则启用测试。

23

<guided-banner gsname="banner area">

输出给定区域的横幅。 可视规则生成器中使用可选的宽度和高度属性，以显示有意义的占位符，以便用户选择横幅。 默认情况下，横幅不会转义。 而是要将HTML插入演示文稿模板。 但是，如果要构建JSON模板，请考虑使用js转义选项。

示例：

<guided-banner gsname="top" width="400px"  height="50px"/>

24

<guided-if-banner-set gsname="banner area"> <guided-else-banner-set> </guided-if-banner-set>

在设置横幅区域时启用测试。

25

<guided-if-simulator-mode> <guided-else-simulator-mode> </guided-if-simulator-mode>

允许您检测在模拟器或可视规则生成器中查看搜索的时间。 它通常用于显示额外的调试信息。

26

<guided-if-tnt-business-rules> <guided-else-tnt-business-rules> </guided-if-tnt-business-rules>

允许您检测是否有任何引用 Adobe Target 活动的业务规则。 它通常用作与 Adobe Target 集成的一部分，以防止在不需要时对 目标 服务器进行攻击。

27

<guided-redirect />

默认情况下，会自动执行重定向。 但是，如果您已配置网站搜索/促销以将XML或JSON响应返回到Web应用程序，则可以选择在Web应用程序中分析302/301响应，或将重定向作为结果集的一部分传递到您。 如果您作为结果集的一部分传递重定向，则可以在模板中使用此标记来输出重定向位置。

28

<guided-if-redirect> <guided-else-redirect> </guided-if-redirect>

当您已配置网站搜索/促销以在结果集中返回重定向时，此标签集可用于确定是否存在指向输出的重定向。

29

<guided-lt /> <guided-gt />

这组标签允许您在HTML属性中嵌入引导模板标签。

示例：

<guided-lt/>div <guided-if-facet-long>         style="height: 125px; overflow:         auto;"</guided-if-facet-long><guided-gt/>

传输模板标签

传输模板是XML模板，可将数据从后端搜索传递到引导搜索表示层。

在您的表示层中，您可以有一个表示多个搜索结果的表示模板。 每个搜索可以使用相同的传输模板或自定义传输模板将数据传递到表示层。

由于传输模板仅用于将数据传递到表示层，因此它没有任何与显示搜索结果相关的HTML。 传输模板使用传输模板XML标记传递搜索结果以填充“导向搜索”组件，如彩块化、痕迹导航和菜单。 在这些标记中，标准搜索模板标记用于显示实际值。

请参阅编辑演示文稿或传输模板。

请参阅搜索模板标记。

传输模板标签

描述

<guided-xml></guided-xml>

表示层用来检测从传输模板中分析的内容的根XML标签。

<general></general>

标记环绕搜索模板标记，这些标记根据结果集提供摘要数据。 通常，这些标签包含搜索标签，用于查找结果总数、较低结果和最高结果。 您可以使用 general-field 标记定义所需的任意数量的附加全局字段，如下例所示：

<general>   <total><search-total /></total>   <lower><search-lower /></lower>   <upper><search-upper /></upper>   <general-field name="my_custom_field">Some global content</general-field> </general>

<results></results>

搜索结果周围会包含标记，以便“向导式搜索”知道在何处查找它们。

<result></result>

每个搜索结果周围都包含标签，因此“向导式搜索”可识别单个搜索结果开始和结尾的内容的位置，如以下示例中所示：

<results>   <search-results>     <result>       <index><search-index /></index>       <loc><search-cdata><search-url length="500" /></search-cdata></loc>     </result>   </search-results> </results>

<attribute-table name="tablename">

允许您在多值列表中循环查看每个项目，以获得单个结果。 仅在结果中使用此标记。 其目的是让您对属于结果字段的属性进行迭代，如下例所示：

<results>   <search-results>     <result>       <index><search-index /></index>       <loc><search-url /></loc>       <title><search-title /></title>       <attribute-table name="downloads">         <field name="download_title"><search-display-field name="download_title" /></field>         <field name="download_link" delimiter="|"><search-display-field name="download_link" /></field>       </attribute-table>     </result>   </search-results> </results>

<facets></facets>

对填充彩块化的结果进行传递。

<dynamic-facet></dynamic-facet>

可以将一个facet指定为动态facet和facet边栏的成员。 但是，在相关的演示模板标签方面，他们的待遇是独立的。

换句话说，不允许在动态facet循环上下文中嵌套facet边栏循环上下文，反之亦然。

对于既是动态的又是有栏的彩块化，只有为给定搜索返回的那些动态彩块化才会显示在彩块化循环上下文中。

<facet name="name"></facet>

每个facet都有其自己的facet标签，其中name参数与facet名称匹配。 搜索标记在facet值的facet标记中使用，如以下示例中所示：

<facets>   <facet name="brand">     <values><search-field-value-list name="brand" quotes="no" commas="yes" data="values" sortby="values" /></values>     <counts><search-field-value-list name="brand" quotes="no" commas="yes" data="counts" sortby="values" /></counts>   </facet>   <facet name="category">     <values><search-field-value-list name="category" quotes="no" commas="yes" data="values" sortby="values" /></values>     <counts><search-field-value-list name="category" quotes="no" commas="yes" data="counts" sortby="values" /></counts>   </facet> </facets>

使用开槽彩块化的帐户可以使用动态标记和显示名称标记。 这两个标签都有助于在创建业务规则时简化时隙彩块化和实际彩块化之间的映射。

<facets>   <facet name="facet_values01">  <dynamic>1</dynamic>  <display-names><search-field-value-list name="facet_names01" quotes="no" commas="yes" data="values" sortby="values" /></display-names>     <values><search-field-value-list name="facet_values01" quotes="no" commas="yes" data="values" sortby="values" /></values>     <counts><search-field-value-list name="facet_values01" quotes="no" commas="yes" data="counts" sortby="values" /></counts>   </facet>

<search-display-field separator=",">

通过分隔符属性，可以更改在输出列表的search-display-field数据时使用的分隔符。 默认值为逗号。

通常，您使用的分隔符应是字段内容中不易显示的内容。

<suggestions></suggestions>

将您的意思所在的建议用标签包装起来，以便“向导式搜索”能够识别哪些XML节点包含建议。

请参阅关于 Did You Mean。

<suggestion></suggestion>

将每个“您的意思”建议与标签一起换行，如下例所示：

<search-if-suggestions>   <suggestions>     <search-suggestions>       <suggestion><search-suggestion-text /></suggestion>     </search-suggestions>   </suggestions> </search-if-suggestions>

请参阅关于 Did You Mean。

搜索模板标记

搜索模板是包含网站搜索/促销所定义的模板标记的HTML文件。 这些标记指示搜索结果的格式。 以下参考包含每个搜索模板标记及其属性的简短说明。

注意

仅在传输模板文件(.tpl)中使用搜索模板标记。

您可以从以下搜索模板标签组和参考材料中进行选择。

仅在结果循环中有效的标记包括：

在整个模板中有效的标记包括：

搜索模板引用主题

关于结果循环标签

结果循环标签是模板系统的主要功能。 在搜索过程中遇到标记时，会重复该HTML，并在开始和结束结果循环标记之间重复其他标记，用搜索结果替换任何其他标记。

<search-results> ... </search-results>

显示搜索结果的HTML周围有结果循环标签。 标记之间的HTML会针对每个结果重复，并显示在页面上。

以下标记仅在结果循环中有效：

结果循环字符串标签

以下标签返回一个字符串。

请参阅关于结果循环标签。

标记

描述

1

<search-index>

返回当前结果的数值索引。

2

<search-title length="XX">

返回当前结果的页面标题。 可选length属性用于限制显示的字符串长度，默认值为80个字符。

1

<search-bodytext length="XX" encoding="html/javascript/json/perl/url/none">

返回从页面顶部开始的正文文本。 相关术语以粗体显示。 可选length属性用于限制显示的字符串长度，默认值为80个字符。 编码属性是可选的，它可以使用HTML编码（默认）、Javascript编码、Perl编码或无编码对输出字符进行编码。

4

<search-description length="XX" encoding="html/javascript/json/perl/url/none">

返回当前结果的描述。 如果meta description标签存在且内容属性不为空，则显示该文本。 否则，将显示页面正文文本的开头。 可选length属性用于限制显示的字符串长度，默认值为80个字符。

可选的编码属性控制输出是否是HTML编码、JavaScript编码、Perl编码、URL编码或未编码，以在结果页上输出。 编码的默认值为 html 。 通常，您无需指定编码属性。

5

<search-score rank="dynamic/static/dynamic-raw/static-raw/final-raw" precision="XX">

返回当前结果的得分，即数字0 - 100。 如果您已在选项 > 元数据 > 定义下定义了排名字段，则可以通过将排名属性设置为动态( <search-score rank="dynamic"> )来显示动态页面排名。 通过将rank属性设置为static( <search-score rank="static"> )，可显示静态页面排名。 您可以使用可选的precision属性指定要显示的小数位数。 默认值为0，显示整数得分)。

6

<search-date length="XX" none="text" date-format="date-format-string" gmt="yes/no" language="0/2/language-id">

返回当前结果的日期。 如果没有与当前结果关联的日期，则显示可选的“无”文本值。 如果未提供可选的“无”值，则如果没有与当前结果关联的日期，则显示文本“无日期”。

"date-format"属性采用UNIX样式的日期格式字符串，如"%A， %B %d， %Y"（对于"2016年7月25日，星期一"）。 "gmt"默认为"yes"，并控制日期字符串的时间部分应以GMT("yes")或帐户的时区("no")输出。

“language”属性控制输出日期字符串的语言和区域设置约定。 “0”（默认）是指“使用帐户语言”。 “2”指“使用文档语言”。 "语言"值"1"保留供将来使用。 任何其他“语言”值都解释为特定语言标识符，例如，“en_US”表示“英语（美国）”。

可选length属性用于限制显示的字符串长度，默认值为80个字符。

7

<search-size>

返回当前结果的大小（以字节为单位）。

8

<search-url length="XX" encoding="html/javascript/json/perl/url/none">

返回当前结果的URL。

使用可选的 length 属性限制显示的字符串长度，默认字符数不限。

编码属性是可选的，它可以使用HTML编码、Javascript编码、Perl编码或无编码对输出字符进行编码。

9

<search-url-path-query length="XX">

返回路径和查询部分，包括当前结果URL的问号。

使用可选的 length 属性限制显示的字符串长度，默认字符数不限。

10

<search-context length="XX" encoding="html/javascript/json/perl/url/none">

返回搜索词的下一行上下文。 相关术语以粗体显示。 重复调用此标记可显示当前结果的多个上下文行。

使用可选的 length 属性限制显示的字符串长度，默认值为80个字符。 如果此标签由 <search-if-context> 或 <search-if-any-context> 标签集包含，则忽略长度属性。

编码属性是可选的，它可以使用HTML编码（默认）、Javascript编码、Perl编码或无编码对输出字符进行编码。

11

<search-display-field name="field-name" length="XX" none="text" date-format="date-format-string" gmt="yes/no" language="0/2/language-id" encoding="html/javascript/json/perl/url/none" quotes="yes/no" commas="yes/no" units="miles/kilometers" separator="|">

此高级标记显示当前结果中在名称属性中指定的选项 > 元数据 >定义)下定义的元数据字段(url、标题、desc、键、目标、正文、alt、日期、字符集和语言或字段)的内容。 例如：

<search-display-field name="title" length="70" none="no title">

输出搜索结果的页面标题。 如果未指定可选的属性，则仅当没有与字段关联的内容时，其值才会显示在结果页上。

date-format 、 gmt 和语言属性仅在指定字段的内容类型为 date 时才相关。

date-format 属性采用UNIX样式日期格式字符串，如 %A、%B %d、%Y （2016年7月25日星期一）。 gmt 默 认为 是，并控制日期字符串的时间部分是以GMT（是）输 出 还是帐户的时区( 否 )输出。

请参阅日期格式字符串。

语言属性控制输出日期字符串的语言和区域设置约定。 0( 默认)是指“使用帐户语言”。 2 表示“使用文档语言”。语言值 1 保留供将来使用)。 任何其他语言值都解释为特定语言标识符，例如， en_US 表示“英语（美国）”。

请参阅语言标识符。

可选的 length 属性用于限制显示的字符串长度，默认值为80个字符。

可选的编码属性控制输出是否是HTML编码、JavaScript编码、Perl编码、URL编码或未编码，以在结果页上输出。 编码的默认值为 html 。 通常，您无需指定编码属性。

可选引号属性控制各个项输出是否用多次引号（或单引号，如果 encoding=perl ）括起来。 引号的默认值为 no 。

可选的逗号属性控制各个项目输出是否以逗号分隔。 逗号的默认值为是。 对于非列表类型字段，将忽略逗号属性。

可选的单位属性控制应用于邻近搜索输出字段的距离单位。 单位的默认值由与给定邻近搜索输出字段关联的位置类型字段的“默认单位”设置确定。

请参阅关于proximity search。

可选的分隔符属性定义在列表类型字段的输出值之间插入的单个字符或分隔符。

12

<search-display-field-values name="field-name"> ...<search-display-field-values>

此标签创建一个循环，用于枚举当前结果的元数据字段值（url、title、desc、keys、body、alt、date、charset和在选项 > 元数据 > 定义下定义的语言或字段）。 请勿将此标记嵌套在另一个 <search-display-field-values> 标记中。 名称属性指定包含要枚举的值的字段的名称。 对于已选中允许列表属性的字段，此标签最有用（在选项 > 元数据 > 定义下）。

13

<search-display-field-value date-format="date-format-string" gmt="yes/no" language="0/language-id" encoding="html/javascript/json/perl/url/none">

此标签输出当前 <search-display-field-values> 循环迭代的元数据字段值(url、title、desc、keys、目标、body、alt、date、charset和在选项 > 元数据 > 定义下定义的语言或字段。 此标记仅在 <search-display-field-values> 循环内有效。 date-format 、 gmt 和语言属性仅在封闭 <search-display-field-values> 标签中指定字段名称的内容类型为 date 时才相关。 date-format 属性采用UNIX样式日期格式字符串，如 "%A , %B %d , %Y "（201年7月25日，星期一）6”)。 gmt 属性默认为是，并控制日期字符串的时间部分是以GMT（是）输出还是以帐户的时区（否）输出。

语言属性控制输出日期字符串的语言和区域设置约定。 0( 默认)是指“使用帐户语言”。任何其他语言值都解释为特定语言标识符，例如， en_US 表示“英语（美国）”。

可选的编码属性控制输出是否是HTML编码、JavaScript编码、Perl编码、URL编码或未编码，以在结果页上输出。 编码的默认值为 html 。 通常，您无需指定编码属性。

14

<search-display-field-value-count name="field-name">

输出当前结果中使用名称属性指定的元数据字段（url、title、desc、keys、body、alt、date、charset和在选项 > 元数据 > 定义下定义的语言或字段）的值总数。 此标签可显示在结果循环中的任意位置。

15

<search-display-field-value-counter>

输出当前 <search-display-field-values> 循环迭代的序数计数器（1、2、3等）。 此标记仅在 <search-display-field-values> 循环内有效。

16

<search-dynamic-facet-fields>

开始为此搜索返回的任何动态彩块化字段循环上下文。

17

<search-dynamic-facet-field-name>

输出此循环迭代的当前dynamic-facet-field的名称。

18

<search-result-trace encoding="html/javascript/ json/perl/url/none">

输出与当前结果放置相关的信息，例如影响结果位置的任何基于结果的操作。

此标记的输出格式为JSON，如以下示例所示：

{   "sliceID": 5,   "indexID": 5894,   "finalScore": 98.5,   "dynamicScore": 15.3,   "staticScore": 55.456,   "position": 1,   "rbtaActionListID": 117,   "rbtaActionID": 57 }

编码属性是可选的；默认值为 html 。

注意： 仅当使用核心搜索查询参数指定了 sp_trace=1 时，此标签才具有输出。

请参见后端搜索CGI参数中的表中的第48行。

结果循环条件标签

以下标签有条件地包括它们之间的HTML。

请参阅关于结果循环标签。

标记

描述

1

<search-if-title> ... </search-if-title>

<search-if-not-title> ... </search-if-not-title>

如果对 <search-title> 的下次调用从文档标题返回（或不返回）文本，则这些标签包括它们之间的HTML。

2

<search-if-description length="XX"> ... /search-if-description>

<search-if-not-description> ... </search-if-not-description>

如果对 <search-description> 的下次调用从文档描述返回（或不返回）文本，则这些标签包括它们之间的HTML。

3

<search-if-bodytext> ... </search-if-bodytext>

<search-if-not-bodytext> ... </search-if-not-bodytext>

如果对 <search-bodytext> 的下次调用从文档正文返回（或不返回）文本，则这些标签包括它们之间的HTML。

4

<search-if-context length="XX"> ... </search-if-context>

<search-if-not-context> ... </search-if-not-context>

如果对 <search-context> 的下次调用返回（或不返回）非空的上下文字符串，则这些标签包括它们之间的HTML。 length属性覆盖任何封闭的 <search-context> 标签上的length属性。

5

<search-if-any-context length="XX"> ... /search-if-any-context>

<search-if-not-any-context> ... </search-if-not-any-context>

如果存在（或不存在）与结果关联的上下文字符串，则这些标签包括它们之间的HTML。 length属性覆盖任何封闭的 <search-context> 标签上的length属性。

6

<search-if-score lower="XX" upper="yy" rank="dynamic/static/dynamic-raw/static-raw/final-raw"> ... </search-if-score>

<search-if-not-score lower="XX" upper="yy" rank="dynamic/static"> ... </search-if-not-score>

如果当前结果的得分介于XX和YY之间，则这些标签包括它们之间的HTML。 对于添加项目符号或图形以显示结果的相关性非常有用。 如果您已在选项 > 元数据 > 定义下定义了排名类型字段，则可以通过将排名属性设置为动态( <search-if-score rank="dynamic" lower=XX upper=YY> )来检查动态页面排名。 通过将rank属性设置为static( <search-if-score rank="static" lower=XX upper=YY> )，可以检查静态页面排名。

7

<search-if-field name="field-name" value="value"> ... </search-if-field>

<search-if-not-field name="field-name" value="value"> ... </search-if-not-field>

这些高级标签包括它们之间的HTML，具体取决于在“name”属性中指定的字段是否包含内容。 如果指定了可选的“value”属性，则根据给定值是否与当前结果中字段的值匹配（或不匹配），标签将在它们之间包含HTML。 这些标签仅在结果循环中起作用（在 <search-results> 和 </search-results> 标签之间）。

结果循环锚点链接标签

请参阅关于结果循环标签。

标记

描述

3

<search-link target="frame-name" hbx-enable="yes/no" hbx-linkid-name="field-name" hbx-linkid-none="text" hbx-linkid-length="XX"> ... </search-link>

这对标签在它们之间的HTML周围创建一个锚点链接。 单击链接时，将显示结果页。 可选的目标属性指定了指定的窗口，支持帧的浏览器应在其中显示结果页。

将hbx-enable属性设置为“是”，以利用通过HBX提供的分析。 将hbx-linkid-name设置为要跟踪的元数据字段的名称。 例如，要按SKU编号跟踪搜索结果，请将hbx-linkid-name设置为包含SKU信息的元数据字段的名称。

当前不支持日期类型字段。 hbx-linkid-name的值将附加到生成的锚点中的链接ID。 只要命名的元数据字段为空，就会将hbx-linkid-none属性的值附加到链接ID。 hbx-linkid-length的值限制从Meta标签中获取和显示的字符数。 默认的字符数为12。

2

<search-smart-link target="frame-name" hbx-enable="yes/no" hbx-linkid-name="field-name" hbx-linkid-none="text" hbx-linkid-length="XX"> ... </search-smart-link>

这对标记与 <search-link> ... </search-link> 标记类似。 单击生成的锚点链接时，将显示结果页，但该页滚动到结果前最近的锚点标签。 对于PDF链接，Acrobat查看器显示包含结果的页面。 可选的目标属性指定了指定的窗口，支持帧的浏览器应在其中显示结果页。

将hbx-enable属性设置为“是”，以利用通过HBX提供的分析。 将hbx-linkid-name设置为要跟踪的元数据字段的名称。 例如，要按SKU编号跟踪搜索结果，请将hbx-linkid-name设置为包含SKU信息的元数据字段的名称。

当前不支持日期类型字段。 hbx-linkid-name的值将附加到生成的锚点中的链接ID。 只要命名的元数据字段为空，就会将hbx-linkid-none属性的值附加到链接ID。 hbx-linkid-length的值限制从Meta标签中获取和显示的字符数。 默认的字符数为12。

1

<search-if-link-extension> ... </search-if-link-extension>

<search-if-not-link-extension> ... </search-if-not-link-extension>

如果值属性指定的扩展与结果的URL结尾相匹配，则这些标签包括它们之间的HTML。 此标签对于在基于链接扩展的搜索结果中包含图形很有用。 value属性是一个或多个扩展（空格分隔）的列表，如下所示：VALUE="。pdf"或VALUE="。html .htm"。

循环位置条件标签

以下标记有条件地包括它们之间的文本。 它们只能显示在“循环”标记中：search-results>和<search-field-values>。 它们用于测试当前结果在结果集中的位置。

请参阅关于结果循环标签。

标记

描述

1

<search-if-first> ... </search-if-first>

<search-if-not-first> ... </search-if-not-first>

如果当前结果是（或不是）页面上的第一个结果（在 <search-results> 中使用）或第一个字段值（在 <search-field-values> 中使用），则这些标签包括它们之间的文本。

2

<search-if-last> ... </search-if-last>

<search-if-not-last> ... </search-if-not-last>

如果当前结果是（或不是）页面上的最后一个结果（在 <search-results> 中使用）或最后一个字段值（在 <search-field-values> 中使用），则这些标签包括它们之间的文本。 此标签可用于在结果之间插入分隔符。 例如，这会在结果之间插入一个 <hr> 标签：

<search-results>    <search-lt>tr<search-if-alt> class="alt"</search-if-alt><search-gt>       <td><search-url></td>    </tr> </search-results>

1

<search-if-inner> ... </search-if-inner>

<search-if-not-inner> ... </search-if-not-inner>

如果当前结果不是页面上的第一个或最后一个结果（在 <search-results> 中使用）或不是第一个或最后一个字段值（在 <search-field-values> 中使用），则这些标签包括它们之间的文本。 标签的not版本测试结果是第一个还是最后一个。

4

<search-if-alt> ... </search-if-alt>

<search-if-not-alt> ... </search-if-not-alt>

如果当前结果是（或不是）页面上的替代结果（在 <search-results> 中使用）或替代字段值（在 <search-field-values> 中使用），则这些标签包括它们之间的文本。 “替代”结果是页面上的第二、第四、第六等。 此示例对替代表行应用不同的类。 请注意，使用 <search-lt> 和 <search-gt> 可允许将 <search-if-alt> 标签放在 <tr> 标签的“内部”。

    <search-results>        <search-lt>tr<search-if-alt> class="alt"</search-if-alt><search-gt>           <td><search-url></td>        </tr>     </search-results>

5

<search-if-even> ... </search-if-even>

<search-if-not-even> ... </search-if-not-even>

如果当前结果是（或不是）偶数编号结果（在 <search-results> 中使用）或偶数编号字段值（在 <search-field-values> 中使用），则这些标签包括它们之间的文本。 如果搜索结果的 <search-index> 值为偶数，则搜索结果为偶数。 换句话说，如果它在整个结果集中的位置是均匀的。 这可能与 <search-if-alt> 不同，后者测试结果在页面上的位置，而不是在整个结果集中。 下面两个表说明了差异：

第一页，sp_n=1

索引

结果

扯平？

Alt?

1

第一个结果

否

否

2

第二个结果

是

是

1

第三个结果

否

否

4

第四个结果

是

是

5

第五个结果

否

否

稍后页，sp_n=10

索引

结果

扯平？

Alt?

10

第十个结果

是

否

11

第11个结果

否

是

12

第十二个结果

是

否

13

第十三个结果

否

是

14

第十四个结果

是

否

最后，请注意，<search-if-even>始终与<search-if-alt>相同，因为字段值不分页。

字段值列表标签

以下高级标记输出字段值以及整个搜索结果集中的相关数据。 这些标签只针对搜索查询中的sp-sfvl-field CGI参数指定的字段生成输出。

标记

描述

3

<search-field-value-list name="field-name" quotes="yes/no" commas="yes/no" data="values/counts/results" separator="X" sortby="none/values/counts/results" max-items="XX" date-format="date-format-string" gmt="yes/no" language="0/language-id" encoding="html/javascript/json/perl/url/none">

此标签显示整个结果集中唯一字段值、值计数或结果计数的列表。

此标签仅生成由搜索查询中的 sp_sfvl_field CGI参数指定的字段的输出。 可选的“quotes”属性控制各个项目输出是否用多次引号（或单引号，如果encoding=perl）括起来。 “quotes”的默认值为“yes”。 可选的“逗号”属性控制各个项目输出是否以逗号分隔。 “逗号”的默认值为“是”。 可选的"data"属性控制是输出每个唯一字段值(data="values")，输出每个唯一字段值的总计数(data="counts")，还是输出包含每个唯一值的结果数(data="results")。 “data”的默认值为“values”。 对于非列表类型字段，data="counts"和data="results"是等效的。 separator属性定义要插入输出值之间的单个字符或分隔符。 可选的“sortby”属性控制输出的顺序；sortby="none"表示没有特定顺序，sortby="values"表示按字段值排序（根据字段的“排序”属性按升序或降序排序），sortby="counts"表示按字段值计数的降序排序，sortby="results"表示按包含每个值的结果数的降序排序。

请注意，sortby="counts"和sortby="results"对于非列表类型字段是等效的。 可选的“max-items”属性限制要输出的项目数。 “max-items”的默认值为–1，表示“输出所有项目”。

最大项目的绝对限制为100。 仅当指定字段的内容类型为“date”时，“date-format”、“gmt”和“language”属性才相关。 "date-format"属性采用UNIX样式的日期格式字符串，如"%A， %B %d， %Y"（对于"2016年7月25日，星期一"）。 "gmt"默认为"yes"，并控制日期字符串的时间部分应以GMT("yes")或帐户的时区("no")输出。

请参阅日期格式字符串。

“language”属性控制输出日期字符串的语言和区域设置约定。 “0”（默认）是指“使用帐户语言”。 任何其他“语言”值都解释为特定语言标识符，例如，“en_US”表示“英语（美国）”。 可选的“encoding”属性控制输出字符串字符是HTML编码、JavaScript编码、Perl编码、URL编码还是未编码，以在结果页上输出。 “encoding”的默认值为“html”。

请参阅语言标识符。

2

<search-field-value-list-count name="field-name" value="field-value" results="yes/no">

此标签显示给定搜索字段值列表的计数信息。 此标签有三种不同的用途。 如果仅提供“name”属性，则此标签输出整个结果集中命名字段的唯一值数。 如果同时提供"name"和"value"属性，则此标签输出整个结果集中给定值的总计数（对于results="no"），或包含整个结果集中给定值的结果总计数（对于results="yes"）。 “results”的默认值为“no”。 注意：对于非列表类型字段，results="yes"和results="no"是等效的。 如果未提供“value”属性，则忽略“results”的值。 此标签仅生成由搜索查询中的 sp-sfvl-field CGI参数指定的字段的输出。

3

<search-if-field-value-list-count name="field-name" value="field-value"> ... </search-if-field-value-list-count>

<search-if-not-field-value-list-count name="field-name" value="field-value"> ... </search-if-not-field-value-list-count>

如果对具有给定属性的 <search-field-value-列表-count name="field-name" value="field-value"> 的等效调用将（或不会）返回大于零的值，则这些标签会显示它们之间的HTML。

4

<search-if-single-field-value-list-count name="field-name"> ... </search-if-single-field-value-list-count>

如果对 <search-field-value-列表-count name="field-name" value="field-value"> 的等效调用（给定属性将返回或不返回）单个值，则这些标签会显示它们之间的内容。 这通常在帐户使用facet插槽时使用。 对于facet插槽，您通常只希望在关联的名称插槽具有单个项目时显示值插槽。 在传输模板中进行此检查比在表示层中进行检查更有效。

字段值列表循环标签

以下高级标签使用循环构造枚举和输出整个搜索结果集中的字段值和相关数据。 这些标签只针对搜索查询中的sp-sfvl-field CGI参数指定的字段生成输出。

标记

描述

3

<search-field-values name="field-name" sortby="none/values/counts/results" max-items="XX"> ... </search-field-values>

此标签创建一个循环，用于枚举整个结果集中特定字段的字段值和相关数据。 请勿将此标记嵌套在另一个 <search-field-values> 标记中。 “name”属性指定包含要枚举的值的字段的名称。 可选的“sortby”属性控制明细列表顺序："none"表示没有特定顺序，"values"表示按字段值排序（根据字段的“排序”属性按升序或降序排序），sortby="counts"表示按字段值计数的降序排序，sortby="results"表示按包含每个值的结果数的降序排序。

请注意，sortby="counts"和sortby="results"对于非列表类型字段是等效的。. 可选的“max-items”属性将迭代次数限制为给定值。 “max-items”的默认值为–1，表示“枚举所有值”。

2

<search-field-value date-format="date-format-string" encoding="html/javascript/json/perl/url/none" gmt="yes/no" language="0/language-id">

此标签输出当前<search-field-values>循环迭代的字段值。 此标记仅在 <search-field-values> 循环内有效。 仅当封闭<search-field-values>标记中指定的字段名称的内容类型为"date"时，“date-format”、“gmt”和“language”属性才相关。 "date-format"属性采用UNIX样式的日期格式字符串，如"%A， %B %d， %Y"（对于"2020年7月25日，星期一"）。

请参阅日期格式字符串。

可选的“encoding”属性控制输出字符串字符是HTML编码、JavaScript编码、Perl编码、URL编码还是未编码，以在结果页上输出。 “encoding”的默认值为“none”。 通常，您无需指定编码属性。 "gmt"默认为"yes"，并控制日期字符串的时间部分应以GMT("yes")或帐户的时区("no")输出。 “language”属性控制输出日期字符串的语言和区域设置约定。 “0”（默认）是指“使用帐户语言”。 任何其他“语言”值都解释为特定语言标识符，例如，“en_US”表示“英语（美国）”。

请参阅语言标识符。

1

<search-field-value-count results="yes/no">

此标签输出与当前 <search-field-values> 循环迭代关联的计数。 输出计数是包含字段值的整个结果集中的结果数（结果="yes"），或整个结果集中字段值的总计数。 “results”的默认值为“no”。

对于非列表类型字段，results="yes"和results="no"是等效的。 此标记仅在 <search-field-values> 循环内有效。

4

<search-field-value-counter>

此标签输出当前 <search-field-values> 循环迭代的序数计数器。 此标记仅在 <search-field-values> 循环内有效。

建议标记

Sembley提供用户友好的“您是说吗？” 服务。 例如，如果用户拼写错误了搜索词，“建议”可以通过建议正确的拼写来帮助用户查找结果。 系统还可以建议相关关键字，以帮助用户发现结果。 在生成建议时，建议服务使用两个词典：一个基于帐户语言（设置在​Indexing > Words and Languages > Language​下），另一个基于帐户索引中的关键字唯一构建。

注意

“建议”服务不适用于中文、日文或韩文。

标记

描述

1

<search-if-suggestions> ... </search-if-suggestions>

在这些标签周围添加任何“建议”模板标签，如 <search-seccuption> 、 <search-seccuption-link> 等。 如果搜索生成建议，则搜索引擎输出并处理开放标记和结束标记之间的所有内容。 如果搜索未生成建议，则不会输出任何嵌套内容。

2

<search-suggestions> ... </search-suggestions>

此标签生成“建议”循环，该循环包含建议搜索词的列表(例如，“打算”、“预期”和“打算”，对于最初输入为“意向”的查询)。 在生成术语列表时，搜索引擎最多重复五次任何嵌套的HTML和/或模板标记，这是建议的最大数目。 使用count属性指定生成的建议数（在0到5之间）。

<search-sugmentiss> 标记可在页面上多次显示以重复建议的列表。 根据每个结果的数量对多个建议进行排序。

将 <search-segments> 标记嵌套在open和close <search-if-segments> 标记之间。

1

<search-suggestion-link> ... </search-suggestion-link>

此标记使用选定的建议搜索词而不是原始词生成指向原始搜索查询的链接。 标签接受并直接打印任何HTML属性，如类、目标和样式。 标记还可以接受URL属性，该属性的值用作生成链接的基本URL。 这些标记只能显示在 <search-segmenties> 循环中。

4

<search-suggestion-text />

此标签将打印出当前建议的查询词(例如，最初作为“意图”输入的查询的“打算”)。 标记没有属性，只能显示在 <search-segcuments> 循环中。

5

<search-if-not-suggestions> ... </search-if-not-suggestions>

如果搜索不生成任何建议，则搜索引擎输出并处理开放标记和结束标记之间的所有内容。 如果搜索生成建议，则不会输出任何嵌套内容。

6

<search-if> ... </search-if>

这些条件标签包括它们之间的HTML，具体取决于建议的术语是否是建议循环中的第一个术语。 标签必须显示在open和close <search-seccuption> 标签之间。

7

<search-if> ... </search-if>

这些条件标签包括它们之间的HTML，具体取决于建议的术语是否是建议循环中的最后一个术语。 标签必须显示在open和close <search-seccuption> 标签之间。

8

<search-suggestion-index>

此标记返回当前建议搜索词的数值索引。 标记必须显示在open和close <search-seccuption> 标记之间。

9

<search-suggestion-total>

此标记返回生成的建议搜索词的总数。 标记必须显示在open和close <search-seccuption> 标记之间。

10

<search-suggestion-result-count>

此标记返回建议搜索词的结果总数。 标记必须显示在open和close <search-seccuption> 标记之间。

模板字符串标签

以下标签在模板中该点将字符串输出到HTML中。

标记

描述

3

<search-body>

具有“基本外观”部分在“模板”链接下设置的任何“搜索链接颜色”设置的HTML正文标签。 为此标签添加一个背景属性，以在结果页上显示背景图像。 添加到此标签的任何颜色属性都会覆盖“基本外观”部分设置的“搜索链接颜色”设置。

2

<search-header>

在“模板”链接下的“基本外观”部分中设置的“搜索结果标题”的HTML。

1

<search-cdata> ... </search-cdata>

search-cdata标记被替换为其XML等效项： <search_cdata> 替换为 <![CDATA["和</search-cdata> 标记替换为" ]> "。 XML分析器不解析开放标签和关闭标签之间的任何信息。

4

<search-query query-number="XX" encoding="html/javascript/json/perl/url/none">

访客输入的查询。 高级、可选的“查询编号”属性控制此标签输出带编号的查询字符串。 例如， <search-查询 查询-number=1> 输出 sp_q_1 cgi参数的内容。 如果未指定“查询编号”，或者查询编号为“0”，则输出主查询( sp_q )。 可选的“encoding”属性控制输出是否是HTML编码、JavaScript编码、Perl编码、URL编码或未编码，以在结果页上输出。 “encoding”的默认值为“html”。 通常，您无需指定编码属性。

5

<search-total>

此搜索的结果总数。

6

<search-count>

为此页面报告的结果计数。

7

<search-lower>

为此页面报告的第一个结果的编号。

8

<search-upper>

为此页面报告的最后一个结果的数量。

9

<search-prev-count>

为上一页报告的结果数。

10

<search-next-count>

为下一页报告的结果数。

11

<search-time>

此搜索的时间（以秒为单位）。

12

<search-logo>

为您的帐户配置的“搜索”徽标的HTML（如果有）。 此徽标是给予网站搜索/促销信誉的图像

目前，大多数帐户没有关联的搜索徽标。

13

<search-collection all="name">

此搜索的结果集合。 可选的“all”属性用于指定表示整个网站的集合的名称。

14

<search-form> ...</search-form>

插入开始和结束表单标记。 将方法和操作属性插入开始表单标签中。 接受其他属性，包括语言的dir="RTL"属性以及与JavaScript相关的“name”和“onSubmit”属性。

15

<search-input-account>

插入指定帐户号的表单输入标记。

16

<search-input-gallery>

插入指定库编号的表单输入标签。

17

<search-input-query query-number="XX">

插入指定查询字符串的表单输入标记。 高级、可选的“查询编号”属性控件用于表单输入标签的编号查询。 例如， <search-input-查询查询编号=1> 输出 sp_q_1 查询的表单输入标签。 如果未指定“查询编号”，或“查询编号”为“0”，则插入主 sp_q 查询的输入标记。

18

<search-input-collections all="name">

插入一个表单选择标记和关联的HTML，用于显示集合选择菜单。 可选的“all”属性用于指定表示整个网站的集合的名称。

19

<search-lt>

在结果页上的其他HTML或模板标记中插入一个“搜索”模板标记的输出。 <search-lt> 插入一个小于字符。使用 <search-lt> 和 <search-gt> 提供了一种对标记定义进行转义的方法，以便您可以使用Search模板标记作为属性值。 当响应搜索而呈现模板时，小于号(<)将替换 <search-lt> 标签。 例如， <search-link> 等效于 <search-lt> a href="<search-url>"<search-gt> 。

20

<search-gt>

在结果页上的其他HTML或模板标记中插入一个“搜索”模板标记的输出。 <search-gt> 插入大于字符。使用 <search-lt> 和 <search-gt> 提供了一种方法，可以转义标记的定义，以便您可以使用其他模板标记作为属性值。 当响应搜索而渲染模板时，大于号(>)将替换 <search-gt> 标记。 例如， <search-link> 等效于 <search-lt> a href="<search-url>"<search-gt> 。

21

<search-param name="param-name" length="XX" encoding="html/javascript/json/perl/url/none">

返回当前搜索请求中名为“param-name”的cgi参数的值。 可选的“encoding”属性控制输出是否是HTML编码、JavaScript编码、Perl编码、URL编码或未编码，以在结果页上输出。 “encoding”的默认值为“html”。 通常，您无需指定编码属性。

22

<search-trace encoding="html/javascript/ json/perl/url/none">

编码属性是可选的；默认值为json 。

注意： 仅当使用核心搜索查询参数指定了 sp_trace=1 时，此标签才具有输出。

请参见后端搜索CGI参数中的表中的第48行。

模板锚点链接标签

以下是导致锚点链接环绕在它们之间的HTML周围的标签。 单击时，锚点链接会请求显示另一页结果。 可选属性“count”要求在页面上显示许多结果。 如果未指定，则使用当前页面上请求的计数。 高级的可选“URL”属性控制关联链接指向的域。 默认情况下，域为https://search.atomz.com/search/，但可以使用URL属性更改。

标记

描述

1

<search-next URL="https://search.yourdomain.com/search/"> ... </search-next>

<search-prev URL="https://search.yourdomain.com/search/"> ... </search-prev>

显示结果的下一页或上一页。

2

<search-sort-by-date URL="https://search.yourdomain.com/search/"> ... </search-sort-by-date>

<search-sort-by-score URL="https://search.yourdomain.com/search/"> ... </search-sort-by-score>

按日期或相关性对结果排序。

3

<search-show-summaries URL="https://search.yourdomain.com/search/"> ... </search-show-summaries>

<search-hide-summaries URL="https://search.yourdomain.com/search/"> ... </search-hide-summaries>

显示或隐藏摘要。

模板条件标签

用于在它们之间有条件地包含HTML的标记。

标记

描述

1

<search-if-results> ... </search-if-results>

<search-if-not-results> ...</search-if-not-results>

如果当前页面包含任何（或不包含）搜索结果，则这些标签包含HTML。

2

<search-if-prev-count> ... </search-if-prev-count>

<search-if-not-prev-count> ... </search-if-not-prev-count>

<search-if-next-count> ... </search-if-next-count>

<search-if-not-next-count> ... </search-if-not-next-count>

如果上一页或下一页具有与其关联的任何（或无）结果，则这些标签包括HTML。

3

<search-if-sort-by-score> ... </search-if-sort-by-score>

<search-if-not-sort-by-score> ... </search-if-not-sort-by-score>

<search-if-sort-by-date> ... </search-if-sort-by-date>

<search-if-not-sort-by-date> ... </search-if-not-sort-by-date>

如果当前页面是否按相关性或日期排序，则这些标记包括HTML。

4

<search-if-show-summaries> ... </search-if-show-summaries>

<search-if-hide-summaries> ... </search-if-hide-summaries>

如果当前页面显示或隐藏摘要，则这些标签包含HTML。 您可以使用这些标记来包含或排除搜索结果的任何部分。

5

<search-if-input-collections> ... </search-if-input-collections>

<search-if-not-input-collections> ... </search-if-not-input-collections>

如果在生成当前页面的搜索结果时指定了集合，则这些标签包括HTML。

6

<search-if-advanced> ... </search-if-advanced>

<search-if-not-advanced> ... </search-if-not-advanced>

如果为搜索查询指定了 sp_advanced=1 CGI参数，则这些标签包括HTML。

7

<search-if-bad-param name="parameter-name"> ... </search-if-bad-param>

<search-if-not-bad-param name="parameter-name"> ... </search-if-not-bad-param>

如果给定参数无效或无效，则这些标签会在它们之间包含或排除HTML。

目前仅支持 sp_q_location[_#] 参数。

8

<search-if-param name="param-name" value="param-value"> ... </search-if-param>

<search-if-not-param name="param-name" value="param-value"> ... </search-if-not-param>

这些高级标签包括它们之间的HTML，这取决于在"name"属性中指定的CGI参数是否具有在"value"属性中指定的值。

9

<search-if-sort-by-field name="field-name"> ... </search-if-sort-by-field>

<search-if-not-sort-by-field name="field-name"> ... </search-if-not-sort-by-field>

如果当前页面是按给定字段名称排序的，或者不是按给定字段名称排序的，这些高级标签包括它们之间的HTML。

模板表单控件标签

用于控制搜索模板上<form>中复选框、单选按钮和列表框的默认选择状态的标签。

标记

描述

1

<search-input>

在模板中用于代替 <input> 标记。 将标记写入浏览器时，单词输入将替换搜索输入，并且标记中的所有其他信息将按原样输出。 此外，如果标签中指定的名称被列为CGI参数，并且标签中指定的值是该CGI参数的值，则在标签末尾添加选中的词。 这样，您可以自动使搜索结果中的默认单选按钮或复选框状态与当前查询相同。

例如，复选框的HTML代码可能如下所示：

<input type="checkbox" name="sp_w" value="exact">无相似声音匹配

该复选框的相应模板代码如下所示：

<search-input type="checkbox" name="sp_w" value="exact">无相似声音匹配

如果查询的CGI参数字符串包含 sp_w=exact ，则写入浏览器的搜索结果的标签如下（检查的字词将插入标签末尾）：

<input type="checkbox" name="sp_w" value="exact" checked="">无相似声音匹配

如果查询的CGI参数字符串不包含 sp_w=exact ，则写入浏览器的搜索结果的标签如下所示（标记中未列出选中的词）：

<input type="checkbox" name="sp_w" value="exact">无相似声音匹配

<search-input> 标记可用于将复选框和单选按钮放入搜索模板中。 如果您有要添加到搜索模板中的 <form> 的复选框或单选按钮，请使用 <search-input...> 代替 <input..> 。

2

<search-select> ... </search-select>

<search-option> ... </search-option>

<form> 标签中的下拉列表框以 <select> 标签开始，并以 </select> 标签结束。 关联的CGI参数的名称列在 <select> 标签中。 在 <select> 标签后面是 <option> 标签的列表，这些标签指定要在列表框中显示的值。

<search-select> 、 </search-select> 、 <search-option> 和 </search-option> 标签提供与 <search-input> 标签类似的功能。 即，如果 <search-select> 标签中的名称被列为CGI参数，且该CGI的值为<search-select> ，则在发送到浏览器的 <option> 标签的末尾自动添加选定的单词参数列为特定 <search-option> 标记中的值。 这样，您就可以自动在搜索结果中使默认列表框选项与当前查询相同。

例如，典型的列表框如下所示：

<select name="sp_x" size=1> <option value="any" selected>Anywhere</option> <option value="title">Title</option> <option value="desc">Description</option> <option value="keys">Keywords</option> <option value="body">Body</option> <option value="alt">Alternate text</option> <option value="url">URL</option> <option value="target">Target</option> </select>

该列表框的相应模板代码如下：

<search-select name="sp_x" size=1> <search-option value="any">Anywhere</search-option> <search-option value="title">Title</search-option> <search-option value="desc">Description</search-option> <search-option value="keys">Keywords</search-option> <search-option value="body">Body</search-option> <search-option value="alt">Alternate text</search-option> <search-option value="url">URL</search-option> <search-option value="target">Target</search-option> </search-select>

如果要将列表框添加到搜索模板的 <form> 中，请使用 <search-select...> 代替 <select...> 、 </search-select> </select>a9/>、 <search-option...> 代替 <option...> , 代替 </option> .

1

<search-sort-by-field name="field-name" count="XX"> ... </search-sort-by-field>

这些高级标签在它们之间的HTML周围创建一个锚点链接。 单击此锚点时，将显示在给定字段中排序的结果页。 可选的 count 属性指定要在结果页上显示的结果数。 如果省略计数，则使用当前页上使用的计数。

日期格式字符串

您可以在日期格式字符串中使用以下转换规范：

日期格式字符串

描述

%同类群组

匹配完整工作日名称（例如，“星期一”）的国家代表。 语言学 > 单词和语言 > 语言中的设置确定国家代表。

请参阅关于单词和语言。

%a

匹配缩写工作日名称的国家代表，其中缩写是前三个字符，例如“Mon”。 语言学 > 单词和语言 > 语言中的设置确定国家代表。

请参阅关于单词和语言。

%B

匹配整月名称的国家代表，例如“June”。 语言学 > 单词和语言 > 语言中的设置确定国家代表。

请参阅关于单词和语言。

%b

匹配缩写月份名称的国家代表，其中缩写是前三个字符，例如“Jun”。 语言学 > 单词和语言 > 语言中的设置确定国家代表。

请参阅关于单词和语言。

%D

等效于“%m/%d/%y”，例如“07/25/13”。

%d

将月中的某天与小数(01-31)匹配。

%e

将月日与小数(1-31)匹配。 空在单位数之前。

%H

将24小时时钟与小数(00-23)匹配。

%h

匹配缩写月份名称的国家代表，其中缩写是前三个字符，例如"Jun"（与%b相同）。

%I

将12小时时钟与小数(01-12)匹配。

%j

将年中的某天与小数(001-366)匹配。

%k

将(24小时时钟作为小数(0-23)匹配。 空在单位数之前。

%l

将12小时时钟作为小数(1-12)匹配。 空在单位数之前。

%M

将分钟数与小数(00-59)匹配。

%m

将月份与小数(01-12)匹配。

%p

根据需要匹配“ante meridiem”或“post meridiem”的国家代表，例如“PM”。 语言学 > 单词和语言 > 语言中的设置确定国家代表。

请参阅关于单词和语言。

%R

等效于“%H:%M”，例如“13:23”。

%r

等效于“%I:%M:%S %p”，例如“01:23:45 PM”。

%S

将第二个数字与十进制数字(00-60)匹配。

%T

等效于“%H:%M:%S”，例如“13:26:47”。

%U

将年份的周数（星期日作为周的第一天）与小数(00-53)匹配。

%v

等效于“%e-%b-%Y”，例如“2013年7月25日”。

%Y

将年份与世纪作为十进制数字进行匹配，例如“2013”。

%y

将不含世纪的年份与小数(00-99)匹配。

%Z

匹配时区名称。

%

匹配 "%".

语言标识符

下表包含每个支持语言的语言标识符。 您可以在以下模板标记中将这些标识符用作可选“语言”属性的值：

语言

语言 identifier

保加利亚语

bg_BG

中文（中国）

zh_CN

中文（香港）

zh_HK

中文（新加坡）

zh_SG

中文（台湾）

zh_TW

捷克语（捷克共和国）

cs_CZ

丹麦语（丹麦）

da_DK

荷兰语（比利时）

nl_BE

荷兰语（荷兰）

nl_NL

英语（澳大利亚）

en_AU

英语（加拿大）

zh_CA

英语（大不列颠）

en_GB

英语（美国）

zh_CN

法语（比利时）

fr_BE

法语（加拿大）

fr_CA

芬兰语（芬兰）

fi_FI

法语（法国）

fr_FR

法语（瑞士）

fr_CH

德语（奥地利）

de_AT

德语（德国）

de_DE

德语（瑞士）

de_CH

希腊语（希腊）

el_GR

爱尔兰盖尔语（爱尔兰）

ga_IE

意大利语（意大利）

it_IT

日语（日本）

ja_JP

朝鲜语（韩国）

ko_KR

挪威语（挪威）

no_NO

波兰语（波兰）

pl_PL

葡萄牙语（巴西）

pt_BR

葡萄牙语（葡萄牙）

pt_PT

俄语(前苏联合并)

ru_SU

斯洛伐克语（斯洛伐克）

sk_SK

斯洛伐克（斯洛文尼亚）

sl_SI

西班牙语（墨西哥）

es_MX

西班牙语（西班牙）

es_ES

瑞典语（瑞典）

sv_SE

指定内容类型HTTP头

可以使用以下标签指定Content-Type HTTP响应头：

<search-content-type-header [content="MIME-type"] [charset="charset-name"]>

content和charset属性是可选的。 此标记应尽早显示在模板中。 还建议在<search-html-meta-charset>或<search-xml-decl>之前显示，因为它会影响这些标签的行为。

如果未指定content属性，则MIME-type的值将默认为在​Settings > Crawling > Content Types​中设置的值。 如果指定content属性，则它将用作<search-html-meta-charset>标签的默认content属性。

如果未指定charset属性，则不会将charset值写入content-type标头。

如果指定charset="1"，则charset-name的实际值是sp_f CGI参数的值。 如果搜索中未提交sp_f CGI参数，则会从帐户设置中读取charset-name的实际值。 您可以视图或更改与您的帐户关联的字符集，该字符集位于​Settings > My Profile > Personal Information > Character Encoding​下。

请参阅配置您的个人用户信息。

可以通过将特定字符集名称列为charset值（如charset="iso-8859-1"或charset="Shift-JIS"）来选择该名称。

如果指定charset属性，则它将用作<search-html-meta-charset>和<search-xml-decl>标签的默认charset属性，并输出到content-type标题。

在HTML模板中指定字符集

默认的HTML搜索结果模板通过以下标记指定与当前帐户关联的字符集：

<search-html-meta-charset [content="MIME-type"] [charset="charset-name"]>

内容和字符集属性是可选的。 此标记必须显示在模板的HTML <head>部分中。 此标签在从模板生成的HTML页上生成以下标签：

<meta http-equiv="content-type" content="MIME-type; charset=charset-name">

如果未指定content属性，则MIME-type的实际值将默认为两个值之一。 如果<search-content-type-header>标签指定了content属性，则使用该值。 否则，使用的值是​Templates > Settings > Content Type​选项卡中的值集。

如果未指定charset属性，则charset-name的实际值默认为两个值之一。 如果<search-content-type-header>标签指定了charset属性，则使用该值。 否则，将从帐户设置中读取charset-name的实际值。 您可以视图或更改与您的帐户关联的字符集，该字符集位于​Settings > My Profile > Personal Information > Character Encoding​下。

请参阅配置您的个人用户信息。

如果指定charset="1"，则charset-name的实际值是sp_f CGI参数的值。 如果搜索中未提交sp_f CGI参数，则charset-name的实际值是在<search-content-type-header>标签中设置的值（如果已指定），或是在帐户设置中设置的值。

可以指定特定字符集名称，如charset="charset-name"中所示。 例如，charset="iso-8859-1"或charset="Shift-JIS"。

<search-html-meta-charset>标记是可选的。 如果删除它，浏览器将采用content-type的默认值，如下所示：content="text/html; charset=ISO-8859-1"。 您还可以选择将<search-html-meta-charset>标签替换为您自己的http-equiv标签。

在XML模板中指定字符集

默认的XML搜索结果模板通过以下标记指定与当前帐户关联的字符集：

<search-xml-decl [charset="charset-name"]>

charset属性是可选的。 此标记必须显示在模板顶部，但位于任何<search-content-type-header>标记之后。 此标签在从模板生成的XML文档上生成以下标签：

<?xml version="1.0" encoding="charset-name" standalone="yes" ?>

如果未指定charset，则charset-name的实际值默认为两个值之一。 如果<search-content-type-header>指定了charset属性，则使用该值。 否则，将从帐户设置中读取charset-name的实际值。 您可以视图或更改与您的帐户关联的字符集，该字符集位于​Settings > My Profile > Personal Information > Character Encoding​下。

请参阅配置您的个人用户信息。

如果指定charset="1"，则charset-name的实际值是sp_f CGI参数的值。 如果搜索中未提交sp_f CGI参数，则charset-name的实际值是在<search-content-type-header>标签中设置的值（如果已指定）或在帐户设置中设置的值。

如果需要，可以指定特定字符集名称，如charset="charset-name"中所示。 例如，charset="iso-8859-1" or charset="Shift-JIS"。

您可以选择将<search-xml-decl>标签替换为您自己的?xml标签。

在另一个中包括搜索模板

要将一个搜索模板包含在另一个中，请使用<search-include>标记，将file属性设置为要包含的模板文件的名称，如下例所示：

<search-include file="seo/seo_search_title.tpl" />

SEO搜索模板段位于seo/子文件夹中，普通搜索模板位于templates/子文件夹中。 只有.tpl文件有意要包含在此上下文中。

管理网站的多个传输模板

您可以通过为每个区域使用不同的搜索传输模板来控制网站中搜索结果的外观。

要实现这种搜索功能，您可以在网站搜索/促销中管理传输模板。 或者，您也可以在“发布”中管理传输模板。 与网站搜索/促销一样，“发布”允许您编辑、预览和发布多个搜索传输模板。

要设置搜索表单以使用特定传输模板（默认模板除外），请使用sp_t查询参数。 例如，假设您有一个名为“clearance”的搜索模板，用于您网站的已标记销售区域。 您可将标准HTML搜索表单与以下附加表单代码一起使用：

<input type=hidden name="sp_t" value="clearance">

当客户单击包含此行代码的标准表单时，将显示“清除”搜索传输模板及其搜索结果。

请参阅在搜索表单中使用集合。

请参阅使用具有表单的帧。

请参阅高级搜索表单示例。

在此页面上