SuperAPI AI 工具集

swiftui-animation-match

设计与创作

查看项目

更新于 10-15 22:34

技能介绍

用途:将“保存应该更有满足感”“列表加载时太无聊”这类模糊的交互愿望,转化为具体的 SwiftUI 动画模式,或转化为刻意使用系统既有动画的决定。它是匹配器而非片段堆砌,核心价值在于判断:先命名交互时刻,检查系统免费提供的能力,再决定是否需要引入自定义动效。

主要能力:提供时刻分类法与系统优先检查清单;按使用场景选择目录,涵盖等待状态、真实百分比进度、操作反馈与确认、开关切换、卡片与手势浏览、文字与主视觉、输入框外观、揭示与品牌惊喜、Metal 着色器效果。目录条目按交互时刻分组,包含关键词、源码路径、技术摘要与改编说明。

使用方式:先阅读 references/matching-playbook.md 命名时刻;若系统能力(Liquid Glass 外观、.symbolEffect、弹簧动画、.contentTransition、缩放导航转场、.sensoryFeedback)已覆盖该时刻,则优先使用并停止;若确需自定义动效,再按交互模式与关键词检索目录,不要按动画名称检索。改编而非粘贴,每个目录条目都有改编注意事项与检查清单(替换依赖、现代化旧模式、支持减弱动态效果)。在 Previews 或模拟器中构建并观察,动效无法仅凭代码判断。

限制与约束:每屏最多一个标志性动效;高频交互使用细微短促动画或系统默认;不要重新皮肤化已自带良好动画的系统界面(标签栏、工具栏、表单、Liquid Glass 表面);尊重“减弱动态效果”;保持单一动效词汇。改编时保留承重几何,现代化管线:Timer 状态机改为 .phaseAnimator、.keyframeAnimator、withAnimation 完成回调或 Task.sleep;UIKit 触感包装改为 .sensoryFeedback;硬编码屏幕边界改为 GeometryReader;演示颜色字体替换为设计令牌;伪造进度改为真实异步工作。该技能可通过添加新动画仓库扩展,配方见 references/adding-a-source.md。