Skip to content

Commit 376790a

Browse files
alastcfstrriadawnkfranqueiro
authored
Text Appearance May 2025 (#311)
--------- Co-authored-by: Francis Storr <[email protected]> Co-authored-by: Kevin White <[email protected]> Co-authored-by: Kenneth G. Franqueiro <[email protected]>
1 parent cef1d52 commit 376790a

13 files changed

+522
-27
lines changed

‎guidelines/groups/text-and-wording/text-appearance.md

Lines changed: 32 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,37 @@
11
---
22
children:
3-
- maximum-text-contrast
4-
- minimum-text-contrast
5-
- text-size
6-
- text-style
3+
- readable-blocks-of-text
4+
- readable-text-style
5+
- adjustable-blocks-of-text
6+
- adjustable-text-style
7+
- content-and-functionality-not-lost-with-text-adjustment
8+
- readable-blocks-of-text-supplemental
9+
- readable-text-style-supplemental
710
---
811

912
Users can read visually rendered text.
13+
14+
:::decision-tree
15+
For each word of text:
16+
1. Is the text :term[purely decorative] or, is it not readable by anybody?
17+
- Yes, Pass
18+
- No, Continue
19+
2. Does the default/authored presentation meet minimum requirements?
20+
1. Yes, the default/authored presentation meets <a href="#readable-blocks-of-text">Readable Blocks of Text (foundational)</a> and <a href="readable-text-style">Readable Text Style (foundational)</a>, Continue
21+
2. No, Fail
22+
3. Can the text appearance be adjusted by the user?
23+
1. Yes, text must be :term[user-manipulable text] and:
24+
1. The :term[accessibility support set] meets:
25+
1. <a href="#adjustable-blocks-of-text">Adjustable blocks of text</a>
26+
2. <a href="#adjustable-text-style">Adjustable text style</a>
27+
2. <a href="#content-and-functionality-not-lost-with-text-adjustment">Content and functional are not lost with text adjustment</a>
28+
3. Pass
29+
2. Yes, via produce-provided themes:
30+
1. <a href="#adjustable-blocks-of-text">Adjustable blocks of text</a>
31+
2. <a href="#adjustable-text-style">Adjustable text style</a>
32+
3. <a href="#content-and-functionality-not-lost-with-text-adjustment">Content and functional are not lost with text adjustment</a>
33+
4. Pass
34+
3. No, and the product does not provide its own themes:
35+
1. Fail.
36+
37+
:::

‎guidelines/groups/text-and-wording/text-appearance/adjustable-blocks-of-text.md

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
status: developing
3+
type: foundational
4+
---
5+
6+
The presentation of :term[blocks of text] can be adjusted to meet the corresponding values for the content's language (or the most similar language of the ones listed).
7+
8+
:::ednote
9+
Information could be lost if the user overrides the appearance. See [other structural guideline] about ensuring the structure conveys the meaning when possible.
10+
:::
11+
12+
:::ednote
13+
The metrics in the following table are still to be determined, the current content is an example.
14+
:::
15+
16+
<table class="data">
17+
<thead>
18+
<tr>
19+
<th>Characteristic</th>
20+
<th>Arabic</th>
21+
<th>Chinese</th>
22+
<th>English</th>
23+
<th>Hindi</th>
24+
<th>Russian</th>
25+
</tr>
26+
</thead>
27+
<tbody>
28+
<tr>
29+
<th>Inline margin</th>
30+
<td></td>
31+
<td></td>
32+
<td></td>
33+
<td></td>
34+
<td></td>
35+
</tr>
36+
<tr>
37+
<th>Block Margin</th>
38+
<td></td>
39+
<td></td>
40+
<td></td>
41+
<td></td>
42+
<td></td>
43+
</tr>
44+
<tr>
45+
<th>Line length</th>
46+
<td></td>
47+
<td></td>
48+
<td></td>
49+
<td></td>
50+
<td></td>
51+
</tr>
52+
<tr>
53+
<th>Line height</th>
54+
<td></td>
55+
<td></td>
56+
<td></td>
57+
<td></td>
58+
<td></td>
59+
</tr>
60+
<tr>
61+
<th>Justification</th>
62+
<td></td>
63+
<td>Not applicable</td>
64+
<td>Left aligned</td>
65+
<td></td>
66+
<td></td>
67+
</tr>
68+
</tbody>
69+
</table>

‎guidelines/groups/text-and-wording/text-appearance/adjustable-text-style.md

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
1+
---
2+
status: developing
3+
type: foundational
4+
---
5+
6+
The presentation of each of the following attributes can be adjusted to meet the corresponding values for the content’s language (or the most similar language of the ones listed).
7+
8+
:::ednote
9+
Information could be lost if the user overrides the appearance. See [other structural guideline] about ensuring the structure conveys the meaning when possible.
10+
:::
11+
12+
:::ednote
13+
The metrics in the following table are still to be determined, the current content is an example.
14+
:::
15+
16+
<table class="data">
17+
<thead>
18+
<tr>
19+
<th>Characteristic</th>
20+
<th>Arabic</th>
21+
<th>Chinese</th>
22+
<th>English</th>
23+
<th>Hindi</th>
24+
<th>Russian</th>
25+
</tr>
26+
</thead>
27+
<tbody>
28+
<tr>
29+
<th>Underlining</th>
30+
<td></td>
31+
<td></td>
32+
<td>
33+
<ul>
34+
<li>Disabled entirely</li>
35+
<li>Enabled on links only</li>
36+
<li>Enabled on links and author defined other text</li>
37+
</ul>
38+
</td>
39+
<td></td>
40+
<td></td>
41+
</tr>
42+
<tr>
43+
<th>Italics</th>
44+
<td></td>
45+
<td></td>
46+
<td>Disabled</td>
47+
<td></td>
48+
<td></td>
49+
</tr>
50+
<tr>
51+
<th>Bold</th>
52+
<td></td>
53+
<td></td>
54+
<td>Disabled</td>
55+
<td></td>
56+
<td></td>
57+
</tr>
58+
<tr>
59+
<th>Font face</th>
60+
<td></td>
61+
<td></td>
62+
<td></td>
63+
<td></td>
64+
<td></td>
65+
</tr>
66+
<tr>
67+
<th>Font width</th>
68+
<td></td>
69+
<td></td>
70+
<td></td>
71+
<td></td>
72+
<td></td>
73+
</tr>
74+
<tr>
75+
<th>Letter spacing</th>
76+
<td></td>
77+
<td></td>
78+
<td></td>
79+
<td></td>
80+
<td></td>
81+
</tr>
82+
<tr>
83+
<th>Capitalization</th>
84+
<td></td>
85+
<td></td>
86+
<td>
87+
<ul>
88+
<li>Sentence case</li>
89+
<li>Title case (headings, titles), sentence case for all other text</li>
90+
</ul>
91+
</td>
92+
<td></td>
93+
<td></td>
94+
</tr>
95+
<tr>
96+
<th>Automatic hyphenation</th>
97+
<td></td>
98+
<td></td>
99+
<td>Disabled</td>
100+
<td></td>
101+
<td></td>
102+
</tr>
103+
</tbody>
104+
</table>

‎guidelines/groups/text-and-wording/text-appearance/content-and-functionality-not-lost-with-text-adjustment.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
status: developing
3+
type: foundational
4+
---
5+
6+
When the content is adjusted according to [Adjustable blocks of text](#adjustable-blocks-of-text) and [Adjustable text style](#adjustable-text-style), content and functionality are not lost.

‎guidelines/groups/text-and-wording/text-appearance/maximum-text-contrast.md

Lines changed: 0 additions & 6 deletions
This file was deleted.

‎guidelines/groups/text-and-wording/text-appearance/minimum-text-contrast.md

Lines changed: 0 additions & 6 deletions
This file was deleted.

‎guidelines/groups/text-and-wording/text-appearance/readable-blocks-of-text-supplemental.md

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
title: Readable blocks of text (supplemental)
3+
status: developing
4+
type: supplemental
5+
---
6+
7+
The default/authored presentation of :term[blocks of text] meets the corresponding values for the content’s language (or the most similar language of the ones listed).
8+
9+
:::ednote
10+
[Readable blocks of text (foundational)](#readable-blocks-of-text) and [Readable text style (foundational)](#readable-text-style) are based on common usage, and their supplemental counterparts are based on readability research. We need more readability research in these languages.
11+
:::
12+
13+
:::ednote
14+
The metrics in the following table are still to be determined, the current content is an example.
15+
:::
16+
17+
<table class="data">
18+
<thead>
19+
<tr>
20+
<th>Characteristic</th>
21+
<th>Arabic</th>
22+
<th>Chinese</th>
23+
<th>English</th>
24+
<th>Hindi</th>
25+
<th>Russian</th>
26+
</tr>
27+
</thead>
28+
<tbody>
29+
<tr>
30+
<th>Inline margin</th>
31+
<td></td>
32+
<td></td>
33+
<td></td>
34+
<td></td>
35+
<td></td>
36+
</tr>
37+
<tr>
38+
<th>Block Margin</th>
39+
<td></td>
40+
<td></td>
41+
<td></td>
42+
<td></td>
43+
<td></td>
44+
</tr>
45+
<tr>
46+
<th>Line length</th>
47+
<td></td>
48+
<td></td>
49+
<td></td>
50+
<td></td>
51+
<td></td>
52+
</tr>
53+
<tr>
54+
<th>Line height</th>
55+
<td></td>
56+
<td></td>
57+
<td></td>
58+
<td></td>
59+
<td></td>
60+
</tr>
61+
<tr>
62+
<th>Justification</th>
63+
<td></td>
64+
<td></td>
65+
<td>Left aligned</td>
66+
<td></td>
67+
<td></td>
68+
</tr>
69+
</tbody>
70+
</table>

‎guidelines/groups/text-and-wording/text-appearance/readable-blocks-of-text.md

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
status: developing
3+
type: foundational
4+
---
5+
6+
The default/authored presentation of :term[blocks of text] meets the corresponding values for the content’s language (or the most similar language of the ones listed).
7+
8+
:::ednote
9+
[Readable blocks of text (foundational)](#readable-blocks-of-text) and [Readable text style (foundational)](#readable-text-style) are based on common usage, and their supplemental counterparts are based on readability research. We need more readability research in these languages.
10+
:::
11+
12+
:::ednote
13+
The metrics in the following table are still to be determined, the current content is an example.
14+
:::
15+
16+
<table class="data">
17+
<thead>
18+
<tr>
19+
<th>Characteristic</th>
20+
<th>Arabic</th>
21+
<th>Chinese</th>
22+
<th>English</th>
23+
<th>Hindi</th>
24+
<th>Russian</th>
25+
</tr>
26+
</thead>
27+
<tbody>
28+
<tr>
29+
<th>Inline margin</th>
30+
<td></td>
31+
<td></td>
32+
<td></td>
33+
<td></td>
34+
<td></td>
35+
</tr>
36+
<tr>
37+
<th>Block Margin</th>
38+
<td></td>
39+
<td></td>
40+
<td>≥0.5em around paragraphs</td>
41+
<td></td>
42+
<td></td>
43+
</tr>
44+
<tr>
45+
<th>Line length</th>
46+
<td></td>
47+
<td></td>
48+
<td>30-100 characters</td>
49+
<td></td>
50+
<td></td>
51+
</tr>
52+
<tr>
53+
<th>Line height</th>
54+
<td></td>
55+
<td></td>
56+
<td>1.0 - paragraph separation height</td>
57+
<td></td>
58+
<td></td>
59+
</tr>
60+
<tr>
61+
<th>Justification</th>
62+
<td></td>
63+
<td></td>
64+
<td>Left aligned or Justified</td>
65+
<td></td>
66+
<td></td>
67+
</tr>
68+
</tbody>
69+
</table>

0 commit comments

Comments
 (0)