diff --git a/guidelines/groups/text-and-wording/text-appearance.md b/guidelines/groups/text-and-wording/text-appearance.md index 3087a195..fa8fc5ed 100644 --- a/guidelines/groups/text-and-wording/text-appearance.md +++ b/guidelines/groups/text-and-wording/text-appearance.md @@ -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 Readable Blocks of Text (foundational) and Readable Text Style (foundational), 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. Adjustable blocks of text + 2. Adjustable text style + 2. Content and functional are not lost with text adjustment + 3. Pass + 2. Yes, via produce-provided themes: + 1. Adjustable blocks of text + 2. Adjustable text style + 3. Content and functional are not lost with text adjustment + 4. Pass + 3. No, and the product does not provide its own themes: + 1. Fail. + +::: \ No newline at end of file diff --git a/guidelines/groups/text-and-wording/text-appearance/adjustable-blocks-of-text.md b/guidelines/groups/text-and-wording/text-appearance/adjustable-blocks-of-text.md new file mode 100644 index 00000000..0937e16f --- /dev/null +++ b/guidelines/groups/text-and-wording/text-appearance/adjustable-blocks-of-text.md @@ -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. +::: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CharacteristicArabicChineseEnglishHindiRussian
Inline margin
Block Margin
Line length
Line height
JustificationNot applicableLeft aligned
\ No newline at end of file diff --git a/guidelines/groups/text-and-wording/text-appearance/adjustable-text-style.md b/guidelines/groups/text-and-wording/text-appearance/adjustable-text-style.md new file mode 100644 index 00000000..f1175e10 --- /dev/null +++ b/guidelines/groups/text-and-wording/text-appearance/adjustable-text-style.md @@ -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. +::: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CharacteristicArabicChineseEnglishHindiRussian
Underlining +
    +
  • Disabled entirely
    • +
  • Enabled on links only
    • +
  • Enabled on links and author defined other text
    • +
+
ItalicsDisabled
BoldDisabled
Font face
Font width
Letter spacing
Capitalization +
    +
  • Sentence case
    • +
  • Title case (headings, titles), sentence case for all other text
    • +
+
Automatic hyphenationDisabled
\ No newline at end of file diff --git a/guidelines/groups/text-and-wording/text-appearance/content-and-functionality-not-lost-with-text-adjustment.md b/guidelines/groups/text-and-wording/text-appearance/content-and-functionality-not-lost-with-text-adjustment.md new file mode 100644 index 00000000..db93a4ad --- /dev/null +++ b/guidelines/groups/text-and-wording/text-appearance/content-and-functionality-not-lost-with-text-adjustment.md @@ -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. \ No newline at end of file diff --git a/guidelines/groups/text-and-wording/text-appearance/maximum-text-contrast.md b/guidelines/groups/text-and-wording/text-appearance/maximum-text-contrast.md deleted file mode 100644 index 019f8cb4..00000000 --- a/guidelines/groups/text-and-wording/text-appearance/maximum-text-contrast.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -needsAdditionalResearch: true -status: exploratory ---- - -The rendered text against its background meets a maximum :term[contrast ratio test] for its text appearance. diff --git a/guidelines/groups/text-and-wording/text-appearance/minimum-text-contrast.md b/guidelines/groups/text-and-wording/text-appearance/minimum-text-contrast.md deleted file mode 100644 index 0c1d4832..00000000 --- a/guidelines/groups/text-and-wording/text-appearance/minimum-text-contrast.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -needsAdditionalResearch: true -status: exploratory ---- - -The rendered text against its background meets a minimum :term[contrast ratio test] for its text appearance. diff --git a/guidelines/groups/text-and-wording/text-appearance/readable-blocks-of-text-supplemental.md b/guidelines/groups/text-and-wording/text-appearance/readable-blocks-of-text-supplemental.md new file mode 100644 index 00000000..046c16cd --- /dev/null +++ b/guidelines/groups/text-and-wording/text-appearance/readable-blocks-of-text-supplemental.md @@ -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. +::: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CharacteristicArabicChineseEnglishHindiRussian
Inline margin
Block Margin
Line length
Line height
JustificationLeft aligned
diff --git a/guidelines/groups/text-and-wording/text-appearance/readable-blocks-of-text.md b/guidelines/groups/text-and-wording/text-appearance/readable-blocks-of-text.md new file mode 100644 index 00000000..5ef475b2 --- /dev/null +++ b/guidelines/groups/text-and-wording/text-appearance/readable-blocks-of-text.md @@ -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. +::: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CharacteristicArabicChineseEnglishHindiRussian
Inline margin
Block Margin≥0.5em around paragraphs
Line length30-100 characters
Line height1.0 - paragraph separation height
JustificationLeft aligned or Justified
diff --git a/guidelines/groups/text-and-wording/text-appearance/readable-text-style-supplemental.md b/guidelines/groups/text-and-wording/text-appearance/readable-text-style-supplemental.md new file mode 100644 index 00000000..26115bb3 --- /dev/null +++ b/guidelines/groups/text-and-wording/text-appearance/readable-text-style-supplemental.md @@ -0,0 +1,81 @@ +--- +needsAdditionalResearch: true +status: exploratory +--- + +The default/authored presentation of text meet 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. +::: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CharacteristicArabicChineseEnglishHindiRussian
Font face
Font sizeVertical viewing angle of ≥0.2° (~10pt at typical desktop viewing distances)
Font width
Text decorationMost text is not bold, italicized, and/or underlined
Letter spacing
Capitalisation
Hyphenation
diff --git a/guidelines/groups/text-and-wording/text-appearance/readable-text-style.md b/guidelines/groups/text-and-wording/text-appearance/readable-text-style.md new file mode 100644 index 00000000..1246eba3 --- /dev/null +++ b/guidelines/groups/text-and-wording/text-appearance/readable-text-style.md @@ -0,0 +1,81 @@ +--- +needsAdditionalResearch: true +status: exploratory +--- + +The default/authored presentation 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. +::: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CharacteristicArabicChineseEnglishHindiRussian
Font face
Font sizeVertical viewing angle of ≥0.2° (~10pt at typical desktop viewing distances)
Font width
Text decorationMost text is not bold, italicized, and/or underlined
Letter spacing
Capitalisation
Hyphenation
diff --git a/guidelines/groups/text-and-wording/text-appearance/text-size.md b/guidelines/groups/text-and-wording/text-appearance/text-size.md deleted file mode 100644 index 83aa52ca..00000000 --- a/guidelines/groups/text-and-wording/text-appearance/text-size.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -needsAdditionalResearch: true -status: exploratory ---- - -The rendered text meets a minimum font size and weight. diff --git a/guidelines/groups/text-and-wording/text-appearance/text-style.md b/guidelines/groups/text-and-wording/text-appearance/text-style.md deleted file mode 100644 index bdae75a7..00000000 --- a/guidelines/groups/text-and-wording/text-appearance/text-style.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -status: exploratory ---- - -The rendered text does not use a decorative or cursive font face.