关于
Apple 人机界面指南中内容展示组件的设计规范
name: hig-components-content description: Apple 人机界面指南中的内容展示组件。 risk: unknown source: community date_added: '2026-02-27'
Apple HIG：内容组件
在提问之前，请先检查 .claude/apple-design-context.md。使用现有上下文，仅询问尚未涵盖的信息。
核心原则
-
适配不同尺寸和上下文。 内容组件必须在不同屏幕尺寸、方向和多任务配置下正常工作。使用 Auto Layout 和 size classes。
-
确保内容可访问。 图表需要音频图形支持。图片需要替代文本。集合需要正确的 VoiceOver 导航顺序。所有内容组件都需要标签和描述。
-
保持视觉层次。 使用间距、尺寸和分组来建立清晰的信息层次。主要内容应在视觉上突出。
-
优先使用系统组件。 在构建自定义组件之前，先评估 UICollectionView、SwiftUI Charts、WKWebView。系统组件自带无障碍功能和平台适配。
-
遵循平台惯例。 tvOS 上的集合使用带视差效果的大型锁定视图。iOS 上的相同集合使用紧凑的单元格和触摸目标。在 visionOS 上，内容获得深度和悬停效果。
-
处理空状态。 显示有意义的空状态并提供如何填充内容的指引，而不是空白屏幕。
-
优化性能。 对大型数据集使用懒加载、单元格复用、分页和预取。
参考索引
| 参考 | 主题 | 关键内容 | |---|---|---| | charts.md | 图表 | Swift Charts、柱状/折线/面积/散点标记、图表无障碍、音频图形 | | collections.md | 集合 | 网格/列表布局、组合布局、选择、重排序、可差异化数据源 | | image-views.md | 图片视图 | 宽高比处理、内容模式、SF Symbol 图片、无障碍 | | image-wells.md | 图片井 | 拖放图片选择、macOS 专用、占位内容 | | color-wells.md | 颜色井 | 颜色选择 UI、系统颜色选择器、自定义颜色空间 | | web-views.md | Web 视图 | WKWebView、SFSafariViewController、导航控件、内容限制 | | activity-views.md | 活动视图 | 分享面板、活动项目、自定义活动、操作扩展 | | lockups.md | 锁定视图 | 图片+文本元素、tvOS 卡片布局、焦点效果、货架布局 |
组件选择指南
| 内容需求 | 推荐组件 | 平台说明 | |---|---|---| | 可视化定量数据 | 图表（Swift Charts） | iOS 16+、macOS 13+、watchOS 9+ | | 浏览网格或列表项目 | Collection View | 组合布局适用于复杂排列 | | 显示单张图片 | Image View | 支持宽高比适配；提供无障碍描述 | | 通过拖放或浏览选择图片 | Image Well | 主要用于 macOS；iOS 上使用图片选择器 | | 选择颜色 | Color Well | 触发系统颜色选择器；macOS、iOS 14+ | | 内联显示网页内容 | Web View（WKWebView） | 外部浏览使用 SFSafariViewController | | 将内容分享到其他应用 | Activity View | 系统分享面板，可配置活动类型 | | 内容卡片（图片+文本） | Lockup | 主要用于 tvOS；可适配其他平台 |
输出格式
- 组件推荐及理由，引用相关的 HIG 参考文件。
- 配置指南 -- 关键属性和设置。
- 无障碍要求 -- 推荐组件的无障碍需求。
- 平台特定说明 -- 针对目标平台的注意事项。
需要询问的问题
- 什么类型的内容？（定量数据、图片、网页内容、可浏览集合、分享操作？）
- 哪些平台？
- 静态还是动态内容？
- 内容量多大？（少量项目 vs 数百/数千项会影响组件选择和优化。）
相关技能
- hig-foundations -- 颜色、排版、无障碍和图片指南
- hig-patterns -- 数据可视化、分享和加载模式
- hig-components-layout -- 承载内容的结构容器（滚动视图、列表、分栏视图）
- hig-platforms -- 平台特定的组件行为（tvOS 上的锁定视图、macOS 上的 Web 视图）
由 Raintree Technology 构建 · 更多开发者工具
何时使用
当任务明确匹配上述概述中描述的工作流程或操作时，适用此技能。
限制
- 仅在任务明确匹配上述范围时使用此技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果所需的输入、权限、安全边界或成功标准不明确，请停下来寻求澄清。