| 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 | |
| 233 // Possible changes to the automation tree. For any given atomic change | 219 // Possible changes to the automation tree. For any given atomic change |
| 234 // to the tree, each node that's added, removed, or changed, will appear | 220 // to the tree, each node that's added, removed, or changed, will appear |
| 235 // in exactly one TreeChange, with one of these types. | 221 // in exactly one TreeChange, with one of these types. |
| 236 // | 222 // |
| 237 // | 223 // |
| 238 // nodeCreated means that this node was added to the tree and its parent is | 224 // nodeCreated means that this node was added to the tree and its parent is |
| 239 // new as well, so it's just one node in a new subtree that was added. | 225 // new as well, so it's just one node in a new subtree that was added. |
| 240 enum TreeChangeType { | 226 enum TreeChangeType { |
| 241 /** | 227 /** |
| 242 * This node was added to the tree and its parent is new as well, | 228 * 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... |
| 585 | 571 |
| 586 // Places focus on this node. | 572 // Places focus on this node. |
| 587 static void focus(); | 573 static void focus(); |
| 588 | 574 |
| 589 // Scrolls this node to make it visible. | 575 // Scrolls this node to make it visible. |
| 590 static void makeVisible(); | 576 static void makeVisible(); |
| 591 | 577 |
| 592 // Sets selection within a text field. | 578 // Sets selection within a text field. |
| 593 static void setSelection(long startIndex, long endIndex); | 579 static void setSelection(long startIndex, long endIndex); |
| 594 | 580 |
| 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 |
| 595 // Adds a listener for the given event type and event phase. | 585 // Adds a listener for the given event type and event phase. |
| 596 static void addEventListener( | 586 static void addEventListener( |
| 597 EventType eventType, AutomationListener listener, boolean capture); | 587 EventType eventType, AutomationListener listener, boolean capture); |
| 598 | 588 |
| 599 // Removes a listener for the given event type and event phase. | 589 // Removes a listener for the given event type and event phase. |
| 600 static void removeEventListener( | 590 static void removeEventListener( |
| 601 EventType eventType, AutomationListener listener, boolean capture); | 591 EventType eventType, AutomationListener listener, boolean capture); |
| 602 | 592 |
| 603 // Gets the first node in this node's subtree which matches the given CSS | 593 // Gets the first node in this node's subtree which matches the given CSS |
| 604 // selector and is within the same DOM context. | 594 // selector and is within the same DOM context. |
| (...skipping 61 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 666 // Everything in the tree between the two node/offset pairs gets included | 656 // Everything in the tree between the two node/offset pairs gets included |
| 667 // in the selection. The anchor is where the user started the selection, | 657 // in the selection. The anchor is where the user started the selection, |
| 668 // while the focus is the point at which the selection gets extended | 658 // while the focus is the point at which the selection gets extended |
| 669 // e.g. when dragging with a mouse or using the keyboard. For nodes with | 659 // e.g. when dragging with a mouse or using the keyboard. For nodes with |
| 670 // the role staticText, the offset gives the character offset within | 660 // the role staticText, the offset gives the character offset within |
| 671 // the value where the selection starts or ends, respectively. | 661 // the value where the selection starts or ends, respectively. |
| 672 [nocompile] static void setDocumentSelection( | 662 [nocompile] static void setDocumentSelection( |
| 673 SetDocumentSelectionParams params); | 663 SetDocumentSelectionParams params); |
| 674 }; | 664 }; |
| 675 }; | 665 }; |
| OLD | NEW |