Skip to content

majiayu000/spellbook / skills/form-motion

form-motion

Verified

FORM UI 动效词典:10 个克制、跟手、可访问的界面微交互,每个都配原始提示词、可改项、验收标准和自动验收脚本——连续形变按钮、液体标签指示器、弹性滑块、柔性开关、原位展开卡片、层叠通知、命令面板、拖动排序、跟随提示、自绘折线图。共用一个从当前位置和速度重定向的阻尼弹簧。当用户说「按钮自己变成加载和完成」「选中条像软糖追过去」「拖到头还能拽一点」「开关圆点拉长」「卡片原位展开」「通知层叠」「Cmd+K 命令面板」「拖动排序」「提示跟随鼠标」「折线自己画出来」,或点名 FORM 动效库、要把某个样例用到自己的页面时使用。只在明确请求时触发,忽略顺带提及。

FileKindSize
SKILL.mdskill md9.3 KB
assets/motion.jsscript3.1 KB
assets/reference.htmlother96.6 KB
assets/skins/hud.cssother4.2 KB
references/catalog.jsonconfig14.6 KB
references/samples.mdmarkdown18.7 KB
scripts/build_samples_md.pyscript5.2 KB
scripts/lib/env.mjsscript3.5 KB
scripts/package.jsonmanifest285 B
scripts/verify.mjsscript35.2 KB

references/samples.md

View on GitHub
# FORM 10 个样例

每节可单独复制。**提示词**是原文,**可改项**交给使用者替换,**验收**是完成标准,**测试钩子**是 `scripts/verify.mjs` 定位元素用的,复现或接入后都保留它们。

所有样例共享视觉方向:暖灰背景 #f2f1ed、黑白组件、Geist 英文字体及系统中文字体、统一 1.7px 图标描边。克制弹簧,轻微超调;不使用弹跳缓动、光晕、粒子、UI 渐变。支持键盘、触摸与 prefers-reduced-motion。


## 01 · 连续形变按钮(Morphing action)

- 用户可能会说:按钮不要换掉,让它自己变成加载和完成状态。
- 适用:提交、保存、导出等需要展示任务进度的主操作。
- 试玩:点击 Export file,观察加载与完成,再点击完成状态重试。
- 参考实现:`assets/reference.html` 里的 `mount01`,`reference.html?sample=01` 直接打开

**提示词**

> 制作一个连续形变的提交按钮。暖灰画布,黑色按钮,白色文字,Geist 字体。点击后,同一个容器从 196×58 的圆角矩形收缩为 58×58 圆形加载器;异步任务成功后伸展为 166×58 的完成按钮,显示勾选和 Done。宽度、圆角用阻尼弹簧,约 350ms 收敛,超调小于 3%;文字先淡出并短暂模糊,再显示下一状态,绝不重叠。加载期间禁用重复提交,向辅助技术报告状态。完成可点击重置。保留同一个 DOM 外壳,不用多个按钮交叉淡化伪装形变。演示可模拟约 1.2 秒任务;接入产品时绑定真实 Promise,错误必须可见且允许重试。支持触摸、Enter/Space 和减少动态效果偏好。

**可改项**:按钮文字、品牌色、真实异步任务、按钮尺寸

**验收**

- 空闲、加载、完成共用同一个外壳
- 连续点击不会启动多个任务
- 状态文本不会重叠
- 加载状态有可读反馈,成功后可以重新操作

**补充说明**(盲测时发现提示词没写清的地方)

- 状态文本示例:Ready / Exporting… / Done,失败时 Failed · Retry。演示可加一个触发失败的方式
- 减少动态效果时转圈可停住,只保留状态文字

**测试钩子**(根元素 `[data-form="01"]`)

- `button[data-part=shell]`:唯一的按钮外壳,三种状态都是它
- `[role=status]`:读出“加载中 / 已完成”等状态

## 02 · 液体标签指示器(Liquid navigation)

- 用户可能会说:选中条像软糖,前面先走,后面再追上。
- 适用:分段导航、视图切换、筛选标签。
- 试玩:切换三个标签,也可用左右方向键。
- 参考实现:`assets/reference.html` 里的 `mount02`,`reference.html?sample=02` 直接打开

**提示词**

