导航设置

📅 2026-11-21 👁️ 0

导航设置

导航设置用于维护网站前台的导航链接,支持自定义导航类别和两级导航结构。

入口路径

后台顶部菜单 →「设置」→「导航设置」。实际地址:/system/setting/nav,需要管理员权限(canAdmin)。

功能说明

页面按导航类别(顶部 Tab)展示列表,支持新增导航类别、添加导航、添加下级、修改和删除。导航链接最多支持两级。

界面截图

导航设置

设置项说明

设置项 作用 取值 / 默认 怎么选 / 填写建议 影响 / 注意
上级导航 决定导航层级 select,含「**导航」=0 一级导航选**;二级选对应父级 最多两级;「添加下级」按钮在满足层级条件时才出现
显示名称 导航在前台显示的文字 文本,无默认 [源码] 可与目标名称不同,便于灵活命名 为空时回填所选文档的标题 [源码]
子标题名称 导航名称下方的小字 文本,无默认 [源码] 需要补充说明时填写 是否展示由模板决定
导航描述 导航的说明文字 文本,无默认 [源码] 后台识别用 —
缩略图 导航配图 图片上传,无默认 [源码] 按模板需要上传 是否展示由模板决定
链接类型 决定导航指向什么 radio:0内置 / 1分类或页面 / 3文档 / 2外链 按目标类型选择,见下方详解 切换类型会改变下一项控件与含义
目标选择 按链接类型指向具体目标 随类型变化,见下方详解 — 同名字段 page_id 在不同类型下含义不同
显示样式 自定义样式类 文本,默认样式名为空 [源码] 需自定义 CSS 时填写样式名 需要模板配合自定义 CSS
显示顺序 排序值 数字,默认 99 [i18n] 值越小越靠前 同值按创建顺序

配置项详解

链接类型与目标(四路联动)

出现条件:新增/编辑导航弹窗中始终显示 [实测]。

链接类型值 含义 对应目标控件
0 内置导航 单选「内置导航」,选项为 0=首页 + 各内容模型
1 分类/页面 下拉「选择分类/页面」,状态不为 1 的选项禁用
3 文档 下拉「选择文档」,支持搜索;选中后回填默认标题
2 外链 文本框「填写链接」

源码中所有类型都用同一个提交字段名 page_id,但随类型切换控件和含义;外链类型改填 link(要求 http 或 https 开头)[源码]。

推荐值:站内栏目用「分类/页面」,单独文章用「文档」,首页/模型入口用「内置」,站外用「外链」。

填错后果:类型与目标不匹配(如选了分类却填了外链地址)会导致导航跳转错误或空链接。

导航层级

导航最多两级。源码中「添加下级」按钮仅在满足 parent_id===0 || level<2 || 子导航非空 时出现 [源码]。

填错后果:试图建立三级导航时入口不出现,属正常限制,不是 bug。

操作步骤

  1. 进入「设置 → 导航设置」。
  2. 选择导航类别,点击「添加导航」。
  3. 填写显示名称,选择链接类型与目标。
  4. 需要二级导航时,在对应条目上点「添加下级」。
  5. 保存后在前台确认导航展示。

适用场景与建议

  • 页脚导航:通过「导航类别管理」新增一个类别,模板按类别调用,避免与顶部导航混在一起。
  • 多级下拉:只支持两级,超过两级需要改用其他展示方式。

前台调用示例

{% navList navs with typeId=1 %}
  <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><a href="{{ inner.Link }}">{{ inner.Title }}</a></dd>
        {% endfor %}
        </dl>
      {% endif %}
    </li>
  {% endfor %}
  </ul>
{% endnavList %}

注意事项

  • 导航只支持两级,添加下级时不会生成第三级入口。
  • 删除导航条目不会删除对应的分类或页面,只影响前台导航展示。
  • 类别 ID 要与模板中的 typeId 对应,否则调用不到数据。

相关文档