Tècnica HTML WCAG 2.2
H57Indicar l'idioma de la pàgina amb lang a l'element html
Nom oficial al W3C: Utilitzar l'atribut d'idioma en l'element html
En poques paraules
Cada pàgina ha d'indicar en quin idioma està escrita. Es fa amb l'atribut lang a l'element html, per exemple lang="es" per al castellà. Així el lector de pantalla utilitza la veu i la pronúncia correctes, i el navegador sap com traduir la pàgina o dividir les paraules.
Per què és important
- Els lectors de pantalla (programes que llegeixen en veu alta el que hi ha a la pantalla) trien la veu segons aquest atribut. Sense l'atribut, poden llegir un text en castellà amb pronúncia anglesa, i no s'entén.
- Les línies braille i els traductors automàtics també l'utilitzen.
- El navegador l'utilitza per dividir paraules amb guionet, per a la correcció ortogràfica i per triar tipus de lletra.
Com es fa
- Afegiu
langa l'element<html>de la plantilla base:<html lang="es">. - Utilitzeu codis d'idioma vàlids:
es,ca,eu,gl,en. - Si hi afegiu el país, separeu-lo amb guionet (
es-ES), mai amb guió baix. - Poseu-hi l'idioma real del contingut, no el que portava la plantilla.
- En webs amb diversos idiomes, feu que cada versió canviï el valor de manera automàtica.
Exemple pràctic
L'idioma de la pàgina es declara una sola vegada, a la plantilla base del lloc. Pot ser el tema de WordPress, la maqueta del CMS o l'index.html d'una aplicació de React o Vue. Sovint l'element html no té lang o conserva l'anglès de la plantilla.
Així no: Pàgina en castellà sense atribut lang
L'element html no indica l'idioma. El lector de pantalla utilitza la veu que tingui configurada. Si està en anglès o en català, «Pedir cita previa» sona amb la pronúncia d'un altre idioma. Els traductors automàtics i els correctors tampoc no saben en quin idioma és el text.
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Pedir cita previa – Ayuntamiento de Villanueva</title>
</head>
<body>
<h1>Pedir cita previa</h1>
<p>Seleccione el trámite y la oficina donde desea ser atendido.</p>
</body>
</html>
Així sí: Idioma principal declarat a l'element html
S'afegeix lang="es" a l'element html. És un codi d'idioma vàlid (norma BCP 47) i coincideix amb l'idioma real del text. El lector canvia a la veu castellana. El navegador tradueix i talla les paraules correctament.
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="utf-8">
<title>Pedir cita previa – Ayuntamiento de Villanueva</title>
</head>
<body>
<h1>Pedir cita previa</h1>
<p>Seleccione el trámite y la oficina donde desea ser atendido.</p>
</body>
</html>
Com comprovar-ho
Errors freqüents en auditories
- Temes i plantilles amb
lang="en"olang="en-US"fix, utilitzats sense canviar en webs en castellà. - Valors que no compleixen la norma BCP 47:
lang="sp",lang="es_ES"(amb guió baix) olang="spanish". - Webs amb diversos idiomes en què les pàgines en català, basc o anglès continuen amb
lang="es". Sol passar quan l'atribut està escrit a mà a la plantilla. - Posar l'atribut a
bodyo en un contenidor, i no ahtml. Així el títol de la pàgina queda sense idioma.
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica H57 de Techniques for WCAG 2.2, del W3C. Pot contenir errors. L'únic document oficial i normatiu és la versió original en anglès, publicada al lloc web del W3C.
Aplicabilitat
HTML
Descripció
L'objectiu d'aquesta tècnica és identificar l'idioma predeterminat d'un document proporcionant l'atribut lang a l'element html.
Identificar l'idioma del document és important per diversos motius:
- Permet que el programari de transcripció braille substitueixi els caràcters accentuats per codis de control i insereixi els codis de control necessaris per evitar la creació errònia de contraccions del braille de grau 2.
- Els sintetitzadors de veu que admeten diversos idiomes es podran orientar i adaptar a la pronúncia i la sintaxi pròpies de l'idioma de la pàgina, i llegiran el text amb l'accent apropiat i la pronúncia correcta.
- Marcar l'idioma pot beneficiar futurs avenços tecnològics; per exemple, els usuaris que no puguin traduir per si mateixos entre idiomes podran utilitzar màquines per traduir idiomes que no coneixen.
- Marcar l'idioma també pot ajudar els agents d'usuari a proporcionar definicions mitjançant un diccionari.
Exemples
Definir que el contingut d'un document HTML està en francès
<!doctype html>
<html lang="fr">
<head>
<meta charset="utf-8">
<title>document écrit en français</title>
</head>
<body>
... document écrit en français ...
</body>
</html>
Proves
Procediment
Examinar l'element html del document.
- Comprovar que l'element
htmlté un atributlang. - Comprovar que el valor de l'atribut
langs'ajusta a BCP 47: Tags for Identifying Languages; Matching of Language Tags o al seu successor, i que reflecteix l'idioma principal utilitzat a la pàgina web.
Resultats esperats
- Les comprovacions núm. 1 i núm. 2 són certes.
Recursos
-
HTML: els atributs
langixml:lang. -
L'atribut «
lang» d'HTML a Mozilla Developer Network. - BCP 47: Tags for Identifying Languages; Matching of Language Tags (etiquetes per identificar idiomes).
- Language tags in HTML and XML (etiquetes d'idioma en HTML i XML).
- Declaring language in HTML (declarar l'idioma en HTML)
Com ho comprovem a ADDAW
En cada auditoria d'ADDAW revisem aquesta tècnica pàgina per pàgina i us lliurem els errors amb captures i la manera de corregir-los.
Basat en la tècnica H57 del W3C (WCAG 2.2). Explicació i exemples: ADDAW. Traducció no oficial del text del W3C © W3C, llicència de documents del W3C. Heu vist un error? Escriviu-nos.