Skip to main content
Build the future with Agentforce at TDX in San Francisco or on Salesforce+ on March 5–6. Register now.

使用通俗易懂的语言

学习目标

完成本单元后,您将能够:

  • 创建无障碍内容。
  • 说明使用感官和定向语言的潜在影响。

保持内容清晰简洁

所有内容都应该易于阅读。这意味着提供足够的信息来传达必要的内容,而不包含不必要的信息。以下是编写消息时要牢记的一些最佳实践。

保持简洁

写简短、清晰的句子和段落。避免带有复杂标点符号和不必要细节的长句。

避免行话、流行语、成语和俚语 

使用特定群体、职业或语言可能常用的单词或短语会让没有相关专业知识或经验的用户难以理解。示例:烟雾测试、煮沸大海和做底层工作。

缩写

在首次使用缩写词和首字母缩略词时解释其含义,然后将首字母缩略词括在括号中。例如,Web 内容无障碍指南 (WCAG)。提供说明后,您就可以只使用首字母缩略词了。

定义术语

考虑为读者可能不知道的术语提供一个词汇表。

让我们来看一个 Dreamforce 的会话描述,该描述可以作为具备可读性且易理解的内容示例。它包含所有相关信息,没有不必要和分散注意力的内容。清晰、简洁的措辞有助于读者了解会发生什么,并决定他们是否想参加会话。例如:

炉边谈话:Arianna Huffington 和 Marc Benioff

Dreamforce 演讲者 Arianna Huffington 再度归来,她曾在 2010 年的 TEDWomen 演讲中说过,当今的女性需要解决睡眠不足的问题才能成为优秀的领导者。作为赫芬顿邮报的创始人、Thrive Global 的创始人兼首席执行官以及 15 本书的作者,她将与 Marc Benioff 一起分享关于健康和领导力的幽默见解。

 

避免定向和感官语言

为了最大限度地提高视障用户的体验,请避免使用要求用户亲眼看到页面布局或设计才能理解内容的词语。这包括提及颜色、大小、形状或位置以增强理解的词语。您可以使用这些描述词,但不要仅依靠这种类型的语言来获得理解。 

假设您正在描述两个图标:

错误:“活动状态用绿色图标表示,非活动状态用红色图标表示。” 

这个例子中的描述没有为无法区分红色图标和绿色图标的色盲用户提供足够的信息,也没有帮助到屏幕阅读器用户。

正确:“活动状态用绿色加号图标表示,非活动状态用红色 X 图标表示。”

额外的描述性语言补充了特定于颜色的信息,并为色盲用户和屏幕阅读器提供了必要的意义。

形状和位置描述可能会导致无障碍问题。避免如下所示的描述词:

  • 圆形、方形
  • 底部
  • 顶部
  • 上部
  • 下部
  • 旁边
  • 角落

如果您发现自己使用了可能有问题的词语,或在现有内容中遇到了这样的词,这里有一些建议可以帮助您明确该怎么做。

问问自己是否需要使用包含该词语的文本。例如:“单击属性选项卡。此选项卡位于窗口顶部。”有视力的用户需要第二句话吗?如果不需要,将其移除。

如果可能的话,在不改变句子意思的情况下改写内容。例如,“位于右侧部分”也可以写成“位于右侧的信息部分”。同义词可能会有所帮助,只要您使用尽可能简单的语言来传达正确的含义即可。以下是您可以用来替换感官词的常用词列表(取决于上下文):

  • 顶部:开端、开始
  • 底部:末尾
  • 上方:上一个,一般可以删除
  • 下方:下一个,一般可以删除
  • 右侧(位置):可以去掉或者换成 UI 控件名

如果用户不必完全依赖感官信息来理解这段文字,严格来说您可以将其保留。只要确保您使用的语言尽可能清晰简洁即可。

以下是一些包含无障碍问题的句子示例,然后是建议的编辑。

包含无障碍问题的文本示例

包含无障碍问题的示例文本 建议的解决方案

在左窗格中,单击“安装”,然后在右窗格中单击“下一步”。 

删除左右窗格的说法。如果窗格有标题,您可以使用标题而不是说左或右。

添加以下语句以确保代理服务器不会修改上方语句中描述的代理。

可以删除包含“上方”一词的短语:添加以下语句以确保代理服务器不会修改代理。


或者将句子重写为:添加以下语句以确保代理服务器不会修改上一步语句中描述的代理。

如果您使用 iPhone 或 iPad 设置帐户,请确认您运行的是 iOS 12 或以上版本。

以上替换为更新:如果您使用 iPhone 或 iPad 设置帐户,请确认您运行的是 iOS 12 或更新版本。 

完成下方任务以配置服务器。

可以这样说:完成以下任务以配置服务器。

单击端口表格顶部的新建按钮。

空间参考很困难,因为盲人和弱视学习者将无法在页面上定位自己。 


将这个短语替换为“端口表格的开头”。使用屏幕阅读器的盲人用户可以找到表格的开头。

选中要重启的群集旁边的复选框,然后单击停止。

首先,盲人看不到什么在什么旁边。其次,如果屏幕被放大,分辨率很低,或者您没有使用样式表,您在屏幕上看到的控件最终在用户那里可能会出现在不同位置。 


在此例中,重写为:选中要重新启动的群集的复选框,然后单击停止。或者:选中相应群集的复选框,然后单击停止。

从顶部导航栏中选择您的姓名,然后选择完成。

顶部改为站点:从站点导航栏中选择您的姓名,然后选择完成。

单击页面顶部的主页链接。

如果您根据位置描述屏幕上的项目,例如一个链接或一组链接,请尝试找到相邻 UI 项目的名称。 


或者看看您是否可以为这些链接创建一个名称,以描述它们的共同特征。在本例中,您可以这样写:单击主菜单中的主页链接。

让我们总结一下

在内容中使用清晰简洁的语言可以为所有用户带来好处。特别值得一提的是,尽量减少使用感官和方向性的措辞可以避免给视觉障碍用户造成问题。 

使用颜色描述时,请确保提供额外的详细信息,以便视障用户获得足够的信息。本文的信息无法解决所有的无障碍问题,但通过掌握这些基本原则,您可以确保每个人都能更好地访问您的内容。

在 Salesforce 帮助中分享 Trailhead 反馈

我们很想听听您使用 Trailhead 的经验——您现在可以随时从 Salesforce 帮助网站访问新的反馈表单。

了解更多 继续分享反馈