| name | harmonyos-motion-vocabulary |
| description | 把用户对 HarmonyOS、ArkUI、Canvas 或代码生成产品动效的模糊描述转换为准确术语、相近概念和可能的 ArkUI 能力，例如“松手像急刹车”“拖过头有阻力”“页面像从同一个卡片长出来”“后端没完成却显示成功”。用于命名、检索和编写提示词；不要用于完整设计审视、传统视频剪辑、镜头叙事、直接实现或构建问题。 |
| metadata | {"status":"experimental","version":"1.0.0"} |
HarmonyOS 动效词汇
只做一件事：把模糊的视觉或手感描述转换为准确术语。
适用边界
- 强适用：ArkUI 交互界面、Canvas/RenderNode 产品动效；
- 部分适用：由代码明确控制时间、几何、排版和状态的非交互产品视频；
- 不适用：传统剪辑、镜头叙事、实拍、生成式视频黑盒。
非交互视频可以使用节奏、连续性、错峰、形变、曲线等术语，但不要套用按下反馈、焦点、可打断输入等交互词汇。对缺少已核验官方资料的第三方工具，不对其具体能力作假设。
输出格式
**术语** — 一句话定义。
ArkUI 关联：`可能的 API 或能力`
边界：何时不是这个术语。
有多个可能时，先给最佳匹配，再给 1–2 个近义概念。
词汇表
输入与反馈
- 按下反馈（Press feedback） — 在 Touch Down 时立即改变控件状态，证明输入已被接收。
- 提交（Commit on release） — 抬起且仍位于有效目标内时执行动作。
- 取消回拖（Cancel and re-enter） — 手指移出目标可取消，重新移入可恢复候选状态。
- 焦点态（Focus state） — 键盘、遥控器或旋钮当前操作目标。
- 悬停态（Hover state） — 光标到达可交互对象时的反馈。
- 激活态（Active/selected state） — 控件或导航项已经被选择的持久状态。
连续手势
- 跟手（Direct tracking） — 对象在手势过程中持续随手指或指针变化。
- 速度继承（Velocity handoff） — 离手动画沿用离手前速度，不从零开始。
- 动画衔接（Animation continuity） — 目标改变时从当前动画状态平滑进入新动画。
- 可打断动画（Interruptible motion） — 动画中可被新输入接管、反向或重定向。
- 边界阻尼（Boundary resistance） — 越过边界越难继续拖动，而不是硬停止。
- 回稳（Settle） — 离手后向边界、吸附点或稳定状态运动。
- 抛滑（Fling） — 离手带方向和速度的滑动。
- 吸附（Snap） — 根据位置和速度选择离散目标点。
ArkUI 关联：
- 跟手：
curves.responsiveSpringMotion()；
- 回稳/速度衔接：
curves.springMotion()；
- 显式物理：
curves.interpolatingSpring()。
曲线
- 标准曲线（Standard curve） — 对象前后都在屏内的加速—减速变化。
- 减速曲线（Decelerate） — 开始快、结束慢，常用于进入视线。
- 加速曲线（Accelerate） — 从静止逐渐加速，常用于退出视线。
- 弹性曲线（Spring） — 由响应、阻尼或质量、刚度、速度决定的物理运动。
- 临界阻尼（Critical damping） — 不振荡并尽快稳定。
- 欠阻尼（Underdamped） — 越过目标并振荡后稳定。
- 过阻尼（Overdamped） — 不越过目标，但更慢地接近稳定。
转场
- 同层转场 — Tab、编辑模式等相同层级状态变化。
- 上下层转场 — 父页面与子页面之间的进入和返回。
- 跨层转场 — 应用或任务上下文之间的切换。
- 共享元素转场 — 同一对象在两个页面之间连续移动和变化。
- 共享容器转场 — 容器边界、大小、圆角连续变化，内部内容再切换。
- 共享动势 — 无法直接共享对象时，保持位移、缩放或旋转的共同运动趋势。
- 一镜到底 — 使用共享关系让转场看起来不中断。
- 交叉淡化（Crossfade） — 一个状态淡出、另一个淡入。
ArkUI 关联：geometryTransition()、Navigation 默认或自定义转场。
编排与微动效
- 错峰（Stagger） — 多个元素以小间隔依次出现。
- 数值脉冲（Value pulse） — 数字变化时短暂缩放或透明度反馈。
- 图标抬升（Icon lift） — 选中图标轻微位移以表达激活。
- 状态形变（State morph） — 同一对象在两个状态间连续改变形状或容器。
- 微动效（Micro-interaction） — 小范围、短时、承担反馈或状态说明的运动。
这些通常是 House Style，不是统一官方要求。
异步状态
- 本地确认（Acknowledged） — 客户端已收到输入，但远端尚未完成。
- 处理中（Pending） — 操作正在等待后端、设备或耗时任务。
- 真实确认（Confirmed） — 业务结果已经被权威状态确认。
- 乐观更新（Optimistic UI） — 在远端确认前先更新界面，并准备失败回滚。
- 回滚（Rollback） — 乐观结果失败后恢复先前真实状态。
- 虚假完成（False completion） — 动效或播报暗示成功，但真实状态尚未确认。
- 响应乱序（Out-of-order response） — 旧请求比新请求晚返回并可能覆盖新状态。
用户说“动画在撒谎”时，最佳匹配通常是 虚假完成 或 异步状态不真实，不是简单的缓动问题。
适配与可访问性
- 交互归一 — 同一任务在触摸、鼠标、键盘、遥控器等输入下使用符合习惯的方式完成。
- 多态控件 — 同一控件针对不同设备、输入和场景呈现不同形态与状态。
- 自适应布局 — 元素随容器连续拉伸、缩放、延伸、隐藏或折行。
- 响应式布局 — 布局在断点处变为缩进、挪移、重复或分栏。
- 语义 Token — 用用途命名而不是用具体数值命名的设计参数。
- 永恒基础层（Evergreen Foundation） — 预期跨多个视觉版本成立的反馈、连续性、层级、可读性和真实性原则。
- 版本化平台层（Versioned Platform Layer） — 随 HarmonyOS/OpenHarmony/ArkUI 版本更新的组件、视觉语言、API 和默认行为。
- 项目覆盖层（Project Overlay） — 品牌、业务风险和 House Style 对平台的产品化表达。
- 无障碍分组 — 将相关节点作为一个语义整体播报。
- 虚拟无障碍节点 — 为自绘内容提供辅助工具可识别的结构。
示例
用户：
卡片拖出去以后，松手那一下像突然刹车，然后才回去。
输出：
**速度继承（Velocity handoff）缺失** — 离手后的回稳动画没有沿用手势最后速度，因此在松手点产生速度断层。
ArkUI 关联：跟手阶段检查 `responsiveSpringMotion()`，离手回稳检查 `springMotion()`。
边界：若卡顿来自掉帧而不是速度归零，则属于性能长帧，不是速度继承。
