diff --git a/index.html b/index.html index d44f687ec..c90c65ea1 100644 --- a/index.html +++ b/index.html @@ -11821,7 +11821,8 @@

Definitions of States and Properties (all aria-* attributes)

If the interface is such that it is not possible to have a visible label on the screen, authors SHOULD use aria-label and SHOULD NOT use aria-labelledby. Authors MUST NOT specify aria-labelledby on an element which has an explicit or implicit WAI-ARIA role where aria-labelledby is prohibited. As required by the accessible name and description computation, user agents give precedence to aria-labelledby over aria-label when computing the accessible name property.

The aria-labelledby attribute is similar to aria-describedby in that both reference other elements to calculate a text alternative (an accessible name, and description, respectively). While a concise accessible name is preferable, a description can either be concise, or provide more verbose information.

-

The expected spelling of this property in U.S. English is "labeledby." However, the accessibility API features to which this property is mapped have established the "labelledby" spelling. This property is spelled that way to match the convention and minimize the difficulty for developers.

+

The expected spelling of this property in U.S. English is "labeled by." However, the accessibility API feature this property was originally based on had established the U.K. English spelling, "labelled by."

+

To mitigate against common author use of the "labeledby" misspelling, thus ensuring more content will be properly named, user agents MUST support the canonical "aria-labelledby" and MAY support the alternate "aria-labeledby" spelling when the canonical variant is missing. Authors MUST NOT use both spelling variants on the same element and SHOULD NOT use the alternate "aria-labeledby" variant of the attribute. For instances where an author has erroneously used both spelling variants on the same element, user agents MUST use the canonical aria-labelledby spelling and ignore the alternate spelling of the attribute.

Characteristics: