ARIA 快照
概述
在 Playwright 中,ARIA 快照提供了页面可访问性树的 YAML 表示。这些快照可以存储并在后续进行比较,以验证页面结构是否保持一致或是否符合预期。
YAML 格式描述了页面上可访问元素的层次结构,详细列出了 角色、属性、值 和 文本内容。该结构遵循类似树的语法,其中每个节点表示一个可访问元素,缩进表示嵌套元素。
以下是 playwright.dev 主页的一个简单 aria 快照示例:
- banner:
- heading /Playwright enables reliable/ [level=1]
- link "Get started"
- link "Star microsoft/playwright on GitHub"
- main:
- img "Browsers (Chromium, Firefox, WebKit)"
- heading "Any browser • Any platform • One API"
树中的每个可访问元素都表示为一个 YAML 节点:
- role "name" [attribute=value]
-
role: 指定元素的 ARIA 或 HTML 角色(例如,heading、list、listitem、button)。
-
"name": 元素的可访问名称。引用的字符串表示精确值,/patterns/ 用于正则表达式。
-
[attribute=value]: 用方括号表示的属性和值,代表特定的 ARIA 属性,例如
checked
、disabled
、expanded
、level
、pressed
或selected
。这些值来自 ARIA 属性或基于 HTML 语义计算得出。
要检查页面的可访问性树结构,可以使用 Chrome 开发者工具中的可访问性面板(Accessibility Pane)。