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 170 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
181 webView, | 181 webView, |
182 window | 182 window |
183 }; | 183 }; |
184 | 184 |
185 // Describes characteristics of an $(ref:automation.AutomationNode). | 185 // Describes characteristics of an $(ref:automation.AutomationNode). |
186 enum StateType { | 186 enum StateType { |
187 busy, | 187 busy, |
188 checked, | 188 checked, |
189 collapsed, | 189 collapsed, |
190 default, | 190 default, |
191 disabled, // ui/views only | 191 disabled, |
192 editable, | 192 editable, |
193 enabled, // content only | |
194 expanded, | 193 expanded, |
195 focusable, | 194 focusable, |
196 focused, | 195 focused, |
197 haspopup, | 196 haspopup, |
198 horizontal, | 197 horizontal, |
199 hovered, | 198 hovered, |
200 invisible, | 199 invisible, |
201 linked, | 200 linked, |
202 multiline, | 201 multiline, |
203 multiselectable, | 202 multiselectable, |
(...skipping 52 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
256 long width; | 255 long width; |
257 long height; | 256 long height; |
258 }; | 257 }; |
259 | 258 |
260 // Arguments for the find() and findAll() methods. | 259 // Arguments for the find() and findAll() methods. |
261 [nocompile, noinline_doc] dictionary FindParams { | 260 [nocompile, noinline_doc] dictionary FindParams { |
262 automation.RoleType? role; | 261 automation.RoleType? role; |
263 | 262 |
264 // A map of $(ref:automation.StateType) to boolean, indicating for each | 263 // A map of $(ref:automation.StateType) to boolean, indicating for each |
265 // state whether it should be set or not. For example: | 264 // state whether it should be set or not. For example: |
266 // <code>{ StateType.enabled: false }</code> would only match if | 265 // <code>{ StateType.disabled: false }</code> would only match if |
267 // <code>StateType.enabled</code> was <em>not</em> present in the node's | 266 // <code>StateType.disabled</code> was <em>not</em> present in the node's |
268 // <code>state</code> object. | 267 // <code>state</code> object. |
269 object? state; | 268 object? state; |
270 | 269 |
271 // A map of attribute name to expected value, for example | 270 // A map of attribute name to expected value, for example |
272 // <code>{ name: 'Root directory', checkbox_mixed: true }</code>. | 271 // <code>{ name: 'Root directory', checkbox_mixed: true }</code>. |
273 // String attribute values may be specified as a regex, for example | 272 // String attribute values may be specified as a regex, for example |
274 // <code>{ name: /stralia$/</code> }</code>. | 273 // <code>{ name: /stralia$/</code> }</code>. |
275 // Unless specifying a regex, the expected value must be an exact match | 274 // Unless specifying a regex, the expected value must be an exact match |
276 // in type and value for the actual value. Thus, the type of expected value | 275 // in type and value for the actual value. Thus, the type of expected value |
277 // must be one of: | 276 // must be one of: |
(...skipping 367 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
645 // Everything in the tree between the two node/offset pairs gets included | 644 // Everything in the tree between the two node/offset pairs gets included |
646 // in the selection. The anchor is where the user started the selection, | 645 // in the selection. The anchor is where the user started the selection, |
647 // while the focus is the point at which the selection gets extended | 646 // while the focus is the point at which the selection gets extended |
648 // e.g. when dragging with a mouse or using the keyboard. For nodes with | 647 // e.g. when dragging with a mouse or using the keyboard. For nodes with |
649 // the role staticText, the offset gives the character offset within | 648 // the role staticText, the offset gives the character offset within |
650 // the value where the selection starts or ends, respectively. | 649 // the value where the selection starts or ends, respectively. |
651 [nocompile] static void setDocumentSelection( | 650 [nocompile] static void setDocumentSelection( |
652 SetDocumentSelectionParams params); | 651 SetDocumentSelectionParams params); |
653 }; | 652 }; |
654 }; | 653 }; |
OLD | NEW |