Addaw, joan hasierara Egin dohaintza

Teknika HTML WCAG 2.2

H57Orriaren hizkuntza adieraztea html elementuko lang atributuarekin

Izen ofiziala W3Cn: Hizkuntza-atributua html elementuan erabiltzea

Versión en castellano · Versió en català

Laburbilduz

Orri bakoitzak zer hizkuntzatan idatzita dagoen adierazi behar du. html elementuko lang atributuarekin egiten da; adibidez, lang="es" gaztelaniarako. Horrela, pantaila-irakurgailuak ahots eta ahoskera zuzenak erabiltzen ditu, eta nabigatzaileak badaki nola itzuli orria edo nola zatitu hitzak.

Zergatik da garrantzitsua

  • Pantaila-irakurgailuek (pantailan dagoena ozen irakurtzen duten programak) atributu horren arabera aukeratzen dute ahotsa. Atributurik gabe, gaztelaniazko testu bat ingelesezko ahoskerarekin irakur dezakete, eta ez da ulertzen.
  • Braille-lerroek eta itzultzaile automatikoek ere erabiltzen dute.
  • Nabigatzaileak hitzak marratxoarekin zatitzeko, ortografia zuzentzeko eta letra-tipoak aukeratzeko erabiltzen du.

Nola egiten da

  1. Gehitu lang atributua oinarrizko txantiloiaren <html> elementuari: <html lang="es">.
  2. Erabili baliozko hizkuntza-kodeak: es, ca, eu, gl, en.
  3. Herrialdea gehitzen baduzu, bereizi marratxoarekin (es-ES), inoiz ez behe-marrarekin.
  4. Jarri edukiaren benetako hizkuntza, ez txantiloiak zekarrena.
  5. Hainbat hizkuntzatako webguneetan, egin bertsio bakoitzak balioa automatikoki alda dezan.

Adibide praktikoa

Orriaren hizkuntza behin bakarrik adierazten da, webgunearen oinarrizko txantiloian. WordPress-eko gaia, CMSaren maketa edo React edo Vue aplikazio baten index.html fitxategia izan daiteke. Askotan, html elementuak ez du lang atributurik, edo txantiloiaren ingelesa gordetzen du.

Horrela ez: Gaztelaniazko orria, lang atributurik gabe

html elementuak ez du hizkuntza adierazten. Pantaila-irakurgailuak konfiguratuta duen ahotsa erabiltzen du. Ahots hori ingelesez edo katalanez badago, «Pedir cita previa» beste hizkuntza baten ahoskerarekin entzuten da. Itzultzaile automatikoek eta zuzentzaileek ere ez dakite testua zer hizkuntzatan dagoen.

<!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>

Horrela bai: Hizkuntza nagusia html elementuan adierazita

lang="es" gehitzen zaio html elementuari. Baliozko hizkuntza-kodea da (BCP 47 araua), eta testuaren benetako hizkuntzarekin bat dator. Irakurgailua gaztelaniazko ahotsera aldatzen da. Nabigatzaileak hitzak zuzen itzultzen eta zatitzen ditu.

<!DOCTYPE html>
<html lang="eu">
<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>

Nola egiaztatu

Nabigatzailearen tresnak

  1. Ireki garapen-tresnak (F12), Elementuak fitxa. Berrikusi <html> hasiera-etiketa.
  2. Kontsola fitxan, exekutatu document.documentElement.lang. "es" edo "es-ES" itzuli behar du. Kate huts bat itzultzen badu, atributua falta da.
  3. Egiaztatu balioa testuaren benetako hizkuntzarekin bat datorrela. Ez da nahikoa atributua egotea.

Pantaila-irakurgailua (NVDA edo VoiceOver)

  1. NVDAn, aktibatu «Hizkuntza automatikoki aldatzea (onartzen denean)» aukera, Hobespenak > Ezarpenak > Ahotsa atalean.
  2. Jarri aldi baterako NVDAren ahotsa beste hizkuntza batean, ingelesez adibidez, eta kargatu orria.
  3. Joan izenburura H teklarekin. lang atributurik gabe, ingelesezko ahotsarekin ahoskatzen da. lang="es" atributuarekin, NVDA gaztelaniazko ahotsera aldatzen da.

Hau iragarri beharko luke: «Pedir cita previa, izenburua, 1. maila», gaztelaniazko ahotsarekin

Balidazio automatikoa

  1. axe DevTools-ek atributua falta den hautematen du (html-has-lang araua). Baliozkoak ez diren balioak ere hautematen ditu, sp edo es_ES adibidez (html-lang-valid araua). Lighthouse-k egiaztapen bera egiten du.
  2. Tresna automatiko batek ere ez du hautematen baliozkoa baina okerra den baliorik, gaztelaniazko orri batean lang="en" jartzea, adibidez. Hori eskuz berrikusten da.

Auditorietako ohiko akatsak

  • lang="en" edo lang="en-US" finko duten gaiak eta txantiloiak, gaztelaniazko webguneetan aldatu gabe erabiliak.
  • BCP 47 araua betetzen ez duten balioak: lang="sp", lang="es_ES" (behe-marrarekin) edo lang="spanish".
  • Hainbat hizkuntzatako webguneak, katalanezko, euskarazko edo ingelesezko orriek oraindik lang="es" dutenak. Atributua txantiloian eskuz idatzita dagoenean gertatu ohi da.
  • Atributua body elementuan edo edukiontzi batean jartzea, eta ez html elementuan. Horrela, orriaren tituluak ez du hizkuntzarik.
Ikusi W3Cren testu osoa (euskarazko itzulpena)

W3Cren Techniques for WCAG 2.2 dokumentuko H57 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.

Aplikagarritasuna

HTML

Deskribapena

Teknika honen helburua da dokumentu baten hizkuntza lehenetsia identifikatzea, html elementuan lang atributua emanez.

Dokumentuaren hizkuntza identifikatzea garrantzitsua da hainbat arrazoirengatik:

  • Braille-transkripzioko softwareari aukera ematen dio karaktere azentudunak kontrol-kodeekin ordezteko eta beharrezko kontrol-kodeak txertatzeko, 2. graduko braillearen laburdurak oker sor ez daitezen.
  • Hainbat hizkuntza onartzen dituzten ahots-sintetizadoreak orriaren hizkuntzaren ahoskerara eta sintaxira orientatu eta egokitu ahal izango dira, eta testua azentu egokiarekin eta ahoskera zuzenarekin irakurriko dute.
  • Hizkuntza markatzeak etorkizuneko aurrerapen teknologikoei mesede egin diezaieke; adibidez, hizkuntzen artean beren kabuz itzuli ezin duten erabiltzaileek makinak erabili ahal izango dituzte ezagutzen ez dituzten hizkuntzak itzultzeko.
  • Hizkuntza markatzeak, halaber, erabiltzaile-agenteei lagun diezaieke hiztegi baten bidez definizioak ematen.

Adibideak

HTML dokumentu baten edukia frantsesez dagoela definitzea

<!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>

Probak

Prozedura

Aztertu dokumentuaren html elementua.

  1. Egiaztatu html elementuak lang atributu bat duela.
  2. Egiaztatu lang atributuaren balioa BCP 47: Tags for Identifying Languages; Matching of Language Tags arauari edo haren ondorengoari egokitzen zaiola, eta web-orrian erabilitako hizkuntza nagusia islatzen duela.

Espero diren emaitzak

  • 1. eta 2. egiaztapenak egiazkoak dira.

Baliabideak

Nola egiaztatzen dugun ADDAWn

ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.

Eskatu auditoria bat

W3Cren H57 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.