| OLD | NEW |
| 1 // Copyright 2014 The Chromium Authors. All rights reserved. | 1 // Copyright 2014 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 // The <code>chrome.automation</code> API allows developers to access the | 5 // The <code>chrome.automation</code> API allows developers to access the |
| 6 // automation (accessibility) tree for the browser. The tree resembles the DOM | 6 // automation (accessibility) tree for the browser. The tree resembles the DOM |
| 7 // tree, but only exposes the <em>semantic</em> structure of a page. It can be | 7 // tree, but only exposes the <em>semantic</em> structure of a page. It can be |
| 8 // used to programmatically interact with a page by examining names, roles, and | 8 // used to programmatically interact with a page by examining names, roles, and |
| 9 // states, listening for events, and performing actions on nodes. | 9 // states, listening for events, and performing actions on nodes. |
| 10 [nocompile] namespace automation { | 10 [nocompile] namespace automation { |
| (...skipping 198 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 209 protected, | 209 protected, |
| 210 readOnly, | 210 readOnly, |
| 211 required, | 211 required, |
| 212 richlyEditable, | 212 richlyEditable, |
| 213 selectable, | 213 selectable, |
| 214 selected, | 214 selected, |
| 215 vertical, | 215 vertical, |
| 216 visited | 216 visited |
| 217 }; | 217 }; |
| 218 | 218 |
| 219 // Actions that can be taken on an $(ref:automation.AutomationNode). |
| 220 enum ActionType { |
| 221 doDefault, |
| 222 hitTest, |
| 223 scrollToMakeVisible, |
| 224 scrollToPoint, |
| 225 setAccessibilityFocus, |
| 226 setFocus, |
| 227 setScrollOffset, |
| 228 setSelection, |
| 229 setValue, |
| 230 showContextMenu |
| 231 }; |
| 232 |
| 219 // Possible changes to the automation tree. For any given atomic change | 233 // Possible changes to the automation tree. For any given atomic change |
| 220 // to the tree, each node that's added, removed, or changed, will appear | 234 // to the tree, each node that's added, removed, or changed, will appear |
| 221 // in exactly one TreeChange, with one of these types. | 235 // in exactly one TreeChange, with one of these types. |
| 222 // | 236 // |
| 223 // | 237 // |
| 224 // nodeCreated means that this node was added to the tree and its parent is | 238 // nodeCreated means that this node was added to the tree and its parent is |
| 225 // new as well, so it's just one node in a new subtree that was added. | 239 // new as well, so it's just one node in a new subtree that was added. |
| 226 enum TreeChangeType { | 240 enum TreeChangeType { |
| 227 /** | 241 /** |
| 228 * This node was added to the tree and its parent is new as well, | 242 * This node was added to the tree and its parent is new as well, |
| (...skipping 342 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 571 | 585 |
| 572 // Places focus on this node. | 586 // Places focus on this node. |
| 573 static void focus(); | 587 static void focus(); |
| 574 | 588 |
| 575 // Scrolls this node to make it visible. | 589 // Scrolls this node to make it visible. |
| 576 static void makeVisible(); | 590 static void makeVisible(); |
| 577 | 591 |
| 578 // Sets selection within a text field. | 592 // Sets selection within a text field. |
| 579 static void setSelection(long startIndex, long endIndex); | 593 static void setSelection(long startIndex, long endIndex); |
| 580 | 594 |
| 581 // Clears focus and sets this node as the starting point for the next | |
| 582 // time the user presses Tab or Shift+Tab. | |
| 583 static void setSequentialFocusNavigationStartingPoint(); | |
| 584 | |
| 585 // Adds a listener for the given event type and event phase. | 595 // Adds a listener for the given event type and event phase. |
| 586 static void addEventListener( | 596 static void addEventListener( |
| 587 EventType eventType, AutomationListener listener, boolean capture); | 597 EventType eventType, AutomationListener listener, boolean capture); |
| 588 | 598 |
| 589 // Removes a listener for the given event type and event phase. | 599 // Removes a listener for the given event type and event phase. |
| 590 static void removeEventListener( | 600 static void removeEventListener( |
| 591 EventType eventType, AutomationListener listener, boolean capture); | 601 EventType eventType, AutomationListener listener, boolean capture); |
| 592 | 602 |
| 593 // Gets the first node in this node's subtree which matches the given CSS | 603 // Gets the first node in this node's subtree which matches the given CSS |
| 594 // selector and is within the same DOM context. | 604 // selector and is within the same DOM context. |
| (...skipping 61 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 656 // Everything in the tree between the two node/offset pairs gets included | 666 // Everything in the tree between the two node/offset pairs gets included |
| 657 // in the selection. The anchor is where the user started the selection, | 667 // in the selection. The anchor is where the user started the selection, |
| 658 // while the focus is the point at which the selection gets extended | 668 // while the focus is the point at which the selection gets extended |
| 659 // e.g. when dragging with a mouse or using the keyboard. For nodes with | 669 // e.g. when dragging with a mouse or using the keyboard. For nodes with |
| 660 // the role staticText, the offset gives the character offset within | 670 // the role staticText, the offset gives the character offset within |
| 661 // the value where the selection starts or ends, respectively. | 671 // the value where the selection starts or ends, respectively. |
| 662 [nocompile] static void setDocumentSelection( | 672 [nocompile] static void setDocumentSelection( |
| 663 SetDocumentSelectionParams params); | 673 SetDocumentSelectionParams params); |
| 664 }; | 674 }; |
| 665 }; | 675 }; |
| OLD | NEW |