导航菜单列表标签使用指南
适用场景与核心功能
适用范围:该标签可在全站的任意位置灵活应用,为构建导航菜单提供便利。
标签功能:其主要作用在于调用导航菜单的栏目列表,与后台的 “基础内容> 内容栏目” 模块紧密关联。通过该标签,能够精准地获取并展示所需的导航菜单信息。
基本标签结构:
{pboot:nav}
<a href="[nav:link]">[nav:name]</a>
{/pboot:nav}
参数设置与控制
num 参数:此参数用于指定输出的导航菜单栏目数量,为非必填项。例如,设置num=8,系统将仅输出 8 个栏目,方便用户根据实际需求灵活控制展示数量。
parent 参数:该参数代表父菜单编码,可用于输出子栏目。默认状态下,从一级菜单开始输出。自 V3.1.2 版本及以上,支持同时传递多个编码。
parent={sort:pcode}:利用此设置可输出当前栏目的同级菜单,方便用户快速定位相关栏目。
parent={sort:scode}:能够输出当前栏目的子菜单,使导航结构更加清晰。
parent={sort:tcode}:用于输出当前栏目顶级菜单的子菜单,满足复杂导航结构的需求。
scode 参数:从 V3.1.2 版本及以上开始可用,主要用于限定输出栏目的范围。如设置scode=4,5,6,系统将仅输出编码为 4、5、6 的栏目。需注意,parent参数侧重于输出子栏目,而scode参数主要用于控制输出范围,两者功能不同,应根据实际需求合理选择。
可用的列表标签详解
序号相关标签:
[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]:栏目关键字,有助于搜索引擎优化,提高页面的搜索曝光率。
[nav:description]:栏目描述,对栏目内容进行简要说明,方便用户快速了解栏目主旨。
[nav:soncount]:当前栏目下子栏目的数量,若无子栏目则显示为 0,帮助用户清晰了解栏目结构。
[nav:rows]:输出栏目下内容的数量(从 V1.3 及以上版本开始支持),便于用户掌握栏目内容的丰富程度。
[nav:def1]、[nav:def2]、[nav:def3]:栏目描述 1、栏目描述 2、栏目描述 3(从 V3.0.6 及以上版本开始支持),可用于补充更多个性化的栏目信息。
常见应用示例
高亮菜单设置:
{pboot:if('[nav:scode]'=='{sort:tcode}')}class="active"{/pboot:if}
{pboot:if(0=='{sort:scode}')}class="active"{/pboot:if}
使用判断语句实现高亮效果。例如:
针对首页的特殊用法:
通过上述设置,可使当前页面对应的导航菜单栏目呈现高亮状态,方便用户识别当前所在位置。
菜单嵌套应用:
{pboot:nav}
<a href= "[nav:link]">[nav:name]</a>
{pboot:2nav parent=[nav:scode]}
<a href= "[2nav:link]">[2nav:name]</a>
{/pboot:2nav}
{/pboot:nav}
{pboot:nav}
<a href= "[nav:link]">[nav:name]</a>
{pboot:2nav parent=[nav:scode]}
<a href= "[2nav:link]">[2nav:name]</a>
{pboot:3nav parent=[2nav:scode]}
<a href= "[3nav:link]">[3nav:name]</a>
{/pboot:3nav}
{/pboot:2nav}
{/pboot:nav}
二级嵌套:
三级嵌套:
若需要更多级别的菜单嵌套,可按照上述规律,通过数字依次对应层级进行设置。理论上,嵌套级数不受限制,可满足各种复杂导航结构的需求。