tag 留言内容列表

更新时间：2020-05-26 14:58:27 作者：米拓建站

## 概述：

当tag标签的action参数值为`message.list`时，可循环调用留言模块内容在留言栏目页面展示。

【注意】留言模块内容可参考“[留言系统](https://doc.metinfo.cn/metinfo/messages/ "留言系统")”进行设置，每个站点同一种语言只能添一个留言系统栏目 。

## 使用范围：
仅在模板文件`message_index.php`中调用。

## 类型：
数据标签，用于调用数据的标签。

## 语法：
    <tag action="message.list" cid=""num="">
        <a href="{$v.url}" name="{$v.name}" title="链接关键词">{$v._name}</a>
    </tag>

【说明】
- tag标签中对应的参数及选项值可参考下面的`参数说明`；
- tag标签中的数据内容，可通过$v数组及对应的字段获取，具体可参考下方的`$v数组`。

## 标签原理：

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

<tag action="message.list" cid="" num="">
        <a href="{$v.url}" name="{$v.name}" title="链接关键词">{$v._name}</a>//通过$v数组调用内容数据
    </tag>

**for函数：**

for(i=0;i<list.length;i++){
    document.write('<a href="'+list[i]['url]+'" name="'+list[i]['name]+'" title="链接关键词">'+list[i]['_name]+'</a>'
    );
    }
	
总结：tag标签是后台返回数据的集合，类似于数组，在传入指定参数后会返回内容数据，在内部编写html代码，并使用$v变量来获取每个内容的数据，这样我们就可以得到一段动态的包含内容的html代码了。

## 参数说明：

tag标签，可通过传入不同的参数值，来调用对应的内容，以下为留言模块内容列表（`message.list`）标签对应的参数选项值：

| 参数名  | 是否必填  | 默认值  | 参数值说明  |
| ------------ | ------------ | ------------ | ------------ |
| action  | 是  |  null | 指定调用的方法(message.list)  |
| num  |  是 | 默认为父级栏目或者系统设置的显示条数，此处应手动传入$c['met_message_list']——该变量的值可在可视化网站后台【[当前页设置](https://doc.metinfo.cn/metinfo/style/style577.html "当前页设置")】自定义设置【列表显示条数】  | 列表页每页大显示条数  |
| cid  | 否  | $data['classnow']（当前列表页栏目id）  | 列表页栏目id  |

## $v数组：

tag标签是一个数据的集合，当`action="message.list"`调用留言模块内容列表时，tag标签内部循环需指定$v数组为循环变量的别名，从而调用更多的内容数据。
	
### 调用语法：`{$v.字段名称}`
例如：

<tag action="message.list" num="$c['met_message_list']">
    <h4>{$v.name}</h4> //调用留言用户名。
    </tag>

### $v数组中包含的字段：
| 字段名称  | 含义  |
| ------------ | ------------ |
| id  | 信息ID  |
| name  | 留言用户名  |
| content  | 留言内容  |
| useinfo  | 管理员回复内容  |
| met_fd_content  | 系统默认回复内容  |
| addtime  | 留言时间  |
| sub  | 用于判断数组长度 |
| _index  | 当前内容的下标，从0开始  |
| _first  |  用于判断是否为第一个 |
| _last  | 用于判断是否为后一个  |

## 示例：
### 留言栏目如何调用留言内容列表和留言表单：
**场景案例：**留言栏目页面展示客户留言信息列表，显示留言用户名、留言时间、留言内容、管理员回复内容或系统默认回复内容，以及留言表单。
**模板代码：**

<tag action="message.form"></tag>// 获取留言模块表单，具体请参考留言表单标签文档
    <ul class="met-pager-ajax">// 列表的父元素必须加上类名met-pager-ajax，这是与列表分页按钮功能相关的
    <tag action="message.list" num="$c['met_message_list']" cid="$data['classnow']">// 内容列表标签，先获取留言内容列表
    //$v包含了每条内容的所有数据，相当于一个数组，可以通过{$v.字段名}的方式来渲染内容数据
        <li>
            <div class="media">
                <div class="media-left block pull-xs-left p-r-0">
                    <i class="icon wb-user-circle blue-grey-400"></i>
                </div>
                <div class="media-body block pull-xs-left">
                    <h4 class="media-heading font-weight-300 blue-grey-500">
                        <small class="pull-xs-right">{$v.addtime}</small>
                        {$v.name}
                    </h4>
                    <p class='m-b-0'>{$v.content}</p>
                    <div class="content well m-t-10 m-b-0"><if value="$v[useinfo]">{$v.useinfo}<else/>{$v.met_fd_content}</if></div>// 通过if标签判断$v[useinfo]是否有值，有则显示{$v.useinfo}，没有则显示{$v.met_fd_content}，if用法具体参考if标签文档
                </div>
            </div>
        </li>
    </list>
    </ul>
    // 列表分页代码：列表下面加上以下固定格式的代码，即可渲染pc端和手机端的分页按钮，实现列表翻页的功能
    // pc端分页按钮
    <div class='m-t-20 text-xs-center hidden-sm-down' m-type="nosysdata">
        <pager/>// 分页标签，参考pager 列表页分页标签文档
    </div>
    // 手机端分页按钮
    <div class="met-pager-ajax-link hidden-md-up" data-plugin="appear" data-animate="slide-bottom" data-repeat="false" m-type="nosysdata">
         <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>
    
【注意】
- 列表页必须添加分页，电脑端与手机端分页功能实现方式不同；
- 留言内容列表（`message.list`）可与留言表单（[message.form](https://doc.metinfo.cn/mb/mbtag/104.html "message.form")）结合一起显示；
- 实际编写时请去掉注释文字。

**前台页面输出HTML：**

<form method="POST" class="met-form" enctype="multipart/form-data" action="../message/index.php?action=add&lang=cn&id=42">
        ...//表单各参数对应的html，此处不列举，具体请参考页面实际代码
    </form>
    <ul class="met-pager-ajax">
        <li>
            <div class="media">
                <div class="media-left block pull-xs-left p-r-0">
                    <i class="icon wb-user-circle blue-grey-400"></i>
                </div>
                <div class="media-body block pull-xs-left">
                    <h4 class="media-heading font-weight-300 blue-grey-500">
                        <small class="pull-xs-right">2018-01-18</small>
                        李四
                    </h4>
                    <p class='m-b-0'>MetInfo可以免费使用吗？免费版和收费版有什么区别？</p>
                    <div class="content well m-t-10 m-b-0">免费使用 MetInfo 在未经授权前，请务必保留底部 Powered by MetInfo 字样版权及链接，后台版权及链接，否则我们将追究法律责任。 购买商业授权后可以使用官方开发的部分商业应用，如七牛云、商城模块等。</div>
                </div>
            </div>
    </li>
    <li>
            <div class="media">
                <div class="media-left block pull-xs-left p-r-0">
                    <i class="icon wb-user-circle blue-grey-400"></i>
                </div>
                <div class="media-body block pull-xs-left">
                    <h4 class="media-heading font-weight-300 blue-grey-500">
                        <small class="pull-xs-right">2018-01-18</small>
                        张三
                    </h4>
                    <p class='m-b-0'>如何购买6.0可视化编辑模板</p>
                    <div class="content well m-t-10 m-b-0">请登录我们的官网www.metinfo.cn选择你喜欢的模板，购买后你可以直接下载源代码或一键安装</div>
                </div>
            </div>
        </li>
        // 实际可能有多条，此处示例只列出2条内容
    </ul>
    <div class="m-t-20 text-xs-center hidden-sm-down" m-type="nosysdata">
        <div class="met_pager">
            <span class="PreSpan editable-click" met-id="17" met-table="language" met-field="value">上一页</span>
            <a href="../message/message.php?class1=3&pageset=1" class="Ahover" title="链接关键词">1</a>
            <a href="../message/index.php?class1=3&page=2&pageset=1" title="链接关键词">2</a>
            <a href="../message/index.php?class1=3&page=2&pageset=1" class="NextA" title="链接关键词">下一页</a>
            <span class="PageTextk">转至第</span>
            <input type="text" id="metPageT" data-pageurl="index.php?lang=cn&class1=3&page=|&pageset=1|2" value="1">
            <input type="button" id="metPageB" value="页">
        </div>
    </div>
    <div class="met-pager-ajax-link hidden-md-up" data-plugin="appear" data-animate="slide-bottom" data-repeat="false" m-type="nosysdata">
        <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>