Skip to content

Commit

Permalink
Update a11y overview doc
Browse files Browse the repository at this point in the history
Remove statement that Linux accessibility is incomplete.
Link to instructions on using ax_dump_tree tools.

Bug: None
Change-Id: I92743a63fcb367cf18b6501b2c69541a65c5940d
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/3335256
Reviewed-by: Nektarios Paisios <[email protected]>
Auto-Submit: Aaron Leventhal <[email protected]>
Commit-Queue: Aaron Leventhal <[email protected]>
Cr-Commit-Position: refs/heads/main@{#952993}
  • Loading branch information
aleventhal authored and Chromium LUCI CQ committed Dec 20, 2021
1 parent bbdf7c1 commit 6d0183a
Showing 1 changed file with 10 additions and 4 deletions.
14 changes: 10 additions & 4 deletions docs/accessibility/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,15 +106,18 @@ if you call IAccessible::get_accRole, it returns ROLE_SYSTEM_DOCUMENT,
and if you call IAccessible::get_accName, it returns "How old are you?".
Other methods let you walk the tree.

The Linux accessibility API, (ATK)[https://gnome.pages.gitlab.gnome.org/atk/],
is similar to (IAccessible2)[https://wiki.linuxfoundation.org/accessibility/iaccessible2/start],
aka IA2. Historical note: IA2 was developed to extend MSAA/IAccessible to add
richer document support, in a way that was harmonious with ATK, in order to
simplify implementing them both within the same product. Both APIs are
maintained by the Linux Foundation.

On macOS, the root node implements the NSAccessibility protocol and
if you call [NSAccessibility accessibilityRole], it returns @"AXWebArea",
and if you call [NSAccessibility accessibilityLabel], it returns
"How old are you?".

The Linux accessibility API, ATK, is more similar to the Windows APIs;
they were developed together. (Chrome's support for desktop Linux
accessibility is unfinished.)

The Android accessibility API is of course based on Java. The main
data structure is AccessibilityNodeInfo. It doesn't have a role, but
if you call AccessibilityNodeInfo.getClassName() on the root node
Expand Down Expand Up @@ -209,6 +212,9 @@ then click again to refresh that tree.
Automation API).
* Installing the [https://github.com/google/automation-inspector](
Automation Inspector Chrome extension).
* Building and using [ax_dump_tree or ax_dump_events](tools/accessibility/inspect/README.md).
These can be used to view accessibility trees and events from any application on
Windows, Mac or Linux.
* Or by using native tools:

- Android: UIAutomatorViewer
Expand Down

0 comments on commit 6d0183a

Please sign in to comment.