Communitygithub.com

Seenry Motion

构建、审查或研究界面动效:按压反馈、菜单、工具提示、对话框、面板、吐司提示、手风琴、选项卡、页面与共享元素过渡、滚动效果、拖拽与手势、数字与图标变化。会判断某个元素是否应动画化,然后选择工具、属性、曲线、持续时间或弹簧参数、中断与减动行为,并附带经过测试的现代CSS配方与可运行资源。同时也能研究来自Seenry参考的录制动效。

Seenry Motion 是什么?

Seenry Motion 是一项专注于界面动效构建与决策的专业技能。它提供了一套结构化的流程,指导开发者或设计师通过七个步骤来制作动效:首先判断是否该有动效,再明确动效目的,选择最经济的实现工具(例如CSS过渡、视图过渡API、Web动画API等),限制使用的属性(仅限 `translate`、`scale`、`rotate`、`opacity`、`clip-path`、`filter`),设定合适的曲线与时长或弹簧参数,处理中断与退出逻辑,最后确保支持减动模式与输入门控。该技能特别强调动效应服务于解释变化,而非单纯装饰,并提供了详细的引用表格、设计启发式检查项以及九分制评审标准(7分合格,9分达到苹果或Linear级别)。它适用于Claude Code、Cursor、Codex等AI编码代理,能够根据具体场景(如切换开关、菜单、对话框、数字变化等)生成精确的CSS或JavaScript动画方案,并附带了大量可运行的测试资产与预设模式。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ayangabryl/seenry-skills/tree/HEAD/skills/seenry-motion

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Seenry Motion 是做什么的?

动效的存在是为了解释变化:元素从何而来、输入做了什么、界面当前处于何种状态。请按以下顺序依次构建每个动画;第1步和第2步决定是否真的需要写任何代码。

做出决定,并用一句话陈述;不要提供一系列动效选项。扩展项目已有的动效令牌和组件,而不是添加一套并行的方案。

构建流程

1. 它应该动效吗? 根据频率决定。

用户看到它的频率决定
每天100+次(命令菜单、键盘快捷键、用箭头键导航列表)无动效。立即切换。
每天数十次(悬停、选项卡、开关)仅对透明度和颜色做≤150ms的动效,或不做动效
偶尔(菜单、对话框、面板、吐司提示)使用下方表格中的标准动效
罕见(引导页、首次成功、从空到满的瞬间)可以有更多个性化的表现空间

键盘触发的操作无需等待动效。如果判断为否,则直接说明,并立即执行状态变更。

2. 用一个词命名目的: 反馈、定向(从哪里来或到哪里去)、状态、连续性(避免突兀的跳跃)、解释(仅用于营销和引导)、或愉悦(仅用于极少数时刻)。没有目的,就没有动效。数据性内容绝不为风格而移动。

3. 选择最经济的工具来实现。

需求工具
悬停、按下、颜色、类或属性切换CSS过渡
挂载时进入、在 display: none 前退出、原生 <dialog> 和 popoverCSS过渡 + @starting-style + allow-discrete
高度变为 autointerpolate-size: allow-keywords,或网格 0fr → 1fr 轨道
路由变化、列表到详情、变形指示器视图过渡 API
滚动关联效果animation-timeline: view() / scroll()
程序化、可取消、无需库Web Animations (element.animate)
带有速度的弹簧、布局动画、手势、React 中的存在状态Motion (motion.dev)
完整的组件(吐司提示、抽屉、命令菜单、选择框)一个维护良好的库,参见 libraries

4. 选择属性。 仅限 translate、scale、rotate、opacity、clip-path、filter。永远不要从 scale(0) 进入:从 0.95-0.97 和不透明度 0 开始。弹窗从其触发器缩放(transform-origin 在触发器一侧);对话框从中心缩放。百分比平移(translate: 0 100%)根据元素自身大小移动。

5. 选择曲线和时长,或一个弹簧。

动效时长缓动函数
按压反馈100-160ms--ease-out
工具提示、小弹窗120-200ms--ease-out
菜单、下拉菜单、选择框150-250ms--ease-out
对话框200-250ms--ease-out
面板、抽屉350-500ms--ease-drawer
元素在屏幕上移动、变形250-400ms--ease-in-out
悬停时的颜色、背景、边框150msease
进度条、跑马灯、按住确认填充与任务等长linear

