channel 获取栏目列表标签-CMS内容管理系统

### 基础用法

名称：channel
功能：非常常用标记，可以循环嵌套标签。通常用于网站导航以获取站点栏目信息，方便网站会员分类浏览整站信息

### 语法：

{fly:channel type='top' row='8' currentstyle='active'}
    <li class="{$field.currentstyle}"><a href='{$field.typeurl}'>{$field.typename}</a> </li>
    {/fly:channel}

### 参数：

typeid='' 栏目ID
row='10' 返回文档列表总数（建议不要与limit属性同时存在，否则row无效）
limit='起始ID,记录数' （起始ID从0开始）表示限定的记录范围（如：limit='1,2' 表示从ID为1的记录开始，取2条记录）
titlelen='30' 栏目名称长度
type='son' 表示下级栏目
type='self' 表示同级栏目
type='top' 表示顶级栏目
type='sonself' 表示当前下级栏目以及同级栏目
type='first' 表示当前栏目ID的最顶级栏目下的第一级全部栏目
currentstyle='' 应用样式class类名
offset=‘0’ 记录的起始ID，默认从0开始，假如指定2，将过滤最前面的2条，从第三条显示
name='' 数组类型的变量名（三级导航时才用到）
empty='' 没有数据时显示的文案
mod='' 每隔N行输出的内容
id='' 可以任意指定循环里的变量名替代field，假设id='field1'，模板调用如：{$field.title} 变成 {$field1.title}

### 底层字段：

请查阅07FLY-CMS官方提供的数据字典，找到表名 fly_arctype
（注：在没有指定typeid的情况下，type标记与模板的环境有关，如：模板生成到栏目一，那么type='son'就表示栏目一的所有子栏目）

### 效果展示

1，调用顶级栏目导航
模板调用代码

{fly:channel type="top" row="8" id="field" currentstyle="on"}
    <li> <a class="{$field.currentstyle}" href="{$field.typeurl}">{$field.typename}</a> </li>
    {/fly:channel}

网站前端显示效果（css样式请自行填充）
 ![图片alt](/upload/picture/20210616/ca1c65bb7e0012a92af74e9906a258d2.png ''图片title'')

2.当前栏目下子栏目调用
模板调用代码

{fly:channel row="6" type ='son' currentstyle="on"}
    <li class="{$field.currentstyle}"><a href="{$field.typeurl}" >{$field.typename}</a> </li>
    {/fly:channel}

网站前端显示效果（css样式请自行填充）
![图片alt](/upload/picture/20210616/ca1c65bb7e0012a92af74e9906a258d2.png ''图片title'')

------------

###  更多示例

-------------------------------示例1--------------------------------

描述：输出最顶级栏目，不包括子孙栏目，可用于网站简单的顶部导航

{fly:channel type="top" row="10" currentstyle="active"}
    <a href="{$field.typeurl}" title="{$field.typename}" class="{$field.currentstyle}">
    {$field.typename}
    </a>
    {/fly:channel}

-------------------------------示例2--------------------------------

描述：输出二个层级栏目（这里用到channel标签层次嵌套，注意属性id | name的用法）

{fly:channel type='top' row='10' id='field1' currentstyle='active'} // 第一级栏目循环开始
    <li>
    <a href="{$field1.typeurl}" title="{$field1.typename}" class="{$field1.currentstyle}">
    {$field1.typename}
    {fly:notempty name='$field1.children'} // 判断是否有子栏目（该示例指的是第二级栏目）
    有子栏目时才显示这里的html代码，比如：箭头、图标等
    {/fly:notempty}
    </a>
    {fly:notempty name='$field1.children'} // 判断是否有子栏目（该示例指的是第二级栏目）
    <div>
    {fly:channel name='$field1.children' id='field2' row='10'} // 第二级栏目循环开始
    <a href="{$field2.typeurl}" class="dropdown-item ">{$field2.typename}</a>
    {/fly:channel} // 第二级栏目循环结束
    </div>
    {/fly:notempty}
    </li>
    {/fly:channel} // 第一级栏目循环结束
网站前端显示效果（css样式请自行填充）
![图片alt](/upload/picture/20210616/5bf10833303da15ee03bfc814eab2a79.png ''图片title'')

-------------------------------示例3--------------------------------

描述：输出复杂的三个层级栏目（这里用到channel标签层次嵌套，注意属性id | name的用法）

{fly:channel type='top' row='10' id='field1' currentstyle='active'} // 第一级栏目循环开始
    <li>
    <a href="{$field1.typeurl}" title="{$field1.typename}" class="{$field1.currentstyle}">
    {$field1.typename}
    {fly:notempty name='$field1.children'}
    有子栏目时才显示这里的html代码，比如：箭头、图标等
    {/fly:notempty}
    </a>
    {fly:notempty name='$field1.children'} // 判断是否有子栏目（第二级栏目）start
    <div>
    {fly:channel name='$field1.children' id='field2' row='10'} //第二级栏目循环开始
    <div>
    <a href="{$field2.typeurl}" class="dropdown-item ">{$field2.typename}</a>
    {fly:notempty name='$field2.children'} // 判断是否有子栏目（第三级栏目）start
    <div class="dropdown-menu animate">
    {fly:channel name='$field2.children' id='field3' row='10'} //第三级栏目循环开始
    <a href="{$field3.typeurl}" class="dropdown-item ">{$field3.typename}</a>
    {/fly:channel} //第三级栏目循环结束
    </div>
    {/fly:notempty} // 判断是否有子栏目（第三级栏目）end
    </div>
    {/fly:channel} // 第二级栏目循环结束
    </div>
    {/fly:notempty} // 判断是否有子栏目（第二级栏目）end
    </li>
    {/fly:channel} //第一级栏目循环结束

-------------------------------示例4--------------------------------

描述：每隔3条输出文档记录

{fly:channel typeid='文档ID' row='10' mod='3'}
    {fly:eq name='mod' value='0'}
    <a href='{$field.typeurl}'>{$field.typename}</a>
    {/fly:eq}
    {/fly:channel}

-------------------------------示例5--------------------------------

描述：mod属性还用于控制一定记录的换行，每3条记录换行一次

{fly:channel typeid='文档ID' row='10' mod='3'}
    <a href='{$field.typeurl}'>{$field.typename}</a>
    {fly:eq name='mod' value='0'}
    <br/>
    {/fly:eq}
    {/fly:channel}

-------------------------------示例6--------------------------------

描述：输出指定起始ID的记录，过滤最前面2条，从第三条开始输出

{fly:channel typeid='栏目ID' type='son' offset='2'}
    <a href='{$field.typeurl}'>{$field.typename}</a>
    {/fly:channel}
    
-------------------------------示例7--------------------------------
描述：内置变量输出数据索引与记录顺序，key 表示索引，默认从0开始；i 表示顺序，默认从1开始。

{fly:channel type='top'}
    {$key} - {$i}
    {/fly:channel}

> 效果：
0 - 1
1 - 2
2 - 3
3 - 4
4 - 5

-------------------------------示例8--------------------------------

描述：自定义变量名

{fly:channel type='top' id='field2'}
    <a href='{$field2.typeurl}'>{$field2.typename}</a>
    {/fly:channel}