约定 · 面包屑导航模型

第一列与进入路径

根导航列来自当前语言的首页和直属页面。结构根页面用于归属判断,可见入口只保留已发布 HTML 的页面;根入口可以是栏目,也可以是普通页面。

内容声明见页面区域与布局。构建入口为 module/layouts/_partials/feature-browse/navigation/root/。

选中规则

默认归属来自真实内容祖先。_map.toml 增加引用关系,不创建新页面,也不修改原文的 Parent 或发布网址。

浏览来源只改变本次导航。来源有效性、排序与历史规则统一见导航状态协议,不能据此改变规范地址或结构化数据中的真实路径。

面包屑模型

构建期区分路径项与列来源:路径项表示目标页面,列来源提供该级的同级条目。Hugo Page 只用于构建,不传入浏览器。

根导航、主列表与正文保留在页面 HTML 中。面包屑内容生成共享 HTML 片段,页面只携带所需列索引。共享片段提供内容和默认排序,不保存用户状态。

以下路径相对 module/。

修改内容入口
真实路径与结构面包屑layouts/_partials/feature-browse/navigation/breadcrumb/model.html
列模型与共享片段layouts/_partials/feature-browse/navigation/source/models.html、fragment.html
片段发布与页面索引layouts/_partials/feature-browse/navigation/source/publish.html、pack.html
索引读取与来源选择assets/js/browse/navigation-source.js
片段校验、加载与显示assets/js/browse/breadcrumb-source.js、breadcrumb-controller.js、breadcrumb-render.js

布局与维护边界

骨架须在片段加载前预留列宽。后续填充或排序复用已有容器;失败时显示说明,无效来源回到默认路径。DOM 与样式归属见UI 命名与职责。

assets/js/browse/canvas-position.js 与 assets/js/inline/canvas-position.js 处理同标签页进入下一文档时的横向位置。已有滚动位置、章节锚点与用户输入优先,历史恢复交给浏览器。

修改后按浏览器检查选择来源、排序、章节、画幅和历史场景。浏览器层的下拉刷新差异仍需真机检查。

横向滚动 · 单击或按 Esc 退出