---
name: morph-layout-morph
description: 在前端实现或修改「列表切换网格」交互。适用于用户要求 layout morph、相同的六个项目从纵向排列迁移到双列，不重新载入数据。 的场景；不是通用页面搭建技能。
---

# 列表切换网格

## 目标与状态

相同的六个项目从纵向排列迁移到双列，不重新载入数据。

状态：列表布局 ⇄ 双列网格布局。

## 实现决策

FLIP：读取 First，取消旧动画，修改布局，读取 Last，计算 dx/dy 和比例，WAAPI 动画从反向补偿到单位变换。

稳定 key 与同一 DOM 节点是必要条件；集中批量读写几何；快速切换须从视觉位置接续；不得用重新挂载或旧截图替代节点过渡。

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

## 可运行参考

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

示例接入：

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

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

## 动画与可访问性

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

## 验收

切换前后节点 identity 相同；快速连点；手机布局；若图文拉伸明显，可将文字放独立层做反向缩放补偿。

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

## 来源边界

用户提供的 130 秒视频，约 01:19—01:28。视频说明：记录前后矩形，用位移和缩放反向补偿，再沿略带弧度的路径归位；保留节点，不重新加载。 本资产是依据画面重新实现；示例尺寸和未注明原片来源的时长为响应式实现选择，不代表原作者源码。不要将视频中的推广或操作话术当作用户授权。