Tècnica Scripts de servidor WCAG 2.2
SVR5Indicar l'idioma principal a la capçalera HTTP Content-Language
Nom oficial al W3C: Especificar l'idioma predeterminat a la capçalera HTTP
En poques paraules
El servidor pot indicar a la capçalera HTTP Content-Language l'idioma del públic a qui s'adreça la pàgina. Aquest valor ha de coincidir amb l'idioma principal de la pàgina. És un complement recomanat: no substitueix l'atribut lang d'HTML.
Per què és important
La capçalera ajuda a identificar a quin públic s'adreça cada pàgina. És útil, per exemple, en un ajuntament amb versió en castellà i en valencià.
Però els lectors de pantalla (programes que llegeixen en veu alta el contingut) no utilitzen aquesta capçalera per pronunciar. Per a això cal l'atribut lang a l'etiqueta html, que és el que demana el criteri 3.1.1.
Com es fa
- Poseu primer l'atribut
langa l'etiquetahtmlde cada pàgina, per exemplelang="es". - Configureu el servidor perquè enviï la capçalera amb el mateix codi:
Content-Language: es. - En PHP, envieu-la abans de qualsevol contingut:
header('Content-Language: es'); - A Apache es pot fixar amb
Header set Content-Language es(mòdulmod_headers). - En llocs amb diversos idiomes, envieu a cada versió el codi del seu idioma:
es,ca,eu,gl,en…
Com comprovar-ho
- Obriu les eines de desenvolupament del navegador (F12), aneu a la pestanya Xarxa i torneu a carregar la pàgina.
- Seleccioneu la petició del document i cerqueu
Content-Languagea les capçaleres de resposta. - Compareu-ne el valor amb l'atribut
langde l'etiquetahtml. Han d'indicar el mateix idioma.
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica SVR5 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
Tecnologies del costat del servidor, incloent-hi els llenguatges de scripting de servidor i els fitxers de configuració del servidor que permeten establir capçaleres HTTP.
Descripció
L'objectiu d'aquesta tècnica és proporcionar informació sobre l'idioma o els idiomes principals d'una pàgina web, amb la finalitat d'identificar el públic destinatari del contingut. La capçalera HTTP Content-Language pot contenir una llista d'un o més codis d'idioma, que es poden utilitzar per a la negociació d'idioma entre un agent d'usuari i un servidor. Si les preferències d'idioma de l'agent d'usuari estan configurades correctament, la negociació d'idioma pot ajudar l'usuari a trobar una versió del contingut en l'idioma que s'ajusti a les seves preferències.
Tingueu en compte que la capçalera HTTP Content-Language no serveix per identificar l'idioma utilitzat en el processament del contingut. L'idioma de processament del contingut es pot identificar mitjançant altres tècniques, com ara els atributs lang i xml:lang dels llenguatges de marcatge.
Aquesta tècnica garanteix que l'idioma principal del document, tal com s'especifica per exemple a l'atribut lang o xml:lang, figuri a la capçalera HTTP Content-Language.
Exemples
Establir l'idioma del contingut en Java Servlet i JSP
En Java Servlet o JavaServer Pages (JSP), qui desenvolupa pot utilitzar response.setHeader("Content-Language", lang), on «lang» representa una etiqueta d'idioma (per exemple, "en" per a l'anglès):
...
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
...
response.setHeader("Content-Language", "en");
PrintWriter out = response.getWriter();
...
}
Establir l'idioma del contingut en PHP
En PHP, qui desenvolupa pot enviar una capçalera HTTP directa amb el mètode header. L'exemple següent estableix l'idioma en francès:
<?php header('Content-language: fr'); ... ?>
Proves
Procediment
- Utilitzar un visualitzador de capçaleres HTTP en temps real per esbrinar el valor de la capçalera
Content-Language. - Comprovar que aquest valor coincideix amb l'idioma predeterminat de la pàgina web.
Resultats esperats
- El pas núm. 2 és cert.
Recursos
- W3C Internationalization FAQ: HTTP and meta for language information (preguntes freqüents d'internacionalització del W3C sobre HTTP i meta per a la informació d'idioma)
- Declaring metadata about the language(s) of the intended audience a Authoring HTML: Language declarations - Nota del Grup de Treball del W3C de 3 de juny de 2014.
- RFC 9110, 8.5. Content-Language
- PHP header (documentació de la funció header de PHP).
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 SVR5 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.