iaccessible2/textattributes

Text Attributes

Contents

General Information

Referenced Specifications

 

 

CSS 2.1 values information

Formatting

 

  • The proper format for the attributes is
    "attribute:value;attribute:value,value;"
  • The format of attribute:value,value; is currently only used for the invalid attribute, e.g. invalid:spelling,grammar;
  • These characters need to be escaped with a backslash: backslash, colon, comma, equals, and semicolon.
  • Attribute strings must always end with a semicolon, i.e. there needs to be a semicolon at the very end of the string of the full set of attribute:value pairs.
  • Series of attribute values, as shown in the examples above, must not end with a comma.

Object Attributes

 

Some text attributes are on a paragraph by paragraph basis and are documented in the Object Attributes Specification.

Attributes

 

The following attributes can change on a character by character basis. They are retrieved via the IAccessibleText::attributes method. If an attribute is not specified and if the table shows that there is a default value, the default value should be assumed.

Name Values Default Comments Reference
auto-generated true, false false This attribute is used in Firefox but not in IBM Lotus Symphony. Symphony uses the list object attribute for bulleted and numbered lists. In Firefox, this attribute's value is "true" for list bullet/numbering prefix text or layout-inserted text such as via the CSS pseudo styles :before or :after.  
background-color transparent, <color> transparent <color> as rgb(n,n,n) where n is 0-255 CSS 2.1 Specification 14.2.1
color <color> rgb(0,0,0) <color> as rgb(n,n,n) where n is 0-255 CSS 2.1 Specification 14.1
font-family <string> no default   CSS 2.1 Specification 15.3
font-size <length> no default font size in points, e.g. font-size:12pt;

Note: When the application's native attribute is not in pts the application accessibility code should convert to pt. The conversion doesn't have to be exact. The intent is to give the user a feel for the size of the text.
CSS 2.1 Specification 15.7
font-style normal, italic, oblique normal   CSS 2.1 Specification 15.4
font-weight normal, bold, <integer> normal (400) 100, 200, 300, 400, 500, 600, 700, 800, 900; normal = 400, bold = 700 CSS 2.1 Specification 15.6
invalid true, false, spelling, grammar false   WAI-ARIA Specification 5.6
language language in IETF RFC 4646 format en-US Examples are en-US and de-DE.

Also refer to Language tags in HTML and XML.

IETF RFC 4646

IETF RFC 4647
text-line-through-mode continuous, skip-white-space continuous   ODF Specification 15.4.34
text-line-through-style none, solid, dotted, dash, long-dash, dot-dash, dot-dot-dash, wave none Either text-line-through-style or text-line-through-type or both can be used. If text-line-through-type is not used the line is a single line. ODF Specification 15.4.7
text-line-through-text <string> an empty string Typical values are / and X, e.g. text-line-through-text:/; ODF Specification 15.4.10
text-line-through-type none, single, double none Either text-line-through-type or text-line-through-style or both can be used. If text-line-through-style is not used the line is solid. ODF Specification 15.4.6
text-line-through-width auto, normal, bold, thin, dash, medium, thick, <integer>, <length>, <percentage> auto <integer> and <length> must be positive. ODF Specification 15.4.8
text-outline true, false false   ODF Specification 15.4.5
text-position baseline, super, sub baseline When the text is not positioned on the baseline and the application's native attribute is not specified as super or sub the application should provide the value super when the text is above the baseline and sub when the text is below the baseline.

Also consider the case of the html snippet, x<sup>a<sub>i</sub></sup>. A super or sub text attribute refers to the base line of the prior character which in turn may itself be offset from the baseline of the character in front of it.

CSS 2.1 Specification 10.8
text-shadow see reference none Inherit is not a valid value.

Note that this attribute was removed from the CSS2 spec. The link in the reference column is to an archived version of the CSS2 spec.

CSS2 Specification 16.3.2
text-underline-mode continuous, skip-white-space continuous   ODF Specification 15.4.33
text-underline-style none, solid, dotted, dash, long-dash, dot-dash, dot-dot-dash, wave none Either text-underline-style or text-underline-type or both can be used. If text-underline-type is not used the line is a single line. ODF Specification 15.4.29
text-underline-type none, single, double none Either text-underline-type or text-underline-style or both can be used. If text-underline-style is not used the line is solid. ODF Specification 15.4.28
text-underline-width auto, normal, bold, thin, dash, medium, thick, <integer>, <length>, <percentage> auto <integer> and <length> must be positive. ODF Specification 15.4.30
writing-mode lr, rl, tb lr tb is top-to-bottom, i.e. text flows from top-to-bottom then left-to-right. XSL 1.1 Specification 7.29.7
Groups: