有没有人用错误消息的样式指南？

Question

我注意到，错误消息往往是写在少数常见的风格。无论是全面的，休闲友好的句子，还是缩短的被动句子，它们并不总是形成一个完整的句子。后者似乎比较常见 - 尽管可能不如我在很多应用程序中看到的风格的随意混合那样普遍。

有没有人在他们的风格指南中包含错误消息？我对这些事情的一致的语法结构的意见比对它们的内容更加好奇，它们已经是been discussed.

Answer 1

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

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

（iPhone）

当您撰写需要报警标题：

• 保持标题足够短，如果可能的话，以显示在一行。 人很快会读取很长的提醒标题，并且可能会删除 或强制提醒 消息进行滚动。
• 避免不提供任何有用信息的单字标题，如 作为“错误”或“警告”。
• 如果可能，请使用句子片段。简短的，内容丰富的 声明通常比完整的句子更容易理解 。
• 不要犹豫是否定的。人们知道，大多数警报 告诉他们有关问题或警告他们 有关危险情况。它是 更好是负面和直接比 它是积极的，但斜。
• 尽量避免使用“你”，“你的”，“我”和“我的”。有时， 直接标识人的文字可能不明确，甚至可能被解释为侮辱。
• 使用标题式的资本化，在没有结束的标点符号：
• 标题是一个句子片段
• 标题由一个简单的句子，是不是一个问题
• 用文式的资本化和结束的问题标记 标题是否包含单个句子 这是一个问题。一般而言，如果 允许您避免添加 消息，则可以考虑使用问题来提醒 标题。
• 如果标题由 两个或更多句子组成，则使用句式大小写和适当的结尾标点符号 每个句子。两句话 警报标题应该很少是 必要的，但如果它允许您避免添加 消息，您可能会考虑 。

如果你提供一个可选的警告消息：

• 创建使用句子式 资本和相应的结束 标点符号很短的，完整的句子。
• 避免创建过长的消息。如果可能，请保留短消息 ，以便在一条或两条 行上显示。如果消息太长， 会滚动，这不是一个好的用户 的经验。

避免延长您的带有介绍警报文本的按钮来 自来水，比如“点击查看可查看 信息。”理想的情况下，明确的警示文字和逻辑 按钮标签的组合 给人足够的 信息了解 情况和他们的选择。然而， 如果你必须提供详细的指导， 遵循以下原则：

• 一定要使用单词“水龙头”（而不是“触摸”或“点击”或“选择”），以 描述选择动作。
• 请勿将引号中的按钮标题括起来，但会保留其大小写 。

-

（苹果机）

警报消息文本。以强调的（粗体）系统字体显示的这段文字提供了一个简短的简短摘要，介绍召唤警报的错误或状况。这应该是一个完整的句子;通常将其作为问题呈现。有关更多信息，请参阅“编写好警报消息”。

资料性文字。该文本以小型系统字体显示，并提供了有关情况及其后果和解决方法的更全面描述。例如，一个动作不能撤消的警告是适当地使用信息文本。

良好的警报消息明确指出导致警报出现的原因以及用户可以对其做些什么。在用户的词汇表中表达一切。

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

-

（微软）

好的错误消息

相较于以往的不良 例子的特性，良好的错误信息有：

• 有问题。发生问题的国家。
• 原因。解释问题出现的原因。
• 解决方案。提供解决方案，以便用户可以解决问题。

此外，良好的错误消息的方式，是呈现 ：

• 相关。该消息提出了用户关心的问题。
• 可操作。用户应该执行某个操作，或者根据该消息更改其行为 。
• 以用户为中心。该消息描述了目标用户 操作或目标方面的问题，而不是对代码不满意的方面。
• 简要说明。该信息尽可能短，但不能更短。
• 清除。该消息使用通俗易懂的语言，目标用户可以通过 轻松了解问题和 解决方案。
• 具体。该消息使用特定语言描述了该问题， 给出了相关对象的具体名称，位置和值。
• 有礼貌。用户不应该被指责或感到愚蠢。
• 很少见。很少显示。频繁显示的错误消息 是设计不良的标志。