Text Attributes
Contents |
General Information
Referenced Specifications
CSS 2.1 values information
- 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.
Some text attributes are on a paragraph by paragraph basis and are documented in the Object Attributes Specification.
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 |
| 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. | CSS 2.1 Specification 10.8 |
| 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 | 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:
