SiteServer STL Language

# <stl:search> Show search results

<stl:search
    isAllSites="对全部站点搜索"
    siteName="站点名称"
    siteDir="站点文件夹"
    siteIds="站点Id列表"
    channelIndex="栏目索引"
    channelName="栏目名称"
    channelIds="栏目Id列表"
    type="搜索类型"
    word="搜索关键词"
    dateAttribute="搜索时间字段"
    dateFrom="搜索开始时间"
    dateTo="搜索结束时间"
    since="搜索时间段"
    pageNum="每页显示的内容数目"
    isHighlight="关键字高亮">
</stl:search>

# 说明

通过 stl:search 标签在模板中显示搜索结果

stl:search 标签有默认显示方式和自定义显示方式两种表现形式。如果 <stl:search> 不包含子标签则采用默认显示方式显示搜索提交表单、如果 <stl:search> 包含子标签则采用自定义的内容显示搜索提交表单。

<stl:search> 标签对应的实体为{stl:search}。

# 页面参数

上表对应的属性均可作为页面参数传递给 <stl:search> 标签，系统将首选页面参数值，如果未传参数，系统再从 <stl:search> 属性取值。

示例：/utils/search.html?word=中国&type=title&pageNum=10将优先于 <stl:search type="title,content" pageNum="20">。

# 子标签

子标签 说明
stl:loading 正在搜索时的显示模板，可以省略
stl:yes 搜索出内容时的显示模板，可以省略
stl:no 未搜索出内容时的显示模板，可以省略

如果需要根据是否搜索成功显示不同的结果，需要使用子标签 <stl:yes> 和 <stl:no> ，有搜索结果时将显示 <stl:yes> 中的内容，无搜索结果时将显示 <stl:no> 中的内容。

如果只定义搜索结果模板，可以省略<stl:yes>，直接将模板放到<stl:search> 中。

自定义搜索提交表单需要在 <stl:search> 中嵌入显示搜索结果的标签，必须包含的标签有 <stl:pageContents> 和 <stl:pageitems> 及 <stl:pageItem> 标签，分别用于显示搜索结果分页列表和搜索结果翻页项。

  • <stl:search> 内必须包含一个 <stl:pageContents> 标签，用于显示搜索结果内容列表，详情请参考 <stl:pageContents> 标签。
  • <stl:search> 内必须包含一个 <stl:pageitems> 标签和多个 <stl:pageItem> 标签，用于显示翻页项，详情请参考 <stl:pageItems> 标签及 <stl:pageItem> 标签。
  • <stl:search> 中除以上标签外可以添加任意 Html 标签或 STL 标签，用于组织显示样式。

# 属性

属性 说明
isAllSites 对全部站点搜索
siteName 站点名称
siteDir 站点文件夹
siteIds 站点Id列表
channelIndex 栏目索引
channelName 栏目名称
channelIds 栏目Id列表
type 搜索类型
word 搜索关键词
dateAttribute 搜索时间字段
dateFrom 搜索开始时间
dateTo 搜索结束时间
since 搜索时间段
pageNum 每页显示的内容数目
isHighlight 关键字高亮

# isAllSites - 对全部站点搜索

是否对全部站点进行搜索

  • "true" 搜索所有站点的内容
  • "false" 只搜索本站内容，默认值

# siteName - 站点名称

站点名称，设置后系统将只搜索对应站点的内容

# siteDir - 站点文件夹

站点文件夹，设置后系统将只搜索对应站点的内容

# siteIds - 站点Id列表

站点 Id 列表，多个站点 Id 以“,”分割，设置后系统将只搜索对应站点集合的内容

# channelIndex - 栏目索引

栏目索引，设置后系统将只搜索对应栏目及其下级栏目的内容

# channelName - 栏目名称

栏目名称，设置后系统将只搜索对应栏目及其下级栏目的内容

# channelIds - 栏目Id列表

