PbootCMS 导航菜单列表标签详解与应用场景

1. 功能概述

功能描述	适用范围	说明
导航菜单调取	全站任意地方	用于调取网站后台配置的导航菜单栏目列表，对应后台“基础内容 > 内容栏目”。

---

2. 基本语法与控制参数

基本语法

 

{pboot:nav} <a href="[nav:link]">[nav:name]</a> {/pboot:nav}

控制参数

参数名	说明	示例
num=*	控制输出的导航菜单数量（非必填）。	{pboot:nav num=5}
parent=*	指定父菜单编码，用于输出子栏目。	{pboot:nav parent={sort:pcode}}
scode=*	指定栏目范围，用于控制输出的栏目范围。	{pboot:nav scode=1,2,3}
parent={sort:pcode}	输出当前栏目的同级菜单。	{pboot:nav parent={sort:pcode}}
parent={sort:scode}	输出当前栏目的子菜单。	{pboot:nav parent={sort:scode}}
parent={sort:tcode}	输出当前栏目顶级菜单的子菜单。	{pboot:nav parent={sort:tcode}}

注意：parent 和 scode 的区别在于，parent 用于输出子栏目，而 scode 用于控制输出的栏目范围。

---

3. 可使用的列表标签

以下是导航菜单中可使用的字段标签及其说明：

标签名	字段说明	示例用途
[nav:n]	序号，从 0 开始	用于生成有序列表或样式编号。
[nav:i]	序号，从 1 开始	用于生成自然序号。
[nav:pcode]	父栏目编码	用于判断栏目层级关系。
[nav:scode]	当前栏目编码	用于高亮当前栏目或生成动态链接。
[nav:name]	栏目名称	显示栏目名称。
[nav:subname]	栏目副名称	显示栏目副标题，增强信息层次感。
[nav:link]	栏目链接	生成栏目链接地址。
[nav:type]	栏目类型	判断栏目类型（1 单页、2 列表）。
[nav:outlink]	后台设置的跳转链接	用于生成外部链接。
[nav:listtpl]	列表页模板	获取栏目对应的列表页模板路径。
[nav:contenttpl]	详情页模板	获取栏目对应的详情页模板路径。
[nav:ico]	栏目缩略图	展示栏目图标或缩略图。
[nav:pic]	栏目大图	展示栏目大图，适用于视觉化导航。
[nav:keywords]	栏目关键字	优化 SEO，定义栏目关键字。
[nav:description]	栏目描述	用于 SEO 描述，提升搜索引擎收录效果。
[nav:soncount]	子栏目数量	判断是否存在子栏目，无子栏目时为 0。
[nav:rows]	栏目下内容数量	显示栏目下的内容条数（V1.3+）。
[nav:def1] ~ [nav:def3]	栏目描述扩展字段	自定义补充信息，如栏目备注或特殊说明（V3.0.6+）。