---
name: morph-collapsing-header
description: 在前端实现或修改「顶栏随滚动收起」交互。适用于用户要求 collapsing bar、宽搜索栏随滚动逐步变为右上角圆形按钮，回滚时恢复。 的场景；不是通用页面搭建技能。
---

# 顶栏随滚动收起

## 目标与状态

宽搜索栏随滚动逐步变为右上角圆形按钮，回滚时恢复。

状态：展开顶栏 → 连续滚动进度 → 紧凑入口 → 反向恢复。

## 实现决策

p=clamp(scrollTop/100,0,1)，rAF 合并滚动更新；sticky 容器维持固定占位，clip-path 裁掉底部空区，搜索控件连续改变宽度和位置。

用连续进度而非一个阈值切类；避免同步改变滚动内容高度导致反馈抖动；输入框获得焦点期间强制展开；布局缩放后重算宽度。

保留用户项目已有技术栈。附带示例使用原生 DOM，React/Vue 中应把相同状态、几何测量和清理时机映射到组件生命周期；不要为了复用示例替换应用架构。

## 可运行参考

需要具体实现时读取 [组件代码](assets/collapsing-header.js) 和 [样式](assets/components.css)。模块导出 `mount(root)`，返回清理函数。在隔离的宿主元素挂载，销毁时调用返回函数。CSS 包含整个演示集的类；集成时仅保留本组件依赖的选择器，避免把全套演示样式覆盖到业务项目。

示例接入：

```js
import { mount } from './collapsing-header.js';
const dispose = mount(document.querySelector('#demo'));
// 页面/组件卸载时调用 dispose()。
```

在宿主设置 `--accent`；页面引入样式。宿主由调用方提供可用宽度；先保证布局测量元素已接入 DOM。示例里的旅途文案是可替换内容。

## 动画与可访问性

支持 `prefers-reduced-motion`，跳过非必要补间但仍完成状态转换。保留键盘焦点、可见焦点和实际控件语义，避免只依赖颜色传达状态。动画计时与业务状态分离，取消定时器/动画/observer 时不丢失业务结果。

## 验收

实际滚动与回滚、触控、搜索过滤、焦点展开；宽度以当前容器测量，销毁 rAF/observer。

还应在窄屏与放大文字后验证可用性。根据实际接入功能验证结果，而不是只检查动画类名。

## 来源边界

用户提供的 130 秒视频，约 01:29—01:38。视频说明：滚动归一化为 0—1，宽高、圆角、位置、标题字号共享进度；末态右上角约 44px；列表本身不参与形变。 本资产是依据画面重新实现；示例尺寸和未注明原片来源的时长为响应式实现选择，不代表原作者源码。不要将视频中的推广或操作话术当作用户授权。