--ease-out: cubic-bezier(0.23, 1, 0.32, 1),--ease-in-out: cubic-bezier(0.77, 0, 0.175, 1),--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1)。不在界面动效中使用 ease-in:它会延迟用户正在关注的时刻。倾向于产品UI在300ms以下;更长的面板移动需要有理由。退出通常比进入快约20-30%,除非是为了保持直接操作或空间关系而需要相同的时长。对于任何用户拖拽、拨动或可能中途反转的内容,使用弹簧:Motion {type: "spring", duration: 0.5, bounce: 0.2}(产品UI中弹跳为0,趣味性UI中≤0.3),或使用 recipes 中的 CSS linear() 弹簧。

6. 规划中断和退出。 对于可逆属性变化,优先使用 CSS 过渡,因为它们会从当前值重新定向。当几何或编排需要 WAAPI 时,捕获当前渲染状态,取消或重新定向拥有的动画,并防范过时完成。第二次输入会反转或替换旧请求,而不是在其后排队。立即发布新的逻辑状态;一个独立的展示状态可能会保留一个退出的绘制。

细化中断的变化。 在适合组件的情况下使用这些检查。它们是设计启发式方法,不是保证的判断分数。尝试在进入和退出期间进行重复输入,包括间隔50-150ms的输入;在做出时序声明时记录实际时间。

  • 保持连续性和语义。 相关的选项卡、过滤器或状态可以共享一个网格单元格(display:grid,grid-area:1/1)并过渡透明度或小幅平移。将非活动内容移出焦点顺序和可访问性树;挂载并不意味着可交互。快速退出阶段(大约65-90ms)和进入阶段(120-160ms)可以作为一个起点,但不是必需的配方。仅在当前过渡允许时才卸载或隐藏;过时的完成绝不能隐藏较新的状态。显式可取消的 WAAPI 和有守卫的原生对话框退出是有效的替代方案。
  • 保持结果可理解。 避免意外的空白间隔或不可读的竞争文本。根据内容选择重叠、短交叉淡入或即时替换;整个标签端点淡出可能比让文本穿过艺术作品更安全。在动效不可用或减少时,保留适当的静态提示。检查实际可读性,而不是将不透明度阈值作为证据。
  • 移动的东西只有一个副本。 当标题、头像或封面移动到新位置时,避免可见的重复绘制。隐藏目标直到移动物着陆,然后移除临时副本。跟踪文本与艺术作品和移动外壳;未裁剪的端点并不能证明路径可读。
  • 标签与其结果一致。 像“标记已支付”变成“已支付”这样的标签遵循与其结果相同的已接受应用状态。在有用时预留其空间,并防止过时文本或可聚焦的重复标签。不要仅仅为了完成装饰而延迟真正的成功状态。
  • 序列可以被取消。 打字演示、分步展示和重放共享一个拥有者来处理待定步骤。暂停、反转和新输入会取消过时工作,并从当前状态重新定向可见动效。过时的超时必须不会恢复已暂停的序列或覆盖较新的内容。
  • 释放完成的动画。 通过 CSS 或已提交的样式建立稳定状态,然后在适当时释放有限的拥有 WAAPI 动画。fill:forwards 绝不能持续覆盖后续状态变化。在交互稳定后检查意外动画,同时允许有目的的持续加载指示器直到其工作结束。
  • 每次移动解释一个关系。 菜单从其触发器生长,面板从其边缘扩展,相关内容与导航一致移动。使用上述时长范围作为起点;保持感知响应立即,并为更长的移动提供理由。测试中断和减动,而不是将固定时长视为质量证明。

