在网站运营中，清晰的导航是提升用户体验的关键。当访问者深入网站内部页面时，一个设计良好、易于理解的面包屑导航（Breadcrumb Navigation）能有效帮助他们了解当前所处的位置，并提供快速返回上级页面的途径。这不仅让网站结构一目了然，也有助于搜索引擎更好地理解网站层级，间接优化SEO。

安企CMS（AnQiCMS）深知导航的重要性，内置了非常实用的面包屑导航功能。它让创建和显示面包屑变得简单直观，无需复杂的二次开发。

认识AnQiCMS中的面包屑导航功能

AnQiCMS 提供了专门的模板标签来生成面包屑导航。这意味着，你只需要在模板文件中简单调用一个标签，系统就会根据当前页面的URL路径和内容层级，自动生成一条完整的导航路径。这条路径通常以“首页”开始，逐步列出所有上级分类或页面，最终指向当前页面。

如何在模板中创建和显示面包屑导航

要在AnQiCMS中显示面包屑导航，我们主要会用到一个名为 breadcrumb 的模板标签。

通常，你会将这段代码放置在网站的公共头部（例如 partial/header.html 或 bash.html）或者你想显示面包屑的任何特定页面模板中。这样，它就能在所有需要显示面包屑的页面上统一展示。

核心标签使用方法

最基本的用法是这样的：

{% breadcrumb crumbs %}
    <nav class="breadcrumb-nav">
        <ul>
            {% for item in crumbs %}
                <li>
                    {% if not forloop.Last %}
                        <a href="{{ item.Link }}">{{ item.Name }}</a>
                        <span class="separator">/</span>
                    {% else %}
                        <span>{{ item.Name }}</span>
                    {% endif %}
                </li>
            {% endfor %}
        </ul>
    </nav>
{% endbreadcrumb %}

在这段代码中：

  • {% breadcrumb crumbs %} 是调用面包屑功能的标签，它会把生成的导航路径数据存储在 crumbs 这个变量里。
  • crumbs 是一个包含多个导航项的数组，每个导航项都代表路径中的一个环节。
  • {% for item in crumbs %} 循环遍历 crumbs 数组中的每一个导航项。
  • item.Link 获取当前导航项的链接地址。
  • item.Name 获取当前导航项的显示名称。
  • forloop.Last 是一个内置的循环变量，用于判断当前循环是否是最后一个元素。这对于处理分隔符（例如 / 或 >）非常有用，通常我们不希望在最后一个导航项后面显示分隔符。
  • separator 是我们自定义的一个类，你可以用CSS来美化这个分隔符的样式。

定制化参数详解

breadcrumb 标签还提供了一些参数，让你能够根据需求进行更灵活的设置：

  • index：用于自定义面包屑导航中“首页”的显示文本。

    • 默认值是 "首页"。
    • 如果你希望显示为其他文本，比如 "我的博客"，可以这样设置：{% breadcrumb crumbs with index="我的博客" %}。

  • title：控制是否在面包屑的最后显示当前页面的标题，或者自定义当前页面的显示文本。

    • 默认值是 true，表示显示当前页面的完整标题。
    • 如果你设置为 false，面包屑的最后一个导航项将不会显示当前页面的标题。
    • 你也可以直接传入一个字符串，例如 title="文章详情"，那么最后一个导航项就会显示为你定义的这个字符串。

  • siteId：这个参数在多站点管理场景下才会用到。

    • 如果你管理着多个站点，并且需要调用特定站点的面包屑数据，可以通过 siteId="站点ID" 来指定。
    • 对于大多数单站点用户来说，通常无需设置此参数。

带有定制参数的示例

假设你想把首页文本改为“网站主页”，并且当前页面名称显示为“详情内容”：

{% breadcrumb crumbs with index="网站主页" title="详情内容" %}
    <nav class="breadcrumb-nav">
        <ul>
            {% for item in crumbs %}
                <li>
                    {% if not forloop.Last %}
                        <a href="{{ item.Link }}">{{ item.Name }}</a>
                        <span class="separator"> > </span>
                    {% else %}
                        <span>{{ item.Name }}</span>
                    {% endif %}
                </li>
            {% endfor %}
        </ul>
    </nav>
{% endbreadcrumb %}

部署与样式优化

在AnQiCMS中，模板文件通常存放在 /template 目录下，并且鼓励将公共代码片段（如面包屑）放在 partial/ 目录中。所以，你可以创建一个 partial/breadcrumb.html 文件，将上述面包屑导航的代码放入其中。

然后，在你的 bash.html（或任何你希望显示面包屑的页面模板）里，使用 {% include "partial/breadcrumb.html" %} 标签来引用它。这样能保持代码的整洁和可维护性。

样式优化： 面包屑导航的视觉效果完全取决于你的CSS样式。通过调整 .breadcrumb-nav、ul、li、a 和 .separator 等元素的样式，你可以实现各种设计风格。例如：

  • 颜色和字体：让文本颜色与网站整体风格协调。
  • 分隔符：可以使用 /、>、箭头图标甚至CSS伪元素来作为分隔符。
  • 间距和内边距：确保每个导航项之间有足够的视觉空间，提高可读性。
  • 响应式设计：考虑在小屏幕设备上如何显示面包屑，例如通过省略中间部分或缩小字体。

通过这些简单的步骤，你就可以在AnQiCMS网站上轻松创建并显示功能完善、视觉美观的面包屑导航，从而大大提升用户的导航体验和网站的结构可见性。

常见问题 (FAQ)

1. 面包屑导航是否会自动生成，还是需要手动为每个页面配置？ AnQiCMS的面包屑导航是自动生成的。只要你在模板中正确调用了{% breadcrumb %}标签，系统就会根据当前页面的URL路径和其在内容管理中的层级关系（例如文章所属的分类，或单页面的父子关系），自动构建出完整的导航路径。你无需手动为每个页面单独配置。

2. 我想修改面包屑导航中“首页”的显示文字，应该怎么操作？ 要修改面包屑导航中“首页”的显示文字，你可以在{% breadcrumb %}标签中使用index参数。例如，如果你想将“首页”显示为“网站主页”，可以这样写：{% breadcrumb crumbs with index="网站主页" %}。

3. 如果我网站的页面层级很深，面包屑导航会不会变得很长，影响美观？ 面包屑导航确实会忠实地反映网站的层级结构，如果层级很深，导航链会相应变长。在AnQiCMS的标签层面，你可以通过设置title=false来省略当前页面的标题（如果它会使面包屑过长）。在前端样式上，你可以利用CSS进行优化，例如：

  • 为长面包屑设置更小的字体或行高。
  • 在移动端隐藏部分中间层级，只显示关键路径（如“首页 > … > 当前页”）。
  • 或者在CSS中设置文本溢出隐藏并显示省略号，同时保留完整链接供点击。