# 滚动关联进度 — design.md

内容版本：sha256:067d43d266e19d3e2535200a4eb38c0ca77f340b41686f0def0d59c89a628ec7

本文件由当前元数据、实现摘要和实际文件列表确定性生成。元数据记录是资料声明；未提供的数值不作推断。实现建议须在后续开发中选择和验收。

## 元数据记录

- 资产：components/scroll-linked-progress；语义类型：interaction。
- 分类：交互模式。
- 标签：Scroll-linked、阅读进度、滚动动画。
- 场景：文章阅读进度、长页面浏览进度、教程章节进度、叙事页面进度提示。
- 平台：未提供。
- 风格：未提供。

### 亮点声明

- 进度随滚动变化：页面滚动多少，视觉状态就相应变化；资料以顶部阅读进度条为例。
- 向 AI 描述：“顶部阅读进度条与页面滚动位置实时关联，滚动时同步更新。”
- 参考画面：样本帧中上方示意窗口可见顶部进度线；无法据此测量更新方式或精确参数。

### 实际文件与参考资源

- `demo.html`（sha256:1dbe0197c0923392cfc5853b491fca41c1a29e71ccc98688dbfc5bc201bfcefa）
- `meta.yml`
- `refs/01.png`（sha256:c84d90d5b3d88f8e2bd9b18c80bc41bb080ebeda631272d537715adcd887a0ee）
- `refs/02.png`（sha256:ce605db46bfe73e8cc20c91b003ca31f31f760dc9362cae7c27363cc02acc72e）
- 参考图：`refs/01.png`；中上方阅读进度线示意。
- 参考图：`refs/02.png`；中上方接近填满的进度线示意。
- 实现摘要：sha256:1dbe0197c0923392cfc5853b491fca41c1a29e71ccc98688dbfc5bc201bfcefa。

## 未提供

- 未结构化记录的精确色值、字号、间距、断点、动效时长与状态转换参数不作推断；亮点中的数值属于元数据声明，demo 的存在与摘要不代表浏览器行为已验收。

## 实现建议

- 按正常、悬停、聚焦、激活、禁用、加载、成功和错误状态定义适用的状态表。
- 使用语义化元素，验证键盘操作、焦点可见性、触控目标和减少动效偏好。
- 以 demo.html 为实现参考，逐项验证交互、窄屏布局、文本溢出和错误恢复；具体参数由实现与验收确认。