栏目 Id 列表，多个栏目 Id 以“,”分割，设置后系统将只搜索对应栏目集合及其下级栏目的内容

# type - 搜索类型

title 定义搜索字段，默认为 title，可以定义多个搜索字段，如：title,content

# word - 搜索关键词

定义搜索关键词，通常不设置在模板中，系统从地址栏参数中获取

# dateAttribute - 搜索时间字段

AddDate 日期搜索字段，定义 dateFrom、dateTo 或者 since 日期过滤条件的对应日期字段

# dateFrom - 搜索开始时间

搜索日期开始时间

# dateTo - 搜索结束时间

搜索日期结束时间

# since - 搜索时间段

搜索时间段，格式为"数字+日期符号"，日期符号有"y"、"m"、"d"及"h"，分别代表年、月、天及小时。

# pageNum - 每页显示的内容数目

每页显示多少条内容

# isHighlight - 关键字高亮

是否关键字高亮显示

  • "true" 高亮显示
  • "false" 正常显示

# 示例

# 采用默认方式显示搜索结果

下面的例子实现页面的简体/繁体转换功能，如果希望所有页面均实现转换，需要把代码放到所有模板中（通常放到头部包含文件）。

<stl:search pageNum="12" isDefaultDisplay="true"></stl:search>

# 采用自定义方式显示搜索结果，搜索结果关键字高亮显示

<stl:search isDefaultDisplay="true" isHighlight="true">
  <stl:pageContents scope="All" pageNum="12">
    <div>
      <stl:a target="_blank"></stl:a><br />
      <stl:content type="Content" isClearTags="true" wordNum="120"></stl:content>
    </div>
  </stl:pageContents>
  <br />
  <stl:pageItems>
    <table cellpadding="0" cellspacing="0" width="90%" height="40" align="center">
      <tr>
        <td align="left">
          <stl:pageItem type="FirstPage" text="首页"></stl:pageItem> |
          <stl:pageItem type="PreviousPage" text="上一页"></stl:pageItem> |
          <stl:pageItem type="NextPage" text="下一页"></stl:pageItem> |
          <stl:pageItem type="LastPage" text="末页"></stl:pageItem>
        </td>
        <td align="right">
          <stl:pageItem type="CurrentPageIndex" text="当前页："></stl:pageItem>
          <stl:pageItem type="PageNavigation"></stl:pageItem>
        </td>
      </tr>
    </table>
  </stl:pageItems>
</stl:search>

# 自定义载入中、有搜索结果以及无搜索结果模板

下面的例子通过自定义载入中、有搜索结果以及无搜索结果模板来实现搜索页面的自定义。

<stl:search>
  <stl:loading>
    <div class="alert alert-info" role="alert">
      <strong>提示!</strong> 系统正在搜索中，请稍后...
    </div>
  </stl:loading>
  <stl:yes>
    <stl:pageContents scope="All" pageNum="12">
      <stl:a target="_blank"></stl:a><br />
    </stl:pageContents>
    <br />
    <stl:pageItems>
      <table cellpadding="0" cellspacing="0" width="90%" height="40" align="center">
        <tr>
          <td align="left">
            <stl:pageItem type="FirstPage" text="首页"></stl:pageItem> |
            <stl:pageItem type="PreviousPage" text="上一页"></stl:pageItem> |
            <stl:pageItem type="NextPage" text="下一页"></stl:pageItem> |
            <stl:pageItem type="LastPage" text="末页"></stl:pageItem>
          </td>
          <td align="right">
            <stl:pageItem type="CurrentPageIndex" text="当前页："></stl:pageItem>
            <stl:pageItem type="PageNavigation"></stl:pageItem>
          </td>
        </tr>
      </table>
    </stl:pageItems>
  </stl:yes>
  <stl:no>
    <div class="alert alert-danger" role="alert">
      <strong>抱歉!</strong> 找不到和您的查询相符的项目
    </div>
  </stl:no>
</stl:search>
Last Updated: 5/22/2020, 12:24:32 PM