From 1d8a008d472522cdbfeafa75adc0dfff1cd3fcac Mon Sep 17 00:00:00 2001 From: "Patrick H. Lauke" Date: Tue, 23 Feb 2021 01:00:52 +0000 Subject: [PATCH 01/22] Rewrite for 3.3.1 Error Identification understanding document * remove the misleading statement about screen reader users needing to know that an error occurred before hitting one of the indicators/fields. this implicitly suggests that the intent is for an error message/list to be shown to (screen reader) users before the actual form, which is not in fact the intention nor the requirement of this SC * tweak the benefit for users with cognitive/language/learinng disabilities * refocus on the benefit to ALL users, not just screen reader users * add allowance for situations where an error indication is already self-explanatory/obvious from context (e.g. a form where fields have already explicitly been identified as mandatory/required - not necessary for compliance to now ALSO explicitly say "as we already told you, this field is mandatory") --- understanding/20/error-identification.html | 44 ++++++++++++---------- 1 file changed, 25 insertions(+), 19 deletions(-) diff --git a/understanding/20/error-identification.html b/understanding/20/error-identification.html index 1882ea8ce0..09a00b7961 100644 --- a/understanding/20/error-identification.html +++ b/understanding/20/error-identification.html @@ -14,13 +14,14 @@

Intent of Error Identification

The intent of this Success Criterion is to ensure that users are aware that an error - has occurred and can determine what is wrong. The error message should be as specific - as possible. - In the case of an unsuccessful form submission, re-displaying the form and indicating - the fields in error is insufficient for some users to perceive that an error has occurred. - Screen reader users, for example, will not know there was an error until they encounter - one of the indicators. They may abandon the form altogether before encountering the - error indicator, thinking that the page simply is not functional. Per the definition in WCAG 2.0, an "input error" is information provided by the user + has occurred and can determine what is wrong. In the case of an unsuccessful form submission, + it is not sufficient to only re-display the form without providing any hint that the submission + failed. It also won't be sufficient to merely indicate that fields are in error, but not providing + users with sufficient information about the specific nature of the error. The error messages should + be as specific as possible. And, to ensure that the information is available to all users (whether + they are using assistive technologies or not), the error messages must be provided as visible text. +

+

Per the definition in WCAG 2.0, an "input error" is information provided by the user that is not accepted. This includes:

@@ -72,14 +73,22 @@

Intent of Error Identification

that user agents or assistive technologies can use to identify an error and provide error information to the user. For example, certain technologies can specify that the user's input must not fall outside a specific range, or that a form field is required. - Currently, few technologies support this kind of programmatic information, but the + Currently, few technologies support this kind of programmatic information, but this Success Criterion does not require, nor prevent it. -

It is perfectly acceptable to indicate the error in other ways such as image, color - etc, in addition to the text description. - + etc, in addition to the text description. +

+

There may also be situations in which it is clear from the context what the specific error + is - for instance, in a simple login form with a username and password field, if a user + leaves one of the fields completely blank, simply indicating that the empty field is in + error using an image or icon (with appropriate alternative text) would be sufficient. + However, if the user did enter data in both of those fields, and login was unsuccessful, further + information and an actual specific error message will be required (e.g. "no account found with this + username", or "the username or password are incorrect"). Likewise, in a form that explicitly indicates + that all fields are mandatory/required, it will be sufficient to indicate empty fields as being in error, + without the need to reiterate that the user must fill in the field.

See also @@ -94,16 +103,14 @@

Benefits of Error Identification

@@ -137,8 +144,7 @@

Examples of Error Identification

This Success Criterion does not mean that color or text styles cannot be used to indicate - errors. It simply requires that errors also be identified using text. In this example, - two asterisks are used in addition to color. + errors. It simply requires that errors also be identified using text.

From d6086efe6403110b46d0baa10941d09089b6f9ec Mon Sep 17 00:00:00 2001 From: "Patrick H. Lauke" Date: Tue, 23 Feb 2021 01:19:18 +0000 Subject: [PATCH 02/22] Remove unnecessary WCAG 2.0 reference, add note about scope of the SC - "Per the definition in WCAG 2.0" is unnecessary and outdated now anyway - added note to clarify that the SC does not mandate any specific way in which errors are shown (as a list, alert, dialog, or inline), but only that the error must be in text if not already obvious --- understanding/20/error-identification.html | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/understanding/20/error-identification.html b/understanding/20/error-identification.html index 09a00b7961..82ebfd9c5f 100644 --- a/understanding/20/error-identification.html +++ b/understanding/20/error-identification.html @@ -21,8 +21,7 @@

Intent of Error Identification

be as specific as possible. And, to ensure that the information is available to all users (whether they are using assistive technologies or not), the error messages must be provided as visible text.

-

Per the definition in WCAG 2.0, an "input error" is information provided by the user - that is not accepted. This includes: +

An "input error" is information provided by the user that is not accepted. This includes: