From 9c002e5066ea1c8e79d9a7ebd0ac9a1364140bef Mon Sep 17 00:00:00 2001 From: "Patrick H. Lauke" Date: Sat, 19 Mar 2022 10:19:18 +0000 Subject: [PATCH 1/9] Expand/clarify understanding for 1.4.4 Resize Text Relates to https://github.com/w3c/wcag/issues/2169 and questions about whether a site that break using "text-only" resizing fails, even if zooming works --- understanding/20/resize-text.html | 28 ++++++++++++++++------------ 1 file changed, 16 insertions(+), 12 deletions(-) diff --git a/understanding/20/resize-text.html b/understanding/20/resize-text.html index eb05e91aff..d2a546381c 100644 --- a/understanding/20/resize-text.html +++ b/understanding/20/resize-text.html @@ -15,7 +15,7 @@

Intent of Resize text

The intent of this Success Criterion is to ensure that visually rendered text, including text-based controls (text characters that have been displayed so that they can be - seen [vs. text characters that are still in data form such as ASCII]) can be scaled + seen, rather than text characters that are still in data form such as ASCII) can be scaled successfully so that it can be read directly by people with mild visual disabilities, without requiring the use of assistive technology such as a screen magnifier. Users may benefit from scaling all content on the Web page, but text is most critical. @@ -23,23 +23,27 @@

Intent of Resize text

The scaling of content is primarily a user agent responsibility. User agents that satisfy - UAAG 1.0 Checkpoint 4.1 allow users to configure text scale. The author's responsibility is to create Web - content that does not prevent the user agent from scaling the content effectively. + UAAG 1.0 Checkpoint 4.1 + allow users to configure text scale through a number of mechanisms - including zoom (of the entire page's content), + magnification, text-only resizing, and allowing the user to configure a reference size for rendered text. + The author's responsibility is to create Web content that does not prevent the user agent from scaling the content effectively. Authors may satisfy this Success Criterion by verifying that content does not interfere with user agent support for resizing text, including text-based controls, or by providing direct support for resizing text or changing the layout. An example of direct support might be via server-side script that can be used to assign different style sheets.

+ +

Content satisfies the Success Criterion if it can be scaled up to 200% using at least one text scaling + mechanism supported by user agents.

The author cannot rely on the user agent to satisfy this Success Criterion for HTML - content if users do not have access to a user agent with zoom support. For example, - if they work in an environment that requires them to use IE 6. + through a specific text scaling mechanism if users do not have access to a user agent with that particular mechanism.

-

If the author is using a technology whose user agents do not provide zoom support, - the author is responsible to provide this type of functionality directly or to provide - content that works with the type of functionality provided by the user agent. If the - user agent doesn't provide zoom functionality but does let the the user change the +

If the author is using a technology whose user agents do not provide support for specific text scaling mechanisms, + the author is responsible for providing this type of functionality directly, or to provide + content that works with the type of functionality provided by the user agent. For instance, if the + user agent doesn't provide full-page zoom functionality, but does let the the user change the text size, the author is responsible for ensuring that the content remains usable when the text is resized.

@@ -58,7 +62,7 @@

Intent of Resize text

can be accessed, is provided to the user in some way besides the fact that it is truncated.

-

Content satisfies the Success Criterion if it can be scaled up to 200%, that is, up +

Content satisfies the Success Criterion if it can be scaled up to 200% - that is, up to twice the width and height. Authors may support scaling beyond that limit, however, as scaling becomes more extreme, adaptive layouts may introduce usability problems. For example, words may be too wide to fit into the horizontal space available to them, @@ -73,7 +77,7 @@

Intent of Resize text

a minimum magnification of 200%. Above 200%, zoom (which resizes text, images, and layout regions and creates a larger canvas that may require both horizontal and vertical scrolling) may be more effective than text resizing. Assistive technology dedicated - to zoom support would usually be used in such a situation and may provide better accessibility + to zoom support would usually be used in such a situation, and may provide better accessibility than attempts by the author to support the user directly.

@@ -131,7 +135,7 @@

