Accessibility
Accessibility 类提供了用于检查 Chromium 的辅助功能树的方法。辅助功能树被辅助技术使用,例如 屏幕阅读器 或 切换控制。
辅助功能是非常平台特定的事物。在不同的平台上,可能有不同的屏幕阅读器,它们的输出可能差异很大。
Chromium、Firefox 和 WebKit 的渲染引擎都有“辅助功能树”的概念,然后将其转换为不同的平台特定 API。Accessibility 命名空间提供了对这个辅助功能树的访问。
当从内部浏览器 AX 树转换为平台特定 AX 树或被辅助技术本身转换时,大部分辅助功能树会被过滤掉。默认情况下,Playwright 尝试近似这种过滤,仅公开树的“有趣”节点。
已弃用
snapshot
在 v1.9 之前添加捕获辅助功能树的当前状态。返回的对象表示页面的根可访问节点。
Chromium 辅助功能树包含在大多数平台和大多数屏幕阅读器上未使用的节点。Playwright 也会丢弃它们,以便更容易处理树,除非将 interesting_only 设置为 false
。
用法
转储整个辅助功能树的示例
- 同步
- 异步
snapshot = page.accessibility.snapshot()
print(snapshot)
snapshot = await page.accessibility.snapshot()
print(snapshot)
记录焦点节点的名称的示例
- 同步
- 异步
def find_focused_node(node):
if node.get("focused"):
return node
for child in (node.get("children") or []):
found_node = find_focused_node(child)
if found_node:
return found_node
return None
snapshot = page.accessibility.snapshot()
node = find_focused_node(snapshot)
if node:
print(node["name"])
def find_focused_node(node):
if node.get("focused"):
return node
for child in (node.get("children") or []):
found_node = find_focused_node(child)
if found_node:
return found_node
return None
snapshot = await page.accessibility.snapshot()
node = find_focused_node(snapshot)
if node:
print(node["name"])
参数
-
从树中修剪不有趣的节点。默认为
true
。 -
root
ElementHandle (可选)#快照的根 DOM 元素。默认为整个页面。
返回值
- NoneType | Dict#
-
role
str角色。
-
name
str节点的易读名称。
-
节点的当前值(如果适用)。
-
description
str节点的附加易读描述(如果适用)。
-
keyshortcuts
str与此节点关联的键盘快捷键(如果适用)。
-
roledescription
str角色的易读替代方案(如果适用)。
-
valuetext
str当前值的描述(如果适用)。
-
disabled
bool节点是否被禁用(如果适用)。
-
expanded
bool节点是展开还是折叠(如果适用)。
-
focused
bool节点是否聚焦(如果适用)。
-
modal
bool节点是否为 模态(如果适用)。
-
multiline
bool节点文本输入是否支持多行(如果适用)。
-
multiselectable
bool是否可以选择多个子节点(如果适用)。
-
readonly
bool节点是否为只读(如果适用)。
-
required
bool节点是否为必需(如果适用)。
-
selected
bool节点是否在其父节点中被选中(如果适用)。
-
checked
bool | "mixed"复选框是否被选中,或为“混合”状态(如果适用)。
-
pressed
bool | "mixed"切换按钮是否被选中,或为“混合”状态(如果适用)。
-
level
int标题的级别(如果适用)。
-
valuemin
float节点中的最小值(如果适用)。
-
valuemax
float节点中的最大值(如果适用)。
-
autocomplete
str控件支持哪种自动完成功能(如果适用)。
-
haspopup
str当前为节点显示哪种类型的弹出窗口(如果适用)。
-
invalid
str此节点的值是否无效以及以何种方式无效(如果适用)。
-
orientation
str节点是水平还是垂直方向(如果适用)。
-
子节点(如果有,如果适用)。
-