dedecms channel标签如何正确调用？

channel 标签是 DedeCMS 中最核心、最常用的标签之一，用于获取并显示网站的所有栏目（包括顶级栏目和子栏目）。

channel 标签的基本语法

channel 标签的基本结构如下：

{dede:channel}
    <a href='[field:typeurl/]'>[field:typename/]</a>
{/dede:channel}

• {dede:channel}: 标签的开始,用于定义一个循环。
• [/dede:channel]: 标签的结束。
• [field:typeurl/]: 循环体内使用的字段,表示当前栏目的链接地址。
• [field:typename/]: 循环体内使用的字段,表示当前栏目的名称。

常用属性详解

channel 标签可以通过多种属性来精确控制输出的内容。

typeid (指定栏目ID)

这是最常用的属性,用于指定从哪个栏目开始调用。

• 不使用 typeid: 默认调用网站所有的一级栏目（顶级栏目）。
• 使用 typeid: 调用指定栏目及其所有下级栏目。

示例: 调用栏目ID为 2 的栏目及其所有子栏目。

{dede:channel typeid='2'}
    <a href='[field:typeurl/]'>[field:typename/]</a>
{/dede:channel}

type (栏目类型)

用于指定调用栏目的类型，通常与 reid (父栏目ID) 配合使用。

• son: 调用指定栏目 (typeid) 的直接子栏目。
• self: 调用指定栏目 (typeid) 本身。
• top: 调用所有顶级栏目（不包含子栏目）。
• grandson: 调用指定栏目 (typeid) 的所有下级栏目（包括子栏目和孙栏目）。

示例: 假设栏目ID为 2 的栏目下有子栏目 3 和 4。

• {dede:channel typeid='2' type='son'}: 只会调用栏目 3 和 4。
• {dede:channel typeid='2' type='grandson'}: 会调用栏目 3、4 以及 3 和 4 的所有子栏目。

row (调用条数)

限制输出的栏目数量。

示例: 只调用前 5 个顶级栏目。

{dede:channel row='5'}
    <a href='[field:typeurl/]'>[field:typename/]</a>
{/dede:channel}

currentstyle (当前栏目样式)

用于为当前所在页面对应的栏目链接添加一个特殊的样式（比如高亮）。

示例: 如果当前页面是这个栏目，链接会加上 class="active"。

{dede:channel currentstyle="<a href='~typelink~' class='active'>~typename~</a>"}
    <a href='[field:typeurl/]'>[field:typename/]</a>
{/dede:channel}

• ~typelink~: 会被替换为 [field:typeurl/]。
• ~typename~: 会被替换为 [field:typename/]。

常用字段 (Fields)

在 {dede:channel} 循环体内,可以使用以下字段来获取栏目的详细信息：

综合实例

实例1：调用网站所有顶级栏目（导航栏）

这是最常见的导航栏实现方式。

<div class="nav">
    <ul>
        {dede:channel}
            <li><a href="[field:typeurl/]">[field:typename/]</a></li>
        {/dede:channel}
    </ul>
</div>

实例2：调用指定栏目的直接子栏目（产品”栏目的分类）

假设“产品”栏目的ID是 2。

<div class="product-category">
    <h3>产品分类</h3>
    <ul>
        {dede:channel typeid='2' type='son'}
            <li><a href="[field:typeurl/]">[field:typename/]</a></li>
        {/dede:channel}
    </ul>
</div>

实例3：带当前栏目高亮的导航栏

这个例子非常实用,能自动高亮用户正在访问的栏目。

<div class="nav">
    <ul>
        {dede:channel
            type='top'
            currentstyle="<li class='active'><a href='~typelink~'>~typename~</a></li>"
        }
            <li><a href="[field:typeurl/]">[field:typename/]</a></li>
        {/dede:channel}
    </ul>
</div>

注意：这里使用了 type='top' 来确保只调用顶级栏目，避免在多级菜单下出现重复高亮。currentstyle 会自动替换掉循环体中对应的 <li>

实例4：调用顶级栏目及其子栏目（二级下拉菜单）

<div class="main-nav">
    <ul>
        {dede:channel type='top'}
            <li>
                <a href="[field:typeurl/]">[field:typename/]</a>
                {dede:channel type='son' typeid='[field:id]'}
                    <div class="sub-nav">
                        <a href="[field:typeurl/]">[field:typename/]</a>
                    </div>
                {/dede:channel}
            </li>
        {/dede:channel}
    </ul>
</div>