Technique H93:Ensuring that id
attributes are unique on a Web page
About this Technique
This technique relates to 4.1.1: Parsing (Sufficient, together with H74: Ensuring that opening and closing tags are used according to specification and H94: Ensuring that elements do not contain duplicate attributes when used for ensuring that Web pages can be parsed).
This technique applies to all HTML pages.
Description
The objective of this technique is to avoid errors that result from the same id
attribute being used multiple times on the same page. These errors can be avoided by making sure the page doesn't have duplicate id
values. This can be done manually or by using HTML's mechanism to specify the technology and technology version, and validating the document for this condition. There are several validators that the developer can use; validation reports generally mention this type of error. The document type declaration is not strictly necessary for this type of evaluation, but specifying the document type declaration makes it easier to use a validator.
Examples
Example 1: Duplicate id attributes in form elements
In this example, the first name and last name inputs both have an id
attribute with the same value. Due to the way accessible names are computed, this results in the last name input having no accessible name.
<label for="fname">First Name</label>
<input autocomplete="given-name" id="fname" type="text">
<label for="lname">Last Name</label>
<input autocomplete="family-name" id="fname" type="text">
Example 2: HTML Validators
HTML pages include a document type declaration (sometimes referred to as !DOCTYPE statement). The developer can use offline or online validators (see Resources below) to check that id
attribute values are only used once on a page. The W3C validator, for example, will report "Duplicate ID" when it encounters the subsequent uses of an id
value.
Related Resources
No endorsement implied.
-
HTML -
id
attribute - Nu HTML Checker
- Do not forget to add a doctype by the W3C Quality Assurance Initiative explains what doctypes are and why you should use them
For other resources, see G134: Validating Web pages.
Tests
Procedure
- Check that all
id
attribute values are unique on the page.
Expected Results
- Check #1 is true.
Test Rules
The following are Test Rules related to this Technique. It is not necessary to use these particular Test Rules to check for conformance with WCAG, but they are defined and approved test methods. For information on using Test Rules, see Understanding Test Rules for WCAG Success Criteria.