导航设置
导航设置
导航设置用于维护网站前台的导航链接,支持自定义导航类别和两级导航结构。
入口路径
后台顶部菜单 →「设置」→「导航设置」。实际地址:/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。
操作步骤
- 进入「设置 → 导航设置」。
- 选择导航类别,点击「添加导航」。
- 填写显示名称,选择链接类型与目标。
- 需要二级导航时,在对应条目上点「添加下级」。
- 保存后在前台确认导航展示。
适用场景与建议
- 页脚导航:通过「导航类别管理」新增一个类别,模板按类别调用,避免与顶部导航混在一起。
- 多级下拉:只支持两级,超过两级需要改用其他展示方式。
前台调用示例
{% 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对应,否则调用不到数据。