Addaw, joan hasierara Egin dohaintza

Teknika HTML WCAG 2.2

H58Beste hizkuntza batean idatzitako zatiak lang atributuarekin markatzea

Izen ofiziala W3Cn: Hizkuntza-atributuak erabiltzea hizkuntza-aldaketak identifikatzeko

Versión en castellano · Versió en català

Laburbilduz

Gaztelaniazko orri batek beste hizkuntza bateko esaldi edo esteka bat duenean, zati hori lang atributuarekin markatzen da. Adibidez, lang="en" ingelesezko aipu batean. Horrela, pantaila-irakurgailuak ahotsa aldatzen du zati horretarako, eta ondo ahoskatzen du.

Zergatik da garrantzitsua

Pantaila-irakurgailu batek orriaren hizkuntza nagusiko ahotsarekin irakurtzen du orria. Markatu gabeko esaldi bat aurkitzen badu ingelesez edo katalanez, gaztelaniazko ahoskerarekin irakurtzen du, eta nekez ulertzen da.

Pertsona itsuei eragiten die, ahotsa erabiltzen duten ikusmen urriko pertsonei eta, irakurtzeko zailtasunak dituztelako, testua ozen irakurtzeko programak erabiltzen dituztenei. Oso kasu ohikoa da hizkuntza-hautatzailea: «English» edo «Català» gaztelaniazko ahotsarekin irakurrita.

Nola egiten da

  1. Aurkitu beste hizkuntza batean dauden zatiak: aipuak, lanen izenburuak, hizkuntza-hautatzaileko estekak, katalanezko edo euskarazko testuak.
  2. Gehitu lang zatia duen elementuari: <q lang="fr">, <a lang="en">.
  3. Zatiak bere elementurik ez badu, inguratu <span lang="…"> elementuarekin.
  4. Ez markatu izen propioak edo gaztelaniaz jada ohikoak diren hitzak, hala nola «wifi» edo «software».
  5. Erabili kode baliodunak, hala nola en, ca edo fr.

Adibide praktikoa

Hizkuntza-aldaketa ohikoenak goiburuko hizkuntza-hautatzailean daude. Baita aipuetan, iritzietan edo beste hizkuntza bateko lanen izenburuetan ere, gaztelaniazko orri baten barruan. Adibidez, ardo-denda bateko produktu-fitxan.

Horrela ez: Hizkuntza-hautatzailea eta frantsesezko aipua, lang gabe

Orria gaztelaniaz dago, eta ezerk ez du adierazten «English», «Català», «Français» eta aipua beste hizkuntza batzuetan daudenik. Hizkuntza automatikoki aldatzeko aukera aktibatuta egon arren, pantaila-irakurgailuak gaztelaniazko ahotsarekin ahoskatzen ditu. Aipua nekez ulertzen da. Hori nabaritzeko, erakustaldia NVDArekin edo VoiceOverrekin entzun behar da.

Adibide okerraren pantaila-argazkia: Hizkuntza-hautatzailea eta frantsesezko aipua, lang gabe
Honela ikusten da adibide okerra.

Erakustaldiak nahita dauka azaltzen den irisgarritasun-errorea.