> 制作一个三项分段标签控件:Overview、Activity、Insights。白色圆角底座,黑色胶囊指示器,选中文字为白色。切换时指示器的左右边缘使用两条独立弹簧:移动方向上的领先边缘先响应,尾随边缘更慢,使胶囊短暂拉长后恢复目标宽度。反向切换时交换领先边缘,快速连续切换必须从当前真实位置和速度重新定向,不能跳到上一终点。按标签实际边界测量目标,适应长短不同的文字。内容区域同步更新。采用 tablist/tab/tabpanel 语义,方向键、Home/End 可切换并移动焦点,选中状态由 aria-selected 表达。减少动态效果时立即定位。不要用 scaleX 拉伸文字,不添加光晕或弹跳。

**可改项**:标签数量、文字长度、指示器颜色、拉伸程度

**验收**

- 指示器两边的速度明显不同
- 文字宽度不同也准确对齐
- 连续反向切换不中断或瞬移
- 键盘焦点和选中内容保持一致

**补充说明**(盲测时发现提示词没写清的地方)

- Space/Enter 也可激活标签;tab 用 aria-controls 指向面板

**测试钩子**(根元素 `[data-form="02"]`)

- `[role=tablist]`、3 个 `[role=tab]`、`[role=tabpanel]`
- `[data-part=indicator]`:黑色胶囊,左右边缘就是它的 left/right

## 03 · 弹性音量滑块(Elastic range)

- 用户可能会说:拖到尽头还能拽一点,松手再柔和地收回来。
- 适用:音量、缩放、亮度等连续数值控制。
- 试玩:按住滑块拖动;越过两端后松手。
- 参考实现:`assets/reference.html` 里的 `mount03`,`reference.html?sample=03` 直接打开

**提示词**

> 制作一个黑白音量滑块,默认 64%,轨道约 280px。按住时数值直接由指针相对轨道的位置计算,跟手过程没有插值延迟。逻辑值始终限制在 0–100;越过端点时,滑块末端只产生有阻力的视觉延伸,距离上限约 24px,不能把逻辑值变成 110%。使用 pointer capture,使鼠标或手指离开控件仍继续拖动。释放后,从当前视觉位置和速度用阻尼弹簧回到最近合法端点,轨道随之恢复。数字跟随真实逻辑值更新。键盘方向键每次 1%,Home/End 到端点,暴露 slider 的 aria-valuenow/min/max。触摸只在滑块区域禁止滚动。减少动态效果时直接回位。不要把整个组件连同文字一起拉伸。

**可改项**:最小最大值、初始数值、越界阻力、数值单位

**验收**

- 拖动时滑块与指针直接对应
- 越界只影响视觉,逻辑值不超范围
- 指针离开轨道后仍能完成拖动
- 松手回位与键盘操作都正常

**补充说明**(盲测时发现提示词没写清的地方)

- 逻辑值取整;合法范围内松手吸附到取整值对应的位置;两端越界对称处理

**测试钩子**(根元素 `[data-form="03"]`)

- `[role=slider]`:接收指针的命中区,带 aria-valuenow/min/max
- `[data-part=track]`:轨道(逻辑 0–100 对应它的宽度)
- `[data-part=fill]`:已填充部分,右边缘=视觉位置,越界时可以超出轨道
- `[data-part=value]`:数字文本

## 04 · 柔性开关(Soft switch)

- 用户可能会说:开关的小圆点,移动时稍微拉长一下。
- 适用:通知、自动保存、隐私等即时二元设置。
- 试玩:点击开关,快速来回切换。
- 参考实现:`assets/reference.html` 里的 `mount04`,`reference.html?sample=04` 直接打开

**提示词**

> 制作一个克制的柔性开关,用于 Quiet mode。关闭时浅灰轨道配白色旋钮,开启时黑色轨道配白色旋钮。旋钮左右边缘分别使用不同响应速度的闭式弹簧:领先边缘更快、尾随边缘更慢,产生短暂的水平拉长,再恢复圆形。关闭方向应镜像这个行为。背景颜色平滑改变,旁边文字同步反映 On/Off;开关真实布尔值在触发时立即更新。快速连续点击必须保留当前位置与速度,不能重启动画导致闪跳。用原生按钮配 role=switch、aria-checked 和可读标签,Space/Enter 可切换,触控目标至少 44px。减少动态效果时立即切换。不要给旋钮添加夸张挤压、阴影光晕或弹跳。

