SuperAPI AI 工具集

swiftui-atomic-design

编程与开发

查看项目

更新于 10-16 05:58

技能介绍

SwiftUI Atomic Design 是一套围绕 SwiftUI 的组件构建指导,基于 Brad Frost 的原子设计方法论。SwiftUI 声明式、可组合的视图架构与该方法论天然契合,整体层级由简单到复杂为:设计令牌(Design Tokens)→ 原子(Atoms)→ 分子(Molecules)→ 有机体(Organisms)→ 模板(Templates)→ 页面(Pages)。每个层级只组合其下一层级,设计令牌为所有层级提供视觉基础,而明确组件应归属哪个层级,是该系统具备可扩展性、一致性与可维护性的关键。

设计令牌:视觉基础 设计令牌是所有视觉属性(颜色、字体、间距)的集中真实来源,位于原子之下,所有组件引用令牌而非硬编码数值,从而保证整个设计系统的一致性,并让品牌换色、暗色模式、无障碍等大范围视觉修改可通过单点更新完成。常见令牌类别包括颜色、字体(字族、字号、字重)、间距(外边距、内边距)、圆角、阴影与层级、动画时长、透明度值。资料中给出了令牌示例代码,其中包含 Colors、Typography、Spacing(xs/sm/md/lg/xl)与 Radius(sm/md/lg)等结构。

主题与定制 令牌与 SwiftUI 的 Environment 系统结合可实现运行时主题切换。资料示例定义了 AppTheme(含 primaryColor、secondaryColor、backgroundColor、textColor,并提供 light 与 dark 两种变体),通过 EnvironmentKey(AppThemeKey)与 EnvironmentValues 扩展暴露 appTheme,再用 ViewModifier(ThemedModifier)与 View 扩展方法 themed(_:) 将主题注入视图层级。组件从 @Environment(.appTheme) 读取主题,而非硬编码颜色,使整个 UI 可切换主题。

原子:单一职责的 UI 基元 原子是最小且有意义的 UI 元素,只做一件事,不感知自身所处上下文,所有视觉属性均引用设计令牌,绝不硬编码颜色、字体或间距。资料给出的原子判定标准包括:呈现单一视觉概念(如徽章、图标、分隔线、标签、按钮);只接受原始/值类型输入(String、Color、Bool、CGFloat、枚举);不含业务逻辑,纯展示;除主题令牌外不读取 Environment 或 store;所有视觉值引用设计令牌。SwiftUI 中的常见模式为小型结构体(通常 10–30 行)、用计算属性表达样式变体、使用比例尺寸(如 size * 0.5)使原子自然缩放。示例原子包括 IconBadge、StatePill、PrimaryButton、TitleText。常见原子有徽章、胶囊标签、分隔线、图标包装器、字符计数器、纯文本区块标题、卡片背景、简单标签、主/次按钮、文本框包装器等。

分子:原子的功能性组合 分子将 2–3 个原子(或原子级元素)组合为一个服务于单一用户目的的单元,是设计系统的骨干,形成应用中反复出现的可复用模式。关键判断是:这种组合是否会在多处出现。资料给出的分子判定标准包括:将原子组合为有意义的组(图标 + 标签 + 值);服务一个面向用户的功能(展示信息、触发操作、显示状态);可接受闭包用于操作,但自身不管理状态;可接受 @Binding 实现双向数据流(如文本框);可接受领域类型以简化 API,但视图本身仍保持展示性质。示例分子包括 InfoRow、QuickActionCard、SearchBar。常见分子有信息行、带标签的操作按钮、搜索栏、带校验的表单字段、统计卡片、选项/开关行、提示视图、带标签的输入框等。

有机体:复杂、自包含的 UI 区块 有机体是界面中一个可独立存在的独特区块,将多个分子(和原子)组合为内聚单元,构成 UI 的重要部分,如登录表单、导航栏、指标面板。这一层级开始引入 @ViewBuilder 内容插槽和区块级结构。资料给出的有机体判定标准包括:代表视觉上独特的区域(区块、卡片组、工具栏、表单);将多个分子组合成布局;可使用 @ViewBuilder 注入内容;可读取 @Environment 获取上下文数据;可管理局部 UI 状态(如展开/折叠、选中的 @State)。示例有机体包括 ContentSection(可折叠内容区块)与 LoginForm(登录表单)。常见有机体有内容区块、表单组、导航栏、卡片列表、详情面板、指标面板、分组设置、登录表单等。

模板:页面级布局骨架 模板定义有机体在屏幕上的空间排布,是骨架——知道各元素放在哪里,但不含具体数据。模板大量使用泛型与 @ViewBuilder,并处理页面级关注点,如加载状态、空状态和错误状态。资料给出的模板判定标准包括:定义整体页面结构(ScrollView、导航、工具栏);使用泛型视图参数安排有机体级插槽;处理页面级关注点:加载、空、错误状态;不包含具体数据(这是页面的职责)。示例模板包括 DetailPageTemplate(含 header、content、actions 插槽与 isLoading)与 MainLayout(导航栏加内容区)。

页面:填充真实数据的模板 页面是模板的具体实例,接入真实数据与业务逻辑,@Observable 对象、@Environment 与导航都发生在这里。页面是用户实际交互的对象。资料中该部分内容在“assemble t”处截断,页面层级的完整说明暂未提供。

适用场景 该指导适用于希望以原子设计方法论组织 SwiftUI 组件、建立可复用 UI 系统、统一视觉规范并支持主题切换的 iOS/macOS 等 Apple 平台应用开发场景,尤其适合需要长期维护与多人协作的界面代码库。

限制 资料未提供关于安装方式、依赖要求、平台版本支持、性能数据或收费信息的说明,这些内容暂未提供。