Addaw, anar a la pàgina d'inici Donar

Tècnica Scripts de client WCAG 2.2

SCR38Oferir la versió HTML bàsica de la pàgina com a alternativa accessible

Nom oficial al W3C: Crear una versió alternativa conforme per a una pàgina web dissenyada amb millora progressiva

Versión en castellano

En poques paraules

Moltes pàgines es construeixen per capes: primer un HTML que funciona tot sol i, a sobre, estils i scripts que la milloren. Aquesta tècnica desa aquesta versió bàsica abans de les millores i afegeix un enllaç per tornar-hi. Aquesta versió bàsica, que ha de complir les WCAG completament, serveix com a versió alternativa conforme.

Per què és important

Les WCAG permeten oferir diverses versions d'una mateixa pàgina. Almenys una ha de complir completament, i des de les altres s'hi ha de poder arribar.

En una pàgina que s'adapta a cada dispositiu hi pot haver moltes versions millorades. La versió bàsica en HTML és la que funciona en més navegadors i productes de suport. Per això és una bona candidata a versió conforme.

És una tècnica avançada i poc habitual. No substitueix la feina de fer accessibles també les versions millorades.

Com es fa

  1. Construïu la pàgina amb un HTML complet i ben estructurat que funcioni sense CSS ni JavaScript.
  2. En carregar la pàgina, i abans d'aplicar cap millora, deseu amb JavaScript una còpia d'aquest contingut inicial.
  3. Inseriu al principi de cada versió millorada un enllaç visible, per exemple «Versió accessible bàsica».
  4. En activar aquest enllaç, restaureu el contingut desat. Podeu utilitzar una adreça pròpia, com #accesible, per arribar-hi també des de la barra d'adreces.
  5. A la versió bàsica, poseu un altre enllaç per tornar a la versió millorada.
  6. Reviseu que la versió bàsica compleix les WCAG en el nivell declarat. Continueu millorant, a més, l'accessibilitat de les altres versions.

Com comprovar-ho

  1. Obriu la pàgina millorada i busqueu l'enllaç a la versió bàsica. Ha de ser al principi i s'ha de poder utilitzar amb el teclat.
  2. Activeu l'enllaç i comproveu que apareix la versió bàsica, amb el mateix contingut i les mateixes funcions essencials.
  3. Reviseu aquesta versió bàsica amb els criteris de les WCAG del nivell declarat.
  4. Comproveu que des de la versió bàsica es pot tornar a la versió millorada.
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica SCR38 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 amb scripts.

Descripció

L'objectiu d'aquesta tècnica és oferir una versió alternativa conforme per a una pàgina web dissenyada amb millora progressiva. La tècnica mostra com aconseguir-ho mitjançant una tècnica de scripts que consisteix a:

  1. Emmagatzemar la versió inicial, sense millores, de la pàgina web, de manera que pugui actuar com a «versió alternativa conforme» de qualsevol versió millorada posterior del contingut; i
  2. Inserir en totes les versions millorades de la pàgina web un mecanisme que permeti a l'usuari tornar a la versió alternativa sense millores que s'ha emmagatzemat.

Les pàgines web dissenyades amb millora progressiva detecten les característiques del dispositiu d'accés al web (mida, capacitats i programari) per permetre que les tecnologies web compatibles s'apliquin per capes sobre una base d'HTML. El contingut i la funcionalitat bàsics d'aquest tipus de pàgina web estan disponibles a través de la base HTML per a qualsevol persona que utilitzi un dispositiu d'accés al web més senzill, mentre que es creen versions millorades de la pàgina adaptades a les diferents característiques dels dispositius d'accés més avançats.

La guia actual per a les pàgines web que es lliuren en versions alternatives diu: «Nota 4: Es poden proporcionar versions alternatives per adaptar-se a diferents entorns tecnològics o grups d'usuaris. Cada versió hauria de ser tan conforme com sigui possible. Una de les versions hauria de ser plenament conforme per complir el requisit de conformitat 1». En el cas de les pàgines web dissenyades amb millora progressiva, això planteja el problema de quina versió triar com a versió plenament conforme, procurant alhora que cap grup d'usuaris no es vegi perjudicat per aquesta elecció.

Una solució a aquest repte consisteix a triar com a «versió plenament conforme» la versió sense millores de la pàgina web (per exemple, l'estat del DOM creat únicament a partir de l'HTML del codi font, sense suport de scripts, estils ni complements no HTML), pel seu ampli abast, pel que fa a compatibilitat, en tots els dispositius d'accés al web que puguin consultar el contingut.

