Skip to main content
Cypress无障碍测试高级解决方案

运行级别报告

本指南重点介绍了在查看Cypress运行的无障碍报告时需要关注的三个主要领域,并解释了报告中使用的关键术语和定义。

运行摘要

标题显示为Cypress无障碍,上方是摘要指标,本文档的正文部分会详细描述这些指标。

运行摘要提供了顶层指标,用于快速概览测试运行中的无障碍情况。点击任何指标可导航至详细报告,包括每个问题的实时DOM快照。

关键指标包括:

  • 总体评分: 整个运行的综合无障碍评分。
  • 失败元素: 至少违反一条无障碍规则的元素总数。
  • 不确定元素: 由于无障碍检查不确定而需要手动审查的元素。
  • 忽略元素: 被配置忽略但仍存在失败或不确定检查的元素。
  • 规则严重性图表: 显示失败规则的Axe Core®严重级别(严重、重要、中等、轻微)的迷你图表。
  • 总失败规则数: 失败规则的累计计数。

下文将进一步定义每个术语以明确含义。

视图

视图代表被测应用程序的快照集合,按页面(通过URL)或组件(通过组件测试路径)分组。视图可配置,并提供对应用程序的结构化洞察。

Cypress无障碍视图列表,在Cypress Cloud中展示,反映了Cypress Realworld App运行的多个页面上检测到的无障碍规则违规情况。

快照

为视图捕获的快照数量。快照表示在记录测试期间应用程序在特定时刻的实时HTML和CSS状态。当测试与元素交互、修改状态或加载动态内容时,会捕获多个快照。

评分

视图的总体评分是所有快照中通过检查与失败检查的加权比率,反映了该部分应用程序的总体无障碍水平。这产生一个顶层百分比评分,指示项目的总体无障碍情况。了解更多信息,请参阅无障碍评分部分。.

元素

视图中元素的计数,分类为:

  • 失败: 违反至少一条规则的元素。这些会影响您的无障碍评分。
  • 不确定: 元素在运行期间被Axe Core®标记为"未完成"的检查。这些代表由于技术原因无法完成的检查,或需要手动审查以确认是否存在无障碍问题的项目。这些不会影响您的无障碍评分。
  • 忽略: 通过配置中的CSS选择器排除但仍被处理的失败或未完成检查的元素。它们不会影响您的无障碍评分。

失败规则

失败规则显示带有严重性图表(严重、重要、中等、轻微)和总计数,便于快速识别问题最严重的区域。

严重性

严重性级别对应于Axe Core®对每条规则的影响级别,提供检测问题关键性的上下文。需要注意的是,这些级别是由Axe Core的创建者Deque Systems制定的,而不是Web内容无障碍指南本身的一部分。了解更多信息,请参阅Axe Core®文档

规则

此部分列出了运行期间启用的所有Axe Core®规则,详细说明了它们的结果。

Cypress无障碍规则列表,显示在此次Cypress Realworld App运行中多个无障碍规则失败的情况。

每条规则的属性包括:

  • 状态图标: 表示规则总体状态的图标,可以是以下任意一种:
    • 通过: 所有元素通过检查或被忽略。
    • 失败: 至少一个元素失败。
    • 不确定: 至少一个元素被Axe Core®标记为"未完成"并需要手动审查,但没有元素失败。
    • 不适用: 未检测到适用于此规则的元素。
    • 被配置忽略: 规则在项目级别被排除。
  • 描述: 规则的摘要。
  • 严重性: 规则的Axe Core®严重级别。
  • 计数: 规则的失败、不确定和忽略元素的计数。

筛选

您可以通过以下方式筛选无障碍报告中的视图和规则:

  • 规则严重性: 严重、重要、中等或轻微。
  • 规则: WCAG 2.1 A、WCAG 2.1 AA或最佳实践。
  • 元素状态: 失败、不确定或其他(其他包括忽略的元素和规则、100%通过的视图和规则,以及不适用的规则)。
  • 名称: 搜索特定的URL或路径以筛选视图,或搜索特定名称以筛选规则。

这样可以全面了解Cypress在运行期间评估的内容,同时能够有针对性地分析关键问题。

Cypress无障碍下拉筛选器,显示规则严重性、规则、元素状态以及搜索栏