说明:用于获取面包屑导航列表
使用方法:{% breadcrumb 变量名称 with index="首页" title=true %} 如将变量定义为 crumbs {% breadcrumb crumbs with index="首页" title=true %}...{% endbreadcrumb %}。
breadcrumb 支持 3 个参数:
- 是否显示标题
titletitle参数可以设置文档详情面包屑是否显示文档标题。如果设置了title=false则不显示标题,title=true时,则显示完整的文档标题,如果设置了 title 为其他具体值时,按设置的值显示,如title="文章详情"则显示“文章详情”,默认值为title=true。 - 首页名称
indexindex参数可以设置首页显示名称,默认值为 首页,如需改成其他可以设置,如index="我的博客"。 - 站点 ID
siteIdsiteId一般不需要填写,如果你使用后台的多站点管理创建了多个站点,并且想调用其他站点的数据,则可以通过指定siteId来实现调用指定站点的数据。
crumbs 是一个数组对象,因此需要使用 for 循环来输出
item 为 for 循环体内的变量,可用的字段有:
- 链接名称
Name - 链接地址
Link
代码示例
{# 默认用法 #}
<div>
{% breadcrumb crumbs %}
<ul>
{% for item in crumbs %}
<li><a href="{{item.Link}}">{{item.Name}}</a></li>
{% endfor %}
</ul>
{% endbreadcrumb %}
</div>
{# 自定义index,不显示标题 #}
<div>
{% breadcrumb crumbs with index="我的博客" title=false %}
<ul>
{% for item in crumbs %}
<li><a href="{{item.Link}}">{{item.Name}}</a></li>
{% endfor %}
</ul>
{% endbreadcrumb %}
</div>