Aquesta tècnica elimina tots els scripts, estils i complements, però és important assenyalar que això no és necessari per a la conformitat amb les WCAG 2.x. Qui desenvolupa podria utilitzar una tècnica similar i conservar un conjunt reduït d'estils i scripts a la versió «sense millores».

Encara que aquesta tècnica ofereix una manera de basar les declaracions de conformitat en una única versió, els autors han de continuar treballant per garantir que cada versió millorada de la pàgina web sigui tan conforme com sigui possible.

Exemples

Utilitzar JavaScript

L'exemple utilitza JavaScript, al fitxer acctoggle.js, per emmagatzemar la versió inicial sense millores de la pàgina web, creada únicament a partir de l'HTML del codi font, de manera que pugui actuar com a «versió alternativa conforme» de qualsevol versió millorada posterior de la pàgina web; i insereix en totes les versions millorades de la pàgina web un enllaç de commutació que permet a l'usuari tornar a la «versió alternativa conforme» sense millores emmagatzemada. Nota: el fitxer sayhello.js hi és simplement com a exemple de fitxer extern de càrrega útil, i s'ha de substituir per qualsevol altre script extern que es vulgui.

El script del fitxer acctoggle.js emmagatzema la versió sense millores i li assigna el sufix d'URL #accessible. En prémer l'enllaç «WCAG 2 conforming alternate version» (versió alternativa conforme amb les WCAG 2), inserit com a primer fill de l'element body en qualsevol versió millorada, l'URL canvia per incloure el sufix #accessible, cosa que restableix l'HTML situat en els elements body i head al codi sense millores. A l'estat sense millores s'hi pot arribar des de l'enllaç o directament des d'un URL escrit al navegador. A més, a la «versió alternativa conforme» sense millores s'insereix un enllaç que permet a l'usuari tornar a aplicar les millores a la pàgina web (cosa que també es pot fer amb el botó «Enrere» del navegador).

JavaScript d'acctoggle.js

window.onload = function(event) {
// store pre-enhanced element content
var initialHead = document.head.innerHTML;
var initialBody = document.body.innerHTML;
var initialURL = location.href;
var runOnce = function() {
  // payload you want to run per page call - e.g. analytics code
}
var setup = function() {
  // create conforming alternate version link
  var toggleEnhanced = document.querySelector("#toggle_enhanced");
  if (toggleEnhanced) {
    toggleEnhanced.outerHTML = "";
  }
  var nel = document.createElement("a");
  nel.id = "acctoggle";
  nel.setAttribute("href", "#accessible");
  nel.innerHTML = "WCAG 2 conforming alternate version";
  document.body.insertBefore(nel, document.body.firstChild);
  // payload
  var s = document.createElement("SCRIPT");
  s.setAttribute("src", "sayhello.js");
  document.querySelector("HEAD").appendChild(s);
}
setup();
runOnce();
window.onpopstate = function(event) {
  if (location.href.indexOf("#accessible") != -1) {
  // revert element contents to pre-enhanced version
  document.head.innerHTML = initialHead;
  document.body.innerHTML = initialBody;
  // create enhanced version link
  var el = document.createElement("a");
  el.id = "toggle_enhanced";
  el.setAttribute("href", "");
  el.innerHTML = "Enhanced version";
  var back = function(e) {
    e.preventDefault();
    window.history.back();
  }
  el.addEventListener("click", back, false);
  document.body.insertBefore(el, document.body.firstChild);
}
if (location.href == initialURL) {
  setup();
}
};
}

Codi font HTML de la pàgina web

<!DOCTYPE html>
<html lang="en">
  <head>
    <title>Evaluera Ltd</title>
    <meta charset="UTF-8">
    <script src="accSwitch.js"></script>
  </head>
  <body>
    <h1>Test Page</h1>
    <p>Say: <span id="change">Goodbye</span></p>
  </body>
</html>

Codi font de sayhello.js

var change = document.querySelector("#change");
change.innerText = "Hello";

Proves

Procediment

  1. Comprovar que les versions millorades de la pàgina web contenen un enllaç a la «versió alternativa conforme».
  2. Comprovar que la versió alternativa és una versió alternativa conforme de la pàgina original i que compleix les WCAG 2 en el nivell de conformitat declarat.

Resultats esperats

  • Les comprovacions núm. 1 i núm. 2 són certes.

Recursos

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.

Sol·licitar una auditoria

Basat en la tècnica SCR38 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.