tag 栏目

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

## 概述：
当tag标签的`action`参数值为`category`时，可调用米拓企业建站系统栏目管理中的栏目及栏目信息，且可通过套用tag标签，循环输出对应栏目及子栏目信息。

【注意】网站栏目信息可参考“[栏目管理](https://doc.metinfo.cn/metinfo/column/column70.html "栏目管理")”进行设置。。
## 使用范围：
可在所有模板页面中使用

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

## 语法：
 
	<tag action="category" type="" class="" hide="">
 <a href="{$m.url}" title="{$m.name}">{$m._name}</a>
 </tag>
【说明】
- tag标签中对应的参数及选项值可参考下面的“参数说明”；
- tag标签中的数据内容，可通过$m数组及对应的字段获取，具体可参考下方的`$m数组`。

## 标签原理：

tag标签是数据的集合，数据类型类似js的数组，通过action参数传入值不同来获取不同的数据，当action传参为`category`时，便可获得栏目数据。
   tag标签的语法和js中的for函数类似，在tag标签的内部书写待渲染的html标签，$m为每个循环变量的别名，包含了每个栏目的数据。
	
**tag标签：**

<tag action="category" type="" class="" hide="">
 <a href="{$m.url}" title="{$m.name}">{$m._name}</a>//通过$m数组调用栏目信息
 </tag>

**for函数：**

for(i=0;i<list.length;i++){
 document.write(
 '<a href="'+list[i]['url']+'" title="'+list[i]['name']+'">'+list[i]['_name']+'</a>'
 );
 }

总结：tag标签是后台返回数据的集合，类似于数组，在传入指定参数后会返回栏目数据，在内部编写html代码，并使用$m变量来获取每个栏目的数据，这样我们就可以得到一个动态的包含栏目信息的html页面了。

## 参数说明

|参数名|是否必填|默认值|参数值说明|
|:----    |:-------    |:---|:---|
|action|是 |null|指定为category获取栏目信息
|type|否 |head|栏目可选调用类型：`head`:获取头部导航栏目；`foot`：获取底部导航栏目；`son`：获取子栏目数据；`current`：获取cid传入的栏目数据。
|cid|当 type 为 `son` 或者 `current` 时必须设置该参数 |0|指定调用[栏目的ID](https://doc.metinfo.cn/mb/faq/102.html "栏目的ID")
|class|否|空|列表输出的栏目id等于当前页面栏目id时该栏目要添加的高亮样式类名
|hide|否|空|用于隐藏不需要显示的子栏目的名称，多个栏目名称以丨分割，填写格式为：xxx丨xxx

## $m数组

tag标签是一个数据的集合，当`action="category"`调用栏目信息时，tag标签内部循环需指定$m数组为循环变量的别名，从而调用更多的栏目数据。
**调用语法：**
{$m.字段名称}
例如：

<tag action="category" type="" class="" hide="">
 <a href="{$m.url}" title="{$m.name}">{$m._name}</a> //调用栏目名称及对应的栏目链接。
 </tag>
### $m数组中包含的字段：

|  字段名称 |  含义 |
| ------------ | ------------ |
| id  |  栏目ID |
| name  | 栏目名称  |
| _name  | 带栏目自定义样式的栏目名称  |
| namemark  |  栏目名称修饰名称 |
| url  | 栏目链接地址  |
| bigclass  |  上级栏目id |
| urlnew  |  是否新窗口打开栏目链接 |
| nofollow  |  是否向栏目链接网址传递权重（0为传递，1为不传递，默认传递） |
| module  | 栏目所属模块标识 |
| classtype  | 栏目级别，存在三种级别，分别为1、2、3  |
| ctitle  | 栏目页面标题 |
| keywords  |  简短关键字 |
| description  |  简短描述文字 |
| content  | 栏目内容，简介模块才有内容。 |
| index_num  | 栏目标识（栏目风格） |
| indeximg  |  栏目标识图片路径 |
| columnimg  |  栏目图片路径 |
| icon  | 栏目图标  |
| other_info  |  栏目其他信息 |
| custom_info  |  自定义栏目信息 |
| new_windows  |  该栏目链接的打开方式，值为1时代表新窗口打开，为0时代表当前窗口打开，默认其当前窗口打开 |
| target  |  该栏目链接的打开方式的属性字符串，new_windows值为1时target值为target="_blank"，new_windows值为0时target值为空 |
| sub  |  用于判断是否存在下级，存在为1，不存在为0 |
| _index  |  索引，从0开始|
| _first  |  用于判断是否为第一个|
| _last  |  用户判断是否为后一个|
【注意】栏目标签可嵌套使用，则$m的取值为当前tag标签调用的栏目内容。

## 示例：
### 如何调用头部导航栏目：
头部导航栏目即在网站后台→栏目管理中设置在头部主导航栏显示或都的栏目，如下图，具体可参考“[导航栏显示](https://doc.metinfo.cn/metinfo/column/column78.html "导航栏显示")”设置。
![](../upload/202003/1585215759651638.png)

**场景案例：**例如在网站后台设置了三个在头部导航栏目：关于我们、产品展示、新闻动态，在新闻动态页面不想显示“关于我们”栏目。

**模板代码：**

<ul>// 栏目列表用ul、li标签的格式，可根据自己需求修改
 <tag action="category" type="head" class="active" hide="关于我们">// 栏目标签，type参数值为head，调用头部导航栏目
 // $m包含了每个栏目的所有数据，相当于一个数组，可以通过{$m.字段名}的方式来渲染栏目数据
 <if value="!$m['hide']">// 判断$m['hide']为0时隐藏该栏目，请参考if标签文档，value参数里的变量调用字段数据要用['']包含变量名，如：$m['hide']，不能是{$m.hide}
 <li class="{$m.class}">
 <a href="{$m.url}" title="{$m.name}">{$m._name}</a>
 </li>
 </if>
 </tag>
 </ul>
【注意】实际编写时请去掉注释文字。
**前台页面输出HTML：**

### 如何调用底部导航栏目：
底部导航栏目即在网站后台→栏目管理中设置在底部部导航栏显示或都显示的栏目，如下图，具体可参考“[导航栏显示](https://doc.metinfo.cn/metinfo/column/column78.html "导航栏显示")”设置。
![](../upload/202003/1585215949420877.png)

**场景案例：**如果设置了三个栏目显示在底部导航：关于我们、产品展示、新闻动态，但前台页面不想显示“关于我们”栏目。

**模板代码：**

<ul>// 栏目列表用ul、li标签的格式，可根据自己需求修改
 <tag action="category" type="foot" hide="关于我们">// 调用栏目标签
 // $m包含了每个栏目的所有数据，相当于一个数组，可以通过{$m.字段名}的方式来渲染栏目数据
 <if value="!$m['hide']">// 判断$m['hide']为0时隐藏该栏目，请参考if标签文档，value参数里的变量调用字段数据要用['']包含变量名，如：$m['hide']，不能是{$m.hide}
 <li>
 <a href="{$m.url}" title="{$m.name}">{$m._name}</a>
 </li>
 </if>
 </tag>
 </ul>
 // hide参数传的名称包含某些底部导航栏目名称，则这些栏目名称就不会显示，在头部导航（需要标签<if value="!$m['hide']">配合）
【注意】实际编写时请去掉注释文字。

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

<ul>
 <li>
 <a href="../product/" title="产品展示">产品展示</a>
 </li>
 <li>
 <a href="../news/" title="新闻动态">新闻动态</a>
 </li>
 </ul>
 
### 如何调用指定栏目的信息：
例如：调用产品展示栏目的信息（栏目名称、栏目链接等）
调用指定栏目的信息，需先获取栏目id：可参考教程“[如何获取栏目ID？](https://doc.metinfo.cn/mb/faq/102.html "如何获取栏目ID？")”

**模板代码：**

<tag action="category" type="current" cid="4">// 调用栏目标签，type参数值为current
 // 将上一步获取到栏目id填入到cid参数中，cid参数的值可以是模板中自定义的变量，例如$lang['index_product_id']
 // $m包含了该栏目的所有数据，相当于一个数组，可以通过{$m.字段名}的方式来渲染栏目数据
 <a href="{$m.url}" title="{$m.name}">{$m._name}</a>
 </tag>
【注意】实际编写时请去掉注释文字。

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

<a href="product/" title="产品展示">产品展示</a>
	
### 如何调用二级栏目：
**模板代码：**
例如：调用产品展示栏目的二级栏目，产品展示栏目id为4

<ul>// 栏目列表用ul、li标签的格式，可根据自己需求修改
 <tag action="category" type="son" cid="4">// 调用栏目标签，cid参数的值可以是模板中自定义的变量（https://doc.metinfo.cn/mb/mb/28.html ），例如$lang['index_product_id']
 // $m包含了每个二级栏目的所有数据，相当于一个数组，可以通过{$m.字段名}的方式来渲染栏目数据
 <li>
 <a href="{$m.url}" title="{$m.name}">{$m._name}</a>
 </li>
 </tag>
 </ul>
【注意】实际编写时请去掉注释文字。

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

<ul>
 <li>
 <a href="../product/product.php?class2=5" title="电脑&平板">电脑&平板</a>
 </li>
 <li>
 <a href="../product/product.php?class2=6" title="手机">手机</a>
 </li>
 <li>
 <a href="../product/product.php?class2=7" title="通用配件">通用配件</a>
 </li>
 </ul>
	
### 如何调用三级栏目：
调用三级栏目就是在调用二级栏目的子栏目，所以需要在调用二级栏目的栏目标签中继续嵌套调用栏目标签。
**模板代码：**
例如：调用产品展示栏目的三级栏目，产品展示栏目id为4

<ul>// 栏目列表用ul、li标签的格式，可根据自己需求修改
 <tag action="category" type="son" cid="4">// 调用栏目标签，cid参数的值可以是模板中自定义的变量，例如$lang['index_product_id']
 // $m包含了每个二级栏目的所有数据，相当于一个数组，可以通过{$m.字段名}的方式来渲染栏目数据
 <li>
 <a href="{$m.url}" title="{$m.name}">{$m._name}</a>
 </li>
 <tag action="category" type="son" cid=”$m[‘id’]”>// 调用三级栏目标签，cid参数的值可以是一个模板变量，此处$m[‘id’]为二级栏目的id
 // 栏目标签中间渲染了每个三级栏目的数据变量$m，$m相当于一个数组，包含了这个栏目的所有数据，可以通过{$m.字段名}的方式来渲染栏目数据
 	<li style=”padding-left:20px;”>//给三级栏目的li标签加上内边距样式便于区分二三级栏目
 	<a href="{$m.url}" title="{$m.name}">{$m._name}</a>
 </li>
 </tag>
 </tag>
 </ul>
 // 调用三级栏目要在二级栏目渲染之后，三级栏目标签之后不能再继续渲染二级栏目数据，以下使用是错误的
 <ul>
 <tag action="category" type="son" cid="4">
 <li>
 <a href="{$m.url}" title="{$m.name}">{$m._name}</a>
 </li>
 {$m.keyword}// 此处渲染的是二级栏目数据
 <tag action="category" type="son" cid="$m['id']">
 	<li style=”padding-left:20px;”>
 	<a href="{$m.url}" title="{$m.name}">{$m._name}</a>
 </li>
 </tag>
 {$m.keywords}// 此处渲染的不是二级栏目数据了，是三级栏目的数据
 </tag>
 </ul>
【注意】实际编写时请去掉注释文字。

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

<ul>
 <li>
 <a href="../product/product.php?class2=5" title="电脑&平板">电脑&平板</a>
 </li>
 <li style=”padding-left:20px;”>// 示例只列出一个三级栏目，实际可能有多个三级栏目
 <a href="../product/product.php?class3=10" title="笔记本电脑">笔记本电脑</a>
 </li>
 <li>
 <a href="../product/product.php?class2=6" title="手机">手机</a>
 </li>
 <li style=”padding-left:20px;”>// 示例只列出一个三级栏目，实际可能有多个三级栏目
 <a href="../product/product.php?class3=11" title="智能手机">智能手机</a>
 </li>
 <li>
 <a href="../product/product.php?class2=7" title="通用配件">通用配件</a>
 </li>
 <li style=”padding-left:20px;”>// 示例只列出一个三级栏目，实际可能有多个三级栏目
 <a href="../product/product.php?class3=12" title="耳机">耳机</a>
 </li>
 </ul>
 
### 如何通过设置指定栏目的栏目风格，来实现渲染该栏目的特殊内容样式：
**场景：**例如首页某个区块调用的是产品模块的子栏目及对应的信息列表，所有栏目风格是一致的，如果需要实现其中一个子栏目展示不同的风格，则可通过栏目标识来实现。
**1.获取父级栏目id：**可参考教程“[如何获取栏目ID？](https://doc.metinfo.cn/mb/faq/102.html "如何获取栏目ID？")”
**2.设置第一个子栏目的栏目风格和栏目图片**
编辑父级栏目的第一个子栏目的信息，将【栏目风格】修改为你想要的数值，此处以3 为例，然后在【栏目图片】处上传一张图片，修改后保存。
![](../upload/202003/1585216591426946.png)
![](../upload/202003/1585216616230033.png)
![](../upload/202003/1585216642393605.png)

**模板代码：**

<ul>// 栏目列表用ul、li标签的格式，可根据自己需求修改
 <tag action="category" type="son" cid=”4”>// 调用栏目标签，调用指定栏目的子栏目列表，type参数值为son
 // 将第一步获取到的栏目id填入到cid参数中，cid参数的值可以是模板中自定义的变量，例如$lang[‘index_product_id’]
 // $m包含了当前子栏目的所有数据，相当于一个数组，可以通过{$m.字段名}的方式来渲染栏目数据
 <li>
 <if value="$m['index_num'] eq 3">// 判断当前子栏目的栏目风格是否为3，是的话就执行if标签包含的代码，$m['index_num']为该栏目的栏目风格，3为第二步设置的栏目风格值
 <img src="{$m.columnimg}" alt="图片关键词" title="图片关键词">// {$m.columnimg}为第二步设置的栏目图片
 </if>
 <a href="{$m.url}" title="{$m.name}">{$m._name}</a>
 </li>
 </tag>
 </ul>
	
【注意】实际编写时请去掉注释文字。

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

<ul>
 <li>
 <img src="../upload/202003/1580793044.jpg" alt="图片关键词" title="图片关键词">
 <a href="../product/product.php?class2=5" title="电脑&平板">电脑&平板</a>
 </li>
 <li>
 <a href="../product/product.php?class2=6" title="手机">手机</a>
 </li>
 <li>
 <a href="../product/product.php?class2=7" title="通用配件">通用配件</a>
 </li>
 </ul>
	
### 如何调用栏目下的内容列表：
需要栏目标签和内容列表标签结合来实现此功能，具体可参考[tag指定内容列表](https://doc.metinfo.cn/mb/mbtag/65.html "tag指定内容列表")