blob: 26e4ab661011490516fe7a59e19d7101a5f12fe5 [file] [log] [blame] [view]
dmazzoni2f489752017-02-16 03:39:161# Accessibility Overview
2
3Accessibility means ensuring that all users, including users with disabilities,
4have equal access to software. One piece of this involves basic design
5principles such as using appropriate font sizes and color contrast,
6avoiding using color to convey important information, and providing keyboard
7alternatives for anything that is normally accomplished with a pointing device.
8However, when you see the word "accessibility" in a directory name in Chromium,
9that code's purpose is to provide full access to Chromium's UI via external
10accessibility APIs that are utilized by assistive technology.
11
12**Assistive technology** here refers to software or hardware which
13makes use of these APIs to create an alternative interface for the user to
14accommodate some specific needs, for example:
15
16Assistive technology includes:
17
18* Screen readers for blind users that describe the screen using
19 synthesized speech or braille
20* Voice control applications that let you speak to the computer,
21* Switch access that lets you control the computer with a small number
22 of physical switches,
23* Magnifiers that magnify a portion of the screen, and often highlight the
24 cursor and caret for easier viewing, and
25* Assistive learning and literacy software that helps users who have a hard
26 time reading print, by highlighting and/or speaking selected text
27
28In addition, because accessibility APIs provide a convenient and universal
29way to explore and control applications, they're often used for automated
30testing scripts, and UI automation software like password managers.
31
32Web browsers play an important role in this ecosystem because they need
33to not only provide access to their own UI, but also provide access to
34all of the content of the web.
35
36Each operating system has its own native accessibility API. While the
37core APIs tend to be well-documented, it's unfortunately common for
38screen readers in particular to depend on additional undocumented or
39vendor-specific APIs in order to fully function, especially with web
40browsers, because the standard APIs are insufficient to handle the
41complexity of the web.
42
43Chromium needs to support all of these operating system and
44vendor-specific accessibility APIs in order to be usable with the full
45ecosystem of assistive technology on all platforms. Just like Chromium
46sometimes mimics the quirks and bugs of older browsers, Chromium often
47needs to mimic the quirks and bugs of other browsers' implementation
48of accessibility APIs, too.
49
50## Concepts
51
52While each operating system and vendor accessibility API is different,
53there are some concepts all of them share.
54
551. The *tree*, which models the entire interface as a tree of objects, exposed
56 to assistive technology via accessibility APIs;
572. *Events*, which let assistive technology know that a part of the tree has
58 changed somehow;
593. *Actions*, which come from assistive technology and ask the interface to
60 change.
61
62Consider the following small HTML file:
63
64```
65<html>
66<head>
67 <title>How old are you?</title>
68</head>
69<body>
70 <label for="age">Age</label>
71 <input id="age" type="number" name="age" value="42">
72 <div>
73 <button>Back</button>
74 <button>Next</button>
75 </div>
76</body>
77</html>
78```
79
80### The Accessibility Tree and Accessibility Attributes
81
82Internally, Chromium represents the accessibility tree for that web page
83using a data structure something like this:
84
85```
86id=1 role=WebArea name="How old are you?"
87 id=2 role=Label name="Age"
88 id=3 role=TextField labelledByIds=[2] value="42"
89 id=4 role=Group
90 id=5 role=Button name="Back"
91 id=6 role=Button name="Next"
92```
93
94Note that the tree structure closely resembles the structure of the
95HTML elements, but slightly simplified. Each node in the accessibility
96tree has an ID and a role. Many have a name. The text field has a value,
97and instead of a name it has labelledByIds, which indicates that its
98accessible name comes from another node in the tree, the label node
99with id=2.
100
101On a particular platform, each node in the accessibility tree is implemented
102by an object that conforms to a particular protocol.
103
104On Windows, the root node implements the IAccessible protocol and
105if you call IAccessible::get_accRole, it returns ROLE_SYSTEM_DOCUMENT,
106and if you call IAccessible::get_accName, it returns "How old are you?".
107Other methods let you walk the tree.
108
109On macOS, the root node implements the NSAccessibility protocol and
110if you call [NSAccessibility accessibilityRole], it returns @"AXWebArea",
111and if you call [NSAccessibility accessibilityLabel], it returns
112"How old are you?".
113
114The Linux accessibility API, ATK, is more similar to the Windows APIs;
115they were developed together. (Chrome's support for desktop Linux
116accessibility is unfinished.)
117
118The Android accessibility API is of course based on Java. The main
119data structure is AccessibilityNodeInfo. It doesn't have a role, but
120if you call AccessibilityNodeInfo.getClassName() on the root node
121it returns "android.webkit.WebView", and if you call
122AccessibilityNodeInfo.getContentDescription() it returns "How old are you?".
123
124On Chrome OS, we use our own accessibility API that closely maps to
125Chrome's internal accessibility API.
126
127So while the details of the interface vary, the underlying concepts are
128similar. Both IAccessible and NSAccessibility have a concept of a role,
129but IAccessible uses a role of "document" for a web page, while NSAccessibility
130uses a role of "web area". Both IAccessible and NSAccessibility have a
131concept of the primary accessible text for a node, but IAccessible calls
132it the "name" while NSAccessibility calls it the "label", and Android
133calls it a "content description".
134
135**Historical note:** The internal names of roles and attributes in
136Chrome often tend to most closely match the macOS accessibility API
137because Chromium was originally based on WebKit, where most of the
138accessibility code was written by Apple. Over time we're slowly
139migrating internal names to match what those roles and attributes are
140called in web accessibility standards, like ARIA.
141
142### Accessibility Events
143
144In Chromium's internal terminology, an Accessibility Event always represents
145communication from the app to the assistive technology, indicating that the
146accessibility tree changed in some way.
147
148As an example, if the user were to press the Tab key and the text
149field from the example above became focused, Chromium would fire a
150"focus" accessibility event that assistive technology could listen
151to. A screen reader might then announce the name and current value of
152the text field. A magnifier might zoom the screen to its bounding
153box. If the user types some text into the text field, Chromium would
154fire a "value changed" accessibility event.
155
156As with nodes in the accessibility tree, each platform has a slightly different
157API for accessibility events. On Windows we'd fire EVENT_OBJECT_FOCUS for
158a focus change, and on Mac we'd fire @"AXFocusedUIElementChanged".
159Those are pretty similar. Sometimes they're quite different - to support
160live regions (notifications that certain key parts of a web page have changed),
161on Mac we simply fire @"AXLiveRegionChanged", but on Windows we need to
162fire IA2_EVENT_TEXT_INSERTED and IA2_EVENT_TEXT_REMOVED events individually
163on each affected node within the changed region, with additional attributes
164like "container-live:polite" to indicate that the affected node was part of
165a live region. This discussion is not meant to explain all of the technical
166details but just to illustrate that the concepts are similar,
167but the details of notifying software on each platform about changes can
168vary quite a bit.
169
170### Accessibility Actions
171
172Each native object that implements a platform's native accessibility API
173supports a number of actions, which are requests from the assistive
174technology to control or change the UI. This is the opposite of events,
175which are messages from Chromium to the assistive technology.
176
177For example, if the user had a voice control application running, such as
178Voice Access on Android, the user could just speak the name of one of the
179buttons on the page, like "Next". Upon recognizing that text and finding
180that it matches one of the UI elements on the page, the voice control
181app executes the action to click the button id=6 in Chromium's accessibility
182tree. Internally we call that action "do default" rather than click, since
183it represents the default action for any type of control.
184
185Other examples of actions include setting focus, changing the value of
186a control, and scrolling the page.
187
188### Parameterized attributes
189
190In addition to accessibility attributes, events, and actions, native
191accessibility APIs often have so-called "parameterized attributes".
192The most common example of this is for text - for example there may be
193a function to retrieve the bounding box for a range of text, or a
194function to retrieve the text properties (font family, font size,
195weight, etc.) at a specific character position.
196
197Parameterized attributes are particularly tricky to implement because
198of Chromium's multi-process architecture. More on this in the next section.
199
200## Chromium's multi-process architecture
201
202Native accessibility APIs tend to have a *functional* interface, where
203Chromium implements an interface for a canonical accessible object that
204includes methods to return various attributes, walk the tree, or perform
205an action like click(), focus(), or setValue(...).
206
207In contrast, the web has a largely *declarative* interface. The shape
208of the accessibility tree is determined by the DOM tree (occasionally
209influenced by CSS), and the accessible semantics of a DOM element can
210be modified by adding ARIA attributes.
211
212One important complication is that all of these native accessibility APIs
213are *synchronous*, while Chromium is multi-process, with the contents of
214each web page living in a different process than the process that
215implements Chromium's UI and the native accessibility APIs. Furthermore,
216the renderer processes are *sandboxed*, so they can't implement
217operating system APIs directly.
218
219If you're unfamiliar with Chrome's multi-process architecture, see
220[this blog post introducing the concept](
221https://blog.chromium.org/2008/09/multi-process-architecture.html) or
222[the design doc on chromium.org](
223https://www.chromium.org/developers/design-documents/multi-process-architecture)
224for an intro.
225
226Chromium's multi-process architecture means that we can't implement
227accessibility APIs the same way that a single-process browser can -
228namely, by calling directly into the DOM to compute the result of each
229API call. For example, on some operating systems there might be an API
230to get the bounding box for a particular range of characters on the
231page. In other browsers, this might be implemented by creating a DOM
232selection object and asking for its bounding box.
233
234That implementation would be impossible in Chromium because it'd require
235blocking the main thread while waiting for a response from the renderer
236process that implements that web page's DOM. (Not only is blocking the
237main thread strictly disallowed, but the latency of doing this for every
238API call makes it prohibitively slow anyway.) Instead, Chromium takes an
239approach where a representation of the entire accessibility tree is
240cached in the main process. Great care needs to be taken to ensure that
241this representation is as concise as possible.
242
243In Chromium, we build a data structure representing all of the
244information for a web page's accessibility tree, send the data
245structure from the renderer process to the main browser process, cache
246it in the main browser process, and implement native accessibility
247APIs using solely the information in that cache.
248
249As the accessibility tree changes, tree updates and accessibility events
250get sent from the renderer process to the browser process. The browser
251cache is updated atomically in the main thread, so whenever an external
252client (like assistive technology) calls an accessibility API function,
253we're always returning something from a complete and consistent snapshot
254of the accessibility tree. From time to time, the cache may lag what's
255in the renderer process by a fraction of a second.
256
257Here are some of the specific challenges faced by this approach and
258how we've addressed them.
259
260### Sparse data
261
262There are a *lot* of possible accessibility attributes for any given
263node in an accessibility tree. For example, there are more than 150
264unique accessibility API methods that Chrome implements on the Windows
265platform alone. We need to implement all of those APIs, many of which
266request rather rare or obscure attributes, but storing all possible
267attribute values in a single struct would be quite wasteful.
268
269To avoid each accessible node object containing hundreds of fields the
270data for each accessibility node is stored in a relatively compact
271data structure, ui::AXNodeData. Every AXNodeData has an integer ID, a
272role enum, and a couple of other mandatory fields, but everything else
273is stored in attribute arrays, one for each major data type.
274
275```
276struct AXNodeData {
277 int32_t id;
278 AXRole role;
279 ...
280 std::vector<std::pair<AXStringAttribute, std::string>> string_attributes;
281 std::vector<std::pair<AXIntAttribute, int32_t>> int_attributes;
282 ...
283}
284```
285
286So if a text field has a placeholder attribute, we can store
287that by adding an entry to `string_attributes` with an attribute
288of ui::AX_ATTR_PLACEHOLDER and the placeholder string as the value.
289
290### Incremental tree updates
291
292Web pages change frequently. It'd be terribly inefficient to send a
293new copy of the accessibility tree every time any part of it changes.
294However, the accessibility tree can change shape in complicated ways -
295for example, whole subtrees can be reparented dynamically.
296
297Rather than writing code to deal with every possible way the
298accessibility tree could be modified, Chromium has a general-purpose
299tree serializer class that's designed to send small incremental
300updates of a tree from one process to another. The tree serializer has
301just a few requirements:
302
303* Every node in the tree must have a unique integer ID.
304* The tree must be acyclic.
305* The tree serializer must be notified when a node's data changes.
306* The tree serializer must be notified when the list of child IDs of a
307 node changes.
308
309The tree serializer doesn't know anything about accessibility attributes.
310It keeps track of the previous state of the tree, and every time the tree
311structure changes (based on notifications of a node changing or a node's
312children changing), it walks the tree and builds up an incremental tree
313update that serializes as few nodes as possible.
314
315In the other process, the Unserialization code applies the incremental
316tree update atomically.
317
318### Text bounding boxes
319
320One challenge faced by Chromium is that accessibility clients want to be
321able to query the bounding box of an arbitrary range of text - not necessarily
322just the current cursor position or selection. As discussed above, it's
323not possible to block Chromium's main browser process while waiting for this
324information from Blink, so instead we cache enough information to satisfy these
325queries in the accessibility tree.
326
327To compactly store the bounding box of every character on the page, we
328split the text into *inline text boxes*, sometimes called *text runs*.
329For example, in a typical paragraph, each line of text would be its own
330inline text box. In general, an inline text box or text run contians a
331sequence of text characters that are all oriented in the same direction,
332in a line, with the same font, size, and style.
333
334Each inline text box stores its own bounding box, and then the relative
335x-coordinate of each character in its text (assuming left-to-right).
336From that it's possible to compute the bounding box
337of any individual character.
338
339The inline text boxes are part of Chromium's internal accessibility tree.
340They're used purely internally and aren't ever exposed directly via any
341native accessibility APIs.
342
343For example, suppose that a document contains a text field with the text
344"Hello world", but the field is narrow, so "Hello" is on the first line and
345"World" is on the second line. Internally Chromium's accessibility tree
346might look like this:
347
348```
349staticText location=(8, 8) size=(38, 36) name='Hello world'
350 inlineTextBox location=(0, 0) size=(36, 18) name='Hello ' characterOffsets=12,19,23,28,36
351 inlineTextBox location=(0, 18) size=(38, 18) name='world' characterOffsets=12,20,25,29,37
352```
353
354### Scrolling, transformations, and animation
355
356Native accessibility APIs typically want the bounding box of every element in the
357tree, either in window coordinates or global screen coordinates. If we
358stored the global screen coordinates for every node, we'd be constantly
359re-serializing the whole tree every time the user scrolls or drags the
360window.
361
362Instead, we store the bounding box of each node in the accessibility tree
363relative to its *offset container*, which can be any ancestor. If no offset
364container is specified, it's assumed to be the root of the tree.
365
366In addition, any offset container can contain scroll offsets, which can be
367used to scroll the bounding boxes of anything in that subtree.
368
369Finally, any offset container can also include an arbitrary 4x4 transformation
370matrix, which can be used to represent arbitrary 3-D rotations, translations, and
371scaling, and more. The transformation matrix applies to the whole subtree.
372
373Storing coordinates this way means that any time an object scrolls, moves, or
374animates its position and scale, only the root of the scrolling or animation
375needs to post updates to the accessibility tree. Everything in the subtree
376remains valid relative to that offset container.
377
378Computing the global screen coordinates for an object in the accessibility
379tree just means walking up its ancestor chain and applying offsets and
380occasionally multiplying by a 4x4 matrix.
381
382### Site isolation / out-of-process iframes
383
384At one point in time, all of the content of a single Tab or other web view
385was contained in the same Blink process, and it was possible to serialize
386the accessibility tree for a whole frame tree in a single pass.
387
388Today the situation is a bit more complicated, as Chromium supports
389out-of-process iframes. (It also supports "browser plugins" such as
390the `<webview>` tag in Chrome packaged apps, which embeds a whole
391browser inside a browser, but for the purposes of accessibility this
392is handled the same as frames.)
393
394Rather than a mix of in-process and out-of-process frames that are handled
395differently, Chromium builds a separate independent accessibility tree
396for each frame. Each frame gets its own tree ID, and it keeps track of
397the tree ID of its parent frame (if any) and any child frames.
398
399In Chrome's main browser process, the accessibility trees for each frame
400are cached separately, and when an accessibility client (assistive
401technology) walks the accessibility tree, Chromium dynamically composes
402all of the frames into a single virtual accessibility tree on the fly,
403using those aforementioned tree IDs.
404
405The node IDs for accessibility trees only need to be unique within a
406single frame. Where necessary, separate unique IDs are used within
407Chrome's main browser process. In Chromium accessibility, a "node ID"
408always means that ID that's only unique within a frame, and a "unique ID"
409means an ID that's globally unique.
410
411## Blink
412
413Blink constructs an accessibility tree (a hierarchy of [WebAXObject]s) from the
sashabb498325a2017-05-17 01:18:46414page it is rendering. WebAXObject is the public API wrapper around [AXObject],
415which is the core class of Blink's accessibility tree. AXObject is an abstract
dmazzoni2f489752017-02-16 03:39:16416class; the most commonly used concrete subclass of it is [AXNodeObject], which
417wraps a [Node]. In turn, most AXNodeObjects are actually [AXLayoutObject]s,
418which wrap both a [Node] and a [LayoutObject]. Access to the LayoutObject is
sashabb498325a2017-05-17 01:18:46419important because some elements are only in the AXObject tree depending on their
dmazzoni2f489752017-02-16 03:39:16420visibility, geometry, linewrapping, and so on. There are some subclasses of
421AXLayoutObject that implement special-case logic for specific types of Node.
sashabb498325a2017-05-17 01:18:46422There are also other subclasses of AXObject, which are mostly used for testing.
dmazzoni2f489752017-02-16 03:39:16423
424Note that not all AXLayoutObjects correspond to actual Nodes; some are synthetic
425layout objects which group related inline elements or similar.
426
427The central class responsible for dealing with accessibility events in Blink is
428[AXObjectCacheImpl], which is responsible for caching the corresponding
429AXObjects for Nodes or LayoutObjects. This class has many methods named
430`handleFoo`, which are called throughout Blink to notify the AXObjectCacheImpl
431that it may need to update its tree. Since this class is already aware of all
432accessibility events in Blink, it is also responsible for relaying accessibility
433events from Blink to the embedding content layer.
434
435## The content layer
436
437The content layer lives on both sides of the renderer/browser split. The content
438layer translates WebAXObjects into [AXContentNodeData], which is a subclass of
439[ui::AXNodeData]. The ui::AXNodeData class and related classes are Chromium's
440cross-platform accessibility tree. The translation is implemented in
441[BlinkAXTreeSource]. This translation happens on the renderer side, so the
442ui::AXNodeData tree now needs to be sent to the browser, which is done by
443sending [AccessibilityHostMsg_EventParams] with the payload being serialized
444delta-updates to the tree, so that changes that happen on the renderer side can
445be reflected on the browser side.
446
447On the browser side, these IPCs are received by [RenderFrameHostImpl], and then
448usually forwarded to [BrowserAccessibilityManager] which is responsible for:
449
4501. Merging AXNodeData trees into one tree of [BrowserAccessibility] objects,
451 by linking to other BrowserAccessibilityManagers. This is important because
452 each page has its own accessibility tree, but each Chromium *window* must
453 have only one accessibility tree, so trees from multiple pages need to be
454 combined (possibly also with trees from Views UI).
4552. Dispatching outgoing accessibility events to the platform's accessibility
456 APIs. This is done in the platform-specific subclasses of
457 BrowserAccessibilityManager, in a method named `NotifyAccessibilityEvent`.
4583. Dispatching incoming accessibility actions to the appropriate recipient, via
459 [BrowserAccessibilityDelegate]. For messages destined for a renderer,
460 [RenderFrameHostImpl], which is a BrowserAccessibilityDelegate, is
461 responsible for sending appropriate `AccessibilityMsg_Foo` IPCs to the
462 renderer, where they will be received by [RenderAccessibilityImpl].
463
464On Chrome OS, RenderFrameHostImpl does not route events to
465BrowserAccessibilityManager at all, since there is no platform screenreader
466outside Chromium to integrate with.
467
468## Views
469
470Views generates a [NativeViewAccessibility] for each View, which is used as the
471delegate for an [AXPlatformNode] representing that View. This part is relatively
472straightforward, but then the generated tree must be combined with the web
473accessibility tree, which is handled by BrowserAccessibilityManager.
474
475## WebUI
476
477Since WebUI surfaces have renderer processes as normal, WebUI accessibility goes
478through the blink-to-content-to-platform pipeline described above. Accessibility
479for WebUI is largely implemented in JavaScript in [webui-js]; these classes take
480care of adding ARIA attributes and so on to DOM nodes as needed.
481
482## The Chrome OS layer
483
484The accessibility tree is also exposed via the [chrome.automation API], which
485gives extension JavaScript access to the accessibility tree, events, and
486actions. This API is implemented in C++ by [AutomationInternalCustomBindings],
487which is renderer-side code, and in JavaScript by the [automation API]. The API
488is defined by [automation.idl], which must be kept synchronized with
489[ax_enums.idl].
490
491[AccessibilityHostMsg_EventParams]: https://cs.chromium.org/chromium/src/content/common/accessibility_messages.h?sq=package:chromium&l=75
492[AutomationInternalCustomBindings]: https://cs.chromium.org/chromium/src/chrome/renderer/extensions/automation_internal_custom_bindings.h
493[AXContentNodeData]: https://cs.chromium.org/chromium/src/content/common/ax_content_node_data.h
494[AXLayoutObject]: https://cs.chromium.org/chromium/src/third_party/WebKit/Source/modules/accessibility/AXLayoutObject.h
495[AXNodeObject]: https://cs.chromium.org/chromium/src/third_party/WebKit/Source/modules/accessibility/AXNodeObject.h
sashab0cd996b2017-05-17 07:31:46496[AXObjectImpl]: https://cs.chromium.org/chromium/src/third_party/WebKit/Source/modules/accessibility/AXObjectImpl.h
dmazzoni2f489752017-02-16 03:39:16497[AXObjectCacheImpl]: https://cs.chromium.org/chromium/src/third_party/WebKit/Source/modules/accessibility/AXObjectCacheImpl.h
498[AXPlatformNode]: https://cs.chromium.org/chromium/src/ui/accessibility/platform/ax_platform_node.h
499[AXTreeSerializer]: https://cs.chromium.org/chromium/src/ui/accessibility/ax_tree_serializer.h
500[BlinkAXTreeSource]: https://cs.chromium.org/chromium/src/content/renderer/accessibility/blink_ax_tree_source.h
501[BrowserAccessibility]: https://cs.chromium.org/chromium/src/content/browser/accessibility/browser_accessibility.h
502[BrowserAccessibilityDelegate]: https://cs.chromium.org/chromium/src/content/browser/accessibility/browser_accessibility_manager.h?sq=package:chromium&l=64
503[BrowserAccessibilityManager]: https://cs.chromium.org/chromium/src/content/browser/accessibility/browser_accessibility_manager.h
504[LayoutObject]: https://cs.chromium.org/chromium/src/third_party/WebKit/Source/core/layout/LayoutObject.h
505[NativeViewAccessibility]: https://cs.chromium.org/chromium/src/ui/views/accessibility/native_view_accessibility.h
506[Node]: https://cs.chromium.org/chromium/src/third_party/WebKit/Source/core/dom/Node.h
507[RenderAccessibilityImpl]: https://cs.chromium.org/chromium/src/content/renderer/accessibility/render_accessibility_impl.h
508[RenderFrameHostImpl]: https://cs.chromium.org/chromium/src/content/browser/frame_host/render_frame_host_impl.h
509[ui::AXNodeData]: https://cs.chromium.org/chromium/src/ui/accessibility/ax_node_data.h
510[WebAXObject]: https://cs.chromium.org/chromium/src/third_party/WebKit/public/web/WebAXObject.h
511[automation API]: https://cs.chromium.org/chromium/src/chrome/renderer/resources/extensions/automation
512[automation.idl]: https://cs.chromium.org/chromium/src/chrome/common/extensions/api/automation.idl
513[ax_enums.idl]: https://cs.chromium.org/chromium/src/ui/accessibility/ax_enums.idl
514[chrome.automation API]: https://developer.chrome.com/extensions/automation
515[webui-js]: https://cs.chromium.org/chromium/src/ui/webui/resources/js/cr/ui/