iOS人机界面指南（HIG）详解：原生应用设计原则、交互模式与可访问性标准

ios-hig by johnrogers/claude-swift-engineering

147 周安装量

190 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/johnrogers/claude-swift-engineering --skill ios-hig

iOS Swift 用户体验

🇨🇳中文介绍

iOS 人机界面指南

Apple 的人机界面指南定义了视觉语言、交互模式和可访问性标准，使 iOS 应用具有原生感和直观性。核心原则：通过深思熟虑的设计实现清晰度和一致性。

参考文件加载指南

只要内容有被需要的可能性，无论多小，都应始终加载参考文件。 拥有上下文总比错过某个模式或犯错误要好。

参考文件	何时加载
交互	触摸目标、导航、布局、层级或手势模式
内容	空状态、撰写文案、排版或占位符文本
视觉设计	颜色、材质、对比度、深色模式或 SF Symbols
可访问性	VoiceOver、动态字体、减弱动态效果或可访问性标签

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

🇺🇸English

iOS Human Interface Guidelines

Apple's Human Interface Guidelines define the visual language, interaction patterns, and accessibility standards that make iOS apps feel native and intuitive. The core principle: clarity and consistency through thoughtful design.

Reference Loading Guide

ALWAYS load reference files if there is even a small chance the content may be required. It's better to have the context than to miss a pattern or make a mistake.

Reference	Load When
Interaction	Touch targets, navigation, layout, hierarchy, or gesture patterns
Content	Empty states, writing copy, typography, or placeholder text
Visual Design	Colors, materials, contrast, dark mode, or SF Symbols
Accessibility	VoiceOver, Dynamic Type, Reduce Motion, or accessibility labels
Feedback	Animations, haptics, loading states, or error messages
Performance	Responsiveness, system components, or app launch
Privacy	Permission requests, data handling, or privacy-sensitive APIs

Common Mistakes

Touch targets smaller than 44x44 points — Buttons and interactive elements must be at least 44x44 points (iOS) to accommodate thumbs. Smaller targets cause frustrated users and accessibility failures.
Ignoring Dynamic Type constraints — Text with fixed sizes doesn't respect user accessibility settings. Use Dynamic Type sizes, test with Large or Extra Large settings, and avoid hardcoded font sizes.
Insufficient color contrast in dark mode — Colors that work in light mode may fail accessibility in dark mode. Test with Reduce Contrast accessibility setting enabled for both modes.
Over-animating transitions — Animations that feel smooth at 60fps can trigger motion sickness in users with vestibular issues. Respect Reduce Motion settings and keep animations under 300ms.
Missing VoiceOver labels on custom controls — Custom buttons, toggles, or interactive views need .accessibilityLabel() and .accessibilityHint() or they're completely unusable to screen reader users.
Haptic overuse — Every action does NOT need haptic feedback. Reserve haptics for confirmations (purchase, critical action) and errors. Excessive haptics are annoying and drain battery.

Weekly Installs

141

Repository

johnrogers/clau…ineering

GitHub Stars

176

First Seen

Jan 23, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode125

codex122

gemini-cli114

claude-code114

github-copilot112

cursor110