Accessibility/Attributes: Difference between revisions

No edit summary
 
 
(15 intermediate revisions by 3 users not shown)
Line 1: Line 1:
#REDIRECT [[MDC:Accessibility:AT-APIs:Gecko:Attrs]]
<small>[[Accessibility |<< Back to Accessibility Home Page]]</small>
= Proposed AT-SPI Attribute Support =
= Proposed AT-SPI Attribute Support =


Line 4: Line 8:
! Attribute name
! Attribute name
! Attribute description
! Attribute description
! Change event fired?
! Document attribute
! Document attribute
! Object attribute
! Object attribute
! Image attribute
! Text attribute
! Text attribute
! Default text attribute
! Default text attribute
Line 13: Line 15:
| W3C-doctype
| W3C-doctype
| Equivalent to what is specified in the <!DOCTYPE> header
| Equivalent to what is specified in the <!DOCTYPE> header
|
| Yes
| Yes
|
|  
|  
|  
|  
Line 22: Line 22:
| DocURL
| DocURL
| The location of the current document, including possibly a named anchor jumped to, for example http://www.foo.org#maincontent
| The location of the current document, including possibly a named anchor jumped to, for example http://www.foo.org#maincontent
| Yes. The document:attributes-changed event is fired if the DocURL changes due to a named anchor jump.
| Yes
| Yes
|
|  
|  
|  
|  
Line 31: Line 29:
| MimeType
| MimeType
| The mime or media type, such as text/plain, text/html, image/jpeg, image/svg+xml, application/xml+xhtml and application/vnd.mozilla.xul+xml.
| The mime or media type, such as text/plain, text/html, image/jpeg, image/svg+xml, application/xml+xhtml and application/vnd.mozilla.xul+xml.
|
| Yes
| Yes
|
|  
|  
|  
|  
Line 41: Line 37:
| A persistant ID for this object, useful for scripting
| A persistant ID for this object, useful for scripting
|  
|  
| Yes
|
|
|-
| tag
| The markup tag used to create this element
|  
|  
| Yes
| Yes
|  
|  
|
|-
| xml-roles
| The exact space-delimited ARIA role string. When a [http://developer.mozilla.org/en/docs/Accessible_DHTML dynamic content accessibility] role string is used, it is exposed here. This may provide more information than the AT-SPI role, which is best-fit. The xml-roles attribute may also include any landmark roles used, or a more specific custom role (e.g. buddylist in addition to listbox).
|
| Yes
|
|
|-
| layout-guess
| "true" when Gecko's heuristic determines that it is a table that is probably used for layout, not for a data table.<br /> Value not set means it is probably a data table.
|
| Only on ROLE_TABLE
|
|
|-
| level
| The heading level
|
| Only on ROLE_HEADING currently
|  
|  
|  
|  
|-
|-
| locale
| language
| What language is this text in, e.g. en-US
| What language is this text in, e.g. en-US
|
| Yes
| Yes
|
|  
|  
| Yes
| Yes
Line 59: Line 79:
| "true" for list bullet/numbering text or layout-inserted text (such as via CSS pseudo styles :before or :after)
| "true" for list bullet/numbering text or layout-inserted text (such as via CSS pseudo styles :before or :after)
|  
|  
| Yes
| Yes
|  
|  
|-
| misspelled
| "true" if it is marked by the inline spell checker for being incorrectly spelled (Note: in most cases a special underlining style will accompany this mark, and the underlining+style should also be exposed as a decoration attribute)
|  
|  
|  
|  
Line 65: Line 90:
|  
|  
|-
|-
| misspelled
| border
| "true" if it is underlined by the inline spell checker for being incorrectly spelled
| not sure how best to expose these properties, or whether to (same with outline CSS property)
|  
|  
|  
|  
|  
|
|-
| background-color
| Background color as u, u, u
|  
|  
| Yes
| Yes
| Yes
|-
| color
| Foreground color as u, u, u
|  
|  
| Yes
| Yes
| Yes
| Yes
|-
| direction
| rtl or ltr for bidi text
|  
|  
|
| Yes
| Yes
|-
|-
| xml-roles
| font-family
| The exact ARIA role, Used when a [http://developer.mozilla.org/en/docs/Accessible_DHTML dynamic content accessibility] role string is used, it is exposed here. This may provide more information than the AT-SPI role, which is best-fit. In the future, this may be a space or comma delimited list of roles ... hopefully t :)
| The computed font name
|  
|  
|  
|  
| Yes
| Yes
| Yes
|-
| margin-left
| In pixels
|  
|  
| Yes
|
|
|-
| margin-right
| In pixels
|
| Yes
|
|
|-
| font-size
| Font size in pixels
|  
|  
|  
|  
| Yes
| Yes
|-
|-
| layout-guess
| font-style
| "true" when Gecko's heuristic determines that it is a table that is probably used for layout, t for table.<br /> Value t set means it is probably a data table.
| normal/italic/oblique
|
|  
|  
| Yes
| Yes
|-
| font-weight
| The computed font weight, as a number
|  
|  
| Only on ROLE_TABLE
|  
|  
| Yes
| Yes
|-
| text-align
| left/center/right/justify
|  
|  
|  
|  
| Yes
| Yes
|-
|-
| level
| text-underline-style
| The heading level
| none/solid
|  
|  
|  
|  
| Only on ROLE_HEADING currently
| Yes
| Yes (empty implies none)
|-
| text-line-through-style
| none/solid
|
|  
|  
| Yes
| Yes (empty implies none)
|-
| z-index
| a number which indicates how low/high an element is
|  
|  
|  
|  
| Yes
|
|}
|}

