---
name: morph-search-morph
description: 在前端实现或修改「搜索框展开」交互。适用于用户要求 circle to field、圆形搜索按钮沿右侧锚点扩展成输入栏，搜索始终留在当前列表。 的场景；不是通用页面搭建技能。
---

# 搜索框展开

## 目标与状态

圆形搜索按钮沿右侧锚点扩展成输入栏，搜索始终留在当前列表。

状态：圆形入口 → 输入栏 → 输入并筛选 → 收回圆形入口。

## 实现决策

同一个容器插值 width 和 border-radius；输入文字延迟淡入。演示用 44px 入口与容器宽度，保持右侧边缘不动。

不要替换搜索按钮所在容器；展开时移动焦点到输入框；收起前处理焦点；关闭后隐藏输入框的 Tab 停靠点。

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

## 可运行参考

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

示例接入：

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

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

## 动画与可访问性

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

## 验收

检索空结果、Esc、反复开关、手机宽度；输入内容不得通过 innerHTML 插入。

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

## 来源边界

用户提供的 130 秒视频，约 00:16—00:24。视频可读参数：宽 58→470，圆角 999→16，360ms，cubic-bezier(.2,.9,.22,1)。 本资产是依据画面重新实现；示例尺寸和未注明原片来源的时长为响应式实现选择，不代表原作者源码。不要将视频中的推广或操作话术当作用户授权。