tag 下载内容列表

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

## 概述：
当tag标签的action参数值为`download.list`时，可循环调用下载模块内容在当前栏目（下载模块）列表页展示。

【注意】
-下载模块的内容可参考“[内容管理](https://doc.metinfo.cn/metinfo/content/content_166_1.html "内容管理")”进行设置。
- 其他页面可通过[“指定栏目的内容列表list标签”](https://doc.metinfo.cn/mb/mbtag/65.html "“指定栏目的内容列表list标签”")调用下载模块的内容列表。

## 使用范围：
仅在模板文件`download.php`中调用，只能调取当前下载栏目的数据。
## 类型：
数据标签，用于调用数据的标签
## 语法：

<tag action="download.list" cid="" num="">
 <a href="{$v.url}" title="{$v.title}">{$v._title}</a>
 </tag>

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

## 标签原理：

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

**tag标签：**

<tag action="download.list" cid="" num="">
 <a href="{$v.url}" title="{$v.title}">{$v._title}</a>//通过$v数组调用内容数据
 </tag>

**for函数：**

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

## 参数说明：
tag标签，可通过传入不同的参数值，来调用对应的信息，以下为下载模块内容列表标签对应的参数选项值：

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

## $v数组：

tag标签是一个数据的集合，当action="download.list"调用下载模块内容列表时，tag标签内部循环需指定$v数组为循环变量的别名，从而调用更多的内容数据。

### 调用语法：
**{$v.字段名称}**

**例如：**

<tag action="download.list" num="$c['met_download_list']">
 <a href="{$v.url}" title="{$v.title}">{$v._title}</a> //调用内容名称及对应的内容详情页链接。
 </tag>

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

| 名称  | 含义  |
| ------------ | ------------ |
|  id | 内容ID  |
| title  | 内容标题  |
| _title  | 带自定义样式的内容标题  |
|class1|所属一级栏目ID|
|class2|所属二级栏目ID|
|class3|所属三级栏目ID|
|downloadurl|下载地址|
|filesize|文件大小，kb|
|para|下载参数，返回一个数组|
|keywords|关键词|
|description|简短描述|
|content|详细内容|
|com_ok|是否为推荐列表，1为推荐0为未推荐|
|top_ok|是否为置顶列表，1为置顶0为未置顶|
|updatetime|更新时间|
|addtime|发布时间|
|url|自定义详情页的链接地址（链接至）|
| sub  |  用于判断数组长度|
| _index  |  当前内容的下标，从0开始|
| _first  |  用于判断是否为第一个|
| _last  |  用于判断是否为后一个|

## 示例：
### 下载模块列表页如何调用内容列表：
**场景案例：**下载模块列表页，按栏目调用对应的内容列表，显示内容标题、详情页链接、下载链接。

**模板代码：**

<ul class="met-pager-ajax">// 信息列表用ul、li标签的格式，可根据自己需求修改;列表的父元素必须加上类名met-pager-ajax，这是与列表分页按钮功能相关的
 <tag action="download.list" num="$c['met_download_list']">// 信息列表标签
 // $v包含了每条信息的所有数据，相当于一个数组，可以通过{$v.字段名}的方式来渲染信息数据
 <li class="{$v.class}">
 <a href="{$v.url}" title="{$v.title}">{$v._title}</a>
 <a href="{$v.downloadurl}" title="{$v.title}">下载文件</a>
 </li>
 </tag>
 </ul>

【注意】
- 列表页必须添加分页标签 ，电脑端与手机端分页功能实现方式不同；
- 实际编写时请去掉注释文字。

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

<ul class="met-pager-ajax">
 <li>
 <a href="download/showdownload.php?id=3" title="产品使用说明书">产品使用说明书</a>
 <a href="https://www.metinfo.cn/upload/file/asdasd.zip" title="产品使用说明书">下载文件</a>
 </li>
 // 实际可能有多条，此处示例只列出一条信息，所以只有一个li标签
 </ul>
 
### 下载模块详情页如何调用下载参数：
**场景案例：**下载模块详情页调用该下载资料的参数。
**模板代码：**

<ul>// 下载参数列表用ul、li标签的格式，可根据自己需求修改
 <list data="$data['para']" name="$para">// $data['para']为当前页下载资料的参数，相当于一个数组，可通过<list></list>标签渲染，具体参考list标签文档
 <if value="$para[value]">// 通过<if></if>标签判断参数有值的情况才显示参数信息，if用法具体参考if标签文档
 <li>
 {$para.name}：{$para.value}// $para.name为参数名称，$para.value为参数值
 </li>
 </if>
 </list>
 </ul>

【注意】实际编写时请去掉注释文字。

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

<ul>
 <li>
 文件版本：V1.0
 </li>
 // 实际可能有多个参数，此处示例只列出一个参数，所以只有一个li标签
 </ul>

### 首页如何调用下载模块列表的详情参数：
**场景案例：**首页调用指定的下载模块栏目的内容列表，显示内容标题、下载参数。
调用指定栏目的内容列表，需先获取栏目id：可参考教程“[如何获取栏目ID？](https://doc.metinfo.cn/mb/faq/102.html "如何获取栏目ID？")”

**模板代码：**

<ul>// 信息列表用ul、li标签的格式，可根据自己需求修改
 <tag action="list" cid="72" para="true" >// 调用指定栏目的内容列表，para参数设置为true可调用内容列表的详情参数
 // 将获取到栏目id填入到cid参数中，cid参数的值可以是模板中自定义的变量（https://doc.metinfo.cn/mb/mb/28.html ），例如$lang[‘index_product_id’]
 // $v包含了每条信息的所有数据，相当于一个数组，可以通过{$v.字段名}的方式来渲染信息数据
 <li>
 <a href="{$v.url}" title="{$v.title}">{$v._title}</a>
 <list data="$v['para']" name='$para'>// $v['para']为该条信息的参数，相当于一个数组，可通过<list></list>标签渲染（如果不需要调用可不写），具体参考list标签文档
 <if value="$para['value']">// 通过<if></if>标签判断参数有值的情况才显示参数信息，if用法具体参考if标签文档
 {$para.name}:{$para.value}// $para.name为参数名称，$para.value为参数值
 </if>
 </list>
 </li>
 </tag>
 </ul>

【注意】实际编写时请去掉注释文字。

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

<ul>
 <li>
 <a href="download/showdownload.php?id=3" title="产品使用说明书">产品使用说明书</a>
 文件版本：V1.0// 实际可能有多条，此处示例只列出一条参数
 </li>
 // 实际可能有多条，此处示例只列出一条信息，所以只有一个li标签
 </ul>