Latest revision as of 03:21, 24 April 2008

<< Back to Accessibility Home Page

Proposed AT-SPI Attribute Support

Attribute name Attribute description Document attribute Object attribute Text attribute Default text attribute
W3C-doctype Equivalent to what is specified in the <!DOCTYPE> header Yes
DocURL The location of the current document, including possibly a named anchor jumped to, for example http://www.foo.org#maincontent Yes
MimeType The mime or media type, such as text/plain, text/html, image/jpeg, image/svg+xml, application/xml+xhtml and application/vnd.mozilla.xul+xml. Yes
id A persistant ID for this object, useful for scripting Yes
tag The markup tag used to create this element Yes
xml-roles The exact space-delimited ARIA role string. When a dynamic content accessibility role string is used, it is exposed here. This may provide more information than the AT-SPI role, which is best-fit. The xml-roles attribute may also include any landmark roles used, or a more specific custom role (e.g. buddylist in addition to listbox). Yes
layout-guess "true" when Gecko's heuristic determines that it is a table that is probably used for layout, not for a data table.
Value not set means it is probably a data table.
Only on ROLE_TABLE
level The heading level Only on ROLE_HEADING currently
language What language is this text in, e.g. en-US Yes Yes Yes
static "true" for list bullet/numbering text or layout-inserted text (such as via CSS pseudo styles :before or :after) Yes Yes
misspelled "true" if it is marked by the inline spell checker for being incorrectly spelled (Note: in most cases a special underlining style will accompany this mark, and the underlining+style should also be exposed as a decoration attribute) Yes
border not sure how best to expose these properties, or whether to (same with outline CSS property)
background-color Background color as u, u, u Yes Yes Yes
color Foreground color as u, u, u Yes Yes Yes
direction rtl or ltr for bidi text Yes Yes
font-family The computed font name Yes Yes
margin-left In pixels Yes
margin-right In pixels Yes
font-size Font size in pixels Yes Yes
font-style normal/italic/oblique Yes Yes
font-weight The computed font weight, as a number Yes Yes
text-align left/center/right/justify Yes Yes
text-underline-style none/solid Yes Yes (empty implies none)
text-line-through-style none/solid Yes Yes (empty implies none)
z-index a number which indicates how low/high an element is Yes