辅助功能清单

提供了可帮助你确保 Windows 应用可访问的清单。

我们在此提供了一个清单,你可以用它来确保你的应用是辅助应用。

  1. 为应用中的内容和交互式 UI 元素设置辅助名称(必选)和描述(可选)。

    辅助名称是屏幕阅读器用于述说 UI 元素的简短且具有描述性的文本字符串。 一些 UI 元素(如 TextBlockTextBox)将其文本内容提升为默认辅助名称;请参阅基本辅助功能信息

    你应当为图像或没有将内部文本内容提升为隐式辅助名称的其他控件明确设置辅助名称。 你应当针对窗体元素使用标签,以便标签文本可以用作 Microsoft UI 自动化模型中的 LabeledBy 目标来将标签与输入相关联。 如果你想要为用户提供的 UI 指南比辅助名称中通常包括的指南多,则可以使用辅助说明和工具提示来帮助用户了解 UI。

    有关详细信息,请参阅辅助名称辅助说明

  2. 实现键盘辅助功能:

    • 测试 UI 的默认 Tab 键索引顺序。 必要时调整 Tab 键索引顺序,这可能需要启用或禁用某些控件或者更改某些 UI 元素上 TabIndex 的默认值。
    • 为复合元素使用支持箭头键导航的控件。 对于默认控件,通常已经实现了箭头键导航。
    • 使用支持键盘激活的控件。 对于默认控件,特别是那些支持 UI 自动化 Invoke 模式的控件,通常提供键盘激活功能;请检查该控件的文档。
    • 为 UI 中支持交互的特定部分设置访问键或实现加速键。
    • 对于 UI 中所使用的任何自定义控件,请验证你已经用正确的 AutomationPeer 激活支持实现了这些控件,而且已经根据需要定义了键处理替换选项以支持激活、遍历、访问键或加速键。

    有关详细信息,请参阅键盘交互

  3. 确保文本为可读的大小

    • Windows 包含各种辅助功能工具和设置,用户可以利用这些工具和设置,并根据自己阅读文本的需求和首选项进行调整。 其中包括:
      • “放大镜”工具,其可以放大 UI 的选定区域。 应确保应用中的文本布局不会让使用放大镜进行阅读变得困难。
      • “设置”->“系统”->“显示”->“缩放和布局”中的全局缩放和分辨率设置。 究竟有哪些大小设置选项可用可能有所不同,因为这取决于显示设备的功能。
      • “设置”->“辅助功能”->“显示”中的文本大小设置。 调整“放大文本”设置,以仅指定所有应用程序和屏幕上支持控件中的文本大小(所有 UWP 文本控件都支持文本缩放体验,无需任何自定义或模板)。

      注意

      “放大所有内容”设置允许用户仅在其主屏幕上指定其首选的文本和应用大小。

  4. 以直观方式验证你的 UI 以确保文本对比度足够大、元素以高对比度主题正确呈现以及使用了正确的颜色。

    • 使用颜色分析器工具验证视觉文本对比度至少为 4.5:1。
    • 切换到高对比度主题并验证应用的 UI 可读且可用。
    • 确保你的 UI 未将颜色用作传递信息的唯一方式。

    有关详细信息,请参阅高对比度主题辅助文本要求

  5. 运行辅助功能工具、解决报告的问题并验证屏幕阅读体验。

    使用 Inspect 之类的工具验证编程访问,运行诊断工具(如 AccChecker)发现常见错误以及使用讲述人验证屏幕读取体验。

    有关详细信息,请参阅辅助功能测试

  6. 确保你的应用清单设置遵循辅助功能指南。

  7. 在 Microsoft Store 中将你的应用声明为辅助应用。

    如果已实现基线辅助功能支持,则在 Microsoft Store 中将应用声明为辅助应用有助于获得更多客户并获取一些额外好评。

    有关详细信息,请参阅 Microsoft Store 中的辅助功能