events
news
The Linux Foundation
 
Accessibility/IAccessible2/TextAttributes

From The Linux Foundation

Text Attributes

Contents

General Information

Referenced Specifications

CSS2 values information

Formating

  • 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 comma 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 CSS2 Specification 14.2.1
color <color> rgb(0,0,0) <color> as rgb(n,n,n) where n is 0-255 CSS2 Specification 14.1
font-family <string> no default CSS2 Specification 15.2.2
font-size <length> no default font size in points, e.g. font-size:12pt; CSS2 Specification 15.2.4
font-style normal, italic, oblique normal CSS2 Specification 15.2.3
font-weight normal, bold, <integer> normal (400) 100, 200, 300, 400, 500, 600, 700, 800, 900; normal = 400, bold = 700 CSS2 Specification 15.2.3
invalid true, false, spelling, grammar false WAI-ARIA Specification 5.2.1
language language in IETF RFC 3066 format en-US Examples are en-US and de-DE. IETF RFC 3066
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 Always used if text-line-through-type is specified. 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 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 A signed percentage, e.g. -40%, specifying a position above or below the baseline, or the values super or sub. There is an optional second parameter, an unsigned percentage, specifying the size of the font. 0% An example is:

"...;text-position:-40% 50%;..."
ODF Specification 15.4.12
text-shadow see reference none Inherit is not a valid value. 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 Always used if text-underline-type is specified. ODF Specification 15.4.29
text-underline-type none, single, double none 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

[Article] [Discussion] [View source] [History]