其他
在 Apple 应用中选择和配置内容展示组件(图表…
当需要为 Apple 平台应用挑选或配置内容展示类组件(图表、集合、图像、网页、分享等)并满足 HIG 规范时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 47/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 85/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 47/100 ×0.15
适用场景
在 Apple 应用中选择和配置内容展示通用
解决思路
- 先检查 `.claude/apple-design-context.md` 是否存在,复用已有上下文,只询问尚未覆盖的信息。
- 遵循关键原则:让内容组件适配不同尺寸与上下文(屏幕尺寸、方向、多任务),使用 Auto Layout 和 size classes。
- 确保内容可访问:图表提供 audio graph 支持,图像提供 alt text,集合设置正确的 VoiceOver 导航顺序,所有内容组件都提供标签和描述。
- 维持视觉层级:通过间距、尺寸和分组建立清晰的信息层级,让主要内容在视觉上突出。
- 优先使用系统组件:在自建之前先评估 UICollectionView、SwiftUI Charts、WKWebView,系统组件自带无障碍和平台适配。
- 尊重平台惯例:tvOS 上的集合使用带视差的大 Lockup,iOS 上使用紧凑 cell 和触摸目标,visionOS 上内容获得深度和悬停效果。
- 处理空状态:显示有意义的空状态并给出如何填充内容的指引,而不是空白屏幕。
- 针对性能优化:对大数据集使用懒加载、cell 复用、分页和预取。
- 按内容需求选择组件:可视化定量数据用 Charts(Swift Charts,iOS 16+、macOS 13+、watchOS 9+);浏览网格或列表用 Collection View(复杂排布用 compositional layout);展示单张图像用 Image View(支持宽高比适配并提供无障碍描述);通过拖拽或浏览选择图像用 Image Well(主要用于 macOS,iOS 用 image picker);选择颜色用 Color Well(触发系统取色器,macOS、iOS 14+);内联展示网页内容用 Web View(WKWebView),外部浏览用 SFSafariViewController;分享内容到其他应用用 Activity View(系统分享面板,可配置活动类型);内容卡片(图像+文字)用 Lockup(主要用于 tvOS,可适配其他平台)。
- 按输出格式给出结果:1)组件推荐及理由,并引用相关 HIG 参考文件;2)配置指导——关键属性和设置;3)推荐组件的无障碍要求;4)目标平台相关的注意事项。
- 在给出建议前先询问:内容类型(定量数据、图像、网页内容、可浏览集合、分享操作?)、目标平台、内容是静态还是动态、内容量级(少量 vs 成百上千,会影响组件选择和优化)。
- 参考相关技能:hig-foundations(颜色、排版、无障碍、图像指南)、hig-patterns(数据可视化、分享、加载模式)、hig-components-layout(承载内容的结构容器如 scroll view、list、split view)、hig-platforms(平台特定组件行为,如 tvOS 的 lockup、macOS 的 web view)。
适用边界 · 注意事项
- 非 Apple 平台或非 Apple HIG 相关的界面设计场景。
- 只需要底层布局容器(scroll view、list、split view)而非内容展示组件时,应改用 hig-components-layout。
- 只需要颜色、排版、无障碍或图像基础规范时,应改用 hig-foundations。