SuperAPI AI 工具集

swiftui-liquid-glass

设计与创作

查看项目

更新于 10-15 21:49

技能介绍

用途:以平台原生玻璃系统为依据,决定 Liquid Glass 应出现的位置、相关表面如何分组,以及旧系统如何保留清晰回退;不负责功能状态或导航架构。

适用:glassEffect、GlassEffectContainer、玻璃按钮样式、glassEffectID、交互式玻璃、形状与色调一致性,以及 iOS/macOS 可用性处理;也用于审查与当前平台设计冲突的自定义工具栏、侧边栏、卡片、标签或操作表面。

用法:先确认当前平台 API、部署目标与可用性;检查现有层级、材质、工具栏、控件、背景与交互模型;分类任务后阅读 references/glass-composition-and-fallbacks.md 与 references/review-and-validation.md。优先使用原生控件、系统材质和标准工具栏,仅在布局与视觉修饰之后应用玻璃效果;GlassEffectContainer 只用于确实相关且相邻的玻璃元素;glassEffectID 与命名空间仅在层级变化且形变关系更清晰时使用。对版本敏感 API 做门控,并提供有意的非玻璃回退。

验证:在浅色与深色、紧凑与常规窗口、减弱动态效果与无障碍设置、键盘/指针交互、最旧支持系统回退下验证;使用 OS 27 beta 工具栏时另做溢出与可见性验证。

限制:不要用自定义模糊替代原生 API;不要让整屏、侧边栏或滚动容器默认玻璃化;不要在静态标签上用交互式玻璃或把玻璃按钮样式用于非操作;未保留语义操作与无障碍行为前不得声称回退可接受。相关职责可交予 swiftui-app-architecture-workflow、swiftui-animation-workflow、apple-ui-accessibility-workflow、xcode-build-run-workflow。官方文档与部署目标冲突或需要非系统视觉语言时停止。