5.1 按钮与菜单描述
本节规范了技术文档中用户界面按钮、菜单及其他控件的描述方式。
R-090
必须
使用标准 UI 动作动词
描述用户界面操作时,必须使用标准的 UI 动作动词。不同的操作类型有对应的专用动词,不得随意替换或混用。例如,用「单击」而非「点一下」;用「选择」而非「选取」。标准动词的使用可确保文档的一致性和专业性。
UI 动作动词对照表
| 中文动词 | 英文对应 | 使用场景 | 避免使用 |
|---|---|---|---|
| 单击 | Click | 用鼠标左键按下并释放一次 | 点击、点一下、按一下 |
| 双击 | Double-click | 用鼠标左键快速连续按下两次 | 双点、连击、连点两下 |
| 右键单击 | Right-click | 用鼠标右键按下并释放一次 | 右击、右键点击、点右键 |
| 选择 | Select | 从列表、菜单或一组选项中选定某项 | 选取、挑选、勾选(除复选框外) |
| 输入 | Enter / Type | 在文本框或输入区域中键入内容 | 打入、敲入、键入(非正式场合) |
| 拖动 | Drag | 按住鼠标按钮将对象从一处移至另一处 | 拉动、拖拉、拖拽(口语化) |
| 展开 | Expand | 显示折叠的子菜单或树节点下级内容 | 打开、张开、摊开 |
| 折叠 | Collapse | 隐藏已展开的子菜单或树节点下级内容 | 关闭、收起、合上 |
R-091
推荐
UI 元素名称使用书名号或加粗标注
在技术文档中引用用户界面元素名称时,应使用书名号(《》或「」)或加粗格式进行标注,以便与正文内容区分。推荐使用直角引号「」,与中文排版习惯更为一致。同一文档内应统一使用同一种标注方式。
正确
单击「文件」菜单,然后选择「保存」。
错误
单击文件菜单,然后选择保存。
使用直角引号标注 UI 元素名称,可帮助读者快速区分界面元素与普通文字,提升阅读效率和操作的准确性。未加标注的写法容易让读者混淆操作对象。