Accessibility/Comparisons:Roles: Difference between revisions

</tr>

<tr>

ALERT

</td>

ALERT

</td>

</td>

An error, warning, or informational message

</td>

</tr>

APPLICATION

</td>

APPLICATION

</td>

[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_2.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_8 Application]

</td>

Toplevel accessible object of an application, which may contain frame objects or other accessible objects.

</td>

</tr>

BUTTONMENU

</td>

add custom role

</td>

MenuButton

</td>

Button that drops down a menu

</td>

</tr>

<tr>

CHART

</td>

CHART (proposed)

</td>

</td>

Graphical depiction of quantitative data

</td>

</td>

</tr>

COLUMNHEADER

</td>

TABLE_COLUMN_HEADER, COLUMN_HEADER

</td>

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>

Header which labels a column of data, or more specifically a column of data in a table.

</td>

</tr>

COMBOBOX

</td>

COMBO_BOX

</td>

ComboBox

</td>

Edit control with a drop-down list of selections

</td>

</tr>

<tr>

DIAGRAM

</td>

IMAGE, DRAWING_AREA, or add custom role

</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>

</td>

</tr>

<td>

DROPLIST

</td>

</tr>

<td>

EQUATION

</td>

<td>

</td>

<td>

</td>

</tr>

MENUITEM

</td>

MENU_ITEM, RADIO_MENU_ITEM, CHECK_MENU_ITEM

</td>

[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>

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>

MENUPOPUP

</td>

MENU, POPUP_MENU, TEAROFF_MENU_ITEM

</td>

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>

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>

</td>

</tr>

PAGETAB

</td>

PAGE_TAB

</td>

</td>

A tab that usually contains a label or title for a page or panel of a notebook container.

</td>

</tr>

PAGETABLIST

</td>

PAGE_TAB_LIST

</td>

</td>

A tabbed notebook container, or a series of panels presented as tabbed pages.

</td>

</tr>

PANE

</td>

FRAME, INTERNAL_FRAME, GLASS_PANE, LAYERED_PANE, OPTION_PANE, SCROLL_PANE, DIRECTORY_PANE, DESKTOP_FRAME, ROOT_PANE, SPLIT_PANE, VIEWPORT

</td>

[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>

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>

PROGRESSBAR

</td>

PROGRESS_BAR

</td>

[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_27.html#//apple_ref/doc/uid/TP40001078-CH211-CACIAHEA ProgressIndicator]

</td>

Object that shows the percentage of a task that has completed.

</td>

</tr>

PROPERTYPAGE

</td>

PAGE (proposed) or add custom role

</td>

Group with DescriptionAttribute describing special purpose?

</td>

Page showing properties of something.

</td>

</td>

</tr>

ROW

</td>

add custom control

</td>

[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>

Row in a table.

</td>

</td>

</tr>

<td>

SEPARATOR

</td>

<td>

</td>

<td>

</td>

</tr>

SPINBUTTON

</td>

SPIN_BUTTON

</td>

Incrementor ("Stepper"), (Increment/Decrement subroles).

</td>

Object that allows the user to select a value from a set of choices.

</td>

</tr>

STATICTEXT

</td>

LABEL, ACCELERATOR_LABEL

</td>

[http://developer.apple.com/documentation/Accessibility/Conceptual/AccessibilityMacOSX/OSXAXRoleReference/chapter_7_section_33.html#//apple_ref/doc/uid/TP40001078-CH211-DontLinkElementID_36 StaticText]

</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>

<td>

STATUSBAR

</td>

<td>

</td>

<td>

</td>

</tr>

<td>

</td>

</td>

<td>

</td>

<td>

</td>

</tr>

<td>

</td>