From 28878f903d443cb1ad2f9669c59cf41b7ebb2e47 Mon Sep 17 00:00:00 2001 From: Momdo Nakamura Date: Wed, 28 Aug 2024 01:11:24 +0900 Subject: [PATCH] Clean up mentions of HTML4 and XHTML (#3980) A lot of HTML4 and XHTML descriptions were removed by #2490, but there are still some parts left. This PR attempts to clean up those pieces. ## Modify link from HTML4 to HTML F40 and F44 ## Remove mentions of XHTML in techniques ARIA6, SCR22, C27, F46, F58, F69, F70, F77, F80, G108, G110, G175 and G204 ## Remove mentions of XHTML in understanding - keyboard - pronunciation (potentially related https://github.com/w3c/wcag/issues/2652) --- However, the following pages are excluded: [Understanding SC 3.1.1](https://www.w3.org/WAI/WCAG22/Understanding/language-of-page): ```html Internationalization Best Practices: Specifying Language in XHTML & HTML Content ``` This link text is probably inappropriate, but I didn't know what to change it to, so I left it as it is. [Understanding Conformance](https://www.w3.org/WAI/WCAG22/Understanding/conformance): In the Examples of Conformance Claims section, there are several mentions of XHTML 1.0. I didn't change them in this PR, but I think it needs to be rewritten separately. --------- Co-authored-by: Patrick H. Lauke --- techniques/css/C27.html | 2 +- techniques/failures/F40.html | 4 ++-- techniques/failures/F44.html | 5 +++-- techniques/failures/F46.html | 2 +- techniques/failures/F58.html | 3 +-- techniques/failures/F69.html | 2 +- techniques/failures/F70.html | 2 +- techniques/failures/F77.html | 2 +- techniques/failures/F80.html | 2 +- techniques/general/G108.html | 2 +- techniques/general/G110.html | 2 +- techniques/general/G175.html | 2 +- techniques/general/G204.html | 2 +- understanding/20/keyboard.html | 2 +- understanding/20/pronunciation.html | 4 ++-- 15 files changed, 19 insertions(+), 19 deletions(-) diff --git a/techniques/css/C27.html b/techniques/css/C27.html index ae4e4ef2b1..a3f1360977 100644 --- a/techniques/css/C27.html +++ b/techniques/css/C27.html @@ -21,7 +21,7 @@

Description

There may also be situations where the visually presented order is necessary to the overall understanding of the page, and if the source order is presented differently, it may be much more difficult to understand.

When the source order matches the visual order, everyone will read the content and interact with it in the same (correct) order.

-

The tabindex attribute in HTML has two functions. One is to make an element focusable and the other is to assign the element a position in the focus order. A tabindex of 0 makes an element focusable, but adds it to the focus order in the order of source elements. The focus order will follow positive values of tabindex in ascending order. Setting tabindex values that result in an order different from the order of elements in the Document Object Model (DOM) can mean the order is incorrect for users of assistive technologies. This is largely because the tabindex property is specified in the HTML or XHTML and not the CSS. This may change in future specifications. It may also differ from the visual presentation order.

+

The tabindex attribute in HTML has two functions. One is to make an element focusable and the other is to assign the element a position in the focus order. A tabindex of 0 makes an element focusable, but adds it to the focus order in the order of source elements. The focus order will follow positive values of tabindex in ascending order. Setting tabindex values that result in an order different from the order of elements in the Document Object Model (DOM) can mean the order is incorrect for users of assistive technologies. This is largely because the tabindex property is specified in the HTML and not the CSS. This may change in future specifications. It may also differ from the visual presentation order.

diff --git a/techniques/failures/F40.html b/techniques/failures/F40.html index 9a37db85e6..c73100bb25 100644 --- a/techniques/failures/F40.html +++ b/techniques/failures/F40.html @@ -56,8 +56,8 @@
diff --git a/techniques/failures/F44.html b/techniques/failures/F44.html index 50804d0779..10f4fa21bd 100644 --- a/techniques/failures/F44.html +++ b/techniques/failures/F44.html @@ -62,8 +62,9 @@

Resources

\ No newline at end of file diff --git a/techniques/failures/F46.html b/techniques/failures/F46.html index 614c4a14ab..84515bf18b 100644 --- a/techniques/failures/F46.html +++ b/techniques/failures/F46.html @@ -18,7 +18,7 @@ scope attributes -

Assistive technologies use the structure of an HTML or XHTML table to present data to +

Assistive technologies use the structure of an HTML table to present data to the user in a logical manner. The th element is used to mark the column and row headers of the table. A screen reader uses the information in th elements to speak the header information that diff --git a/techniques/failures/F58.html b/techniques/failures/F58.html index 090a84500d..4a80faa6d1 100644 --- a/techniques/failures/F58.html +++ b/techniques/failures/F58.html @@ -30,8 +30,7 @@ response.setContentType("text/html"); PrintWriter out = response.getWriter(); response.setHeader("Refresh", "10; URL=TargetPage.html"); -out.println("<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" - \"https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">"); +out.println("<!DOCTYPE html>"); out.println("<html><head><title>Redirect</title></head><body>"); out.println("<p>This page will redirect you in 10 seconds.</p>"); out.println("</body></html>"); diff --git a/techniques/failures/F69.html b/techniques/failures/F69.html index 1d34576250..fda9f3e2fc 100644 --- a/techniques/failures/F69.html +++ b/techniques/failures/F69.html @@ -1,5 +1,5 @@ Failure of Success Criterion 1.4.4 when resizing visually rendered text up to 200 percent causes the text, image or controls to be clipped, truncated or obscured

Failure of Success Criterion 1.4.4 when resizing visually rendered text up to 200 percent causes the text, image or controls to be clipped, truncated or obscured

ID: F69

Technology: failures

Type: Failure

When to Use

-

HTML, XHTML and CSS

+

HTML and CSS

Description

The objective of this failure condition is to describe a problem that occurs when changing the size of text causes text to be clipped, truncated, or obscured, so that it is no longer available to the user. In general, this failure occurs when there is no way for a user agent's layout engine to honor all the layout hints in the HTML at the new font size. Some of the ways in which this can occur include:

    diff --git a/techniques/failures/F70.html b/techniques/failures/F70.html index 417c383ba2..0b2d9cd0a9 100644 --- a/techniques/failures/F70.html +++ b/techniques/failures/F70.html @@ -4,7 +4,7 @@ obsoleteSince: 22 --- Failure of Success Criterion 4.1.1 due to incorrect use of start and end tags or attribute markup

    Failure of Success Criterion 4.1.1 due to incorrect use of start and end tags or attribute markup

    ID: F70

    Technology: failures

    Type: Failure

    When to Use

    -

    Markup languages: HTML, XHTML, and other SGML or XML-based technologies.

    +

    Markup languages: HTML, and other SGML or XML-based technologies.

    Description

    The objective of this failure is to identify examples of markup errors in element tags that could cause assistive technology to be unable to generate a satisfactory model of the page. Different user agents may implement different heuristics to recover from errors, resulting in inconsistent presentations of the page between user agents.

    Some common types of problems with start and end tags that lead to this failure condition (though this is not an exhaustive list):

    diff --git a/techniques/failures/F77.html b/techniques/failures/F77.html index 83f2666c80..7d69288edc 100644 --- a/techniques/failures/F77.html +++ b/techniques/failures/F77.html @@ -4,7 +4,7 @@ obsoleteSince: 22 --- Failure of Success Criterion 4.1.1 due to duplicate values of type ID

    Failure of Success Criterion 4.1.1 due to duplicate values of type ID

    ID: F77

    Technology: failures

    Type: Failure

    When to Use

    -

    HTML, and any XML-based markup languages including XHTML and SVG

    +

    HTML, and any XML-based markup languages including SVG

    Description

    This describes a failure condition where duplicate id errors are known to cause problems for assistive technologies when they are trying to interact with content. Duplicate values of type id can be problematic for user agents that rely on this attribute to accurately convey relationships between different parts of content to users. For example, a screen reader may use id values to identify the applicable header content for a data cell within a data table, or an input control to which a given label applies. If these values are not unique, the screen reader will be unable to programmatically determine which headers are associated with the data cell or which control is associated with which label or name.

    Checking that id attribute values are unique within a document can be done by validating the document against its specification, because the specification defines which attributes contain document-wide unique identifiers.

    diff --git a/techniques/failures/F80.html b/techniques/failures/F80.html index 27f90b4053..9758dedfa3 100644 --- a/techniques/failures/F80.html +++ b/techniques/failures/F80.html @@ -1,5 +1,5 @@ Failure of Success Criterion 1.4.4 when text-based form controls do not resize when visually rendered text is resized up to 200%

    Failure of Success Criterion 1.4.4 when text-based form controls do not resize when visually rendered text is resized up to 200%

    ID: F80

    Technology: failures

    Type: Failure

    When to Use

    -

    HTML, XHTML, and CSS

    +

    HTML and CSS

    Description

    The objective of this failure condition is to describe a problem that occurs when changing the size of text does not cause the text-based form controls to resize accordingly. This means that the user may have difficulty entering text and being able to read what they have entered because the text is not displayed at the text size required by the user.

    Text-based form controls include input boxes (text and textarea) as well as buttons.

    diff --git a/techniques/general/G108.html b/techniques/general/G108.html index 200172ac51..11a3cd56d8 100644 --- a/techniques/general/G108.html +++ b/techniques/general/G108.html @@ -20,7 +20,7 @@

    Examples

    -

    Example 1: A Web page written in HTML or XHTML uses standard form +

    Example 1: A Web page written in HTML uses standard form controls, and identifies the form control using the title attribute. The user agent makes information about these controls, including the name, available to assistive technology through the DOM and through diff --git a/techniques/general/G110.html b/techniques/general/G110.html index 767fa1a863..3ebb2e953e 100644 --- a/techniques/general/G110.html +++ b/techniques/general/G110.html @@ -19,7 +19,7 @@

    HTML: Refresh With a URI and No Timeout

    -

    In HTML 4.x and XHTML 1.x, it is possible to implement a client-side +

    In HTML, it is possible to implement a client-side redirect using the meta diff --git a/techniques/general/G175.html b/techniques/general/G175.html index c176693090..9dc5716048 100644 --- a/techniques/general/G175.html +++ b/techniques/general/G175.html @@ -17,7 +17,7 @@

    Screenshot showing the color selection tool with the color picker opened to select a color for the foreground. The user is presented with a choice of 216 colors.
    -

    Here is a working example of this technique implemented using PHP, Javascript, CSS and XHTML: +

    Here is a working example of this technique implemented using PHP, Javascript, CSS and HTML: Color Picker Example.

    diff --git a/techniques/general/G204.html b/techniques/general/G204.html index a5e7e127c5..67998514dc 100644 --- a/techniques/general/G204.html +++ b/techniques/general/G204.html @@ -2,7 +2,7 @@

    All technologies

    Description

    This technique helps avoid situations where horizontal scrolling may occur. Many people with cognitive disabilities and low vision users who do not use assistive technology have a great deal of trouble with blocks of text that require horizontal scrolling. It involves not interfering with the reflow of text if the window is narrowed. One of the best ways to do this is to define widths of text block containers in percentages.

    -

    HTML and XHTML user agents automatically reflow text as the browser window is narrowed as long as the author does not specify widths using absolute measurements such as pixels or points.

    +

    HTML user agents automatically reflow text as the browser window is narrowed as long as the author does not specify widths using absolute measurements such as pixels or points.

    Examples

    diff --git a/understanding/20/keyboard.html b/understanding/20/keyboard.html index 0e82e59d14..c779848171 100644 --- a/understanding/20/keyboard.html +++ b/understanding/20/keyboard.html @@ -245,7 +245,7 @@

    Additional Techniques (Advisory) for Keyboard

      -
    • Using XHTML role, state, and value attributes if repurposing static elements as interactive +
    • Using WAi-ARIA role, state, and value attributes if repurposing static elements as interactive user interface components (future link) AND Adding keyboard-accessible actions to static HTML elements diff --git a/understanding/20/pronunciation.html b/understanding/20/pronunciation.html index 870fc52470..7f671e03ac 100644 --- a/understanding/20/pronunciation.html +++ b/understanding/20/pronunciation.html @@ -82,7 +82,7 @@

      Examples of Pronunciation

      twice: the Han characters (Kanji) that can be pronounced in a wrong way are read first and then kana is spoken in order to provide the correct reading.
      Showing the reading of the words by ruby element
      -
      Web content using XHTML 1.1 provides kana (phonetic syllabary characters) written +
      Web content using HTML provides kana (phonetic syllabary characters) written above the characters to show the reading (pronunciation) of the words by using the ruby element.
      Providing sound files of the pronunciation
      @@ -154,7 +154,7 @@

      Sufficient Techniques for Pronunciation

    • - Using the ruby element (XHTML 1.1) + Using the ruby element