SC3-1-1-text

From Automated WCAG Monitoring Community Group
Jump to: navigation, search

This test belongs to 3.1.1 Language of Page.

Status

Version 1

Previous versions

Version 0: For review

Version 0: For review

Description

This test checks that the primary language of the content is specified correctly by the language attribute of the <html>-element.

Background

Assumptions

  • The comparison of language-code does not look for exact matches. Technique H57 states: "Use of the primary code is important for this technique." which means that region subtags can be ignored in the comparison, i.e. "en-GB" is the same as "en".
  • This test assumes that the language of the web page has been specified in the lang attribute of the <html> element (see also SC3-1-1-html). The xml:lang attribute is not taken into account because tests have shown, that xml:lang is ignored by screenreaders.
  • There are different possible definitions of "primary language" of a web page:
  1. language of the majority of content
  2. language of interface
  3. language of the intended audience

This test does not prescribe which of these definitions to use as long as one of them is used.
Note that all language changes must be marked correctly independent of the chosen definition. This is covered by 3.1.2 Language of Parts.

Test properties

Property Possible values
Success Criterion 3.1.1 Language of Page
Test mode semiAuto
Test environment DOM
Test subject single web page
User expertise and skills no prior knowledge
User profile Knowledge of the languages used in the web page

Test procedure

Selector

Test mode: earl:automatic

L1 = value of lang attribute.

Step 1

Test mode: earl:automatic

Select a continuous run of text from one or more consecutive p-elements. If no p-elements exist, select any text from the body of the web page. The text should be at least 300 characters in length and not contain any language changes, i.e. lang-attributes on the element or its parent. If no such text is found, continue with Step 2.

Use a language identification algorithm to check if L1 is the language of the selected text.

If yes, return

Property Value
TestCase SC311-text
Identifier SC311-text-pass1
Outcome passed
Pointer position
Info


Else continue with Step 2.

Step 2

Test mode: earl:manual

Present the page to the user.
Question: Is L1 the primary language of this page?

Note that language code L1 should be presented in human readable form, e.g. using the description from the language subtag registry.

Help text: "Primary language" means the language of the majority of the text on the page or the language of the interface (navigation menu etc.) of the page.

If yes, return

Property Value
TestCase SC311-text
Identifier SC311-text-pass2
Outcome passed
Pointer position
Info


Else return

Property Value
TestCase SC311-text
Identifier SC311-text-fail1
Outcome failed
ErrorMessage The primary language of the page is not specified correctly.
Pointer position
Info L1