标签手册

导航与标签云

更新于 2026-11-13 阅读 4 # 导航与标签云 导航与标签云,适合头部菜单和聚合页。 ## 导航菜单 `nav` 读取后台「导航管理」的菜单,自动附带… Markdown

导航与标签云

导航与标签云,适合头部菜单和聚合页。

导航菜单 nav

读取后台「导航管理」的菜单,自动附带二级子菜单与当前栏目标记;成对写法直接循环,默认变量为 $item。

调用格式

{pycms:nav type="head"}...{/pycms:nav}

参数

参数说明默认取值 / 备注
type位置headhead 顶部 / footer 页脚 / 后台自定义的导航类型
id循环变量名item改为 nav 后使用 $nav.title

可用字段

  • $item.id
  • $item.title
  • $item.href / url
  • $item.target_html
  • $item.currentstyle
  • $item.children

完整示例

{pycms:nav type="head" id="nav"}
    <a href="{$nav.href}"{$nav.target_html|raw} class="{$nav.currentstyle}">{$nav.title}</a>
    {if $nav.children}
        {pycms:volist name="$nav.children" id="child"}
            <a href="{$child.href}" class="{$child.currentstyle}">{$child.title}</a>
        {/pycms:volist}
    {/if}
{/pycms:nav}
也可使用单标签 {pycms:nav type="head" /} 直接输出内置导航 HTML;导航为空时自动回退到一级栏目。

标签云 tags

聚合文章 tags 字段生成标签云,按出现次数排序;成对写法直接循环,默认变量为 $item。

调用格式

{pycms:tags num="20"}...{/pycms:tags}

参数

参数说明默认取值 / 备注
num输出条数20最大 80
id循环变量名item改为 tag 后使用 $tag.title

可用字段

  • $item.title / name
  • $item.href / url
  • $item.count
  • $item.currentstyle

完整示例

<div class="tag-cloud">
    {pycms:tags num="20" id="tag"}
        <a href="{$tag.href}" class="{$tag.currentstyle}">{$tag.title}<small>{$tag.count}</small></a>
    {/pycms:tags}
</div>
也可使用单标签 {pycms:tags num="20" /} 输出内置标签列表;标签链接指向 /tag/{名称}。