# 菜单与导航底座 · Motion Lab 1.9.0 当前共十四种菜单,主实验室 118 项、20 分类。新增基础下拉、级联、形变、分组大下拉、手风琴、搜索选择、底部弹层和收缩侧栏,集中在同一长页面。 [新增八项的接口、来源与实际验收](DROPDOWNS.md) · [旧六项的 1.8.0 记录](README-1.8.0.md) · [文件摘要](sources.json) 新下拉类请依次引入 /menus/foundation.css 和 /menus/dropdowns.css。两页说明中的默认结果均为当前本机实例状态,接入实际路由或表单请传入 onSelect。 # 菜单与导航底座 · Motion Lab 1.8.0 2026-10-13。入口 `/menus/index.html`,六个案例合并在同一长页面,主实验室增加「菜单与导航底座」分类。当前主注册表 110 项、20 个分类;原 104 项和 37 条图文案例入口继续保留。新增的是六个机制,不把新页面数量当成独立组件数量。 ## 六种机制与选择理由 | 示例 ID | 名称与常用术语 | 解决的问题 | 实际机制 | |---|---|---|---| | navigation-full | 整屏分幕/Fullscreen Navigation | 少量主栏目需要完整视觉表达 | 原生 dialog;背景 clip-path 展开;栏目错峰上移;焦点或鼠标联动另一栏图片、子链接与说明;手机上下分栏 | | navigation-mega | 图片联动大菜单/Mega Menu | 导航需要容纳分类及下一层内容 | 150ms 悬停意图判断;点击/方向键/ArrowDown 进入;真实栏目内容切换;离开延迟关闭、Esc 与外部点击 | | navigation-drill | 层级推进/Drill-down | 手机屏幕不适合展示全部分类层级 | 同一栏目树逐层进入;前一视图滑出、新视图滑入;返回按钮、面包屑和左方向键;新视图焦点定位 | | navigation-radial | 径向快捷菜单/Radial Menu | 在工具或画布内就近使用少量动作 | 六个操作围绕指针/触点实际位置展开;边界约束;右键、600ms 长按、普通按钮;方向键、Enter 与 Esc | | navigation-command | 搜索式命令菜单/Command Palette | 栏目多时减少翻找 | Ctrl/⌘+K 或按钮打开;查询真实叶节点的名称、说明、所属栏目;空结果、方向键、Enter;可选最近使用记录 | | navigation-dock | 当前位置导航/Scrollspy Dock | 长内容需要当前位置和跳转 | 根据真实内部滚动计算章节;测量按钮位置的滑动胶囊;下滑隐藏、上滑显现;键盘恢复导航;指针小幅偏移 | 径向菜单适合少量常用操作,完整主导航仍应保留普通列表入口。命令菜单的快捷键是补充入口,页面也有明确按钮。方向响应案例滚动范围为示例内部阅读区,未劫持整页滚轮;不会用定时器伪造章节位置。 ## 接入 API 与真实业务交接 引入 `framework/menu-foundation.js` 与 `menus/foundation.css`。`menuSceneHTML(kind)` 只负责示例结构;`mountMenuFoundation` 负责运行、状态、交互和清理。主实验室通过 `menu-renderer.js` 调用同一模块,整页没有另写一套菜单代码。 ```js host.innerHTML = menuSceneHTML('mega'); const menu = mountMenuFoundation({ root: host.querySelector('[data-menu-kind]'), kind: 'mega', data: [{ id: 'products', label: '产品', description: '浏览产品系列', image: '/images/products.webp', children: [{ id: 'new', label: '新品', href: '/products/new/' }] }], speed: 1, onSelect: item => location.assign(item.href) }); menu.open(); menu.close(); menu.reset(); menu.getState(); menu.updateOptions({ speed: 1.2, reducedMotion: true }); menu.destroy(); ``` 每个节点必须有唯一 `id` 和可读 `label`;说明、图片和链接可选,层级用 `children`。树在挂载时校验并复制;改变栏目数据时销毁后重新挂载。选中叶节点会发出 `menu:select`,并调用可选的 `onSelect`。路由网站可以跳转 `item.href`,工具类应用可以用 `item.id` 映射动作。 默认 Demo 会更新其下方的栏目名称和说明,焦点转到这个结果。没有把本地示例状态伪装成真实网站跳转。接入应用须提供自己的有效链接或动作。最近使用默认只在当前实例内保存;整页命令案例显式使用 `motion-lab-menu-recent` 保存最近五个 ID,不保存用户的搜索文本。可传入自己的 `storageKey`,也可以保持默认 `null`。 `reset()` 重置当前菜单视图和选择结果,保留最近使用;整页「全部回放」销毁再创建六个实例。菜单由用户操作触发,无持续自动播放,主预览对应的播放按钮显示「无需自动播放」。回放、减少动态和直接操作仍有效。系统减少动态、手动减少动态均关闭过渡,保留状态变化。 销毁会关闭原生弹层,移除事件、悬停/长按计时器、尺寸观察器和动画。关闭过程中销毁或重置时,过期选中回调不会在稍后执行。非法重复 ID 在创建内部运行作用域前拒绝。 ## 逐模块来源 | 对象 | 来源 | 性质 | |---|---|---| | 六个菜单的 DOM、状态逻辑和样式 | `public/framework/menu-foundation.js`、`public/menus/foundation.css` | 本轮原创实现,参考常见导航模式;不是安装了现成菜单组件库 | | 运行作用域 | `public/framework/case-runtime.js`,原实验室既有模块 | 继承事件、计时、暂停、减少动态和清理机制 | | 整页示例与说明 | `public/menus/index.html`、`app.js`、`page.css` | 原创;六例使用同一模块与可替换数据 | | 实验室注册与预览 | `catalog.js`、`renderers.js`、`menu-renderer.js`、`app.js` | 在原主框架上增加导航分类和适配器 | | 导航概念插画 | `/reading/universal/scene-0.svg` 至 `scene-3.svg`,由原 `tests/create-universal-assets.mjs` 生成 | 继承 1.7.0 原创 SVG 插画,非实拍;本次无新增图像生成或素材下载 | | 字体与图标 | Arial/系统中文回退;文字、序号和含义明确的箭头 | 继承系统字体,无外部字体或图标包 | | 原有整屏菜单、方向响应与其他案例 | `experience-gallery.js`、其他既有框架及页面 | 保留;本轮的新版本不能倒写成旧案例当时的来源 | 本轮没有修改 Finesse 或用户的建站 Skill,没有新增外部动画依赖。旧 Finesse 来源、缺项审计继续按原记录理解,不因新增六个菜单而声称已完成全部参考案例。 ## 实际工作流与验收 执行者只有 Codex,没有子代理或独立评审。输入为用户提出菜单进阶建议并要求在实验室实现通用 Demo。先读取原实验室 1.7.0 的注册表、渲染入口、运行作用域、已有整屏菜单与导航示例,决定六例集中长页,并保留原案例。 通过本机文件工具创建共用模块、样式和页面;在原 `127.0.0.1:23340` 服务上预览,不另建服务器项目。Node 22.20.0 做语法和五项框架检查,Playwright 1.62.1 驱动真实 Edge 155.0.4283.45 做浏览器验收。基础检查证明 110 个唯一 ID、20 分类及原 31 个交互组件保留;不把这些静态断言当作动画画面验收。 `tests/menu-foundation.cjs` 的实际操作覆盖:六机制;整屏中间/终态、栏目图片切换、Esc 与焦点返回;大菜单鼠标/键盘/点击;两级推进与返回;径向六个不同终态位置、键盘和触摸长按;命令搜索、空结果、最近使用与快捷键;真实滚动章节、隐藏和恢复;320、375、768、1440 宽度;手机点按;系统/手动减少动态;回放与原生弹层卸载;自定义栏目回调。最终结果错误列表为空。 `tests/menu-extras.cjs` 检查主实验室六个注册预览、接入代码真实换行、减少动态和回放;原始接口 reset;关闭过程中销毁不再迟到执行回调;重复数据拒绝。`tests/menu-mobile.cjs` 在真实触摸事件的长按/松手后等待完整结束,确认六个点击目标留在容器内、实际选中有效,并冒烟检查原 space-corridor、universal-liquid、scroll-reveal 入口。 保留的失败与修正:第一次手机长按测试发现松手产生的合成点击立即关闭菜单,第二次边界检查又发现展开中的按钮可能移到松手触点下方,因此按“新一次 pointerdown”区分合成点击与主动点按;增加该手势区分后完整测试通过,并为底部提示预留空间;主预览测试误点了正确禁用的自动播放按钮,依据手动菜单语义改为断言禁用;接入代码一度包含字面的换行转义,已修正,并从关闭的说明区域读取 `textContent` 验证真实九个换行,不能用不可见区域的空 `innerText` 下结论。关闭按钮改为固定位置,手机滚动整屏菜单时仍能关闭。 实际查看了当前 full-desktop、full-mobile、mega-desktop、radial-mobile-final、main-preview 截图;其余为程序保存的证据,不声称逐张人工复核。证据位于工作目录 `evidence/menu-foundation/`,测试源码与证据随本地 ZIP 保存。仅验证 Windows Edge 与触摸模拟,未做实体手机、全部浏览器或读屏器的人工验收。 菜单数据示例与运行底座已完成;女装网站属于另一项目,本次结果交付在本机实验室。源码版本 1.8.0,通过同一原服务访问,未上传至用户服务器。