元素

为了使图案对将要使用它们的设计人员和开发人员有所帮助，它们必须易于查找和可读。

尽管模式描述有所不同，但是许多模式库包含一些常见元素：

• 模式名称：选择清晰，描述性的名称可以帮助人们找到模式，并鼓励团队成员在设计讨论期间进行清晰的沟通。
• 模式说明：由于有时诸如“单窗口向下钻取”之类的简称有时不足以描述模式，因此，额外的几行解释（或规范的屏幕截图）将有助于说明模式的工作原理。
• 问题陈述：以用户为中心的语言编写的信息，向最终用户传达了用户想要实现的目标或面临的挑战。
• 使用时间： “使用上下文”是设计模式的关键组成部分。此元素可帮助人们了解应用设计模式时（或不应用时）的情况。
• 解决方案：解决方案应说明解决问题的“方法”，并可能包括说明性清单，屏幕截图，甚至是演示该模式的简短视频。
• 理由：提供“为什么”模式有效的理由将加强解决方案，尽管时间紧迫的开发人员可能更愿意忽略此​​解释。
• 示例：每个示例都说明如何成功应用模式。通常随附屏幕截图和简短说明。
• 注释：为团队成员提供讨论该模式使用情况的场所有助于维护活跃的资源并保持团队的参与度。

模式库还可以包含可选元素，具体取决于使用它们的团队的需求。这些可能包括：

• 实施规范：样式指南，其中包含有关字体大小，像素大小，颜色以及消息和标签的措辞的详细信息，对开发人员有帮助。
• 可用性研究：应记录可用性测试或其他用户反馈中的任何支持性研究。这也可以包括开发人员，客户服务或销售团队的反馈。
• 相关模式：模式库可以包括类似的模式，也可以组织成父模式和子模式的层次结构。
• 相似的方法：由于可能有很多解决此问题的方法，因此团队可能需要一个场所来捕获相似的替代方案。
• 源代码：如果代码的模块化程度足以重用，那么它也可以包含在库中。