1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
|
/*
* Copyright (C) 2011 Apple Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS''
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
* THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
* THE POSSIBILITY OF SUCH DAMAGE.
*/
interface AccessibilityUIElement {
boolean isEqual(AccessibilityUIElement otherElement);
// Document information
readonly attribute DOMString documentEncoding;
readonly attribute DOMString documentURI;
// Element access.
AccessibilityUIElement elementAtPoint(int x, int y);
AccessibilityUIElement childAtIndex(unsigned long index);
unsigned long indexOfChild(AccessibilityUIElement child);
AccessibilityUIElement linkedUIElementAtIndex(unsigned long index);
AccessibilityUIElement selectedChildAtIndex(unsigned long index);
void setSelectedChild(AccessibilityUIElement element);
void setSelectedChildAtIndex(unsigned long index);
void removeSelectionAtIndex(unsigned long index);
AccessibilityUIElement titleUIElement();
AccessibilityUIElement parentElement();
readonly attribute DOMString role;
readonly attribute DOMString subrole;
readonly attribute DOMString roleDescription;
readonly attribute DOMString computedRoleString;
readonly attribute DOMString title;
readonly attribute DOMString description;
readonly attribute DOMString language;
readonly attribute DOMString helpText;
readonly attribute DOMString valueDescription;
readonly attribute DOMString url;
readonly attribute DOMString speak;
readonly attribute DOMString orientation;
readonly attribute int insertionPointLineNumber;
readonly attribute DOMString selectedTextRange;
DOMString stringAttributeValue(DOMString attr);
double numberAttributeValue(DOMString attr);
object uiElementArrayAttributeValue(DOMString attr);
AccessibilityUIElement uiElementAttributeValue(DOMString attr);
boolean boolAttributeValue(DOMString attr);
void setBoolAttributeValue(DOMString attr, boolean value);
boolean isAttributeSupported(DOMString attr);
boolean isAttributeSettable(DOMString attr);
boolean isPressActionSupported();
boolean isIncrementActionSupported();
boolean isDecrementActionSupported();
readonly attribute DOMString stringValue;
readonly attribute int intValue;
readonly attribute int minValue;
readonly attribute int maxValue;
readonly attribute boolean isEnabled;
readonly attribute boolean isRequired;
readonly attribute boolean isFocused;
readonly attribute boolean isFocusable;
readonly attribute boolean isSelectable;
readonly attribute boolean isSelected;
readonly attribute boolean isSelectedOptionActive;
readonly attribute boolean isMultiSelectable;
readonly attribute boolean isExpanded;
readonly attribute boolean isChecked;
readonly attribute boolean isIndeterminate;
readonly attribute boolean isVisible;
readonly attribute boolean isCollapsed;
readonly attribute boolean hasPopup;
readonly attribute boolean isIgnored;
readonly attribute boolean isOffScreen;
readonly attribute boolean isValid;
readonly attribute int hierarchicalLevel;
readonly attribute boolean ariaIsGrabbed;
readonly attribute DOMString ariaDropEffects;
readonly attribute DOMString classList;
readonly attribute int x;
readonly attribute int y;
readonly attribute int width;
readonly attribute int height;
readonly attribute int clickPointX;
readonly attribute int clickPointY;
readonly attribute int childrenCount;
readonly attribute int selectedChildrenCount;
readonly attribute int rowCount;
readonly attribute int columnCount;
// Actions.
void increment();
void decrement();
void press();
void showMenu();
// Attribute info.
DOMString allAttributes();
DOMString attributesOfChildren();
DOMString attributesOfLinkedUIElements();
DOMString attributesOfDocumentLinks();
// Text info.
DOMString characterAtOffset(int offset);
DOMString wordAtOffset(int offset);
DOMString lineAtOffset(int offset);
DOMString sentenceAtOffset(int offset);
// Table info.
DOMString attributesOfColumnHeaders();
DOMString attributesOfRowHeaders();
DOMString attributesOfColumns();
DOMString attributesOfRows();
DOMString attributesOfVisibleCells();
DOMString attributesOfHeader();
AccessibilityUIElement cellForColumnAndRow(unsigned long column, unsigned long row);
AccessibilityUIElement selectedRowAtIndex(unsigned long index);
AccessibilityUIElement disclosedByRow();
AccessibilityUIElement disclosedRowAtIndex(unsigned long index);
AccessibilityUIElement rowAtIndex(unsigned long index);
int indexInTable();
DOMString rowIndexRange();
DOMString columnIndexRange();
int rowCount();
int columnCount();
object columnHeaders();
object rowHeaders();
AccessibilityUIElement ariaOwnsElementAtIndex(unsigned long index);
AccessibilityUIElement ariaFlowToElementAtIndex(unsigned long index);
AccessibilityUIElement ariaControlsElementAtIndex(unsigned long index);
// Paramaterized attributes.
DOMString parameterizedAttributeNames();
int lineForIndex(int index);
DOMString rangeForLine(int index);
DOMString rangeForPosition(int x, int y);
DOMString boundsForRange(unsigned long location, unsigned long length);
DOMString stringForRange(unsigned long location, unsigned long length);
DOMString attributedStringForRange(unsigned long location, unsigned long length);
boolean attributedStringRangeIsMisspelled(unsigned long location, unsigned long length);
[PassContext] unsigned int uiElementCountForSearchPredicate(AccessibilityUIElement startElement, boolean isDirectionNext, object searchKey, DOMString searchText, boolean visibleOnly, boolean immediateDescendantsOnly);
[PassContext] AccessibilityUIElement uiElementForSearchPredicate(AccessibilityUIElement startElement, boolean isDirectionNext, object searchKey, DOMString searchText, boolean visibleOnly, boolean immediateDescendantsOnly);
[PassContext] DOMString selectTextWithCriteria(DOMString ambiguityResolution, object searchStrings, DOMString replacementString, DOMString activity);
boolean setSelectedTextRange(unsigned long location, unsigned long length);
// Scroll area attributes.
readonly attribute AccessibilityUIElement horizontalScrollbar;
readonly attribute AccessibilityUIElement verticalScrollbar;
void scrollToMakeVisible();
void scrollToGlobalPoint(int x, int y);
void scrollToMakeVisibleWithSubFocus(int x, int y, int width, int height);
void takeFocus();
boolean scrollPageDown();
boolean scrollPageUp();
boolean scrollPageLeft();
boolean scrollPageRight();
// Text markers.
AccessibilityTextMarkerRange lineTextMarkerRangeForTextMarker(AccessibilityTextMarker textMarker);
AccessibilityTextMarkerRange textMarkerRangeForElement(AccessibilityUIElement element);
AccessibilityTextMarkerRange textMarkerRangeForMarkers(AccessibilityTextMarker startMarker, AccessibilityTextMarker endMarker);
AccessibilityTextMarkerRange selectedTextMarkerRange();
void resetSelectedTextMarkerRange();
AccessibilityTextMarker startTextMarkerForTextMarkerRange(AccessibilityTextMarkerRange range);
AccessibilityTextMarker endTextMarkerForTextMarkerRange(AccessibilityTextMarkerRange range);
AccessibilityTextMarker endTextMarkerForBounds(int x, int y, int width, int height);
AccessibilityTextMarker startTextMarkerForBounds(int x, int y, int width, int height);
AccessibilityTextMarker textMarkerForPoint(int x, int y);
AccessibilityTextMarker previousTextMarker(AccessibilityTextMarker marker);
AccessibilityTextMarker nextTextMarker(AccessibilityTextMarker marker);
AccessibilityUIElement accessibilityElementForTextMarker(AccessibilityTextMarker marker);
DOMString stringForTextMarkerRange(AccessibilityTextMarkerRange range);
int textMarkerRangeLength(AccessibilityTextMarkerRange range);
boolean attributedStringForTextMarkerRangeContainsAttribute(DOMString attr, AccessibilityTextMarkerRange range);
int indexForTextMarker(AccessibilityTextMarker marker);
boolean isTextMarkerValid(AccessibilityTextMarker marker);
AccessibilityTextMarker textMarkerForIndex(int textIndex);
readonly attribute AccessibilityTextMarker startTextMarker;
readonly attribute AccessibilityTextMarker endTextMarker;
boolean setSelectedVisibleTextRange(AccessibilityTextMarkerRange range);
AccessibilityTextMarkerRange leftWordTextMarkerRangeForTextMarker(AccessibilityTextMarker textMarker);
AccessibilityTextMarkerRange rightWordTextMarkerRangeForTextMarker(AccessibilityTextMarker textMarker);
AccessibilityTextMarker previousWordStartTextMarkerForTextMarker(AccessibilityTextMarker textMarker);
AccessibilityTextMarker nextWordEndTextMarkerForTextMarker(AccessibilityTextMarker textMarker);
AccessibilityTextMarkerRange paragraphTextMarkerRangeForTextMarker(AccessibilityTextMarker textMarker);
AccessibilityTextMarker previousParagraphStartTextMarkerForTextMarker(AccessibilityTextMarker textMarker);
AccessibilityTextMarker nextParagraphEndTextMarkerForTextMarker(AccessibilityTextMarker textMarker);
AccessibilityTextMarkerRange sentenceTextMarkerRangeForTextMarker(AccessibilityTextMarker textMarker);
AccessibilityTextMarker previousSentenceStartTextMarkerForTextMarker(AccessibilityTextMarker textMarker);
AccessibilityTextMarker nextSentenceEndTextMarkerForTextMarker(AccessibilityTextMarker textMarker);
// Returns an ordered list of supported actions for an element.
readonly attribute DOMString supportedActions;
readonly attribute DOMString mathPostscriptsDescription;
readonly attribute DOMString mathPrescriptsDescription;
readonly attribute DOMString pathDescription;
// iOS specific accessibility methods.
readonly attribute DOMString identifier;
readonly attribute DOMString traits;
readonly attribute int elementTextPosition;
readonly attribute int elementTextLength;
readonly attribute DOMString stringForSelection;
object elementsForRange(unsigned long location, unsigned long length);
void increaseTextSelection();
void decreaseTextSelection();
AccessibilityUIElement linkedElement();
AccessibilityUIElement headerElementAtIndex(unsigned long index);
// This will simulate the accessibilityDidBecomeFocused API in UIKit.
void assistiveTechnologySimulatedFocus();
readonly attribute boolean isSearchField;
readonly attribute boolean isTextArea;
// Fieldset
readonly attribute boolean hasContainedByFieldsetTrait;
AccessibilityUIElement fieldsetAncestorElement();
// Notification support.
boolean addNotificationListener(object callbackFunction);
boolean removeNotificationListener();
};
|
