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/catalog.json

View on GitHub
{
  "name": "FORM — UI 动效词典",
  "version": 1,
  "language": "zh-CN",
  "purpose": "通过可交互结果选择效果,再把配对的 Prompt 与 HTML 参考实现一起交给 Agent。",
  "shared_direction": "暖灰背景 #f2f1ed、黑白组件、Geist 英文字体及系统中文字体、统一 1.7px 图标描边。克制弹簧,轻微超调;不使用弹跳缓动、光晕、粒子、UI 渐变。支持键盘、触摸与 prefers-reduced-motion。",
  "samples": [
    {
      "id": "01",
      "name": "连续形变按钮",
      "english": "Morphing action",
      "phrase": "按钮不要换掉,让它自己变成加载和完成状态。",
      "use_when": "提交、保存、导出等需要展示任务进度的主操作。",
      "gesture": "点击 Export file,观察加载与完成,再点击完成状态重试。",
      "result": "index.html?sample=01",
      "implementation": "mount01",
      "editable": ["按钮文字", "品牌色", "真实异步任务", "按钮尺寸"],
      "prompt": "制作一个连续形变的提交按钮。暖灰画布,黑色按钮,白色文字,Geist 字体。点击后,同一个容器从 196×58 的圆角矩形收缩为 58×58 圆形加载器;异步任务成功后伸展为 166×58 的完成按钮,显示勾选和 Done。宽度、圆角用阻尼弹簧,约 350ms 收敛,超调小于 3%;文字先淡出并短暂模糊,再显示下一状态,绝不重叠。加载期间禁用重复提交,向辅助技术报告状态。完成可点击重置。保留同一个 DOM 外壳,不用多个按钮交叉淡化伪装形变。演示可模拟约 1.2 秒任务;接入产品时绑定真实 Promise,错误必须可见且允许重试。支持触摸、Enter/Space 和减少动态效果偏好。",
      "acceptance": ["空闲、加载、完成共用同一个外壳", "连续点击不会启动多个任务", "状态文本不会重叠", "加载状态有可读反馈,成功后可以重新操作"]
    },
    {
      "id": "02",
      "name": "液体标签指示器",
      "english": "Liquid navigation",
      "phrase": "选中条像软糖,前面先走,后面再追上。",
      "use_when": "分段导航、视图切换、筛选标签。",
      "gesture": "切换三个标签,也可用左右方向键。",
      "result": "index.html?sample=02",
      "implementation": "mount02",
      "editable": ["标签数量", "文字长度", "指示器颜色", "拉伸程度"],
      "prompt": "制作一个三项分段标签控件:Overview、Activity、Insights。白色圆角底座,黑色胶囊指示器,选中文字为白色。切换时指示器的左右边缘使用两条独立弹簧:移动方向上的领先边缘先响应,尾随边缘更慢,使胶囊短暂拉长后恢复目标宽度。反向切换时交换领先边缘,快速连续切换必须从当前真实位置和速度重新定向,不能跳到上一终点。按标签实际边界测量目标,适应长短不同的文字。内容区域同步更新。采用 tablist/tab/tabpanel 语义,方向键、Home/End 可切换并移动焦点,选中状态由 aria-selected 表达。减少动态效果时立即定位。不要用 scaleX 拉伸文字,不添加光晕或弹跳。",
      "acceptance": ["指示器两边的速度明显不同", "文字宽度不同也准确对齐", "连续反向切换不中断或瞬移", "键盘焦点和选中内容保持一致"]
    },
    {
      "id": "03",
      "name": "弹性音量滑块",
      "english": "Elastic range",
      "phrase": "拖到尽头还能拽一点,松手再柔和地收回来。",
      "use_when": "音量、缩放、亮度等连续数值控制。",
      "gesture": "按住滑块拖动;越过两端后松手。",
      "result": "index.html?sample=03",
      "implementation": "mount03",
      "editable": ["最小最大值", "初始数值", "越界阻力", "数值单位"],
      "prompt": "制作一个黑白音量滑块,默认 64%,轨道约 280px。按住时数值直接由指针相对轨道的位置计算,跟手过程没有插值延迟。逻辑值始终限制在 0–100;越过端点时,滑块末端只产生有阻力的视觉延伸,距离上限约 24px,不能把逻辑值变成 110%。使用 pointer capture,使鼠标或手指离开控件仍继续拖动。释放后,从当前视觉位置和速度用阻尼弹簧回到最近合法端点,轨道随之恢复。数字跟随真实逻辑值更新。键盘方向键每次 1%,Home/End 到端点,暴露 slider 的 aria-valuenow/min/max。触摸只在滑块区域禁止滚动。减少动态效果时直接回位。不要把整个组件连同文字一起拉伸。",
      "acceptance": ["拖动时滑块与指针直接对应", "越界只影响视觉,逻辑值不超范围", "指针离开轨道后仍能完成拖动", "松手回位与键盘操作都正常"]
    },
    {
      "id": "04",
      "name": "柔性开关",
      "english": "Soft switch",
      "phrase": "开关的小圆点,移动时稍微拉长一下。",
      "use_when": "通知、自动保存、隐私等即时二元设置。",
      "gesture": "点击开关,快速来回切换。",
      "result": "index.html?sample=04",
      "implementation": "mount04",
      "editable": ["设置名称", "开启颜色", "旋钮大小", "弹簧硬度"],
      "prompt": "制作一个克制的柔性开关,用于 Quiet mode。关闭时浅灰轨道配白色旋钮,开启时黑色轨道配白色旋钮。旋钮左右边缘分别使用不同响应速度的闭式弹簧:领先边缘更快、尾随边缘更慢,产生短暂的水平拉长,再恢复圆形。关闭方向应镜像这个行为。背景颜色平滑改变,旁边文字同步反映 On/Off;开关真实布尔值在触发时立即更新。快速连续点击必须保留当前位置与速度,不能重启动画导致闪跳。用原生按钮配 role=switch、aria-checked 和可读标签,Space/Enter 可切换,触控目标至少 44px。减少动态效果时立即切换。不要给旋钮添加夸张挤压、阴影光晕或弹跳。",
      "acceptance": ["视觉、文字、aria-checked 三者一致", "左右切换都呈现方向正确的拉伸", "快速切换没有跳跃", "触控和键盘可用"]
    },
    {
      "id": "05",
      "name": "原位展开卡片",
      "english": "Expanding surface",
      "phrase": "点开后还是这张卡,只是它长出了更多内容。",
      "use_when": "详情披露、订单摘要、设置说明、项目卡片。",
      "gesture": "点击卡片右上角展开,再折叠。",
      "result": "index.html?sample=05",
      "implementation": "mount05",
      "editable": ["摘要与详情", "卡片宽度", "展开高度", "圆角"],
      "prompt": "制作一张可原位展开的项目摘要卡片。白色卡片、细灰边框、黑色文字,标题 Weekend escape,下方一句摘要。点击右上角展开按钮后,同一张卡从约 142px 高伸展到约 278px 高,展示进度、成员和下一步;用阻尼弹簧改变高度,轻微超调。内容与外壳分开控制:展开时等空间打开后再淡入并上移约 6px,折叠时内容先在约 120ms 内淡出,再收起外壳。快速反向操作要从当前高度继续。用 aria-expanded 和 aria-controls 连接按钮与详情,折叠内容不可被 Tab 聚焦或辅助技术读取。长文字能自然换行,移动端宽度不溢出。减少动态效果时立即展开。不要用 scale 拉伸整张卡,也不要替换成模态框。",
      "acceptance": ["外壳始终同一元素", "文字在高度变化中不被挤压拉伸", "收起后隐藏内容不接收焦点", "连续展开折叠没有重叠文字"]
    },
    {
      "id": "06",
      "name": "层叠通知",
      "english": "Stacked feedback",
      "phrase": "新通知压在最前面,旧的轻轻往后退。",
      "use_when": "连续保存、上传、协作操作等短反馈。",
      "gesture": "连续点击 Add notification,再关闭最上面的通知。",
      "result": "index.html?sample=06",
      "implementation": "mount06",
      "editable": ["消息内容", "最多显示条数", "层间距离", "出现方向"],
      "prompt": "制作一个最多三层可见的通知堆叠。新通知从下方约 16px 进入最前层,旧通知向上退 12px 并略缩小,最低缩放不低于 0.92,透明度逐层降低。每张通知具有稳定身份;插入或关闭时,剩余通知从当前视觉位置以阻尼弹簧重新排列。只展示最前层的完整正文和关闭操作,后层露出边缘,避免文字拥挤。新增内容通过独立的 polite live region 宣告,不能把整个堆栈反复朗读。示例采用手动关闭,最多保留三条,连续点击有明确反馈。关闭按钮具备明确标签与至少 44px 的触控区域。减少动态效果时立即排列。不要使用弹跳、光晕或每条通知都配一套不同图标。",
      "acceptance": ["连续新增时最多三条可见", "关闭前层后后层平滑接替", "后层正文和按钮不形成视觉或键盘拥挤", "新消息能被辅助技术宣告"]
    },
    {
      "id": "07",
      "name": "搜索命令面板",
      "english": "Command search",
      "phrase": "像 ⌘K 一样,打开就能输入,边打字边筛选。",
      "use_when": "全局快捷操作、跳转搜索、工具选择。",
      "gesture": "点击 Open commands,搜索、用方向键选中并回车。",
      "result": "index.html?sample=07",
      "implementation": "mount07",
      "editable": ["命令列表", "搜索范围", "快捷键", "执行动作"],
      "prompt": "制作一个紧凑的命令搜索面板。点击 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。演示执行结果用可读状态文本呈现;接入时替换成真实操作。支持移动端触摸。减少动态效果时立即开关。不要加入装饰性仪表盘或无效搜索占位。",
      "acceptance": ["打开即聚焦,关闭恢复焦点", "搜索确实过滤结果", "方向键和 Enter 执行高亮项", "无结果和 Escape 行为正确"]
    },
    {
      "id": "08",
      "name": "跟手拖动排序",
      "english": "Direct reorder",
      "phrase": "抓住一行拖走,其他行自然让出位置。",
      "use_when": "播放队列、任务顺序、导航或优先级列表。",
      "gesture": "抓住右侧拖柄上下拖动;也可用上下按钮排序。",
      "result": "index.html?sample=08",
      "implementation": "mount08",
      "editable": ["列表内容", "行高", "插槽阈值", "拖动抬升程度"],
      "prompt": "制作一个三行任务排序列表,依次为 Research、Wireframes、Prototype。通过行右侧拖柄开始拖动,使用 pointer capture;拖动项直接跟随指针的垂直位移,抬升约 1.02 倍且保持文字清晰。其余项目在拖动中心越过插槽中点时交换位置,用阻尼弹簧让出空间;只移动到明确插槽,不无限自由漂移。松手后拖动项从当前位置归位,保留稳定的项目身份,并实际更新列表顺序。提供独立的上移/下移按钮作为键盘与辅助技术替代操作,使用 live region 宣告新顺序。边界按钮禁用。触摸拖动仅在拖柄禁用页面滚动。减少动态效果时立即排位。不要只做 transform 动画而不更新逻辑顺序,不使用已弃用 aria-grabbed。",
      "acceptance": ["拖动项直接跟手", "其他行在越过中点时让位", "释放后的真实顺序与画面一致", "上下按钮可以完成同样排序"]
    },
    {
      "id": "09",
      "name": "跟随式提示",
      "english": "Following tooltip",
      "phrase": "提示轻轻跟着鼠标走,但不要挡住鼠标。",
      "use_when": "图形预览、颜色样本、画布对象的补充说明。",
      "gesture": "在色块上移动鼠标;键盘 Tab 也能查看说明。",
      "result": "index.html?sample=09",
      "implementation": "mount09",
      "editable": ["提示内容", "偏移距离", "边界留白", "跟随速度"],
      "prompt": "制作一个跟随式提示:鼠标悬停在三个黑白色块上时,展示对应颜色名称和色值。提示与指针保持约 16px 偏移,以高阻尼弹簧轻微跟随,既有柔软感又不明显拖尾。基于提示实际尺寸限制位置,接近预览区域边缘时翻转或夹紧,始终完整可读。提示设 pointer-events:none,不能抢走 hover;离开触发区域后淡出,快速跨色块时平滑更新内容。每个色块能获得键盘焦点,以 aria-describedby 关联提示;键盘聚焦时在色块旁固定定位,Escape 可隐藏。触摸点击色块可查看同样说明。减少动态效果时直接定位。保持文字清晰,不对跟随层使用模糊或 will-change,不做磁吸光标。",
      "acceptance": ["提示不遮挡指针或阻断 hover", "靠近边缘仍完整可见", "颜色名称和色值与当前色块一致", "键盘、Escape 和触摸可以查看或隐藏说明"]
    },
    {
      "id": "10",
      "name": "自绘折线图",
      "english": "Drawing data",
      "phrase": "折线自己画出来,鼠标停到哪里就解释哪里。",
      "use_when": "趋势指标、轻量统计卡片、报告中的可交互图表。",
      "gesture": "查看折线绘制,悬停或拖动查看数据,Replay 重播。",
      "result": "index.html?sample=10",
      "implementation": "mount10",
      "editable": ["日期与数据", "单位", "线条颜色", "绘制时长"],
      "prompt": "制作一张黑白七日趋势折线图卡片,标题 Weekly visits。用 SVG 路径按真实数据绘制,约 800ms 从左向右显示,线宽固定 2.5px,不缩放 SVG 笔画;淡灰网格提供参照。鼠标悬停或手指移动时,按横坐标选择最近的数据点,显示竖向引导线、圆点和包含日期及数值的提示,不能使用随机数模拟。提示位置限制在卡片内,避开边缘。提供可聚焦图表及左右方向键查看相邻日期,并为屏幕阅读器提供完整数据表。Replay 按钮只重播绘制,不改变数据。减少动态效果时立即显示完整折线。数据为空时显示明确空态。不要添加面积渐变、发光轨迹或只有漂亮曲线没有可读数值的装饰。",
      "acceptance": ["七个点与数据表逐一对应", "悬停选择最近横坐标的数据点", "提示在卡片边缘不溢出", "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