用途:为 Apple 平台设计原生感的应用 UI,并统一标准组件库。适用于布局 iOS/iPadOS/macOS/visionOS/watchOS 的屏幕及其外壳,以及选择或标准化组件(导航栏、列表样式、按钮层级、表单、弹窗、空状态)。
核心规则:主要控件放在易触达位置——iPhone 上置于底部(标签栏 49pt 加安全区),优先使用平台原生栏与表单模式而非自造外壳。表单使用 detents(medium/large/custom)并带 grabber;模态用于聚焦任务而非导航。匹配各平台输入模型:iOS 触控(44pt 目标)、macOS 指针精度加全局菜单栏、visionOS 注视(60pt 目标)加眼/捏合、watchOS 数码表冠与可一瞥性。使用文档化的按钮层级(borderedProminent → bordered → borderless)与合适的列表样式(plain / grouped / insetGrouped);始终设计空状态(ContentUnavailableView)。iOS 26 / macOS Tahoe 将控件重塑为 Liquid Glass(悬浮、半透明),详见 apple-design-materials。
参考文件:references/ios-ipados.md 用于主屏/锁屏/控制界面、导航/标签/表单度量、iOS 26 玻璃、iPad 窗口化;references/macos.md 用于窗口、红绿灯按钮、工具栏、侧边栏、菜单栏、vibrancy、Tahoe 玻璃;references/visionos-watchos.md 用于空间窗口/装饰/沉浸与 watchOS 复杂功能/表冠/一瞥;references/app-component-anatomy.md 用于完整 UIKit/SwiftUI 组件目录及 iOS 列表/开关/分段控件的 CSS 模拟。
常见错误:控件仅置顶部而超出拇指范围;用错误度量伪造原生外壳;在指针系统上使用触控尺寸目标(或反之);模态滥用;缺少空状态;visionOS 中注视目标过小或引发晕动;表盘过于密集。
相关:这些表面的玻璃效果见 apple-design-materials,动效/手势见 apple-design-motion,间距/字体见 apple-design-foundations。