apple-human-interface-guidelines-writinglisted
Install: claude install-skill OPN48/skills-apple-human-interface-guidelines
# iOS Writing - 写作指南
基于 Apple Human Interface Guidelines 的界面写作规范。
## 核心原则
### 简洁
- 快速切入要点
- 使用短句和常用词
- 避免不必要的词(the, a, an, that)
### 友好语气
- 就像与用户对话
- 使用缩写
- 避免术语和技术缩写
- 界面中避免"please"(除错误消息外)
### 主动语态
- 更清晰直接
- 错误消息尤其重要
### 直接称呼
- 使用"你"和"你的"
- 更个人化
### 避免 condescension
- 避免 simply, just, obviously, merely
- 不要让人感到被催促或愚蠢
### 一致性
- 相同概念使用相同词
- 帮助用户建立心智模型
---
## 大小写规则
### 句式大小写 (Sentence Case)
用于大多数UI文本:
- 正文
- 标签
- Tab名称
- 按钮标签
- 菜单项
- 工具提示
### 标题大小写 (Title Case)
用于:
- 窗口标题
- 导航栏标题
- Table View Section Headers
- 一些大型字体处理
- 专有名词(包括应用名称)
### 按钮大小写
- 首字母大写,所有主要词大写
- 不大写介词(at, for, by, from, in, of, on, to, up, as)
- 除非是第一个或最后一个词
---
## 常见术语
### UI 元素
| 元素 | 术语 |
|------|------|
| Action sheet | Alert |
| Activity view | - |
| Alert | Alert |
| Button | 按钮 |
| Menu | 菜单 |
| Navigation bar | Navigation Bar |
| Search bar | Search Bar |
| Tab bar | Tab Bar |
| Table view | Table View |
| Text field | Text Field |
| Toolbar | Toolbar |
| Window | Window |
### 手势
| 手势 | 术语 |
|------|------|
| 点击 | Tap |
| 长按 | Touch and hold / Long press |
| 滑动 | Swipe, Swipe up/down/left/right |
| 滚动 | Scroll up/down/left/right |
| 拖动滑块 | Drag the slider |
| 缩放 | Pinch to zoom |
| 旋转 | Rotate |
---
## 错误消息
### 原则
- 解释发生了什么
- 说明如何解决
- 主动语态
- 避免责备
### 示例
| 不好的 | 好的 |
|--------|------|
| Invalid email address. | Enter an email address in the format: name@example.com. |
---
## 本地化注意
### 空间
- 某些语言需要多30%空间
- 避免长无间断字符串
### RTL
- 自动翻转
- 使用系统元素
### 文化
- 避免俚语
- 避免文化特定引用