**可改项**:设置名称、开启颜色、旋钮大小、弹簧硬度

**验收**

- 视觉、文字、aria-checked 三者一致
- 左右切换都呈现方向正确的拉伸
- 快速切换没有跳跃
- 触控和键盘可用

**补充说明**(盲测时发现提示词没写清的地方)

- 参考尺寸:轨道 72×44(也是触控目标),旋钮 34px,左右各留 5px

**测试钩子**(根元素 `[data-form="04"]`)

- `button[role=switch]`
- `[data-part=knob]`:旋钮,左右边缘就是它的 left/right
- `[data-part=state]`:On / Off 文本

## 05 · 原位展开卡片(Expanding surface)

- 用户可能会说:点开后还是这张卡,只是它长出了更多内容。
- 适用:详情披露、订单摘要、设置说明、项目卡片。
- 试玩:点击卡片右上角展开,再折叠。
- 参考实现:`assets/reference.html` 里的 `mount05`,`reference.html?sample=05` 直接打开

**提示词**

> 制作一张可原位展开的项目摘要卡片。白色卡片、细灰边框、黑色文字,标题 Weekend escape,下方一句摘要。点击右上角展开按钮后,同一张卡从约 142px 高伸展到约 278px 高,展示进度、成员和下一步;用阻尼弹簧改变高度,轻微超调。内容与外壳分开控制:展开时等空间打开后再淡入并上移约 6px,折叠时内容先在约 120ms 内淡出,再收起外壳。快速反向操作要从当前高度继续。用 aria-expanded 和 aria-controls 连接按钮与详情,折叠内容不可被 Tab 聚焦或辅助技术读取。长文字能自然换行,移动端宽度不溢出。减少动态效果时立即展开。不要用 scale 拉伸整张卡,也不要替换成模态框。

**可改项**:摘要与详情、卡片宽度、展开高度、圆角

**验收**

- 外壳始终同一元素
- 文字在高度变化中不被挤压拉伸
- 收起后隐藏内容不接收焦点
- 连续展开折叠没有重叠文字

**补充说明**(盲测时发现提示词没写清的地方)

- 展开时外壳先走,内容约 140ms 后淡入;高度目标取 max(278, 内容实测高度),长文字不被截断

**测试钩子**(根元素 `[data-form="05"]`)

- `[data-part=card]`:卡片外壳,高度变化发生在它身上
- `button[aria-expanded][aria-controls]`:展开按钮,aria-controls 指向详情区的 id

## 06 · 层叠通知(Stacked feedback)

- 用户可能会说:新通知压在最前面,旧的轻轻往后退。
- 适用:连续保存、上传、协作操作等短反馈。
- 试玩:连续点击 Add notification,再关闭最上面的通知。
- 参考实现:`assets/reference.html` 里的 `mount06`,`reference.html?sample=06` 直接打开

**提示词**

> 制作一个最多三层可见的通知堆叠。新通知从下方约 16px 进入最前层,旧通知向上退 12px 并略缩小,最低缩放不低于 0.92,透明度逐层降低。每张通知具有稳定身份;插入或关闭时,剩余通知从当前视觉位置以阻尼弹簧重新排列。只展示最前层的完整正文和关闭操作,后层露出边缘,避免文字拥挤。新增内容通过独立的 polite live region 宣告,不能把整个堆栈反复朗读。示例采用手动关闭,最多保留三条,连续点击有明确反馈。关闭按钮具备明确标签与至少 44px 的触控区域。减少动态效果时立即排列。不要使用弹跳、光晕或每条通知都配一套不同图标。

**可改项**:消息内容、最多显示条数、层间距离、出现方向

**验收**

- 连续新增时最多三条可见
- 关闭前层后后层平滑接替
- 后层正文和按钮不形成视觉或键盘拥挤
- 新消息能被辅助技术宣告

**补充说明**(盲测时发现提示词没写清的地方)

- 第 4 条到来时移除最旧的一条(不是隐藏)
- 关闭也要在 live region 宣告,比如“已关闭,剩余 2 条”
- 后层正文与按钮用 visibility:hidden + inert + aria-hidden

**测试钩子**(根元素 `[data-form="06"]`)

