tag 搜索结果列表

更新时间：2020-07-17 17:07:05 作者：米拓建站

## 概述：
当tag标签的action参数值为`search.list`时，可循环调用搜索结果列表在全站搜索模块页面展示，且搜索词默认高亮。

【注意】可参考“[搜索功能](https://doc.metinfo.cn/metinfo/lookup/lookup298.html "搜索功能")”设置“全站搜索”和“高级搜索”的搜索范围为“全部”。

## 使用范围：
仅在模板文件`search.php`中调用，调取包含搜索词的搜索结果列表数据。

## 类型：
数据标签，调用搜索结果内容列表的标签。

## 语法：

<tag action='search.list' num="$c['met_search_list']">
        <a href="{$v.url}" name="{$v.ctitle}">{$v.ctitle}</a>
    </tag>
	$c['met_search_list']为内容列表每页大显示条数，该变量的值可在可视化界面进入搜索模块栏目页面后，点击底部导航【当前页设置】中自定义设置【列表显示条数】
【说明】tag标签中的数据内容，可通过$v数组及对应的字段获取，具体可参考下方的“$v数组”。

## 标签原理：

tag标签是数据的集合，数据类型类似js的数组，通过action参数传入值不同来获取不同的数据，当`action`传参为`search.list`时，可获取含有搜索词的内容列表。
 tag标签的语法和js中的for函数类似，在tag标签的内部书写待渲染的html标签，$v为每个循环变量的别名，包含了每条内容的数据。
**tag标签：**

<tag action="search.list" num="$c['met_search_list']">
        <a href="{$v.url}" name="{$v.ctitle}">{$v.ctitle}</a>//通过$v数组调用内容数据
    </tag>

**for函数：**

for(i=0;i<list.length;i++){
    document.write('<a href="'+list[i][‘url]+'" name="'+list[i][‘ctitle’]+'">'+list[i][‘ctitle’]+'</a>'
    );
    }
	
总结：tag标签是后台返回数据的集合，类似于数组，在传入指定参数后会返回内容数据，在内部编写html代码，并使用$v变量来获取每个内容的数据，这样我们就可以得到一段动态的包含内容的html代码了。
## $v数组：
 tag标签是一个数据的集合，当`action="search.list"`调用搜索模块结果列表时，tag标签内部循环需指定$v数组为循环变量的别名，从而调用更多的内容数据。
### 调用语法：`{$v.字段名称}`
例如：

<tag action="search.list" num="$c['met_search_list']">
    <h4>{$v.ctitle}</h4> //调用搜索结果的标题。
    </tag>

### $v数组中包含的字段：

|  名称 | 含义  |
| ------------ | ------------ |
|title   |  带自定义样式的搜索结果标题 |
|ctitle   |  搜索结果标题 |
| content  |  包含搜索词的部分详情内容 |
| url  |  搜索结果内容列表URL |
| updatetime  |  搜索结果更新时间 |
| sub  |  用于判断数组长度|
| _index  |  当前内容的下标，从0开始|
| _first  |  用于判断是否为第一个|
| _last  |  用于判断是否为后一个|

## 示例：
### 搜索范围为全站时，如何显示搜索结果列表：
**场景案例：**当全站搜索和高级搜索的搜索范围为“全部”时，在`search.php`页面显示搜索结果列表：显示搜索结果标题、带自定义样式的标题、链接、部分详情内容。
**模板代码：**

<ul class="list-group list-group-full list-group-dividered met-pager-ajax">// 列表的父元素必须加上类名met-pager-ajax，这是与列表分页按钮功能相关的
    <tag action='search.list' num="$c['met_search_list']">// 调取搜索结果列表，请参考搜索结果列表标签文档
    //$v包含了每条内容的所有数据，相当于一个数组，可以通过{$v.字段名}的方式来渲染内容数据，具体请参考搜索结果列表标签文档
        <li class="list-group-item">
            <h4>
                <a href="{$v.url}" title='{$v.ctitle}' {$g.urlnew}>
                    <if value="$v['ctitle']">{$v.ctitle}<else/>{$v.title}</if>//通过if标签是否有纯搜索结果标题文字，有则显示搜索结果标题，没有则显示带自定义样式的搜索结果标题，if标签用法请参考if else elseif标签文档https://doc.metinfo.cn/mb/mbtag/85.html
                </a>
            </h4>
            <a class="search-result-link" href="{$v.url}" {$g.urlnew} title="链接关键词">{$v.url}</a>
            <if value="$v['content']">//通过if标签是否有搜索结果内容，有则显示搜索结果内容，if标签用法请参考if else elseif标签文档https://doc.metinfo.cn/mb/mbtag/85.html
            <p>{$v.content}</p>
            </if>
        </li>
    </tag>
    </ul>
    // PC端分页按钮
    <div class='m-t-20 text-xs-center hidden-sm-down' m-type="nosysdata">
        <pager />
    </div>
    // 手机端分页按钮
    <div class="met-pager-ajax-link hidden-md-up" m-type="nosysdata" data-plugin="appear" data-animate="slide-bottom" data-repeat="false">
        <button type="button" class="btn btn-primary btn-block btn-squared ladda-button" id="met-pager-btn" data-plugin="ladda" data-style="slide-left" data-url="" data-page="1">
            <i class="icon wb-chevron-down m-r-5" aria-hidden="true"></i>
        </button>
    </div>

【注意】
- 可搭配[高级搜索](https://doc.metinfo.cn/mb/mbtag/107.html "高级搜索")功能和[全站搜索](https://doc.metinfo.cn/mb/mbtag/105.html "全站搜索")功能使用；
- `if标签`可参考[if标签手册](https://doc.metinfo.cn/mb/mbtag/85.html "if标签手册")；
- 搜索结果列表页必须添加分页，电脑端与手机端分页功能实现方式不同；
- 实际编写时请去掉注释文字。

**前台页面输出HTML：**
当框搜索词为“产品”时，前台输出html如下：

<ul class="list-group list-group-full list-group-dividered met-pager-ajax">
        <li class="list-group-item">
            <h4>
                <a href="../xinwen/shownews.php?id=358" title="企业标志LOGO设计有哪些事项是需要忌讳和注意的" target="_self">企业标志LOGO设计有哪些事项是需要忌讳和注意的</a>
            </h4>
            <p>是传播是一个品牌的终极目的和核心需求。仔细想一下，你的品牌命名、广告语、<em style="font-style:normal;">产品</em>核心价值提取等等方面，辅助成了你的企业品牌形象，让你的品牌形象如何根深蒂...</p>
            <a class="search-result-link" href="../xinwen/shownews.php?id=358" target="_self" title="链接关键词">../xinwen/shownews.php?id=358</a>
    </li>
    // 实际情况可能有多条搜索结果，此处只列举一条
    </ul>
    <div class="m-t-20 text-xs-center hidden-sm-down" m-type="nosysdata">
        <div class="met_pager">
            <span class="PreSpan">上一页</span>
            <a href="../search/index.php?search=search&searchword=产品&stype=0&module=&lang=cn&page=1&search=search" class="Ahover" title="链接关键词">1</a>
            <a href="../search/index.php?search=search&searchword=产品&stype=0&module=&lang=cn&page=2&search=search" title="链接关键词">2</a>
            <a href="../search/index.php?search=search&searchword=产品&stype=0&module=&lang=cn&page=2&search=search" class="NextA" title="链接关键词">下一页</a>
            <span class="PageText">转至第</span>
            <input type="text" id="metPageT" data-pageurl="../search/index.php?lang=cn&search=search&searchword=产品&page=|&search=search|2" value="1">
            <input type="button" id="metPageB" value="页">
        </div>
    </div>
    <div class="met-pager-ajax-link hidden-md-up invisible" m-type="nosysdata" data-plugin="appear" data-animate="slide-bottom" data-repeat="false" style="">
        <button type="button" class="btn btn-primary btn-block btn-squared ladda-button" id="met-pager-btn" data-plugin="ladda" data-style="slide-left" data-url="" data-page="1">
            <i class="icon wb-chevron-down m-r-5" aria-hidden="true"></i>
        </button>
    </div>