Language of Page:
Understanding SC 3.1.1
3.1.1 Language of Page: The default human language of each Web page [begin delete]within the content [end delete]can be programmatically determined. (Level A)
Intent of this Success Criterion
The intent of this success criterion is to ensure that content developers provide information in the Web page that user agents need to present text and other linguistic content correctly. Both assistive technologies and conventional user agents can render text more accurately when the language of the Web page is identified. Screen readers can load the correct pronunciation rules. Visual browsers can display characters and scripts correctly. Media players can show captions correctly. As a result, users with disabilities will be better able to understand the content.
The default human language of the Web page is the default text-processing language as discussed in Internationalization Best Practices: Specifying Language in XHTML & HTML Content. When a Web page uses several languages, the default text-processing language is the language which is used most. (If several languages are used equally, the first language used should be chosen as the default human language.)
Note: For multilingual sites targeting Conformance Level A, the Working Group strongly encourages developers to follow SC 3.1.2 as well even though that is a Level AA success criterion.
Specific Benefits of Success Criterion 3.1.1:
This success criterion helps:
people who use screen readers or other technologies that convert text into synthetic speech;
people who find it difficult to read written material with fluency and accuracy, such as recognizing characters and alphabets or decoding words;
people with certain cognitive, language and learning disabilities who use text-to-speech software
people who rely on captions for synchronized media.
Examples of Success Criterion 3.1.1
Example 1. A Web page with content in two languages
[begin change]A Web page produced in Germany and written in HTML includes content in both German and English, but most of the content is in German. The default human language is identified as German (de) by the lang attribute on the html element. [1960]
[end change]
Related Resources
Resources are for information purposes only, no endorsement implied.
Internationalization Best Practices: Specifying Language in XHTML & HTML Content
d140 Learning to read. 2001. International Classification of Functioning, Disabilities, and Health. World Health Organization
Techniques and Failures for Success Criterion 3.1.1 [Language of Page]
Each numbered item in this section represents a technique or combination of techniques that the WCAG Working Group deems sufficient for meeting this success criterion. The techniques listed only satisfy the success criterion if all of the WCAG 2.0 conformance requirements have been met.
Sufficient Techniques
Identifying default human language(s) using one of the following techniques:
Additional Techniques (Advisory)
Although not required for conformance, the following additional techniques should be considered in order to make content more accessible. Not all techniques can be used or would be effective in all situations.
Specifying the default language in the HTTP header (future link)
using http or the Content-Language meta tag for metadata (future link)
Failures
The following are common mistakes that are considered failures of Success Criterion 3.1.1 by the WCAG Working Group.
(No failures currently documented)
Key Terms
- human language
language that is spoken, written or signed ([begin change]through visual or tactile means [2264] [end change]) [begin delete]by humans [end delete]to communicate with [begin add]humans[end add] [begin delete]one another[end delete] [2139]
Note: See also sign language.
- programmatically determined / programmatically determinable
determined by software from author-supplied data provided in a way that different user agents, including assistive technologies, can extract and present this information to users in different modalities
Example: Determined in a markup language from elements and attributes that are accessed directly by commonly available assistive technology.
Example: Determined from technology-specific data structures in a non-markup language and exposed to assistive technology via an accessibility API that is supported by commonly available assistive technology.
- Web page
[begin add]a non-embedded resource [begin delete]that is referenced by a URI[end delete] [begin add]obtained from a single URI using HTTP[end add] plus any other resources that are used in the rendering or intended to be rendered together with it by a user agent [end add] [begin delete]a resource that is referenced by a URI and is not embedded in another resource, plus any other resources that are used in the rendering or intended to be rendered together with it[end delete] [1948]
Note 1: Although any "other resources" would be rendered together with the primary resource, they would not necessarily be rendered simultaneously with each other.
Note 2: For the purposes of conformance with these guidelines, a resource must be "non-embedded" within the scope of conformance to be considered a Web page.
Example 1: A Web resource including all embedded images and media.
Example 2: A Web mail program built using Asynchronous JavaScript and XML (AJAX). The program lives entirely at http://example.com/mail, but includes an inbox, a contacts area and a calendar. Links or buttons are provided that cause the inbox, contacts, or calendar to display, but do not change the URL of the page as a whole.
Example 3: A customizable portal site, where users can choose content to display from a set of different content modules.
Example 4: When you enter "http://shopping.example.com/" in your browser, you enter a movie-like interactive shopping environment where you visually move about a store dragging products off of the shelves around you [begin add]and[end add] into a visual shopping cart in front of you. Clicking on a product causes it to be demonstrated with a specification sheet floating alongside.