dede channel调用怎么写？参数用法有哪些？

{dede:channel} 标签主要用于获取网站栏目的列表信息，通常用于制作网站的导航栏、侧边栏的栏目列表、面包屑导航等。

基础语法

{dede:channel} 标签的基本语法如下：

{dede:channel}
    <a href="[field:typelink/]">[field:typename/]</a>
{/dede:channel}

• {dede:channel} 和 {/dede:channel} 是标签的开始和结束。
• [field:typelink/] 是一个字段，表示栏目的链接地址。
• [field:typename/] 是一个字段，表示栏目的名称。

最简单的应用示例（制作主导航）：

假设你的网站有几个顶级栏目,你想把它们显示在网站顶部，可以这样写：

<div class="main-nav">
    <ul>
        {dede:channel type='top'}
            <li><a href="[field:typelink/]" title="[field:typename/]">[field:typename/]</a></li>
        {/dede:channel}
    </ul>
</div>

核心属性详解

{dede:channel} 的强大之处在于它的各种属性，通过组合这些属性可以实现不同的调用效果。

type - 栏目类型（最常用）

• top: 调用顶级栏目，这是默认值，会获取所有没有被其他栏目包含的一级栏目。
• son: 调用当前栏目的子栏目，必须在使用此标签的页面中指定当前栏目ID（通过 typeid 属性），否则调用失败。
• self: 调用当前栏目及其所有子栏目，同样需要指定 typeid。
• sun: 调用指定栏目ID下的所有子栏目（多级）。

示例：

• 调用顶级栏目（主导航）

  {dede:channel type='top'}
      <a href="[field:typelink/]">[field:typename/]</a>
  {/dede:channel}

• 调用指定栏目ID为3的子栏目（产品分类的子分类）

  {dede:channel type='son' typeid='3'}
      <a href="[field:typelink/]">[field:typename/]</a>
  {/dede:channel}

typeid - 指定栏目ID

这个属性用于指定要操作的栏目,当 type 为 son 或 self 时，typeid 是必须的，你也可以用它来指定一个或多个顶级栏目（用逗号隔开），type 属性可以省略。

示例：

• 只调用栏目ID为2和5的栏目

  {dede:channel typeid='2,5'}
      <a href="[field:typelink/]">[field:typename/]</a>
  {/dede:channel}

row - 调用栏目数量

指定要调用的栏目数量,默认为调用所有符合条件的栏目。

示例：

• 只调用前5个顶级栏目

  {dede:channel type='top' row='5'}
      <a href="[field:typelink/]">[field:typename/]</a>
  {/dede:channel}

currentstyle - 当前栏目样式

这是一个非常实用的属性,用于高亮显示当前所在的栏目，当用户访问某个栏目页面时，这个栏目对应的链接会应用你指定的样式。

语法： currentstyle='<a href="[field:typelink/]" class="active">[field:typename/]</a>'

示例：

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

工作原理：

• 当访问首页时,{dede:channel} 会正常输出所有顶级栏目。
• 当你点击并进入“关于我们”栏目页面时，{dede:channel} 会自动检测到当前栏目是“关于我们”，然后输出 currentstyle 中定义的代码，即 <a href="..." class="active">关于我们</a>，而其他栏目则输出普通的 <a>

<div class="sidebar-category">
    <h3>产品分类</h3>
    <ul>
        {dede:channel type='son' typeid='4'}
        <li>
            <a href="[field:typelink/]">
                <img src="[field:litpic/]" alt="[field:typename/]" />
                <h4>[field:typename/]</h4>
                <p>[field:description function='cn_substr(@me, 50)'/]</p>
            </a>
        </li>
        {/dede:channel}
    </ul>
</div>

<div class="breadcrumb">
    <a href="/">首页</a>
    {dede:field name='position' runphp='yes'}
        // 这是一个更高级的用法，通过PHP代码来处理面包屑字符串
        // 将 > 替换为 /
        $aaa = str_replace(' >', ' / ', @me);
        @me = $aaa;
    {/dede:field}
</div>