Examples of Resize text

  • - A user uses a zoom function in his user agent to change the scale of the content. + A user uses a full-page zoom function in his user agent to change the scale of the content. All the content scales uniformly, and the user agent provides scroll bars, if necessary.
    • From 0c4e299a5ffb55a77e49bb2f8e140f7cddbc2427 Mon Sep 17 00:00:00 2001 From: "Patrick H. Lauke" Date: Tue, 22 Mar 2022 11:49:14 +0000 Subject: [PATCH 2/9] Add rewording suggestion (modified) from Bruce removes the inscrutable bit about "ASCII", and mentions the exception (which was otherwise missing from the understanding) --- understanding/20/resize-text.html | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/understanding/20/resize-text.html b/understanding/20/resize-text.html index d2a546381c..00a2aee398 100644 --- a/understanding/20/resize-text.html +++ b/understanding/20/resize-text.html @@ -14,11 +14,10 @@

    Intent of Resize text

    The intent of this Success Criterion is to ensure that visually rendered text, including - text-based controls (text characters that have been displayed so that they can be - seen, rather than text characters that are still in data form such as ASCII) can be scaled - successfully so that it can be read directly by people with mild visual disabilities, - without requiring the use of assistive technology such as a screen magnifier. Users - may benefit from scaling all content on the Web page, but text is most critical. + controls and labels using text, can be made larger so that it can be read more easily by + people with milder visual impairments, without requiring the use of assistive technology + (such as a screen magnifier). Users may benefit from scaling all content on the Web page, + but text is most critical.

    The scaling of content is primarily a user agent responsibility. User agents that From 482e2cdca2067dbd4fabae74152c4396aafb1e22 Mon Sep 17 00:00:00 2001 From: "Patrick H. Lauke" Date: Tue, 22 Mar 2022 14:18:38 +0000 Subject: [PATCH 3/9] Harmonise wording in 1.4.8 --- understanding/20/visual-presentation.html | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/understanding/20/visual-presentation.html b/understanding/20/visual-presentation.html index 2f59b5bb08..58aa4b5891 100644 --- a/understanding/20/visual-presentation.html +++ b/understanding/20/visual-presentation.html @@ -59,13 +59,12 @@

    Intent of Visual Presentation

    together, so that it is difficult for them to locate word boundaries.

    -

    The resizing provision ensures that visually rendered text (text characters that have - been displayed so that they can be seen [vs. text characters that are still in data - form such as ASCII]) can be scaled successfully without requiring that the user - scroll left and right to see all of the content. When the content has been authored - so that this is possible, the content is said to reflow. This permits people with - low vision and people with cognitive disabilities to increase the size of the text - without becoming disoriented. +

    The resizing provision ensures that visually rendered text, including + controls and labels using text, can be made larger without requiring the user to then + scroll left and right to see all of the content. When the content has been authored + so that this is possible, the content is said to reflow. This permits people with + low vision and people with cognitive disabilities to increase the size of the text + without becoming disoriented.

    The scaling of content is primarily a user agent responsibility. User agents that From 8ec5c36fa4da3d0d9f5ef0ba9aee1bed38146646 Mon Sep 17 00:00:00 2001 From: "Patrick H. Lauke" Date: Wed, 6 Jul 2022 12:34:28 +0100 Subject: [PATCH 4/9] Change `his` to `their` --- understanding/20/resize-text.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/understanding/20/resize-text.html b/understanding/20/resize-text.html index 00a2aee398..63de079469 100644 --- a/understanding/20/resize-text.html +++ b/understanding/20/resize-text.html @@ -134,7 +134,7 @@

    Examples of Resize text

  • - A user uses a full-page zoom function in his user agent to change the scale of the content. + A user uses a full-page zoom function in their user agent to change the scale of the content. All the content scales uniformly, and the user agent provides scroll bars, if necessary.
    • From 6466f727ddb1c697ff61238a472449bd4198f0ad Mon Sep 17 00:00:00 2001 From: "Patrick H. Lauke" Date: Wed, 5 Jul 2023 19:41:03 +0100 Subject: [PATCH 5/9] Reword to avoid "user uses ... user agent", whitespace/line break cleanup --- understanding/20/resize-text.html | 132 ++-------------------- understanding/20/visual-presentation.html | 122 ++------------------ 2 files changed, 16 insertions(+), 238 deletions(-) diff --git a/understanding/20/resize-text.html b/understanding/20/resize-text.html index 8accd71fec..01cc5b5657 100644 --- a/understanding/20/resize-text.html +++ b/understanding/20/resize-text.html @@ -8,11 +8,9 @@

    Understanding Resize text

    -

    Intent of Resize text

    - - +

    The intent of this Success Criterion is to ensure that visually rendered text, including controls and labels using text, can be made larger so that it can be read more easily by people with milder visual impairments, without requiring the use of assistive technology @@ -86,7 +84,6 @@

    Intent of Resize text

    we suggest using text wherever possible. It is also harder to change foreground and background contrast and color combinations for images of text, which are necessary for some users. -

    @@ -95,254 +92,141 @@

    Intent of Resize text

    1.4.3: Visual Presentation.

    -

    Benefits of Resize text

    - -
      -
    • This Success Criterion helps people with low vision by letting them increase text size in content so that they can read it. -
      • -
    -

    Examples of Resize text

    - -
      -
    • A user with vision impairments increases the text size on a Web page in a browser from 1 em to 1.2 ems. While the user could not read the text at the smaller size, she can read the larger text. All the information on the page is still displayed when the larger font is used for the text. -
      • -
    • A Web page contains a control for changing the scale of the page. Selecting different settings changes the layout of the page to use the best design for that scale. -
      • -
    • - A user uses a full-page zoom function in their user agent to change the scale of the content. - All the content scales uniformly, and the user agent provides scroll bars, if necessary. - + A user changes the scale of the content with the browser's full-page zoom function. + All the content scales uniformly, and the browser provides scroll bars, if necessary.
      • -
    -

    Resources for Resize text

    - - -

    Techniques for Resize text

    - - +

    Sufficient Techniques for Resize text

    - -
      -
    1. - Using a technology that has commonly-available user agents that support zoom -
      2. -
    2. -

      Ensuring that text containers resize when the text resizes AND using measurements that are relative to other measurements in the content by using one or more of the following techniques:

      - -
      3. -
    3. - Providing controls on the Web page that incrementally change the size of the text - -
      4. -
    4. - - Ensuring that there is no loss of content or functionality when the text resizes and - text containers do not resize - - + Ensuring that there is no loss of content or functionality when the text resizes and text containers do not resize
      5. -
    -

    Additional Techniques (Advisory) for Resize text

    - - -

    Failures for Resize text

    - - -
    diff --git a/understanding/20/visual-presentation.html b/understanding/20/visual-presentation.html index 1effcadc60..7e7f3adf73 100644 --- a/understanding/20/visual-presentation.html +++ b/understanding/20/visual-presentation.html @@ -8,11 +8,9 @@

    Understanding Visual Presentation

    -

    Intent of Visual Presentation

    -

    The intent of this Success Criterion is to ensure that visually rendered text is presented in such a manner that it can be perceived without its layout interfering with its readability. People with some cognitive, language and learning disabilities @@ -100,12 +98,11 @@

    Intent of Visual Presentation

    -
    +

    Benefits of Visual Presentation

    - - +

    This Success Criterion helps low vision users by letting them see text without distracting presentational features. It lets them configure text in ways that will be easier for them to see by letting them control the color and size of blocks of text. @@ -116,347 +113,244 @@

    Benefits of Visual Presentation

      -
    • People with some cognitive disabilities can read text better when they select their own foreground and background color combinations.
      • -
    • People with some cognitive disabilities can track their locations more easily when blocks of text are narrow and when they can configure the amount of space between lines and paragraphs.
      • -
    • People with some cognitive disabilities can read text more easily when the spacing between words is regular.
      • -
    -

    Examples of Visual Presentation

    -
    The following images show examples of single-spacing, space-and-a-half and double-spaced text in a paragraph.
    - Example of single-spaced text. (no space between each line of text) - Example of space-and-a-half text. (a space equal to half the height of a line of text line) - Example of double-spaced text. (a space equal to the height of a line of text between each line) +
    The following images show examples of single-spacing, space-and-a-half and double-spaced text in a paragraph.
    + Example of single-spaced text. (no space between each line of text) + Example of space-and-a-half text. (a space equal to half the height of a line of text line) + Example of double-spaced text. (a space equal to the height of a line of text between each line)

    Examples of glyphs include "A", "→" (an arrow symbol), and "さ" (a Japanese character).

    -

    Resources for Visual Presentation

    - - -

    Techniques for Visual Presentation

    - -

    Sufficient Techniques for Visual Presentation

    - -

    - Instructions: Since this is a multi-part success criterion, you must satisfy one of the numbered items for each of the requirements below.

    - -
      -
    1. Specifying text and background colors of secondary content such as banners, features and navigation in CSS while not specifying text and background colors of the main content OR
      2. -
    2. Specifying borders and layout in CSS to delineate areas of a Web page while not specifying text and text-background colors OR
      3. -
    3. Using a technology that has commonly-available user agents that can change the foreground and background of blocks of text OR
      4. -
    4. G148 OR
      5. -
    5. Providing a multi color selection tool on the page for foreground and background colors
      6. -
    -
    - -
      -
    1. Not interfering with the user agent's reflow of text as the viewing window is narrowed OR
      2. -
    2. Using ems to set the column width
      3. -
    -
    - -
      -
    1. Specifying alignment either to the left OR right in CSS OR
      2. -
    2. Providing a mechanism to remove full justification of text OR
      3. -
    3. Aligning text on only one side
      4. -
    -
    - -
      -
    1. - Providing a button on the page to increase line spaces and paragraph spaces OR
      2. -
    2. C21: Specifying line spacing in CSS
      3. -
    -
    - -
      -
    1. - Not interfering with the user agent's reflow of text as the viewing window is narrowed OR
      2. -
    2. -

      - G146: Using liquid layout AND using measurements that are relative to other measurements in the content by using one or more of the following techniques:

      -
      3. -
    3. - Providing options within the content to switch to a layout that does not require the - user to scroll horizontally to read a line of text + Providing options within the content to switch to a layout that does not require the user to scroll horizontally to read a line of text
      4. -
    -
    -

    Additional Techniques (Advisory) for Visual Presentation

    - -

    Failures for Visual Presentation

    - - -
    From f3945df2d006fa73ac26b115a47ea355e4f8a236 Mon Sep 17 00:00:00 2001 From: Mike Gower Date: Fri, 19 Jul 2024 08:22:29 -0700 Subject: [PATCH 6/9] Update understanding/20/resize-text.html --- understanding/20/resize-text.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/understanding/20/resize-text.html b/understanding/20/resize-text.html index 4286504046..ddd4131022 100644 --- a/understanding/20/resize-text.html +++ b/understanding/20/resize-text.html @@ -32,7 +32,7 @@

    Intent of Resize Text

    satisfy UAAG 1.0 Checkpoint 4.1 allow users to configure text scale through a number of mechanisms - including zoom (of the entire page's content), - magnification, text-only resizing, and allowing the user to configure a reference size for rendered text. + magnification, text-only resizing, and allowing the user to configure a size for rendered text. The author's responsibility is to create Web content that does not prevent the user agent from scaling the content effectively. Authors may satisfy this Success Criterion by verifying that content does not interfere with user agent support for resizing text, including text-based controls, or by providing From d5ef40b78bd12b3812c45cd8c17caee5c8e661d2 Mon Sep 17 00:00:00 2001 From: Mike Gower Date: Fri, 19 Jul 2024 08:25:21 -0700 Subject: [PATCH 7/9] Update understanding/20/resize-text.html --- understanding/20/resize-text.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/understanding/20/resize-text.html b/understanding/20/resize-text.html index ddd4131022..ad51b1169a 100644 --- a/understanding/20/resize-text.html +++ b/understanding/20/resize-text.html @@ -48,7 +48,7 @@

    Intent of Resize Text

    If the author is using a technology whose user agents do not provide support for specific text scaling mechanisms, - the author is responsible for providing this type of functionality directly, or to provide + the author is responsible for providing this type of functionality directly, or providing content that works with the type of functionality provided by the user agent. For instance, if the user agent doesn't provide full-page zoom functionality, but does let the the user change the From 1655d8c558c21b2903085b58a4c81ba147008249 Mon Sep 17 00:00:00 2001 From: Mike Gower Date: Fri, 19 Jul 2024 08:25:42 -0700 Subject: [PATCH 8/9] Update understanding/20/resize-text.html Co-authored-by: Alastair Campbell --- understanding/20/resize-text.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/understanding/20/resize-text.html b/understanding/20/resize-text.html index ad51b1169a..abf2940c72 100644 --- a/understanding/20/resize-text.html +++ b/understanding/20/resize-text.html @@ -44,7 +44,7 @@

    Intent of Resize Text

    mechanism supported by user agents.

    The author cannot rely on the user agent to satisfy this Success Criterion for HTML - through a specific text scaling mechanism if users do not have access to a user agent with that particular mechanism. + through a specific text scaling mechanism if people do not have access to a user agent with that particular mechanism.

    If the author is using a technology whose user agents do not provide support for specific text scaling mechanisms, From 8f214b9623f1f05b319f8fed8ec824728d089313 Mon Sep 17 00:00:00 2001 From: Mike Gower Date: Fri, 19 Jul 2024 08:30:40 -0700 Subject: [PATCH 9/9] Update understanding/20/resize-text.html --- understanding/20/resize-text.html | 3 --- 1 file changed, 3 deletions(-) diff --git a/understanding/20/resize-text.html b/understanding/20/resize-text.html index abf2940c72..2fc1cadaf2 100644 --- a/understanding/20/resize-text.html +++ b/understanding/20/resize-text.html @@ -43,9 +43,6 @@

    Intent of Resize Text

    Content satisfies the Success Criterion if it can be scaled up to 200% using at least one text scaling mechanism supported by user agents.

    -

    The author cannot rely on the user agent to satisfy this Success Criterion for HTML - through a specific text scaling mechanism if people do not have access to a user agent with that particular mechanism. -

    If the author is using a technology whose user agents do not provide support for specific text scaling mechanisms, the author is responsible for providing this type of functionality directly, or providing