Apple HIG: Design Foundations
掌握 Apple 设计指南,打造精美应用
遵循官方《人机界面指南》,构建外观和手感原生的 Apple 应用。避免设计被拒,确保您的应用在所有平台上满足 Apple 的无障碍、布局和视觉标准。
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "Apple HIG: Design Foundations". iOS 中 17pt 文本需要什么对比度?
النتيجة المتوقعة:
对于 17pt 及以下的文本(无论权重如何),您需要至少 4.5:1 的对比度才能满足 WCAG AA 级别,这是 Apple 无障碍检查器使用的基线。对于 18pt 及以上的文本或任何大小的粗体文本,要求降至 3:1。来源:accessibility.md,'Vision' 部分。
استخدام "Apple HIG: Design Foundations". 展示如何在 SwiftUI 中使用语义系统颜色
النتيجة المتوقعة:
使用语义颜色 API,如 Color.label、Color.secondaryLabel、Color.systemBackground,而不是硬编码值。这些会自动适应浅色/深色模式和高对比度:Text('Hello').foregroundColor(.label).background(Color.systemBackground)。来源:color.md,'System colors' 部分。
استخدام "Apple HIG: Design Foundations". 如何在文本视图中支持 Dynamic Type?
النتيجة المتوقعة:
应用语义文本样式,如 .body、.headline、.subheadline,它们会根据用户的首选文本大小自动缩放:Text('Hello').font(.body)。这些支持 iOS 上从 11pt 到 23pt 的完整范围。结合 frame(maxWidth: .infinity) 和适当的布局约束以防止溢出。来源:typography.md,'Supporting Dynamic Type' 部分。
التدقيق الأمني
آمنStatic analysis detected 2676 pattern matches across 18 markdown documentation files (4647 lines). All findings are confirmed FALSE POSITIVES from legitimate documentation content: Ruby backtick notation for inline code examples (e.g., `systemRed`, `label`), hardcoded URLs linking to Apple's official developer documentation, and 'C2 keywords' that are benign terminology in accessibility/design contexts (e.g., 'control' for Switch Control, 'access' for accessibility, 'capture' for screen capture guidelines). This skill contains only static markdown reference documentation with no executable code, network operations, or security risks. Safe to publish.
درجة الجودة
ماذا يمكنك بناءه
设计无障碍 iOS 应用
通过实现 VoiceOver 标签、Dynamic Type 支持和 WCAG AA 对比度,确保您的应用符合 Apple 无障碍标准。了解如何使用无障碍检查器进行测试,并为所有交互元素提供无障碍替代方案。
实现深色模式支持
使用语义系统颜色为您的应用适配浅色和深色外观。了解如何测试两种模式下的对比度、应用鲜艳材质,并确保自定义调色板在所有外观下正常工作。
标准化应用排版
使用 Apple 的字体缩放和文本样式,确保您的文本能够随 Dynamic Type 正确缩放。了解何时使用 SF Pro 与自定义字体、如何实现字体权重层级以及行间距最佳实践。
جرّب هذه الموجهات
我正在为 iOS 设计一个背景颜色为 #007AFF、白色文本的按钮。这个组合是否无障碍?它实现了什么对比度,符合哪个 WCAG 级别?
我正在用 SwiftUI 构建表单,需要为标签、次要文本和错误状态使用正确的语义颜色。展示使用适应深色模式的系统颜色的代码模式。
当用户在无障碍设置中启用较大字体时,我的文本布局会中断。展示如何使用文本样式和 Auto Layout 构建我的 SwiftUI 视图,使其能够从 11pt 正确缩放到 23pt。
我需要与 SF Symbols 视觉外观匹配的自定义图标。符号权重、网格对齐和渲染模式的设计规范是什么?展示如何导出无缝集成的自定义符号。
أفضل الممارسات
- 在提问之前始终检查 `.claude/apple-design-context.md` 以使用现有项目上下文并避免冗余信息收集
- 在提供指导时引用具体的 HIG 基础文档,包括文件名和部分,以实现可追溯性和进一步阅读
- 尽早请求平台目标信息,因为 Apple 指南在 iOS、macOS、watchOS、tvOS 和 visionOS 之间差异很大
- 在建议设计模式时始终解释无障碍影响,包括对比度、Dynamic Type 支持和 VoiceOver 行为
تجنب
- 不要硬编码颜色值,如 RGB(0, 122, 255) - 使用语义 API,如 UIColor.systemBlue 或 Color.blue,它们会自动适应深色模式和无障碍设置
- 避免使用固定字体大小,如 16.0 - 而是使用文本样式,如 .body 或 .headline,它们会随 Dynamic Type 缩放并尊重用户的首选文本大小
- 不要仅依靠颜色来传达信息 - 始终为无障碍提供额外的视觉指示器,如形状、图标或文本标签
- 永远不要在设计期间跳过无障碍测试 - 尽早集成���障碍检查器,并在提交前验证 VoiceOver 导航、Dynamic Type 缩放和对比度