Skip to content

Commit

Permalink
Merge pull request #1804 from w3c/patrickhlauke-understanding-errors2
Browse files Browse the repository at this point in the history 
Update/correct 3.3.3 understanding
  • Loading branch information
@alastc
alastc committed Jun 1, 2023
2 parents 1d77219 + be25a2e commit d9a5fc2
Showing 1 changed file with 31 additions and 83 deletions.
114 changes: 31 additions & 83 deletions understanding/20/error-suggestion.html
View file
Expand Up @@ -14,8 +14,8 @@ <h2>Intent of Error Suggestion</h2>


<p>The intent of this Success Criterion is to ensure that users receive appropriate suggestions
for correction of an input error if it is possible. The WCAG 2.0 definition of "input
error" says that it is "information provided by the user that is not accepted" by
for correction of an input error if it is possible. The definition of "input error"
says that it is "information provided by the user that is not accepted" by
the system. Some examples of information that is not accepted include information
that is required but omitted by the user and information that is provided by the user
but that falls outside the required data format or allowed values.
Expand All @@ -42,14 +42,12 @@ <h2>Benefits of Error Suggestion</h2>


<ul>

<li>Providing information about how to correct input errors allows users who have learning
disabilities to fill in a form successfully. Users who are blind or have impaired
vision understand more easily the nature of the input error and how to correct it.
People with motion impairment can reduce the number of times they need to change an
input value.
</li>

disabilities to fill in a form successfully.</li>
<li>Users who are blind or have impaired vision understand more easily the nature of the
input error and how to correct it.</li>
<li>People with motion impairment can reduce the number of times they need to change an
input value.</li>
</ul>

</section>
Expand Down Expand Up @@ -95,8 +93,6 @@ <h2>Examples of Error Suggestion</h2>
May, June, July, August, September, October, November, December."
</li>

<li>A description of the set of values, e.g., "Please provide the name of the month."</li>

<li>The conversion of the input data interpreted as a different month format, e.g., "Do
you mean 'December'?"
</li>
Expand Down Expand Up @@ -132,40 +128,10 @@ <h2>Techniques for Error Suggestion</h2>

<section id="sufficient">
<h3>Sufficient Techniques for Error Suggestion</h3>


<section class="situation" id="error-suggestion-situation-0">

<h4>Situation A: If a mandatory field contains no information:</h4>

<ol>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/general/G83" class="general">Providing a text description that identifies the field as mandatory</a>

</li>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/aria/ARIA2" class="aria">ARIA2: Identifying required fields with the "required" property</a>

</li>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/pdf/PDF5" class="pdf"></a>

</li>

</ol>


</section>


<section class="situation" id="error-suggestion-situation-1">

<h4>Situation B: If information for a field is required to be in a specific data format:</h4>
<h4>Situation A: If information for a field is required to be in a specific data format:</h4>

<ol>

Expand All @@ -176,31 +142,19 @@ <h4>Situation B: If information for a field is required to be in a specific data
</li>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/general/G85" class="general">Providing a text description when user input falls outside the required format or
values
</a>

</li>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/general/G177" class="general">Providing suggested correction text</a>

</li>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/client-side-script/SCR18" class="script">SCR18: Providing client-side validation and alert</a>

</li>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/client-side-script/SCR32" class="script">Providing client-side validation and adding error text via the DOM</a>

</li>


<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/pdf/PDF22" class="pdf"></a>
Expand All @@ -213,7 +167,7 @@ <h4>Situation B: If information for a field is required to be in a specific data

<section class="situation" id="error-suggestion-situation-2">

<h4>Situation C: Information provided by the user is required to be one of a limited set
<h4>Situation B: Information provided by the user is required to be one of a limited set
of values:
</h4>

Expand All @@ -226,29 +180,17 @@ <h4>Situation C: Information provided by the user is required to be one of a lim
</li>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/general/G84" class="general">Providing a text description when the user provides information that is not in list
of allowed values
</a>

</li>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/general/G177" class="general">Providing suggested correction text</a>

</li>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/client-side-script/SCR18" class="script">SCR18: Providing client-side validation and alert</a>

</li>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/client-side-script/SCR32" class="script">Providing client-side validation and adding error text via the DOM</a>


</li>

<li>
Expand All @@ -270,15 +212,15 @@ <h3>Additional Techniques (Advisory) for Error Suggestion</h3>
<ul>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/general/G139" class="general">G139: Creating a mechanism that allows users to jump to errors</a>

</li>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/general/G199" class="general">Providing success feedback when data is submitted successfully</a>

</li>

</ul>
Expand All @@ -290,11 +232,17 @@ <h4>Client-Side Scripting Techniques (Advisory)</h4>
<ul>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/client-side-script/SCR18" class="script">Providing client-side validation and alert</a>

</li>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/client-side-script/SCR32" class="script">Providing client-side validation and adding error text via the DOM</a>

</li>

</ul>

</section>
Expand Down

0 comments on commit d9a5fc2

Please sign in to comment.