Skip to content

Text Appearance May 2025 #311

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 14 commits into
base: main
Choose a base branch
from
Open

Text Appearance May 2025 #311

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
bd5a592
Initial file name updates
alastc May 23, 2025
1a98c97
drafts of requirements
alastc May 23, 2025
ce73f32
Updates
alastc May 23, 2025
1f5cc35
Fixing formating
alastc May 23, 2025
aeca9cb
add data class to tables
fstrr May 23, 2025
5787b8e
draft of adjustable text style
alastc May 24, 2025
7a44f51
Merge branch 'group-text-appearance-may-2025' of https://github.com/w…
alastc May 24, 2025
3d400f2
Adding decision tree
alastc May 27, 2025
71894fd
Merge branch 'main' into group-text-appearance-may-2025
alastc May 30, 2025
e269947
Merge branch 'main' into group-text-appearance-may-2025
iadawn Jun 11, 2025
e900309
readable text style supplimental
alastc Jul 15, 2025
2071c2b
Fix build failure
iadawn Jul 31, 2025
47c8fb4
Merge branch 'main' into group-text-appearance-may-2025
kfranqueiro Aug 6, 2025
9ecc014
add table styles, add links, fix typos
fstrr Aug 6, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 32 additions & 4 deletions guidelines/groups/text-and-wording/text-appearance.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,37 @@
---
children:
- maximum-text-contrast
- minimum-text-contrast
- text-size
- text-style
- readable-blocks-of-text
- readable-text-style
- adjustable-blocks-of-text
- adjustable-text-style
- content-and-functionality-not-lost-with-text-adjustment
- readable-blocks-of-text-supplemental
- readable-text-style-supplemental
---

Users can read visually rendered text.

:::decision-tree
For each word of text:
1. Is the text :term[purely decorative] or, is it not readable by anybody?
- Yes, Pass
- No, Continue
2. Does the default/authored presentation meet minimum requirements?
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
2. No, Fail
3. Can the text appearance be adjusted by the user?
1. Yes, text must be :term[user-manipulable text] and:
1. The :term[accessibility support set] meets:
1. <a href="#adjustable-blocks-of-text">Adjustable blocks of text</a>
2. <a href="#adjustable-text-style">Adjustable text style</a>
2. <a href="#content-and-functionality-not-lost-with-text-adjustment">Content and functional are not lost with text adjustment</a>
3. Pass
2. Yes, via produce-provided themes:
1. <a href="#adjustable-blocks-of-text">Adjustable blocks of text</a>
2. <a href="#adjustable-text-style">Adjustable text style</a>
3. <a href="#content-and-functionality-not-lost-with-text-adjustment">Content and functional are not lost with text adjustment</a>
4. Pass
3. No, and the product does not provide its own themes:
1. Fail.

:::
65 changes: 65 additions & 0 deletions guidelines/groups/text-and-wording/text-appearance/adjustable-blocks-of-text.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
needsAdditionalResearch: true
status: exploratory
---

The user can adjust the presentation of :term[blocks of text] to meet the corresponding values for the content's language (or the most similar language of the ones listed).

:::ednote
Information could be lost if the user overrides the appearance. See [other structural guideline] about ensuring the structure conveys the meaning when possible.
:::

<table class="data">
<thead>
<tr>
<th>Characteristic</th>
<th>Arabic</th>
<th>Chinese</th>
<th>English</th>
<th>Hindi</th>
<th>Russian</th>
</tr>
</thead>
<tbody>
<tr>
<th>Inline margin</th>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<th>Block Margin</th>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<th>Line length</th>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<th>Line height</th>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<th>Justification</th>
<td></td>
<td>Not applicable</td>
<td>Left aligned</td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
100 changes: 100 additions & 0 deletions guidelines/groups/text-and-wording/text-appearance/adjustable-text-style.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,100 @@
---
needsAdditionalResearch: true
status: exploratory
---

The user can adjust the presentation of each of the following attributes to meet the corresponding values for the content’s language (or the most similar language of the ones listed).

:::ednote
Information could be lost if the user overrides the appearance. See [other structural guideline] about ensuring the structure conveys the meaning when possible.
:::

<table class="data">
<thead>
<tr>
<th>Characteristic</th>
<th>Arabic</th>
<th>Chinese</th>
<th>English</th>
<th>Hindi</th>
<th>Russian</th>
</tr>
</thead>
<tbody>
<tr>
<th>Underlining</th>
<td></td>
<td></td>
<td>
<ul>
<li>Disabled entirely</li>
<li>Enabled on links only</li>
<li>Enabled on links and author defined other text</li>
</ul>
</td>
<td></td>
<td></td>
</tr>
<tr>
<th>Italics</th>
<td></td>
<td></td>
<td>Disabled</td>
<td></td>
<td></td>
</tr>
<tr>
<th>Bold</th>
<td></td>
<td></td>
<td>Disabled</td>
<td></td>
<td></td>
</tr>
<tr>
<th>Font face</th>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<th>Font width</th>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<th>Letter spacing</th>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<th>Capitalization</th>
<td></td>
<td></td>
<td>
<ul>
<li>Sentence case</li>
<li>Title case (headings, titles), sentence case for all other text</li>
</ul>
</td>
<td></td>
<td></td>
</tr>
<tr>
<th>Automatic hyphenation</th>
<td></td>
<td></td>
<td>Disabled</td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
6 changes: 6 additions & 0 deletions ...ding/text-appearance/content-and-functionality-not-lost-with-text-adjustment.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
needsAdditionalResearch: true
status: exploratory
---

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 is not lost.
6 changes: 0 additions & 6 deletions guidelines/groups/text-and-wording/text-appearance/maximum-text-contrast.md
View file
Open in desktop

This file was deleted.

6 changes: 0 additions & 6 deletions guidelines/groups/text-and-wording/text-appearance/minimum-text-contrast.md
View file
Open in desktop

This file was deleted.

65 changes: 65 additions & 0 deletions ...groups/text-and-wording/text-appearance/readable-blocks-of-text-supplemental.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
needsAdditionalResearch: true
status: exploratory
---

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).

:::ednote
[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.
:::

<table class="data">
<thead>
<tr>
<th>Characteristic</th>
<th>Arabic</th>
<th>Chinese</th>
<th>English</th>
<th>Hindi</th>
<th>Russian</th>
</tr>
</thead>
<tbody>
<tr>
<th>Inline margin</th>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<th>Block Margin</th>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<th>Line length</th>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<th>Line height</th>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<th>Justification</th>
<td></td>
<td></td>
<td>Left aligned</td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
65 changes: 65 additions & 0 deletions guidelines/groups/text-and-wording/text-appearance/readable-blocks-of-text.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
needsAdditionalResearch: true
status: exploratory
---

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).

:::ednote
[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.
:::

<table class="data">
<thead>
<tr>
<th>Characteristic</th>
<th>Arabic</th>
<th>Chinese</th>
<th>English</th>
<th>Hindi</th>
<th>Russian</th>
</tr>
</thead>
<tbody>
<tr>
<th>Inline margin</th>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<th>Block Margin</th>
<td></td>
<td></td>
<td>≥0.5em around paragraphs</td>
<td></td>
<td></td>
</tr>
<tr>
<th>Line length</th>
<td></td>
<td></td>
<td>30-100 characters</td>
<td></td>
<td></td>
</tr>
<tr>
<th>Line height</th>
<td></td>
<td></td>
<td>1.0 - paragraph separation height</td>
<td></td>
<td></td>
</tr>
<tr>
<th>Justification</th>
<td></td>
<td></td>
<td>Left aligned or Justified</td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
Loading