小组件状态和内置 UI 组件
注意
一些信息与预发布产品相关，在商业发行之前可能发生实质性修改。 Microsoft 对此处提供的信息不提供任何明示或暗示的保证。
重要
本主题中所述的功能在从内部版本 25217 开始的 Windows 开发频道预览版中提供。 有关 Windows 预览版的信息，请参阅 Windows 10 Insider Preview。
小组件状态
当小组件显示在小组件板上时，根据小组件板和应用的当前状态（例如，小组件加载时间、小组件处于错误状态或用户自定义小组件布局时），小组件可能处于几种不同的状态。 某些状态由应用设计和实现，而另一些状态则内置于小组件主机中。 本部分显示并描述每个小组件状态。 请记住，小组件同时支持浅色和深色主题，因此，根据当前主题，内置状态和你自定义的状态可能看起来有所不同。
默认状态
默认状态是小组件正常运行时的样子。 这是小组件的主要用户体验。 你为小组件的默认状态设计了布局。 尽管小组件默认状态的 UI 可能会因用户配置而更改，但小组件的默认状态应完全实现，并且在用户配置之前不应为空。 如果小组件要求用户登录，则可能需要实现注销状态，如下所述。 有关为小组件创建默认状态的设计指南，请参阅小组件设计基础知识。
应做事项
- 处于默认活动状态时，小组件应感觉个人化并连接到用户。
- 小组件应显示引人入胜的内容，从而在当前时刻带来用户价值。
- 让用户能够立即开始与小组件进行交互。
- 提供反映应用 UI 的 UI，同时保持在小组件的设计约束范围内，以最大程度地提高一致性并降低学习曲线。
- 请考虑使用用户的位置预先填充要添加的运动和建议日历等内容的数据，而不是一般数据。
- 允许元素之间有足够的呼吸空间。
禁止事项
- 将小组件用于通用商业产品/服务。 内容应反映用户的愿望和意图。
- 避免繁忙的复杂布局。
旨在在每个小组件大小内获得舒适的信息密度和正常的负空间，以帮助实现“即看即用”模式。 如果要包含大量信息，请考虑下一个大小，以显示更多内容。 还要考虑用户浏览和使用内容的难易程度。
考虑在小组件中添加惊喜和愉悦的时刻，以提升体验。 例如，对于“家庭”或“日历”小组件，可以通过不同的视觉处理突出显示孩子的生日。
这是具有最大设计灵活性的状态。 使用本文中的指南以及小组件原则、小组件设计基础知识和小组件交互设计指南来设计要如何布局内容。
注销状态（对于需要身份验证的小组件）
某些小组件方案可能要求用户必须登录或执行其他操作才能查看个性化小组件内容。 当用户未登录时，应考虑呈现非个性化内容。
错误状态 - 系统提供
如果出于某种原因，小组件板无法检索小组件的布局或数据，它将显示错误状态。 Windows 将显示带有错误消息和“重新加载”按钮的小组件标题。 对于每个小组件，此消息看起来都相同。
如果有可供显示的缓存内容，小组件标题将显示上次刷新数据的时间，格式如下：
- 如果小于一小时，则为分钟数
- 如果超过一小时，则舍入到最接近的小时
长小组件合作伙伴名称显示缓存消息时，将在最大 15 个字符处被截断。
自定义状态
从 Windows App SDK 1.4 开始，小组件可以提供自定义模板，该模板为用户提供控件来自定义小组件的外观或小组件显示的数据。 自定义 UI 在 JSON 模板中定义。
内置小组件 UI 组件
小组件的某些 UI 元素内置于小组件体验中，尽管小组件提供程序无法自定义这些元素，但请务必了解这些元素是什么以及它们的行为方式。
上下文菜单（系统提供）
当用户单击右上角的三点图标时，将显示上下文菜单。 此菜单允许用户选择其首选小组件大小并访问小组件的配置状态。 合作伙伴将使用相同的模板小组件注册“由 ___ 提供支持”。
属性区域
属性区域由小组件板根据小组件注册期间提供的小组件名称和图标呈现。 有关注册小组件的详细信息，请参阅小组件提供程序包清单 XML 格式。
