Linux Foundation Wiki

project collaboration site

User Tools

Site Tools


accessibility:iaccessible2:textattributes

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.

NameValuesDefaultCommentsReference
auto-generatedtrue, falsefalseThis 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-colortransparent, <color>transparent<color> as rgb(n,n,n) where n is 0-255CSS 2.1 Specification 14.2.1
color<color>rgb(0,0,0)<color> as rgb(n,n,n) where n is 0-255CSS 2.1 Specification 14.1
font-family<string>no default CSS 2.1 Specification 15.3
font-size<length>no defaultfont 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-stylenormal, italic, obliquenormal CSS 2.1 Specification 15.4
font-weightnormal, bold, <integer>normal (400)100, 200, 300, 400, 500, 600, 700, 800, 900; normal = 400, bold = 700CSS 2.1 Specification 15.6
invalidtrue, false, spelling, grammarfalse WAI-ARIA Specification 5.6
languagelanguage in IETF RFC 4646 formaten-USExamples are en-US and de-DE.
Also refer to Language tags in HTML and XML.
IETF RFC 4646

IETF RFC 4647
text-line-through-modecontinuous, skip-white-spacecontinuous ODF Specification 15.4.34
text-line-through-stylenone, solid, dotted, dash, long-dash, dot-dash, dot-dot-dash, wavenoneEither 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 stringTypical values are / and X, e.g. text-line-through-text:/;ODF Specification 15.4.10
text-line-through-typenone, single, doublenoneEither 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-widthauto, normal, bold, thin, dash, medium, thick, <integer>, <length>, <percentage>auto<integer> and <length> must be positive.ODF Specification 15.4.8
text-outlinetrue, falsefalse ODF Specification 15.4.5
text-positionbaseline, super, subbaselineWhen 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, xai. 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-shadowsee referencenoneInherit 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-modecontinuous, skip-white-spacecontinuous ODF Specification 15.4.33
text-underline-stylenone, solid, dotted, dash, long-dash, dot-dash, dot-dot-dash, wavenoneEither 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-typenone, single, doublenoneEither 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-widthauto, normal, bold, thin, dash, medium, thick, <integer>, <length>, <percentage>auto<integer> and <length> must be positive.ODF Specification 15.4.30
writing-modelr, rl, tblrtb is top-to-bottom, i.e. text flows from top-to-bottom then left-to-right.XSL 1.1 Specification 7.29.7
accessibility/iaccessible2/textattributes.txt · Last modified: 2016/07/19 01:23 (external edit)