- `button[data-part=add]`:新增通知
- `[data-part=toast]`:每条通知;内含 `button[data-part=close]`
- `[data-part=live][aria-live=polite]`:独立的宣告区

## 07 · 搜索命令面板(Command search)

- 用户可能会说:像 ⌘K 一样,打开就能输入,边打字边筛选。
- 适用:全局快捷操作、跳转搜索、工具选择。
- 试玩:点击 Open commands,搜索、用方向键选中并回车。
- 参考实现:`assets/reference.html` 里的 `mount07`,`reference.html?sample=07` 直接打开

**提示词**

> 制作一个紧凑的命令搜索面板。点击 Open commands 或按 Cmd/Ctrl+K 打开,白色面板从 0.96 缩放并淡入,退出约 140ms、进入约 200ms,使用克制 ease-out。打开后立即聚焦输入框;输入按名称实时过滤命令,显示 New document、Search projects、Invite teammate、Export workspace。方向键循环移动高亮,Enter 执行当前命令并关闭,Escape 关闭,关闭后将焦点还给触发按钮。无结果时明确显示 No commands found,并禁止执行。使用 dialog 语义、焦点约束、combobox/listbox 关系及 aria-activedescendant。演示执行结果用可读状态文本呈现;接入时替换成真实操作。支持移动端触摸。减少动态效果时立即开关。不要加入装饰性仪表盘或无效搜索占位。

**可改项**:命令列表、搜索范围、快捷键、执行动作

**验收**

- 打开即聚焦,关闭恢复焦点
- 搜索确实过滤结果
- 方向键和 Enter 执行高亮项
- 无结果和 Escape 行为正确

**补充说明**(盲测时发现提示词没写清的地方)

- 用原生 dialog + showModal;退出时先加关闭类跑 140ms 过渡,再调用 close();拦截 cancel 事件让 Escape 也走带动画的关闭

**测试钩子**(根元素 `[data-form="07"]`)

- `button[data-part=trigger]`:Open commands
- `[role=dialog]` 内含 `input[role=combobox]`、`[role=listbox]`、`[role=option]`
- `[data-part=result]`:执行结果文本

## 08 · 跟手拖动排序(Direct reorder)

- 用户可能会说:抓住一行拖走,其他行自然让出位置。
- 适用:播放队列、任务顺序、导航或优先级列表。
- 试玩:抓住右侧拖柄上下拖动;也可用上下按钮排序。
- 参考实现:`assets/reference.html` 里的 `mount08`,`reference.html?sample=08` 直接打开

**提示词**

> 制作一个三行任务排序列表,依次为 Research、Wireframes、Prototype。通过行右侧拖柄开始拖动,使用 pointer capture;拖动项直接跟随指针的垂直位移,抬升约 1.02 倍且保持文字清晰。其余项目在拖动中心越过插槽中点时交换位置,用阻尼弹簧让出空间;只移动到明确插槽,不无限自由漂移。松手后拖动项从当前位置归位,保留稳定的项目身份,并实际更新列表顺序。提供独立的上移/下移按钮作为键盘与辅助技术替代操作,使用 live region 宣告新顺序。边界按钮禁用。触摸拖动仅在拖柄禁用页面滚动。减少动态效果时立即排位。不要只做 transform 动画而不更新逻辑顺序,不使用已弃用 aria-grabbed。

**可改项**:列表内容、行高、插槽阈值、拖动抬升程度

**验收**

- 拖动项直接跟手
- 其他行在越过中点时让位
- 释放后的真实顺序与画面一致
- 上下按钮可以完成同样排序

**补充说明**(盲测时发现提示词没写清的地方)

- 参考:行高 64、行距 74;拖动位置夹在列表范围内(上下各留约 15px)
- 拖动中只改逻辑顺序和其他行的位置,松手时再重排 DOM(拖动中移动节点会丢 pointer capture),之后恢复焦点
- 拖柄 aria-hidden,键盘走上移/下移按钮

**测试钩子**(根元素 `[data-form="08"]`)

- 3 个 `[data-part=row]`,每行含 `[data-part=grip]`、`button[data-part=up]`、`button[data-part=down]`
- `[data-part=live]`:宣告新顺序
- 松手或点按钮后,行在 DOM 里的顺序就是新顺序