Ikusi adibide okerraren kodea
<style>
  .idiomas { list-style: none; padding: 0; display: flex; gap: 16px; }
  .idiomas a { color: #744E9A; }
</style>
<nav aria-label="Idiomas">
  <ul class="idiomas">
    <li><a href="#" aria-current="page">Español</a></li>
    <li><a href="#">Català</a></li>
    <li><a href="#">English</a></li>
    <li><a href="#">Français</a></li>
  </ul>
</nav>
<h1>Crianza 2021, D. O. Jumilla</h1>
<p>En el concurso internacional de Burdeos, el jurado lo describió como
  <q>un vin d'une grande élégance</q>.</p>

Horrela bai: Hizkuntza-aldaketa bakoitza lang atributuarekin markatuta

Hautatzaileko esteka bakoitzak lang darama, bere testuaren hizkuntzarekin. hreflang ere badarama, helburuko orriaren hizkuntzarekin. Aipuak lang="fr" darama. Irakurgailuak ahotsa aldatzen du zati horietan, eta gaztelaniara itzultzen da amaitzean.

Probatu hemen:

Ikusi adibide zuzenaren kodea
<style>
  .idiomas { list-style: none; padding: 0; display: flex; gap: 16px; }
  .idiomas a { color: #744E9A; }
</style>
<nav aria-label="Idiomas">
  <ul class="idiomas">
    <li><a href="#" aria-current="page">Español</a></li>
    <li><a href="#" lang="ca" hreflang="ca">Català</a></li>
    <li><a href="#" lang="en" hreflang="en">English</a></li>
    <li><a href="#" lang="fr" hreflang="fr">Français</a></li>
  </ul>
</nav>
<h1>Crianza 2021, D. O. Jumilla</h1>
<p>En el concurso internacional de Burdeos, el jurado lo describió como
  <q lang="fr">un vin d'une grande élégance</q>.</p>

Nola egiaztatu

Pantaila-irakurgailua (NVDA edo VoiceOver)

  1. NVDAn, aktibatu «Hizkuntza automatikoki aldatzea (onartzen denean)» aukera, Hobespenak > Aukerak > Ahotsa atalean. Egiaztatu hizkuntza horietarako ahotsak instalatuta daudela.
  2. Korritu hautatzailea Tab teklarekin, eta irakurri paragrafoa gezi-teklekin.
  3. Egiaztatu beste hizkuntza bateko zati bakoitza bere ahotsarekin entzuten dela. Gaztelaniazko testuak gaztelaniazko ahotsera itzuli behar du.

Hau iragarri beharko luke: «English, esteka», ingelesezko ahotsarekin

Nabigatzailearen tresnak

  1. Ireki garapen-tresnak (F12), Kontsola fitxan.
  2. Exekutatu [...document.querySelectorAll('[lang]')].map(e => e.lang + ': ' + e.textContent.trim()). Markatutako zati guztiak erakusten ditu, bakoitza bere hizkuntzarekin.
  3. Konparatu zerrenda hori testu ikusgaiarekin. Bilatu falta diren beste hizkuntza bateko zatiak.

Balidazio automatikoa

  1. axe DevTools-ek egiaztatzen du orriaren barruko lang balioak kode baliodunak direla (valid-lang araua).
  2. Ez du hautematen markatu gabeko beste hizkuntza bateko testurik. Ezta hizkuntza oker bati jarritako kode baliodunik ere. Hori orria irakurriz berrikusten da.

Auditorietako ohiko akatsak

  • Hizkuntza-izen bakoitzean lang ez duten hizkuntza-hautatzaileak, edo banderekin soilik egindakoak.
  • Izen propioak edo gaztelaniaz jada ohikoak diren hitzak (software, marketing, wifi) lang atributuarekin markatzea. Ez da beharrezkoa: 3.1.2 irizpideak salbuetsi egiten ditu.
  • Beste hizkuntza bateko testu alternatiboak edo aria-label atributuak, beren elementuan lang gabe. Horiek ere ahots okerrarekin irakurtzen dira.
  • Hizkuntza-kode baliogabeak, hala nola lang="cat" edo lang="en_GB". Edo lang="uk" Britainia Handiko ingeleserako: uk ukrainera da.
Ikusi W3Cren testu osoa (euskarazko itzulpena)

W3Cren Techniques for WCAG 2.2 dokumentuko H58 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 orri baten barruko edozein hizkuntza-aldaketa argi identifikatzea da, lang atributua erabiliz.

lang atributuak onartzen dituen balioak beherago aipatutako baliabideetan adierazten dira. Hizkuntza-etiketek kode nagusi bat erabiltzen dute hizkuntza adierazteko, eta aukerako azpikodeak (marratxoz bereizita) hizkuntzaren aldaerak adierazteko. Adibidez, ingelesa "en" kode nagusiarekin adierazten da; Britainia Handiko ingelesa eta Estatu Batuetako ingelesa bereizteko, "en-GB" eta "en-US" erabil daitezke, hurrenez hurren. Kode nagusia erabiltzea garrantzitsua da teknika honetarako. Azpikodeak erabiltzea aukerakoa da, baina zenbait egoeratan erabilgarria izan daiteke.

Adibideak

lang atributua erabiltzea alemanez idatzitako aipu bat definitzeko

<blockquote lang="de">
  <p>
    Da dachte der Herr daran, ihn aus dem Futter zu schaffen,
    aber der Esel merkte, daß kein guter Wind wehte, lief fort
    und machte sich auf den Weg nach Bremen: dort, meinte er,
    könnte er ja Stadtmusikant werden.
  </p>
</blockquote>

Probak

Prozedura

Dokumentuko elementu bakoitzerako:

  1. Egiaztatu elementuaren edukiaren giza hizkuntza eta elementuak heredatzen duen hizkuntza bera direla, HTML: lang eta xml:lang atributuak atalean zehazten den bezala.

Dokumentuko lang atributu bakoitzerako:

  1. Egiaztatu lang atributuaren balioa BCP 47: Tags for Identifying Languages; Matching of Language Tags espezifikaziora edo haren ondorengora egokitzen dela.
  2. Egiaztatu hizkuntza-kodea aplikatzen zaion edukiaren hizkuntzari dagokiola.

Espero diren emaitzak

  • Aurreko egiaztapen guztiak 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 H58 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.