说明:用于获取页面导航列表
使用方法: {% navList 变量名称 %}
如将变量定义为navs {% navList navs %}...{% endnavList %}
,也可以定义为其他变量名称,定义后,需要与下面的for循环使用的变量名称一致。
navList 支持的参数有
- 导航列表ID
typeId
typeId
为后台的导航类别ID,默认typeId=1
,如果后台设置了多个导航类别,可以通过typeId
来指定调用。 - 站点ID
siteId
siteId
一般不需要填写,如果你使用后台的多站点管理创建了多个站点,并且想调用其他站点的数据,则可以通过指定siteId
来实现调用指定站点的数据。
navList 需要使用使用 endnavList 标签表示结束,中间使用for循环输出内容。
navs 是一个数组对象,因此需要使用 for
循环来输出
item 为for循环体内的变量,可用的字段有:
- 导航标题
Title
- 子标题
SubTitle
- 导航描述
Description
- 导航链接
Link
- 对应分类ID
PageId
如果这个导航菜单是选择了分类的话,则存在 - 是否当前链接
IsCurrent
- 下级导航列表
NavList
下级导航内同样具有 item 相同的字段。
代码示例
{% navList navs %}
<ul>
{%- for item in navs %}
<li class="{% if item.IsCurrent %}active{% endif %}">
<a href="{{ item.Link }}">{{item.Title}}</a>
{%- if item.NavList %}
<dl>
{%- for inner in item.NavList %}
<dd class="{% if inner.IsCurrent %}active{% endif %}">
<a href="{{ inner.Link }}">{{inner.Title}}</a>
</dd>
{% endfor %}
</dl>
{% endif %}
</li>
{% endfor %}
</ul>
{% endnavList %}
常见使用实例
- 在导航上显示下拉分类,并且在分类下显示产品文档。如图:
调用代码示例,该调用需要在后台已经设置好二级导航的基础上(代码不包含css样式控制)
<ul>
{% navList navList with typeId=1 %}
{%- for item in navList %}
<li>
<a href="{{ item.Link }}">{{item.Title}}</a>
{%- if item.NavList %}
<ul class="nav-menu-child">
{%- for inner in item.NavList %}
<li>
<a href="{{ inner.Link }}">{{inner.Title}}</a>
{% archiveList products with type="list" categoryId=inner.PageId limit="8" %}
{% if products %}
<ul class="nav-menu-child-child">
{% for item in products %}
<li><a href="{{item.Link}}">{{item.Title}}</a></li>
{% endfor %}
</ul>
{% endif %}
{% endarchiveList %}
</li>
{% endfor %}
</ul>
{% endif %}
</li>
{% endfor %}
{% endnavList %}
</ul>
- 在导航上显示下拉分类,并且在分类下显示它的下级分类,如果没有则不显示。如图:
调用代码示例,该调用需要在后台已经设置好二级导航的基础上(代码不包含css样式控制)
<ul>
{% navList navList with typeId=1 %}
{%- for item in navList %}
<li>
<a href="{{ item.Link }}">{{item.Title}}</a>
{%- if item.NavList %}
<ul class="nav-menu-child">
{%- for inner in item.NavList %}
<li>
<a href="{{ inner.Link }}">{{inner.Title}}</a>
{% if inner.PageId > 0 %}
{% categoryList categories with parentId=inner.PageId %}
{% if categories %}
<ul>
{% for item in categories %}
<li>
<a href="{{ item.Link }}">{{item.Title}}</a>
</li>
{% endfor %}
</ul>
{% endif %}
{% endcategoryList %}
{% endif %}
</li>
{% endfor %}
</ul>
{% endif %}
</li>
{% endfor %}
{% endnavList %}
</ul>