达到9分。 在动效评审中,7分表示正确但普通,8分表示明显高级,9分则达到苹果或Linear级别的卓越。反复尝试通常停滞在7-8分,因为几个相同的原因。在花费一轮时间之前处理所有这些原因:

  • 一次只处理一个组件。 单独评判每个组件,使用 --labels "<Row>" 直到它达到9分,并保留每个组件的最佳版本。目录的整体分数取决于其最弱的行,因此一次修补许多行永远不会提升它,并且降低某行的更改即使评审建议也会被回退。
  • 应用每一个修复,而不仅仅是标题性的那个。 小型重复项目(悬停、按下和关闭控件反馈)使得 states 得分一轮又一轮地卡在7分。--prev <last motion.json> 列出未提升的指标和要求再次修复的交互;check.mjs 会自动传递它。
  • 修复后再次出现的问题是结构性的。 重新定时无法修复交叉的路径。共享元素在状态之间保持其相对排列:封面下方的标题在详情视图中仍保持在封面下方,因此两者不会穿过彼此。
  • 没有空白帧。 在每个拍摄的时刻(30-320ms),变化的区域显示真实内容。外壳在生长时携带其内容;流式回答从其第一个单词开始生长。绝不显示空白的回答框或等待然后消失的骨架屏。
  • 每个组件一个精心构思的点子。 持续的内容移动,新内容由其起因产生。一个淡出、4px平移和标签交换只能得7分。
  • 从何处打开,就在何处关闭。 从控件打开的表面积从同一位置关闭:控件变成(或在原地被替换为)其关闭按钮,因此手无需移动。它不需要保持相同的颜色;它保持位置和大小。
  • 单次运行不是分数。 一次评审运行(本身是三次的中位数)在代码不变的情况下改变一分。只有当两次独立运行都达到9分时才接受9分,并在相同的运行次数下比较版本。

7. 同时实现减动和输入门控。 在 prefers-reduced-motion: reduce 下,移除移动、视差、模糊和循环;保留有助于理解的简短透明度变化。使用 @media (hover: hover) and (pointer: fine) 门控悬停动效。每个动画化的状态变化也留下一个静态提示(标签、图标、颜色),以备动效不运行时使用。

配方

从 recipes 开始,获取按压反馈、菜单和弹窗、工具提示、对话框、面板、吐司提示、手风琴、交错进入、选项卡指示器、页面和共享元素过渡、滚动揭示、图标交换、数字变化、按住确认、拖拽关闭(带速度投影和橡皮筋效果)、交叉淡入遮罩、主题切换和首次渲染抑制。这些原生CSS配方已在Chromium中由包测试验证。

可运行资源

请求的更改聚焦的路径
动作菜单或简短状态标签原始 action menu、status switch 和 product transitions。如果菜单被要求动画化打开和关闭,则通过关闭阶段保留其表面;根据条件在关闭时卸载会跳过该阶段。对于状态过渡,在预留槽中移动文本;仅纯文本替换或点颜色更改是不完整的。应用程序拥有实际操作。
流内展开或变化几何形状原始 expanding card、geometry helper 和 surface patterns。保留焦点并从当前几何形状重新定向。
聚焦的模态任务原始 modal surface 和 surface patterns。对顶层和焦点行为使用原生对话框;允许退出在关闭前完成,并使反转取消待定关闭。
变化的数字或图标Number transitions 和 adapters。对于小整数计数,优先使用原始 count-pop 帮助函数,而不是重建数字语义。保留一个真实的可访问值;不要隐藏每个数字并将 aria-label 放在纯 <strong> 上。数字过渡需要每个位置的动效;保持单位锚定。
实时语音输入或输出原始 voice presence 接受应用程序拥有的状态和归一化的音频电平。在 DOM 中保留控件和公告;生成的演示信号不是麦克风活动。
加载或过程存在状态原始 signal field、boundary trace 和 loading patterns。动画时间不是进度。
解码图像或表现性材质原始 image reveal、reflective solid and rim surfaces、pointer tilt、surface effects 和 expressive effects。在替换内容加载时保留有用内容;仅在有目的的情况下使用反射和倾斜。
设计任何新的交互组件(简介、状态图、动效分数、输入契约、检查清单)Interaction craft
吐司提示或横幅堆栈Feedback patterns 和原始 notification reducer。在退出前从活动状态中移除溢出;测试三个项目堆栈中的第四个事件。
偶尔完成的里程碑原始 confirmation burst。首先在应用状态中记录成功,然后播放有限装饰;稳定结果必须在其清除后保持可见。
选中的选项卡或有顺序的页面更改原始 selection surface 用于共享高亮,以及 directional stage 用于相关视图;应用程序拥有选择、面板、路由和历史。对其他结构使用 navigation patterns。
滚动或协调系统Scroll choreography、worked scores、system choreography 和 motion index。

仅选择本次更改所需的指南和帮助函数。捆绑的原始资产是可重用的起点,不是命名源组件的自动替代品或对其保真度的证明。保留任何复制第三方运行时的许可证;原始的 Seenry 资产使用仓库的 MIT 许可证。

绝不发布

绝不改为
每天100+次或键盘驱动操作上的动效立即更改
transition: all命名具体属性

相关技能