## 09 · 跟随式提示(Following tooltip)

- 用户可能会说:提示轻轻跟着鼠标走,但不要挡住鼠标。
- 适用:图形预览、颜色样本、画布对象的补充说明。
- 试玩:在色块上移动鼠标;键盘 Tab 也能查看说明。
- 参考实现:`assets/reference.html` 里的 `mount09`,`reference.html?sample=09` 直接打开

**提示词**

> 制作一个跟随式提示:鼠标悬停在三个黑白色块上时,展示对应颜色名称和色值。提示与指针保持约 16px 偏移,以高阻尼弹簧轻微跟随,既有柔软感又不明显拖尾。基于提示实际尺寸限制位置,接近预览区域边缘时翻转或夹紧,始终完整可读。提示设 pointer-events:none,不能抢走 hover;离开触发区域后淡出,快速跨色块时平滑更新内容。每个色块能获得键盘焦点,以 aria-describedby 关联提示;键盘聚焦时在色块旁固定定位,Escape 可隐藏。触摸点击色块可查看同样说明。减少动态效果时直接定位。保持文字清晰,不对跟随层使用模糊或 will-change,不做磁吸光标。

**可改项**:提示内容、偏移距离、边界留白、跟随速度

**验收**

- 提示不遮挡指针或阻断 hover
- 靠近边缘仍完整可见
- 颜色名称和色值与当前色块一致
- 键盘、Escape 和触摸可以查看或隐藏说明

**补充说明**(盲测时发现提示词没写清的地方)

- 只有键盘聚焦(:focus-visible)才把提示固定在色块旁;鼠标点击按钮也会触发 focus,此时保持跟随
- 提示先尝试右下,放不下时水平或垂直翻转,最后夹紧;键盘聚焦时放在色块下方,放不下放上方

**测试钩子**(根元素 `[data-form="09"]`)

- `[data-part=stage]`:预览区,提示不能出它的边界
- 3 个 `[data-part=swatch]`,带 `data-name`(颜色名)和 `data-value`(色值)
- `[role=tooltip]`:唯一的提示层

## 10 · 自绘折线图(Drawing data)

- 用户可能会说:折线自己画出来,鼠标停到哪里就解释哪里。
- 适用:趋势指标、轻量统计卡片、报告中的可交互图表。
- 试玩:查看折线绘制,悬停或拖动查看数据,Replay 重播。
- 参考实现:`assets/reference.html` 里的 `mount10`,`reference.html?sample=10` 直接打开

**提示词**

> 制作一张黑白七日趋势折线图卡片,标题 Weekly visits。用 SVG 路径按真实数据绘制,约 800ms 从左向右显示,线宽固定 2.5px,不缩放 SVG 笔画;淡灰网格提供参照。鼠标悬停或手指移动时,按横坐标选择最近的数据点,显示竖向引导线、圆点和包含日期及数值的提示,不能使用随机数模拟。提示位置限制在卡片内,避开边缘。提供可聚焦图表及左右方向键查看相邻日期,并为屏幕阅读器提供完整数据表。Replay 按钮只重播绘制,不改变数据。减少动态效果时立即显示完整折线。数据为空时显示明确空态。不要添加面积渐变、发光轨迹或只有漂亮曲线没有可读数值的装饰。

**可改项**:日期与数据、单位、线条颜色、绘制时长

**验收**

- 七个点与数据表逐一对应
- 悬停选择最近横坐标的数据点
- 提示在卡片边缘不溢出
- Replay 不改变数据,键盘能够逐日查看

**补充说明**(盲测时发现提示词没写清的地方)

- 数据表可以只给读屏器(视觉隐藏),单元格放原始整数;提示显示千分位
- 空态:数据为空时显示 No data yet,不画折线(验收脚本暂未覆盖)
- 笔画不缩放:path 加 vector-effect: non-scaling-stroke

**测试钩子**(根元素 `[data-form="10"]`)

- `[data-part=card]`:图表卡片,提示不能出它的边界
- `[data-part=chart]`:可聚焦的绘图区,也接收指针
- `path[data-part=line]`:折线
- `table`:7 行 `tbody tr`,第一格日期、第二格数值
- `[role=tooltip]`:提示
- `button[data-part=replay]`
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall