Skip to content

Commit

Permalink
Merge pull request #239 from w3c/maryjom-change-parsing-sc
Browse files Browse the repository at this point in the history
Handle WCAG changes to 4.1.1 Parsing
  • Loading branch information
maryjom authored Nov 3, 2023
2 parents ab89898 + 6dbd500 commit f5bf189
Show file tree
Hide file tree
Showing 3 changed files with 3 additions and 21 deletions.
21 changes: 1 addition & 20 deletions comments-by-guideline-and-success-criterion.md
Original file line number Diff line number Diff line change
Expand Up @@ -929,28 +929,9 @@ Guideline 4.1 Compatible: Maximize compatibility with current and future <INS>**

###### Applying SC 4.1.1 Parsing to Non-Web Documents and Software

<p class="ednote">This section is to be updated by the WCAG2ICT Task Force since 4.1.1 Parsing is being made obsolete and removed from WCAG 2.2. This work is planned for the next public working draft of the document.</p>

This applies directly as written, and as described in [Intent from Understanding Success Criterion 4.1.1](https://www.w3.org/WAI/WCAG22/Understanding/parsing#intent) (also provided below), replacing “In content implemented using markup languages” with “For non-web documents or software that use markup languages, in such a way that the markup is separately exposed and available to assistive technologies and accessibility features of software or to a user-selectable user agent”.

With these substitutions, it would read:

**4.1.1 Parsing:** <INS>**[For [non-web documents](#document) or [software](#software) that use markup languages, in such a way that the markup is separately exposed and available to [assistive technologies](#dfn-assistive-technology) and accessibility features of software or to a user-selectable [user agent](#user-agent)]**</INS>, elements have complete start and end tags, elements are nested according to their specifications, elements do not contain duplicate attributes, and any IDs are unique, except where the specifications allow these features. (Level A)

<div class="note">

Start and end tags that are missing a critical character in their formation, such as a closing angle bracket or a mismatched attribute value quotation mark are not complete.</div>
<div class="note">

Markup is not always available to [assistive technologies](#dfn-assistive-technology) or to user selectable [user agents](#user-agent) such as browsers. Software sometimes uses markup languages internally for persistence of the software user interface, in ways where the markup is never available to assistive technology (either directly or through a document object model (DOM)), or to a user agent (such as a browser). In such cases, conformance to this provision would have no impact on accessibility as it can have for web content where it is exposed.</div>

Examples of markup that is separately exposed and available to [assistive technologies](#dfn-assistive-technology) and to [user agents](#user-agent) include: documents encoded in HTML, ODF, and OOXML. In these examples, the markup can be parsed entirely in two ways: (a) by assistive technologies which may directly open the document, (b) by assistive technologies using DOM APIs of user agents for these document formats.

Examples of markup used internally for persistence of the software user interface that are never exposed to [assistive technology](#dfn-assistive-technology) include but are not limited to: XUL, GladeXML, and FXML. In these examples assistive technology only interacts with the user interface of generated software.

<div class="note">

See also the discussion on [Closed Functionality](#closed-functionality).</div>
WCAG 2.2 has made this success criterion obsolete and removed it as a requirement in the standard. Therefore, the interpretation of this success criterion for [non-web documents](#document) and [software](#software) has been removed.</div>

##### name-role-value

Expand Down
2 changes: 2 additions & 0 deletions introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,8 @@ The following changes and additions have been made to update the 2013 WCAG2ICT d
* New WCAG 2.2 Success Criteria
* [Success Criterion 2.5.8 Target Size (Minimum)](#target-size-minimum)
* [Success Criterion 3.3.7 Redundant Entry](#redundant-entry)
* Obsolete and Removed WCAG 2.2 Success Criteria
* [Success Criterion 4.1.1 Parsing](#parsing)
* New terms
* pointer input, process, single pointer, state, status message were added to [Glossary Items that Apply to All Technologies](#glossary-items-that-apply-to-all-technologies)
* motion animation, region, and user inactivity were added to [Glossary Items Used only in AAA Success Criteria](#glossary-items-used-only-in-aaa-success-criteria)
Expand Down
1 change: 0 additions & 1 deletion success-criteria-problematic-for-closed-functionality.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,6 @@ There are Success Criteria that can be problematic for developers of closed func
<li><a href="#language-of-page">3.1.1 Language of Page</a>—requires information in a programmatically determinable form;</li>
<li><a href="#language-of-parts">3.1.2 Language of Parts</a>—requires information in a programmatically determinable form;</li>
<li><a href="#error-identification">3.3.1 Error Identification</a>—while it's important for errors that can be detected to be described to the user, for closed functionality, the error description doesn't have to be provided in text, as defined in WCAG 2.2;</li>
<li><a href="#parsing">4.1.1 Parsing</a>—the <a href="https://www.w3.org/WAI/WCAG22/Understanding/parsing.html#intent">Intent of 4.1.1</a> is to provide consistency so that different user agents or assistive technologies will yield the same result;</li>
<li><a href="#name-role-value">4.1.2 Name, Role, Value</a>—requires information in a programmatically determinable form.</li>
<li><a href="#status-messages">4.1.3 Status Messages</a>—requires information in a programmatic determinable form. Additionally, software with closed functionality is not typically implemented using markup languages.
<div class="note">Non-web software with closed functionality would need equivalent facilitation to provide access to status messages.</div></li>
Expand Down

0 comments on commit f5bf189

Please sign in to comment.