Apple Human Interface Guidelines Writing

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 元素

手势

错误消息

原则

• 解释发生了什么
• 说明如何解决
• 主动语态
• 避免责备

示例

本地化注意

空间

• 某些语言需要多30%空间
• 避免长无间断字符串

RTL

• 自动翻转
• 使用系统元素

文化

• 避免俚语
• 避免文化特定引用

Android 适配

字符串资源

<!-- strings.xml -->
<string name="welcome">Welcome!</string>
<string name="enter_password">Enter your password</string>
<string name="delete_confirm">Delete this item?</string>
<string name="loading">Loading…</string>
<string name="error_generic">Something went wrong. Please try again.</string>

格式化字符串

<string name="welcome_user">Welcome, %1$s!</string>
<string name="item_count">%1$d items selected</string>

复数形式

<plurals name="item_count">
    <item quantity="one">%d item</item>
    <item quantity="other">%d items</item>
</plurals>

按钮文字

<!-- 使用动词 -->
<string name="action_done">Done</string>
<string name="action_cancel">Cancel</string>
<string name="action_delete">Delete</string>
<string name="action_edit">Edit</string>
<string name="action_save">Save</string>

避免

<!-- 避免 -->
<string name="error_occurred">An error has occurred.</string>

<!-- 使用 -->
<string name="error_generic">Something went wrong.</string>

大小写应用

<!-- 按钮：首字母大写 -->
<string name="btn_submit">Submit</string>
<string name="btn_cancel">Cancel</string>

<!-- 标签：句式大小写 -->
<string name="label_username">Username</string>
<string name="label_password">Password</string>

<!-- 标题：标题大小写 -->
<string name="title_settings">Settings</string>
<string name="title_profile">Profile</string>

占位符

<!-- 输入框提示 -->
<string name="hint_email">Email address</string>
<string name="hint_password">Password</string>
<string name="hint_search">Search</string>

辅助功能

<!-- ContentDescription 用于图片 -->
<ImageView
    android:src="@drawable/ic_menu"
    android:contentDescription="@string/menu" />

<!-- LabelFor 用于输入框 -->
<TextView
    android:id="@+id/label_email"
    android:text="@string/label_email"
    android:labelFor="@+id/input_email" />