MozillaWiki

Accessibility/Comparisons:Roles: Difference between revisions

Page Discussion

Accessibility/Comparisons:Roles (view source)

Revision as of 13:34, 26 May 2006

251 bytes added ,  26 May 2006
→‎Color legend
(fix broken link)
 
(6 intermediate revisions by the same user not shown)
Line 8: Line 8:
--[[User:Hwaara|HakanW]] 12:24, 9 May 2006 (PDT)
--[[User:Hwaara|HakanW]] 12:24, 9 May 2006 (PDT)


=== Color legend ===
=== Legend ===
<table border="1"><tr><th>Color legend</th></tr>
<table border="1"><tr><th>Legend</th></tr>
<tr><td class="OK">UA seems compatible</td></tr>
<tr><td class="OK">[OK] UA seems compatible</td></tr>
<tr><td class="maybe">UA probably compatible</td></tr>
<tr><td class="maybe">[MAYBE] UA probably compatible</td></tr>
<tr><td class="irrelevant">Seems irrelevant?</td></tr>
<tr><td class="irrelevant">[NOT NEEDED] Irrelevant</td></tr>
<tr><td>Not yet done / Undecided (white).</td></tr>
<tr><td>Not yet sure; TBD</td></tr>
</table>
</table>


== Comparison Table ==
== Comparison Table ==  
<table border="1"> <tr> <th>MSAA 1.3 Role (ROLE_SYSTEM_ *)</th>
<table border="1">
<tr>
<th>
MSAA 1.3 Role (ROLE_SYSTEM_ *)
</th>
<th>
Closest ATK Role(s) (ATK_ROLE_*)
</th>
<th>
Closest UA Role (NSAccessibility*Role)
</th>
<th>
Description
</th>
</tr>
<tr>
<td>
ALERT
</td>
<td>
ALERT
</td>
<td>
TBD
</td>
TBD
<td>
An error, warning, or informational message
</td>
</tr>
<tr class="OK">
<td>
APPLICATION
</td>
<td>
APPLICATION
</td>
<td> [OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_2.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_8 Application]
</td>
<td>
Toplevel accessible object of an application, which may contain frame objects or other accessible objects.
</td>
</tr>
<tr class="OK">
<td>
BUTTONMENU
</td>
<td>
add custom role
</td>
<td>[OK]
MenuButton
</td>
<td>
Button that drops down a menu
</td>
</tr>
<tr>
<td>
CELL
</td>
<td>
TABLE_CELL
</td>
<td>
TBD
</td>
<td>
Cell in a table
</td>
</tr>
<tr>
<td>
CHART
</td>
<td>
CHART (proposed)
</td>
<td>
TBD
</td>
<td>
Graphical depiction of quantitative data
</td>
</tr>
<tr>
<td class="OK">
CHECKBUTTON
</td>
<td class="OK">
CHECK_BOX, CHECK_MENU_ITEM, TOGGLE_BUTTON
</td>
<td class="OK">[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_10.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_15 CheckBox]
</td>
<td class="OK">
Choice that can be checked or unchecked. A checkbox and check menu item have a separate indicator for the state. A toggle button is a specialized push button that does not have a separate indicator for the state.
</td>
</tr>
<tr>
<td class="OK">
COLUMN
</td>
<td class="OK">
don't use
</td>
<td class="OK">[OK]
Column
</td>
<td class="OK">
Column of table cells.
</td>
</tr>
<tr class="OK">
<td>
COLUMNHEADER
</td>
<td>
TABLE_COLUMN_HEADER, COLUMN_HEADER
</td>
<td>[OK]
Get the NSAccessibilityHeaderAttribute on a&nbsp;[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_14.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_19 Table]
</td>
<td>
Header which labels a column of data, or more specifically a column of data in a table.
</td>
</tr>
<tr class="OK">
<td>
COMBOBOX
</td>
<td>
COMBO_BOX
</td>
<td>[OK]
ComboBox
</td>
<td>
Edit control with a drop-down list of selections
</td>
</tr>
<tr class="OK">
<td>
DIAGRAM
</td>
<td>
IMAGE, DRAWING_AREA, or add custom role
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_7.html#//apple_ref/doc/uid/TPhttp://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_7.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_1340001078-CH211-DontLinkElementID_13 Image]?
</td>
<td>
Image is a generic graphic. Diagram is a specific type of a drawn graphic. Drawing area is used for creating custom user interface elements.
</td>
</tr>
<tr class="OK">
<td>
DIALOG
</td>
<td>
DIALOG, COLOR_CHOOSER, FILE_CHOOSER
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_3.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_9 Window] with dialog subrole (sometimes Sheet)
</td>
<td>
Top level window with a title bar and border. A file chooser is a specialized dialog that displays files in a directory and allows file selection, directory browsing, and filename specification. A color chooser is a specialized dialog for choosing a color.
</td>
</tr>
<tr class="OK">
<td>
DOCUMENT
</td>
<td>
HTML_CONTAINER or DOCUMENT_FRAME (proposed)
</td>
<td>[OK]
Use custom role WebArea like Safari for the actual web browser view? Window for the actual window.
</td>
<td>
For MSAA, a document is a window that corresponds to MDI document. An HTML container or document frame is an HTML document or a frame containing a view of document content.
</td>
</tr>
<tr class="OK">
<td>
DROPLIST
</td>
<td>
add custom role or COMBO_BOX
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_23.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_28 ComboBox]?&nbsp;
</td>
<td>
Drop down list but not a combo box
</td>
</tr>
<tr>
<td>
EQUATION
</td>
<td>
add custom role
</td>
<td>
TBD
</td>
<td>
Math and chemistry equations
</td>
</tr>
<tr class="OK">
<td>
GRAPHIC
</td>
<td>
IMAGE, DESKTOP_ICON
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_7.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_13 Image]
</td>
<td>
Graphic or an icon
</td>
</tr>
<tr class="OK">
<td>
GRIP
</td>
<td>
add custom role
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_39.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_42 SplitterBar]
</td>
<td>
Mouse pointer used for resizing windows.
</td>
</tr>
<tr class="OK">
<td>
GROUPING
</td>
<td>
PANEL, PAGE (proposed), SECTION (proposed)
</td>
<td>[OK]
Group
</td>
<td>
Container used to group objects, like a group box or a FIELDSET in HTML. A page is defined for documents. A section is a generic container of content within a document, such as a navigation bar, table of contents, main content section, content between headings, etc.
</td>
</tr>
<tr class="OK">
<td>
HELPBALLOON
</td>
<td>
add custom role
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_8.html#//apple_ref/doc/uid/TP40001078-CH211-CACDEHBG Button] with DescriptionAttribute="Help"
</td>
<td>
Help icon to click on to get tooltip help
</td>
</tr>
<tr class="OK">
<td>
LINK
</td>
<td>
LINK (proposed)
</td>
<td>[OK]
[http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/ObjC_classic/Protocols/NSAccessibility.html#//apple_ref/doc/c_ref/NSAccessibilityMarkerTypeAttribute TextLink]<span class="content_text">
<code>
</code>
</span>
</td>
<td>
Hypertext link in a document that can be an image or text
</td>
</tr>
<tr class="OK">
<td>
LIST
</td>
<td>
LIST, FONT_CHOOSER
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_21.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_26 List]
</td>
<td>
List of objects that allows one or more selections. A font chooser allows selection of a display font.
</td>
</tr>
<tr class="OK">
<td>
LISTITEM
</td>
<td>
LISTITEM
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_17.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_22 Row]?
</td>
<td>
Element in a selectable list
</td>
</tr>
<tr class="OK">
<td>
MENUBAR
</td>
<td>
MENU_BAR
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_34.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_37 MenuBar]
</td>
<td>
Object drawn at the top of the primary window or dialog box of an application ((just below the title bar)) that contains a list of menus.
</td>
</tr>
<tr class="OK">
<td>
MENUITEM
</td>
<td>
MENU_ITEM, RADIO_MENU_ITEM, CHECK_MENU_ITEM
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_37.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_40 MenuItem], [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_35.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_38 MenuBarItem]
</td>
<td>
Element in a menu that presents a selectable action. A radio menu item is both a radio button and a menu item. A check menu item is both a check box and a menu item.
</td>
</tr>
<tr class="OK">
<td>
MENUPOPUP
</td>
<td>
MENU, POPUP_MENU, TEAROFF_MENU_ITEM
</td>
<td>[OK]
Menu, [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_12.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_17 MenuButton] (button with icon that pops up a menu when clicked) or [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_11.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_16 PopupButton] (regular popupmenu showing the current choice)
</td>
<td>
A menu is a list of actions from which the user can choose. A pop-up menu is a temporary window that offers the user a list of choices, then hides itself once the user selects one of those choices. A tearoff menu item is a is a menu that can be removed from the menubar and shown in its own window.
</td>
</tr>
<tr>
<td class="OK">
OUTLINE
</td>
<td class="OK">
TREE, TREE_TABLE
</td>
<td class="OK">[OK]
[http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/ObjC_classic/Protocols/NSAccessibility.html#//apple_ref/doc/c_ref/NSAccessibilityMarkerTypeAttribute Outline]
</td>
<td class="OK">
A tree or an outline is an object used to present hierarchical information to the user, usually with expandable/collapsable elements. A tree table presents both tabular and hierarchical information to the user.
</td>
</tr>
<tr>
<td class="OK">
OUTLINEITEM
</td>
<td class="OK">
use custom role
</td>
<td class="OK">[OK]
Row and subrole OutlineRow
</td>
<td class="OK">
A tree item.
</td>
</tr>
<tr class="OK">
<td>
PAGETAB
</td>
<td>
PAGE_TAB
</td>
<td>[OK] Use TabGroup and friends. We'll try to do this similarly to how XUL structures tabboxes, but since that will be different from how [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_13.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_18 TabGroup]s normally are represented in UA, we'll need to make sure VoiceOver and everything still works.
</td>
<td>
A tab that usually contains a label or title for a page or panel of a notebook container.
</td>
</tr>
<tr class="OK">
<td>
PAGETABLIST
</td>
<td>
PAGE_TAB_LIST
</td>
<td>[OK]
See TabGroup above.
</td>
<td>
A tabbed notebook container, or a series of panels presented as tabbed pages.
</td>
</tr>
<tr class="OK">
<td>
PANE
</td>
<td>
FRAME, INTERNAL_FRAME, GLASS_PANE, LAYERED_PANE, OPTION_PANE, SCROLL_PANE, DIRECTORY_PANE, DESKTOP_FRAME, ROOT_PANE, SPLIT_PANE, VIEWPORT
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_3.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_9 Window]&nbsp;(subroles StandardWindow), ScrollArea, SplitGroup (two adjacent "views" with a splitter bar), Browser (horizontal tree-like view often used for nagivating in the filesystem)
</td>
<td>
A pane or frame in the current window. A frame is a top level window with a title bar, border, menubar, etc. An internal frame is a frame clipped by a desktop pane. A glass pane is painted on top of all panes beneath it. A layered pane allows its children to be drawn in layers based on a stacking order. An option pane is a pane inside of a dialog. A scroll pane contains scroll bars. A directory pane contains selections (icons, lists, trees) for the content of a directory. A desktop frame is a pane that supports internal frames and icons for those internal frames. A root pane has a glass pane and a layered pane as its children. A split pane is a panel that presents two other panels at the same time. A viewport is a container of content, usually used in a scroll pane, that represents a clipped version of that pane that is onscreen (visible).
</td>
</tr>
<tr class="OK">
<td>
PROGRESSBAR
</td>
<td>
PROGRESS_BAR
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_27.html#//apple_ref/doc/uid/TP40001078-CH211-CACIAHEA ProgressIndicator]
</td>
<td>
Object that shows the percentage of a task that has completed.
</td>
</tr>
<tr class="OK">
<td>
PROPERTYPAGE
</td>
<td>
PAGE (proposed) or add custom role
</td>
<td>[OK]
Group with DescriptionAttribute describing special purpose?
</td>
<td>
Page showing properties of something.
</td>
</tr>
<tr class="OK">
<td>
PUSHBUTTON
</td>
<td>
PUSH_BUTTON, TOGGLE_BUTTON
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_8.html#//apple_ref/doc/uid/TP40001078-CH211-CACDEHBG Button] (see also subrole ToolbarButton)
</td>
<td>
A push button tells the application to do something when it is activated. A toggle button is a specialized push button that does not have a separate indicator for the state.
</td>
</tr>
<tr class="OK">
<td>
RADIOBUTTON
</td>
<td>
RADIO_BUTTON, RADIO_MENU_ITEM
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_9.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_14 RadioButton] (grouped together using [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_20.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_25 RadioGroup])
</td>
<td>
Usually in a group, only one radio button in a group can be "checked". Check one radio button causes all others in the group to be unchecked. A radio menu item is both a radio button and a menu item.
</td>
</tr>
<tr class="OK">
<td>
ROW
</td>
<td>
add custom control
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_17.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_22 Row] (see subroles OutlineRow, TableRow)
</td>
<td>
Row in a table.
</td>
</tr>
<tr>
<td class="OK">
ROWHEADER
</td>
<td class="OK">
ROW_HEADER, TABLE_ROW_HEADER
</td>
<td class="OK">[OK]
Header attribute of a table/outliner/browser.
</td>
<td class="OK">
Header which labels a row of data, or more specifically a row of data in a table.
</td>
</tr>
<tr>
<td class="OK">
SCROLLBAR
</td>
<td class="OK">
SCROLL_BAR
</td>
<td class="OK">[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_19.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_24 ScrollBar], see children [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/index.html?http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXModel/chapter_4_section_3.html#//apple_ref/doc/uid/TP40001078-CH208-BEICBEEG ValueIndicator] (the draggable thumb), and arrows:&nbsp;IncrementPage, DecrementPage subroles
</td>
<td class="OK">
Object which allows a user to incrementally view a large amount of data by moving the bounds of a viewport along a one-dimensional axis.
</td>
</tr>
<tr>
<td>
SEPARATOR
</td>
<td>
SEPARATOR
</td>
<td>
TBD
</td>
<td>
Object that provides a visual separation of contents in a menu or between 2 areas/panes.
</td>
</tr>
<tr class="OK">
<td>
SLIDER
</td>
<td>
SLIDER
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_24.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_29 Slider]
</td>
<td>
Object that allows the user to select or adjust a value in increments from a bounded range of minimum to maximum values.
</td>
</tr>
<tr class="OK">
<td>
SPINBUTTON
</td>
<td>
SPIN_BUTTON
</td>
<td>[OK]
Incrementor ("Stepper"), (Increment/Decrement subroles).
</td>
<td>
Object that allows the user to select a value from a set of choices.
</td>
</tr>
<tr class="OK">
<td>
STATICTEXT
</td>
<td>
LABEL, ACCELERATOR_LABEL
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_33.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_36 StaticText]
</td>
<td>
A label presents text that provides a short name or description associated with another object, like a text entry field. An accelerator label indicates the keyboard accelerators for its parent, like a menu item.
</td>
</tr>
<tr class="OK">
<td>
STATUSBAR
</td>
<td>
STATUS_BAR
</td>
<td>[OK]
Represented as its individual parts; the status text is text, the progressbar is a ProgressBar, etc.
</td>
<td>
Display non-quantitative status information, in contrast to a progress bar which displays quantitative status.
</td>
</tr>
<tr class="OK">
<td>
TABLE
</td>
<td>
TABLE, CALENDAR, TREE_TABLE
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_14.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_19 Table]
</td>
<td>
Presents information in terms of rows and columns. A calendar contains one or more dates, usually arranged in a tabular format, but not always. A tree table presents information in both a tabular and hierarchical format.
</td>
</tr>
<tr class="OK">
<td>
TEXT
</td>
<td>
TEXT, DATE_EDITOR, PASSWORD_TEXT, AUTOCOMPLETE, ENTRY (proposed), PARAGRAPH, HEADING (proposed), HEADER, FOOTER, CAPTION (proposed)
</td>
<td>[OK]
StaticText, [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_31.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_34 TextField], [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_32.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_35 TextArea] are the actual text widgets. See various text attributes for describing text content. There's also SecureTextField for password boxes.
</td>
<td>
Text information in general. A date editor allows entry of a date. A password text entry object shows nothing or an alternative character, like an asterisk, when the password text is typed. Autocomplete is a dialog or list containing items for insertion into an entry widget, such as a list of words or characters for completion of a text entry. Entry is a text entry field which may be editable or read-only depending on the STATE_EDITABLE attribute. A paragraph is a paragraph of text in a document. A heading is the title for a section in a document. A header is a section at the top of a document, or the top of each page in a document. A footer is a section at the bottom of a document, or the bottom of each page of a document. A caption is descriptive information, usually textual, about another user interface element such as a table, chart, or image.
</td>
</tr>
<tr class="OK">
<td>
TITLEBAR
</td>
<td>
add custom role
</td>
<td>[OK]
title attribute of [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_3.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_9 Window] role
</td>
<td>
Title or caption of a window or dialog.
</td>
</tr>
<tr class="OK">
<td>
TOOLBAR
</td>
<td>
TOOL_BAR
</td>
<td>[OK]
[http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/ObjC_classic/Protocols/NSAccessibility.html#//apple_ref/occ/instm/NSObject/accessibilityParameterizedAttributeNames Toolbar] (see also toolbar button subrole of [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_8.html#//apple_ref/doc/uid/TP40001078-CH211-CACDEHBG Button])
</td>
<td>
A bar or palette usually comprised of push buttons or toggle buttons.
</td>
</tr>
<tr class="OK">
<td>
TOOLTIP
</td>
<td>
TOOL_TIP
</td>
<td>[OK]
[http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/ObjC_classic/Protocols/NSAccessibility.html#//apple_ref/occ/instm/NSObject/accessibilityParameterizedAttributeNames HelpTag] (same as "Help Balloon")
</td>
<td>
An object that provides descriptive or helpful information about another object, often when the help key is pressed or the mouse moves over an object.
</td>
</tr>
<tr class="OK">
<td>
WINDOW
</td>
<td>
WINDOW
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_3.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_9 Window]
</td>
<td>
A top level window with no title or border.
</td>
</tr>
<tr class="OK">
<td>
</td>
<td>
RULER
</td>
<td>[OK]
[http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/ObjC_classic/Protocols/NSAccessibility.html#//apple_ref/doc/c_ref/NSAccessibilityMarkerTypeAttribute Ruler], [http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/ObjC_classic/Protocols/NSAccessibility.html#//apple_ref/doc/c_ref/NSAccessibilityMarkerTypeAttribute RulerMarker]
</td>
<td>
Object that describes margins and tab stops.
</td>
</tr>
<tr>
<td>
</td>
<td>
EMBEDDED
</td>
<td>
TBD
</td>
<td>
Object that is an embedded component container in a document.
</td>
</tr>
<tr class="OK">
<td>
</td>
<td>
EDITBAR
</td>
<td>[OK]
Basically same as textfield, or similar to whatever we'd do for an inline textfield in a table?
</td>
<td>
Object that is an editable text object in a toolbar.
</td>
</tr>
<tr>
<td>
</td>
<td>
CANVAS
</td>
<td>
TBD
</td>
<td>
Object that can be drawn into and used to trap events.
</td>
</tr>
<tr class="OK">
<td>
</td>
<td>
INVALID
</td>
<td>[OK]
Unknown
</td>
<td>
An error condition, such as an uninitialized role.
</td>
</tr>
<tr class="OK">
<td>
</td>
<td>
UNKNOWN
</td>
<td>[OK]
[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_42.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_45 Unknown]
</td>
<td>
Object contains accessible information but its role is not known.
</td>
</tr>
<tr>
<td>
</td>
<td>
</td>
<td>
ColorWell
</td>
<td>
Button for invoking a color inspector, where you can choose colors.
</td>
</tr>
<tr>
<td>
</td>
<td>
</td>
<td>
SearchField
</td>
<td>
Textfield used for searching
</td>
</tr>
</table>


<th>Closest ATK Role(s) (ATK_ROLE_*)</th>
== Firefox-specific Roles ==
<table border="1"><tr>
<th>MSAA</th><th>ATK</th><th>UA</th><th>Description</th></tr>
<tr><td colspan="4">h1, h2, h3, h4, h5, h6</td></tr>
<tr><td colspan="4">iframe</td></tr>
<tr><td colspan="4">q</td></tr>
<tr><td colspan="4">tbody, thead, tfoot</td></tr>
</table>


<th>Closest UA Role (NSAccessibility*Role)</th>
== Roles We Don't Implement ==
Here are roles that we, for one reason or the other, have decided to not implement. Most of them can be represented in some other way, and so we deem them irrelevant.


<th>Description</th> </tr>
<table border="1">
 
<tr>
<tr> <td class="maybe">ALERT</td>
<th>
 
MSAA 1.3 Role (ROLE_SYSTEM_ *)
<td class="maybe">ALERT</td>
</th>
 
<th>
<td class="maybe">[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_3.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_9  Window] with SystemDialog subrole?</td>
Closest ATK Role(s) (ATK_ROLE_*)
 
</th>
<td class="maybe">An error, warning, or informational message</td> </tr>
<th>
 
Closest UA Role (NSAccessibility*Role)
<tr> <td>ANIMATION</td>
</th>
 
<th>
<td>ANIMATION</td>
Description
 
</th>
<td> </td>
</tr>
 
<tr>
<td>A dynamic or moving image that changes over time.</td> </tr>
<td>
 
BORDER
<tr> <td class="OK">APPLICATION</td>
</td>
 
<td>
<td class="OK">APPLICATION</td>
don't use
 
</td>
<td class="OK">[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_2.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_8  Application]</td>
<td>
 
don't use
<td class="OK">Toplevel accessible object of an application, which may contain frame objects or other accessible objects.</td> </tr>
</td>
 
<td>
<tr> <td class="irrelevant">BORDER</td>
Window border as an object
 
</td>
<td class="irrelevant">don't use</td>
</tr>
 
<tr>
<td class="irrelevant">don't use</td>
<td>
 
BUTTONDROPDOWN
<td class="irrelevant">Window border as an object</td> </tr>
</td>
 
<td>
<tr class="irrelevant"> <td>BUTTONDROPDOWN</td>
add custom role
 
</td>
<td>add custom role</td>
<td>
 
</td>
<td>No such standard widget on mac. (If needed, roll our own.)</td>
<td>
 
Button that drops down a list of items
<td>Button that drops down a list of items</td> </tr>
</td>
 
</tr>
<tr class="irrelevant"> <td>BUTTONDROPDOWNGRID</td>
<tr>
 
<td>
<td>add custom role</td>
BUTTONDROPDOWNGRID
 
</td>
<td>No such standard widget on mac. (If needed, roll our own.)</td>
<td>
 
add custom role
<td>Button that drops down a grid</td> </tr>
</td>
 
<td>
<tr> <td class="OK">BUTTONMENU</td>
</td>
 
<td>
<td class="OK">add custom role</td>
Button that drops down a grid
 
</td>
<td class="OK">MenuButton</td>
</tr>
 
<tr>
<td class="OK">Button that drops down a menu</td> </tr>
<td>
 
CARET
<tr> <td class="irrelevant">CARET</td>
</td>
 
<td>
<td class="irrelevant">don't use</td>
don't use
 
</td>
<td class="irrelevant">don't use</td>
<td>
 
don't use
<td class="irrelevant">System caret</td> </tr>
</td>
 
<td>
<tr> <td>CELL</td>
System caret
 
</td>
<td>TABLE_CELL</td>
</tr>
 
<tr>
<td> </td>
<td>
 
CHARACTER
<td>Cell in a table</td> </tr>
</td>
 
<td>
<tr> <td class="irrelevant">CHARACTER</td>
don't use
 
</td>
<td class="irrelevant">don't use</td>
<td>
 
don't use
<td class="irrelevant">don't use</td>
</td>
 
<td>
<td class="irrelevant">Paperclip character.</td> </tr>
Paperclip character.
 
</td>
<tr> <td class="maybe">CHART</td>
</tr>
 
<tr>
<td class="maybe">CHART (proposed)</td>
<td>
 
CLOCK
<td class="maybe">Image with a special DescriptionAttribute?</td>
</td>
 
<td>
<td class="maybe">Graphical depiction of quantitative data</td> </tr>
add custom role
 
</td>
<tr> <td class="OK">CHECKBUTTON</td>
<td>
 
don't use
<td class="OK">CHECK_BOX, CHECK_MENU_ITEM, TOGGLE_BUTTON</td>
</td>
 
<td>
<td class="OK">[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_10.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_15  CheckBox]</td>
Clock object.
 
</td>
<td class="OK">Choice that can be checked or unchecked. A checkbox and check menu item have a separate indicator for the state. A toggle button is a specialized push button that does not have a separate indicator for the state.</td> </tr>
</tr>
 
<tr>
<tr> <td class="irrelevant">CLOCK</td>
<td>
 
CURSOR
<td class="irrelevant">add custom role</td>
</td>
 
<td>
<td class="irrelevant">don't use</td>
don't use
 
</td>
<td class="irrelevant">Clock object.</td> </tr>
<td>
 
don't use
<tr> <td class="OK">COLUMN</td>
</td>
 
<td>
<td class="OK">don't use</td>
Mouse pointer.
 
</td>
<td class="OK">Column</td>
</tr>
 
<tr>
<td class="OK">Column of table cells.</td> </tr>
<td>
 
DIAL
<tr> <td class="OK" normal=""> COLUMNHEADER</td>
</td>
 
<td>
<td class="OK">TABLE_COLUMN_HEADER, COLUMN_HEADER</td>
DIAL
 
</td>
<td class="OK">Get the NSAccessibilityHeaderAttribute on a&nbsp;[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_14.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_19  Table]</td>
<td>
 
</td>
<td class="OK">Header which labels a column of data, or more specifically a column of data in a table.</td> </tr>
<td>
 
Control with value changes using a rotating visual indicator
<tr> <td class="OK">COMBOBOX</td>
</td>
 
</tr>
<td class="OK">COMBO_BOX</td>
<tr>
 
<td>
<td class="OK">ComboBox</td>
ANIMATION
 
</td>
<td class="OK">Edit control with a drop-down list of selections</td> </tr>
<td>
 
ANIMATION
<tr> <td class="irrelevant">CURSOR</td>
</td>
 
<td>
<td class="irrelevant">don't use</td>
</td>
 
<td>
<td class="irrelevant">don't use</td>
A dynamic or moving image that changes over time.
 
</td>
<td>Mouse pointer.</td> </tr>
</tr>
 
<tr>
<tr> <td class="maybe">DIAGRAM</td>
<td>
 
HOTKEYFIELD
<td class="maybe">IMAGE, DRAWING_AREA, or add custom role</td>
</td>
 
<td>
<td class="maybe">[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_7.html#//apple_ref/doc/uid/TPhttp://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_7.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_1340001078-CH211-DontLinkElementID_13  Image]</td>
add custom role
 
</td>
<td class="maybe">Image is a generic graphic. Diagram is a specific type of a drawn graphic. Drawing area is used for creating custom user interface elements.</td> </tr>
<td>
 
</td>
<tr> <td class="irrelevant">DIAL</td>
<td>
 
Editable field for assigning keys
<td class="irrelevant">DIAL</td>
</td>
 
</tr>
<td class="irrelevant">Really useful?</td>
<tr>
 
<td>
<td class="irrelevant">Control with value changes using a rotating visual indicator</td> </tr>
INDICATOR
 
</td>
<tr class="OK"> <td>DIALOG</td>
<td>
 
ARROW or add custom role
<td>DIALOG, COLOR_CHOOSER, FILE_CHOOSER</td>
</td>
 
<td>
<td>[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_3.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_9  Window] with dialog subrole (sometimes Sheet)</td>
</td>
 
<td>
<td>Top level window with a title bar and border. A file chooser is a specialized dialog that displays files in a directory and allows file selection, directory browsing, and filename specification. A color chooser is a specialized dialog for choosing a color.</td> </tr>
An indicator is a graphic, like an arrow, used to indicate something. Arrow is a 2D directional indicator.
 
</td>
<tr class="OK"> <td>DOCUMENT</td>
</tr>
 
<tr>
<td>HTML_CONTAINER or DOCUMENT_FRAME (proposed)</td>
<td>
 
SOUND
<td>Use custom role WebArea like Safari for the actual web browser view? Window for the actual window.</td>
</td>
 
<td>
<td>For MSAA, a document is a window that corresponds to MDI document. An HTML container or document frame is an HTML document or a frame containing a view of document content.</td> </tr>
IMAGE, ICON, or add custom control
 
</td>
<tr class="maybe"> <td>DROPLIST</td>
<td>
 
</td>
<td>add custom role or COMBO_BOX</td>
<td>
 
System sound object.
<td>[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_23.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_28  ComboBox]?&nbsp;</td>
</td>
 
</tr>
<td>Drop down list but not a combo box</td> </tr>
<tr>
 
<td>
<tr class="maybe"> <td>EQUATION</td>
WHITESPACE
 
</td>
<td>add custom role</td>
<td>
 
FILLER
<td>Image/StaticText + special DescriptionAttribute probably sufficient.</td>
</td>
 
<td>
<td>Math and chemistry equations</td> </tr>
</td>
 
<td>
<tr class="OK"> <td>GRAPHIC</td>
Object that takes up space in a user interface.
 
</td>
<td>IMAGE, DESKTOP_ICON</td>
</tr>
 
</table>
<td>[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_7.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_13  Image]</td>
 
<td>Graphic or an icon</td> </tr>
 
<tr class="OK"> <td>GRIP</td>
 
<td>add custom role</td>
 
<td>[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_39.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_42  SplitterBar]</td>
 
<td>Mouse pointer used for resizing windows.</td> </tr>
 
<tr class="OK"> <td>GROUPING</td>
 
<td>PANEL, PAGE (proposed), SECTION (proposed)</td>
 
<td>Group</td>
 
<td>Container used to group objects, like a group box or a FIELDSET in HTML. A page is defined for documents. A section is a generic container of content within a document, such as a navigation bar, table of contents, main content section, content between headings, etc.</td> </tr>
 
<tr class="OK"> <td>HELPBALLOON</td>
 
<td>add custom role</td>
 
<td>[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_8.html#//apple_ref/doc/uid/TP40001078-CH211-CACDEHBG  Button] with DescriptionAttribute="Help"</td>
 
<td>Help icon to click on to get tooltip help</td> </tr>
 
<tr class="irrelevant"> <td>HOTKEYFIELD</td>
 
<td>add custom role</td>
 
<td>Really needed?</td>
 
<td>Editable field for assigning keys</td> </tr>
 
<tr class="irrelevant"> <td>INDICATOR</td>
 
<td>ARROW or add custom role</td>
 
<td>Too vague. Can we really have a role to indicate "something"? Image + RoleDescription/DescriptionAttribute?</td>
 
<td>An indicator is a graphic, like an arrow, used to indicate something. Arrow is a 2D directional indicator.</td> </tr>
 
<tr class="OK"> <td>LINK</td>
 
<td>LINK (proposed)</td>
 
<td>[http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/ObjC_classic/Protocols/NSAccessibility.html#//apple_ref/doc/c_ref/NSAccessibilityMarkerTypeAttribute  TextLink]<span class="content_text"><code> </code></span></td>
 
<td>Hypertext link in a document that can be an image or text</td> </tr>
 
<tr class="OK"> <td>LIST</td>
 
<td>LIST, FONT_CHOOSER</td>
 
<td>[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_21.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_26  List]</td>
 
<td>List of objects that allows one or more selections. A font chooser allows selection of a display font.</td> </tr>
 
<tr class="OK"> <td>LISTITEM</td>
 
<td>LISTITEM</td>
 
<td>[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_17.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_22  Row]?</td>
 
<td>Element in a selectable list</td> </tr>
 
<tr class="OK"> <td>MENUBAR</td>
 
<td>MENU_BAR</td>
 
<td>[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_34.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_37  MenuBar]</td>
 
<td>Object drawn at the top of the primary window or dialog box of an application ((just below the title bar)) that contains a list of menus.</td> </tr>
 
<tr> <td class="OK">MENUITEM</td>
 
<td class="OK">MENU_ITEM, RADIO_MENU_ITEM, CHECK_MENU_ITEM</td>
 
<td class="OK">[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_37.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_40  MenuItem], [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_35.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_38  MenuBarItem]</td>
 
<td class="OK">Element in a menu that presents a selectable action. A radio menu item is both a radio button and a menu item. A check menu item is both a check box and a menu item.</td> </tr>
 
<tr> <td class="OK">MENUPOPUP</td>
 
<td class="OK">MENU, POPUP_MENU, TEAROFF_MENU_ITEM</td>
 
<td class="OK">Menu, [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_12.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_17  MenuButton] (button with icon that pops up a menu when clicked) or [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_11.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_16  PopupButton] (regular popupmenu showing the current choice)</td>
 
<td class="OK">A menu is a list of actions from which the user can choose. A pop-up menu is a temporary window that offers the user a list of choices, then hides itself once the user selects one of those choices. A tearoff menu item is a is a menu that can be removed from the menubar and shown in its own window.</td> </tr>
 
<tr> <td class="OK">OUTLINE</td>
 
<td class="OK">TREE, TREE_TABLE</td>
 
<td class="OK">[http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/ObjC_classic/Protocols/NSAccessibility.html#//apple_ref/doc/c_ref/NSAccessibilityMarkerTypeAttribute  Outline]</td>
 
<td class="OK">A tree or an outline is an object used to present hierarchical information to the user, usually with expandable/collapsable elements. A tree table presents both tabular and hierarchical information to the user.</td> </tr>
 
<tr> <td class="OK">OUTLINEITEM</td>
 
<td class="OK">use custom role</td>
 
<td class="OK">Row and subrole OutlineRow</td>
 
<td class="OK">A tree item.</td> </tr>
 
<tr> <td class="OK">PAGETAB</td>
 
<td class="OK">PAGE_TAB</td>
 
<td class="OK">Just a [http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/ObjC_classic/Protocols/NSAccessibility.html#//apple_ref/doc/c_ref/NSAccessibilityMarkerTypeAttribute  Group] child inside a&nbsp;[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_13.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_18  TabGroup]</td>
 
<td class="OK">A tab that usually contains a label or title for a page or panel of a notebook container.</td> </tr>
 
<tr> <td class="OK">PAGETABLIST</td>
 
<td class="OK">PAGE_TAB_LIST</td>
 
<td class="OK">[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_13.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_18  TabGroup]</td>
 
<td class="OK">A tabbed notebook container, or a series of panels presented as tabbed pages.</td> </tr>
 
<tr> <td class="OK">PANE</td>
 
<td class="OK">FRAME, INTERNAL_FRAME, GLASS_PANE, LAYERED_PANE, OPTION_PANE, SCROLL_PANE, DIRECTORY_PANE, DESKTOP_FRAME, ROOT_PANE, SPLIT_PANE, VIEWPORT</td>
 
<td class="OK">[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_3.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_9  Window]&nbsp;(subroles StandardWindow), ScrollArea, SplitGroup (two adjacent "views" with a splitter bar), Browser (horizontal tree-like view often used for nagivating in the filesystem)</td>
 
<td class="OK">A pane or frame in the current window. A frame is a top level window with a title bar, border, menubar, etc. An internal frame is a frame clipped by a desktop pane. A glass pane is painted on top of all panes beneath it. A layered pane allows its children to be drawn in layers based on a stacking order. An option pane is a pane inside of a dialog. A scroll pane contains scroll bars. A directory pane contains selections (icons, lists, trees) for the content of a directory. A desktop frame is a pane that supports internal frames and icons for those internal frames. A root pane has a glass pane and a layered pane as its children. A split pane is a panel that presents two other panels at the same time. A viewport is a container of content, usually used in a scroll pane, that represents a clipped version of that pane that is onscreen (visible).</td> </tr>
 
<tr> <td class="OK">PROGRESSBAR</td>
 
<td class="OK">PROGRESS_BAR</td>
 
<td class="OK">[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_27.html#//apple_ref/doc/uid/TP40001078-CH211-CACIAHEA  ProgressIndicator]</td>
 
<td class="OK">Object that shows the percentage of a task that has completed.</td> </tr>
 
<tr> <td class="maybe">PROPERTYPAGE</td>
 
<td class="maybe">PAGE (proposed) or add custom role</td>
 
<td class="maybe">Group with DescriptionAttribute describing special purpose?</td>
 
<td class="maybe">Page showing properties of something.</td> </tr>
 
<tr class="OK"> <td>PUSHBUTTON</td>
 
<td>PUSH_BUTTON, TOGGLE_BUTTON</td>
 
<td>[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_8.html#//apple_ref/doc/uid/TP40001078-CH211-CACDEHBG  Button] (see also subrole ToolbarButton)</td>
 
<td>A push button tells the application to do something when it is activated. A toggle button is a specialized push button that does not have a separate indicator for the state.</td> </tr>
 
<tr class="OK"> <td>RADIOBUTTON</td>
 
<td>RADIO_BUTTON, RADIO_MENU_ITEM</td>
 
<td>[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_9.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_14  RadioButton] (grouped together using [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_20.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_25  RadioGroup])</td>
 
<td>Usually in a group, only one radio button in a group can be "checked". Check one radio button causes all others in the group to be unchecked. A radio menu item is both a radio button and a menu item.</td> </tr>
 
<tr> <td class="OK">ROW</td>
 
<td class="OK">add custom control</td>
 
<td class="OK">[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_17.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_22  Row] (see subroles OutlineRow, TableRow)</td>
 
<td class="OK">Row in a table.</td> </tr>
 
<tr> <td class="OK">ROWHEADER</td>
 
<td class="OK">ROW_HEADER, TABLE_ROW_HEADER</td>
 
<td class="OK">Header attribute of a table/outliner/browser.</td>
 
<td class="OK">Header which labels a row of data, or more specifically a row of data in a table.</td> </tr>
 
<tr> <td class="OK">SCROLLBAR</td>
 
<td class="OK">SCROLL_BAR</td>
 
<td class="OK">[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_19.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_24  ScrollBar], see children [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/index.html?http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXModel/chapter_4_section_3.html#//apple_ref/doc/uid/TP40001078-CH208-BEICBEEG  ValueIndicator] (the draggable thumb), and arrows:&nbsp;IncrementPage, DecrementPage subroles</td>
 
<td class="OK">Object which allows a user to incrementally view a large amount of data by moving the bounds of a viewport along a one-dimensional axis.</td> </tr>
 
<tr class="maybe"> <td>SEPARATOR</td>
 
<td>SEPARATOR</td>
 
<td>A Splitter that is disabled/static?</td>
 
<td>Object that provides a visual separation of contents in a menu or between 2 areas/panes.</td> </tr>
 
<tr class="OK"> <td>SLIDER</td>
 
<td>SLIDER</td>
 
<td>[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_24.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_29  Slider]</td>
 
<td>Object that allows the user to select or adjust a value in increments from a bounded range of minimum to maximum values.</td> </tr>
 
<tr class="irrelevant"> <td>SOUND</td>
 
<td>IMAGE, ICON, or add custom control</td>
 
<td> </td>
 
<td>System sound object.</td> </tr>
 
<tr> <td class="OK">SPINBUTTON</td>
 
<td class="OK">SPIN_BUTTON</td>
 
<td class="OK">Incrementor ("Stepper"), (Increment/Decrement subroles).</td>
 
<td class="OK">Object that allows the user to select a value from a set of choices.</td> </tr>
 
<tr> <td class="OK">STATICTEXT</td>
 
<td class="OK">LABEL, ACCELERATOR_LABEL</td>
 
<td class="OK">[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_33.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_36  StaticText]</td>
 
<td class="OK">A label presents text that provides a short name or description associated with another object, like a text entry field. An accelerator label indicates the keyboard accelerators for its parent, like a menu item.</td> </tr>
 
<tr> <td>STATUSBAR</td>
 
<td>STATUS_BAR</td>
 
<td>We could use [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_26.html#//apple_ref/doc/uid/TP40001078-CH211-CACGDCAF  BusyIndicator] here&nbsp;for indeterminate progress and [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_27.html#//apple_ref/doc/uid/TP40001078-CH211-CACIAHEA  ProgressIndicator] for determinate progress</td>
 
<td>Display non-quantitative status information, in contrast to a progress bar which displays quantitative status.</td> </tr>
 
<tr class="OK"> <td>TABLE</td>
 
<td>TABLE, CALENDAR, TREE_TABLE</td>
 
<td>[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_14.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_19  Table]</td>
 
<td>Presents information in terms of rows and columns. A calendar contains one or more dates, usually arranged in a tabular format, but not always. A tree table presents information in both a tabular and hierarchical format.</td> </tr>
 
<tr class="OK"> <td>TEXT</td>
 
<td>TEXT, DATE_EDITOR, PASSWORD_TEXT, AUTOCOMPLETE, ENTRY (proposed), PARAGRAPH, HEADING (proposed), HEADER, FOOTER, CAPTION (proposed)</td>
 
<td>StaticText, [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_31.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_34  TextField], [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_32.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_35  TextArea] are the actual text widgets. See various text attributes for describing text content. There's also SecureTextField for password boxes.</td>
 
<td>Text information in general. A date editor allows entry of a date. A password text entry object shows nothing or an alternative character, like an asterisk, when the password text is typed. Autocomplete is a dialog or list containing items for insertion into an entry widget, such as a list of words or characters for completion of a text entry. Entry is a text entry field which may be editable or read-only depending on the STATE_EDITABLE attribute. A paragraph is a paragraph of text in a document. A heading is the title for a section in a document. A header is a section at the top of a document, or the top of each page in a document. A footer is a section at the bottom of a document, or the bottom of each page of a document. A caption is descriptive information, usually textual, about another user interface element such as a table, chart, or image.</td> </tr>
 
<tr class="OK"> <td>TITLEBAR</td>
 
<td>add custom role</td>
 
<td>title attribute of [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_3.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_9  Window] role</td>
 
<td>Title or caption of a window or dialog.</td> </tr>
 
<tr class="OK"> <td>TOOLBAR</td>
 
<td>TOOL_BAR</td>
 
<td>[http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/ObjC_classic/Protocols/NSAccessibility.html#//apple_ref/occ/instm/NSObject/accessibilityParameterizedAttributeNames  Toolbar] (see also toolbar button subrole of [http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_8.html#//apple_ref/doc/uid/TP40001078-CH211-CACDEHBG  Button])</td>
 
<td>A bar or palette usually comprised of push buttons or toggle buttons.</td> </tr>
 
<tr class="OK"> <td>TOOLTIP</td>
 
<td>TOOL_TIP</td>
 
<td>[http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/ObjC_classic/Protocols/NSAccessibility.html#//apple_ref/occ/instm/NSObject/accessibilityParameterizedAttributeNames  HelpTag] (same as "Help Balloon")</td>
 
<td>An object that provides descriptive or helpful information about another object, often when the help key is pressed or the mouse moves over an object.</td> </tr>
 
<tr class="irrelevant"> <td>WHITESPACE</td>
 
<td>FILLER</td>
 
<td>Really needed?</td>
 
<td>Object that takes up space in a user interface.</td> </tr>
 
<tr class="OK"> <td>WINDOW</td>
 
<td>WINDOW</td>
 
<td>[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_3.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_9  Window]</td>
 
<td>A top level window with no title or border.</td> </tr>
 
<tr class="OK"> <td> </td>
 
<td>RULER</td>
 
<td>[http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/ObjC_classic/Protocols/NSAccessibility.html#//apple_ref/doc/c_ref/NSAccessibilityMarkerTypeAttribute  Ruler], [http://developer.apple.com/documentation/Cocoa/Reference/ApplicationKit/ObjC_classic/Protocols/NSAccessibility.html#//apple_ref/doc/c_ref/NSAccessibilityMarkerTypeAttribute  RulerMarker]</td>
 
<td>Object that describes margins and tab stops.</td> </tr>
 
<tr class="maybe"> <td> </td>
 
<td>EMBEDDED</td>
 
<td>Unknown + smart RoleDescription/DescriptionAttribute?</td>
 
<td>Object that is an embedded component container in a document.</td> </tr>
 
<tr class="maybe"> <td> </td>
 
<td>EDITBAR</td>
 
<td>Basically same as textfield, or similar to whatever we'd do for an inline textfield in a table?</td>
 
<td>Object that is an editable text object in a toolbar.</td> </tr>
 
<tr> <td> </td>
 
<td>CANVAS</td>
 
<td> </td>
 
<td>Object that can be drawn into and used to trap events.</td> </tr>
 
<tr> <td> </td>
 
<td>INVALID</td>
 
<td> </td>
 
<td>An error condition, such as an uninitialized role.</td> </tr>
 
<tr class="OK"> <td> </td>
 
<td>UNKNOWN</td>
 
<td>[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_42.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_45  Unknown]</td>
 
<td>Object contains accessible information but its role is not known.</td> </tr>
 
<tr> <td> </td>
 
<td> </td>
 
<td>ColorWell</td>
 
<td>Button for invoking a color inspector, where you can choose colors.</td> </tr>
 
<tr> <td> </td>
 
<td> </td>
 
<td>SearchField</td>
 
<td>Textfield used for searching</td> </tr> </table>
Hwaara
107

edits

Retrieved from "https://wiki.allizom.org/Special:MobileDiff/25718...26724"