[ PROMPT_NODE_23376 ]
platform-ios
[ SKILL_DOCUMENTATION ]
# iOS 平台指南
> 人机交互指南 (HIG) 核心要素、iOS 设计惯例、SF Pro 字体排版及原生交互模式。
> **在为 iPhone/iPad 构建应用时请阅读此文件。**
---
## 1. 人机交互指南哲学
### Apple 核心设计原则
清晰 (CLARITY):
├── 文本在任何尺寸下都易读
├── 图标精确且清晰
├── 修饰微妙且恰当
└── 以功能为核心驱动设计
尊重 (DEFERENCE):
├── UI 帮助用户理解和交互
├── 内容填满屏幕
├── UI 绝不与内容竞争
└── 半透明暗示更多内容
深度 (DEPTH):
├── 独特的视觉层级传达结构
├── 过渡提供深度感
├── 触摸揭示功能
└── 内容置于 UI 之上
### iOS 设计价值观
| 价值 | 实现方式 |
|-------|----------------|
| **审美完整性** | 设计匹配功能 (游戏 ≠ 生产力工具) |
| **一致性** | 使用系统控件,熟悉模式 |
| **直接操作** | 触摸直接影响内容 |
| **反馈** | 操作得到确认 |
| **隐喻** | 现实世界的类比辅助理解 |
| **用户控制** | 用户发起操作,可取消 |
---
## 2. iOS 排版
### SF Pro 字体家族
iOS 系统字体:
├── SF Pro Text: 正文 (< 20pt)
├── SF Pro Display: 大标题 (≥ 20pt)
├── SF Pro Rounded: 友好场景
├── SF Mono: 代码、表格数据
└── SF Compact: Apple Watch、小屏幕
### iOS 类型比例 (动态类型)
| 样式 | 默认大小 | 字重 | 用途 |
|-------|--------------|--------|-------|
| **Large Title** | 34pt | 粗体 | 导航栏 (滚动折叠) |
| **Title 1** | 28pt | 粗体 | 页面标题 |
| **Title 2** | 22pt | 粗体 | 章节标题 |
| **Title 3** | 20pt | 半粗体 | 子章节标题 |
| **Headline** | 17pt | 半粗体 | 强调正文 |
| **Body** | 17pt | 常规 | 主要内容 |
| **Callout** | 16pt | 常规 | 次要内容 |
| **Subhead** | 15pt | 常规 | 三级内容 |
| **Footnote** | 13pt | 常规 | 标注、时间戳 |
| **Caption 1** | 12pt | 常规 | 注释 |
| **Caption 2** | 11pt | 常规 | 细则 |
### 动态类型支持 (强制)
swift
// ❌ 错误: 固定字体大小
Text("Hello")
.font(.system(size: 17))
// ✅ 正确: 动态类型
Text("Hello")
.font(.body) // 随用户设置缩放
// React Native 等效写法
// ❌ 固定
// 使用动态缩放系统