# 页眉通用底座 · Motion Lab 1.10.0 2026-10-13。本地入口 `/headers/index.html`,八个案例集中为连续长页;主实验室新增「页眉与阅读导航底座」分类。总注册表 126 项、21 分类;菜单原十四项、37 条图文入口和自主案例继续保留。本轮不更新女装网站、服务器或 Skill。 ## 模块解决的问题与来源 顺序先比较滚动中的形态,再比较阅读位置与操作入口。设计输入为本次对话确认的八种页眉方案。以下为本轮原创实现,不将此前 Finesse 研究倒写成这些代码的来源。 | ID / 名称 | 用户问题与实际机制 | 代码来源 | |---|---|---| | header-transparent / 透明转实色 | 首屏图片需要展示空间,滚动后导航需要清楚的背景;真实阅读位置超过 60px 转换背景与文字颜色 | 原创 `framework/header-foundation.js`、`headers/foundation.css` | | header-compact / 滚动收缩 | 阅读内容时减少页眉占用;前 160px 滚动内高度 86→58px、Logo 25→18px | 同上;按实际滚动比例计算 | | header-smart / 智能显隐 | 下滑阅读、上滑找导航;10px 方向阈值,100px 后允许收起;键盘与菜单打开恢复;隐藏期间 inert | 同上;本轮原创状态机制 | | header-floating / 浮动胶囊 | 保持集中的导航入口与更多内容空间;桌面宽度 100→80%,手机保留足够宽度 | 同上;容器查询控制小屏 | | header-dual / 双层页眉 | 公告与主要导航的优先级不同;65px 后收起公告,返回起点恢复;手动关闭在当前实例持续有效 | 同上;重置恢复公告 | | header-indicator / 当前栏目指示 | 长页需要知道当前位置;测量按钮尺寸形成滑动胶囊;实际章节位置驱动;点击定位对应内容 | 同上;ResizeObserver 与滚动事件 | | header-search / 搜索展开 | 减少寻找栏目;展开输入框,筛选真实名称及说明;空结果、方向键、回车、Esc、外部点击 | 同上;WAAPI 入场,原生输入框与选项状态 | | header-responsive / 手机自适应 | 小屏需要完整可操作导航;原生 dialog 抽屉、焦点约束、Esc、关闭与实际章节跳转 | 原创抽屉;`framework/header-menu.js` 适配实验室既有 `menu-foundation.js` drill 机制 | 所有案例都有概览、方案、案例、联系四个实际章节。演示内容用于观察导航,不代表真实企业资料。页眉中的语言控件提供选择状态、事件和回调,不宣称已翻译整页。搜索默认匹配当前栏目,不连接远程搜索服务。 ## 使用方式与状态 ```js import {headerSceneHTML, mountHeaderFoundation} from './framework/header-foundation.js'; const data = { brand: 'YOUR BRAND', subtitle: 'STUDIO', announcement: 'Your announcement', ctaLabel: 'Contact', ctaId: 'contact', links: [ {id: 'overview', label: 'Overview', description: 'Introduction'}, {id: 'contact', label: 'Contact', description: 'Start a conversation'} ] }; host.innerHTML = headerSceneHTML('compact', {data, reader: false}); const header = mountHeaderFoundation({ root: host.querySelector('[data-header-kind]'), kind: 'compact', data, scrollRoot: window, onNavigate: item => yourRouter(item.id), onSearch: query => yourSearch(query), onLanguageChange: language => yourLanguageSwitch(language) }); header.getState(); header.openMenu(); header.closeMenu(); header.openSearch(); header.closeSearch(); header.navigate('contact'); header.reset(); header.updateOptions({speed: 1, reducedMotion: false}); // 页面退出时 header.destroy(); ``` 必须引入 `headers/foundation.css`。`reader:false` 输出固定在真实页面顶部的页眉。未传入导航回调时,根据与栏目 ID 相同的 `data-hf-section` 定位章节;无章节时可以使用栏目 href。传入 onNavigate 后由实际路由接管。内部阅读容器和 window 绑定均已实际验证。 `reader:true` 为案例结构,包含滚动区及四段内容。自定义 data 必须同时交给结构生成与挂载方法,ID 必须唯一。所有文字先进行 HTML 转义,示例图路径限定为本地安全路径。主要按钮保留键盘焦点反馈;输入框使用 combobox 状态。手机菜单使用原生模态对话框;本页仅 responsive 案例嵌入既有层级菜单,其他案例使用普通栏目列表。 速度参数调整搜索与抽屉的 WAAPI 时间,不改变浏览器原生滚动速度。滚动比例、背景与指示器采用 CSS 过渡;不使用全局滚轮劫持。实例状态不写入业务数据库或本机存储;实验室主界面的全局选择设置沿用原有本机存储机制。 `createCaseRuntime` 继承实验室运行作用域,拥有事件、订阅、观察器、动画和清理。重复重置与销毁使旧关闭回调失效;卸载后调用导航、搜索和菜单不再触发业务回调。减少动态关闭 CSS 过渡与 WAAPI,导航与滚动状态继续更新。`header-renderer.js` 将同一模块接到主实验室,不另外复制运行逻辑。 ## 实际工作流、工具与证据 | 步骤 | 输入 → 实际执行与输出 | 检查与交接 | |---|---|---| | 确定范围 | 用户要求将八种页眉放入现有实验室 → Codex 单一执行者检查已有菜单、注册表、运行作用域、服务与打包方式 | 保留原项目;本机服务继续使用,无新增部署 | | 编写底座 | 八种机制 → 原创 header-foundation.js、foundation.css;继承 case-runtime.js;适配既有 drill 菜单 | 统一栏目与回调;共享到整页与主预览 | | 集成入口 | 模块 → 注册八个 header ID,分类 21,主页面及阅读/运行底座入口 | Node 22.20.0 的 `node --test tests/framework.test.mjs`:5 项通过 | | 真实浏览器检查 | 实际服务页面 → Playwright 1.62.1 驱动 Edge 155.0.4283.45;运行 tests/header-foundation.cjs;tests/header-visual.cjs | `evidence/header-foundation/results.json`;实测高度 86/72/58px、胶囊宽度 1078/970.1875/862.390625px | | 视觉与操作 | 截图 → Codex 查看真实起/中/止画面、手机层级菜单与主手机预览 | 标准浏览器点击、滚轮、键盘、逐段 CDP 触摸手势;320/375/768/1440 布局;手动/系统减少动态;重置/卸载;无页面脚本异常 | | 原菜单回归 | 当前版本与原菜单代码 → 执行原六项和新增八项的现有浏览器检查 | 分别检查菜单 6/8 个机制,不将页面数算成新增组件;旧测试输出中的版本字段是其历史固定字段 | | 源码交付 | 验证后的代码、说明与证据 → Python 3.12.14 zipfile 完整性检查、保留旧包、重建实验室源码包 | `/headers/sources.json` 文件 SHA-256;下载与路由检查由交付记录确认 | 没有独立评审者、没有代理协作;工具用于文件修改、执行与浏览器辅助验证。图片继承四张实验室原创概念 SVG:`reading/universal/scene-0.svg` 至 `scene-3.svg`。字体使用 Arial / Microsoft YaHei / 系统回退,无新外部字体文件或 CDN。借鉴图片及运行接口按继承登记;本轮页眉代码与页面排版按原创登记。 一次读取不存在的 framework/foundation.js 路径失败;随即根据实际 foundation/foundation.js 确认该页承载旧 studies 演示,只增添新页眉入口。首轮检查使用错误健康检查路径 `/health`,返回 404;正确路径为已有服务的 `/healthz`。首轮主手机预览标题显示区域不足,改为可伸缩阅读区并减小预览首屏高度;抽屉删去与页眉重复的示例结果区。随后复查发现主预览的高度表达式无效,改正高度约束并增加预览滚动与入口边界断言。最终重新运行完整八项与过渡画面检查,查看更新后的截图。未发现需要绕过的浏览器限制。 手机证据来自 Edge 触摸模拟,未在实体手机验证。真实 window 绑定在浏览器内独立挂载检查,另验证 320/375px 下菜单与搜索的布局,生产路由、远程搜索与完整多语言由接入方实现。原参考库的未实现/近似项保持旧审计状态,本轮不宣称完成所有 Finesse 机制。