Accessibility/AT-Windows-API: Difference between revisions

xforms role
(initial port of http://www.mozilla.org/access/windows/at-apis)
 
(xforms role)
Line 271: Line 271:
== MSAA Role Support ==
== MSAA Role Support ==


{| class="standard-table" summary="This table shows what MSAA roles Gecko supports,
{| class="standard-table" summary="This table shows what MSAA roles Gecko supports, what markup is used to create objects with those roles, and any special features that objects with those roles support"
  what markup is used to create objects with those roles, and any special features
  that objects with those roles support" width="90%" border="1" cellspacing="1" cellpadding="1"
! scope="col" | Role
! scope="col" | Role
! scope="col" | Supported?
! scope="col" | Supported?
Line 308: Line 306:
|-
|-
| ROLE_ALERT
| ROLE_ALERT
| XUL: <browsermessage><br /> DHTML: role="wairole:alert"
| XUL: <browser> <br/> DHTML: role="wairole:alert" <br/> XForms: <message/>, <alert/>, <help/>
| Fires EVENT_ALERT
| Fires EVENT_ALERT
|-
|-
Line 327: Line 325:
| ROLE_MENUITEM
| ROLE_MENUITEM
|
|
XUL: menuitem<br /> DHTML: role="wairole:menuitem"
XUL: <menuitem/><br /> DHTML: role="wairole:menuitem"<br /> XForms: <item/> of minimal <select1/> in XHTML document
|
|
Sets STATE_CHECKED for radio or checkbox menuitem types
Sets STATE_CHECKED for radio or checkbox menuitem types
Line 384: Line 382:
|-
|-
| ROLE_GROUPING
| ROLE_GROUPING
| HTML: <fieldset><br /> XUL: <groupbox><br /> DHTML: role="wairole:group" or DHTML: role="wairole:radiogroup"
| HTML: <fieldset><br /> XUL: <groupbox><br /> DHTML: role="wairole:group" or DHTML: role="wairole:radiogroup"<br />XForms: compact <select/>, minimal <select1/> in XUL document, xsd:gMonth/xsd:gDay types <input/>
| For a <fieldset> the name is exposed using the <legend>
| For a <fieldset> the name is exposed using the <legend>
|-
|-
| ROLE_SEPARATOR
| ROLE_SEPARATOR
| XUL: <separator><br /> HTML: <hr><br /> DHTML: role="wairole:separator"
| XUL: <separator><br /> HTML: <nowiki><hr></nowiki><br /> DHTML: role="wairole:separator"
|  
|  
|-
|-
Line 499: Line 497:
| ROLE_STATICTEXT
| ROLE_STATICTEXT
|
|
XUL: <label> or <description><br /> HTML: <label><br /> DHTML: role="wairole:label" or<br /> role="wairole:description"
XUL: <label> or <description><br /> HTML: <label><br /> DHTML: role="wairole:label" or<br /> role="wairole:description"<br />XForms: <output/>, <label/>
|
|
Supports NAVRELATION_LABEL_FOR and NAVRELATION_DESCRIPTION_FOR via accNavigate().
Supports NAVRELATION_LABEL_FOR and NAVRELATION_DESCRIPTION_FOR via accNavigate().
Line 507: Line 505:
The accName is also reflected in the accName of a form control that this labels, which is a good reason to check NAVRELATION_LABEL_FOR.
The accName is also reflected in the accName of a form control that this labels, which is a good reason to check NAVRELATION_LABEL_FOR.
|-
|-
| ROLE_TEXT
| ROLE_ENTRY
|
|
Normal web text uses no tag or element, uses STATE_READONLY<br /> For editable text, that state is cleared.<br /> XUL: <textbox><br /> HTML: <input type="text"> or <textarea><br /> DHTML: role="wairole:textfield" or<br /> role="wairole:textarea"
Normal web text uses no tag or element, uses STATE_READONLY<br /> For editable text, that state is cleared.<br /> XUL: <textbox><br /> HTML: <input type="text"> or <textarea><br /> DHTML: role="wairole:textfield" or<br /> role="wairole:textarea"<br />XForms: default <input/>
|
|
Sets STATE_LINKED if within link.
Sets STATE_LINKED if within link.
Line 519: Line 517:
| ROLE_PUSHBUTTON
| ROLE_PUSHBUTTON
|
|
XUL: <button><br /> HTML: <input type= "button"> or<button><br /> DHTML: role="wairole:button"
XUL: <button><br /> HTML: <input type= "button"> or<button><br /> DHTML: role="wairole:button"<br />XForms: <trigger/>, <submit/>
| Sets STATE_HASPOPUP for buttons containing menus
| Sets STATE_HASPOPUP for buttons containing menus
|-
|-
| ROLE_CHECKBUTTON
| ROLE_CHECKBUTTON
|
|
XUL: <checkbox><br /> HTML: <input type="checkbox"><br /> DHTML: role="wairole:checkbox"
XUL: <checkbox><br /> HTML: <input type="checkbox"><br /> DHTML: role="wairole:checkbox"<br />XForms: <item/> of full <select/>
|
|
Fires EVENT_STATE_CHANGE when checkbox is toggled
Fires EVENT_STATE_CHANGE when checkbox is toggled
Line 530: Line 528:
| ROLE_RADIOBUTTON
| ROLE_RADIOBUTTON
|
|
XUL: <radio><br /> HTML: <input type="radio"><br /> DHTML: role="wairole:radio"
XUL: <radio><br /> HTML: <input type="radio"><br /> DHTML: role="wairole:radio"<br />XForms: <item/> of full <select1/>
|
|
Fires EVENT_STATE_CHANGE when radiobutton is set
Fires EVENT_STATE_CHANGE when radiobutton is set
Line 536: Line 534:
| ROLE_COMBOBOX
| ROLE_COMBOBOX
|
|
XUL: <menulist><br /> HTML: <select size="1"><br /> DHTML: role="wairole:combobox"
XUL: <menulist><br /> HTML: <select size="1"><br /> DHTML: role="wairole:combobox"<br />XForms: <select1/> in XHTML document
| Fires EVENT_VALUECHANGE when current combobox option changes.
| Fires EVENT_VALUECHANGE when current combobox option changes.
|-
|-
| ROLE_DROPLIST
| ROLE_DROPLIST
| Not supported.
| XForms: xsd:date <input/>
| n/a
|  
|-
|-
! Role
! Role
Confirmed users
1,396

edits