有没有人使用样式指南来获取错误消息？

Question

我注意到错误消息往往以几种常见的样式编写。可以是完整的、随意友好的句子，也可以是不总是形成完整句子的缩短的被动句。两者中的后者似乎更常见——尽管可能不像我在很多应用程序中看到的随意混合样式那样常见。

有人在他们的风格指南中包含错误信息吗？我对这些东西的一致语法结构的看法比对它们的内容更好奇，这已经been discussed.

Answer 1

iPhone Human Interface Guidelines 和 Apple Human Interface Guidelines 都包含有关警报的部分。

此外，Windows User Experience Interaction Guidelines 包含一些不同类型对话框的信息，包括错误消息。

(iPhone)

在编写所需的警报标题时：

• 如果可能，请保持标题足够短，以便在一行中显示。 长警报标题很难 人们快速阅读，它可能 被截断或强制警报 要滚动的消息。
• 避免使用不提供任何有用信息的单字标题，例如 作为“错误”或“警告”。
• 如果可能，请使用句子片段。一个简短的，内容丰富的 陈述往往更容易 比一个完整的句子理解。
• 不要犹豫否定。人们明白大多数警报 告诉他们问题或警告他们 关于危险情况。它的 最好是消极和直接 应该是正面的，但是是倾斜的。
• 尽可能避免使用“you”、“your”、“me”和“my”。有时， 直接识别人的文本 可以是模棱两可的，甚至可以是 被解读为侮辱。
• 在以下情况下使用标题式大写且无结尾标点：
• 标题是一个句子片段
• 标题由一个非问题的句子组成
• 使用句子式大写和结尾问号，如果 标题由一个句子组成 这是一个问题。一般来说， 考虑使用问题作为警报 标题，如果它允许您避免添加 一条消息。
• 使用句式大写和适当的结尾标点符号 如果标题由每个句子组成 两个或多个句子。两句 警报标题应该很少是 必要的，虽然你可能会考虑 如果它允许您避免添加 消息。

如果您提供可选的警报消息：

• 使用句子风格创建一个简短、完整的句子 大写和适当的结尾 标点符号。
• 避免创建过长的消息。如果可能，请保留消息 足够短，可以显示在一两个上 线。如果消息太长 会滚动，这不是一个好的用户 经验。

避免在警报文本中添加要使用哪个按钮的说明 点按，例如“点按查看以查看 信息。”理想情况下，组合 明确的警报文本和逻辑 按钮标签给人们足够的 了解的信息 情况和他们的选择。然而， 如果您必须提供详细的指导， 请遵循以下准则：

• 请务必使用“点击”（而不是“触摸”或“点击”或“选择”）一词 描述选择操作。
• 不要用引号将按钮标题括起来，但要保留它的 大写。

-

（苹果机）

警报消息文本。 该文本采用强调（粗体）系统字体，提供了一个简短的、简单的关于引发警报的错误或条件的摘要。这应该是一个完整的句子；通常它是作为一个问题提出的。有关详细信息，请参阅“编写良好的警报消息”。

信息性文本。此文本以小系统字体显示，并提供了对情况、后果以及摆脱困境的方法的更完整描述。例如，无法撤消操作的警告是对信息文本的适当使用。

良好的警报消息清楚地说明导致警报出现的原因以及用户可以采取的措施。用用户的词汇表达一切。

要使警报真正有用，请提供有关用户可以针对当前情况做些什么的建议。即使警报用作向用户发出的通知并且不需要进一步的操作，也要提供尽可能多的信息来描述情况。

-

（微软）

好的错误信息的特征

对比之前的坏 例如，好的错误消息有：

• 一个问题。说明发生了问题。
• 一个原因。解释问题发生的原因。
• 解决方案。提供解决方案，以便用户解决问题。

此外，好的错误消息是 以如下方式呈现：

• 相关。该消息提出了用户关心的问题。
• 可操作。用户应该执行操作或更改他们的 行为作为消息的结果。
• 以用户为中心。该消息根据目标用户描述问题 行动或目标，而不是根据什么 代码不满意。
• 简介。消息尽可能短，但不能更短。
• 清除。该消息使用简单的语言，以便目标用户可以 容易理解问题和 解决方案。
• 具体。该消息使用特定语言描述问题， 给出具体的名称、位置和 所涉及对象的值。
• 有礼貌。不应责备用户或让用户感到愚蠢。
• 稀有。很少显示。经常显示的错误信息 是糟糕设计的标志。