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

Tècnica Scripts de servidor WCAG 2.2

SVR3Utilitzar la capçalera Referer per passar sempre abans per la versió accessible

Nom oficial al W3C: Utilitzar la capçalera HTTP referer per garantir que només es pugui accedir al contingut no conforme des de contingut conforme

Versión en castellano

En poques paraules

Quan un contingut no accessible té una versió alternativa accessible, el servidor pot comprovar de quina pàgina ve la persona. Per fer-ho, un script (PHP, ASP, JSP…) llegeix la capçalera HTTP Referer. Si no ve de la versió accessible, la hi porta, i des d'allà pot triar l'altra.

Per què és important

Imagineu un curs en línia amb simulacions fetes amb una eina que els lectors de pantalla no poden llegir. Si hi ha una pàgina accessible que explica el mateix, convé passar-hi primer.

Així ningú no es queda atrapat a la versió no accessible per haver-hi arribat des d'un cercador o un enllaç directe. És una manera de complir la condició de les WCAG sobre les versions alternatives conformes (versions accessibles amb la mateixa informació).

Com es fa

  1. Per a cada pàgina no accessible, anoteu l'adreça de la seva versió accessible.
  2. En rebre la petició de la pàgina no accessible, llegiu la capçalera Referer. Indica la pàgina des de la qual ve la persona.
  3. Compareu aquesta adreça amb la de la versió accessible. No tingueu en compte diferències sense importància, com ara els paràmetres després de ? o el fragment després de #.
  4. Si coincideixen, serviu la pàgina sol·licitada. Si no, redirigiu a la versió accessible.
  5. Incloeu a la versió accessible un enllaç clar a l'altra versió per a qui la vulgui utilitzar.

Com comprovar-ho

  1. Escriviu directament a la barra d'adreces l'URL de la pàgina no accessible.
  2. Comproveu que el servidor us porta a la versió accessible.
  3. Des de la versió accessible, premeu l'enllaç a l'altra versió i comproveu que aquesta vegada sí que s'obre.
Veure el text complet del W3C (traducció al català)

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

Contingut creat mitjançant scripts del costat del servidor en què es proporciona una versió conforme del contingut com a alternativa a una versió no conforme en funció de la capçalera HTTP Referer.

Descripció

L'objectiu d'aquesta tècnica és garantir que els usuaris puguin obtenir una versió accessible del contingut quan es proporcionen tant versions no conformes com conformes.

El requisit de conformitat 1 permet incloure pàgines no conformes dins de l'abast de la conformitat sempre que tinguin una versió alternativa conforme. No sempre és possible que els autors incloguin enllaços compatibles amb l'accessibilitat cap al contingut conforme des de dins del contingut no conforme. Per tant, els autors poden haver de recórrer a tecnologies de scripting del costat del servidor (p. ex., PHP, ASP, JSP) per garantir que a la versió no conforme només s'hi pugui arribar des d'una pàgina conforme.

Aquesta tècnica descriu com utilitzar la informació que proporciona la capçalera HTTP referer per garantir que al contingut no conforme només s'hi pugui arribar des d'una pàgina conforme. La capçalera HTTP referer l'estableix l'agent d'usuari i conté l'URI de la pàgina (si n'hi ha) que ha remès l'agent d'usuari a la pàgina no conforme.

Per implementar aquesta tècnica, l'autor identifica, per a cada pàgina no conforme, l'URI de la versió conforme del contingut. Quan es rep una petició de la versió no conforme d'una pàgina, el servidor compara el valor de la capçalera HTTP referer amb l'URI de la versió conforme per determinar si l'enllaç a la versió no conforme procedeix de la versió conforme. La versió no conforme només se serveix si la capçalera HTTP referer coincideix amb l'URI de la versió no conforme. En cas contrari, l'usuari és redirigit a la versió conforme del contingut. Tingueu en compte que, en comparar l'URI de la capçalera HTTP referer, cal tenir en consideració les variacions no rellevants de l'URI, com les de la cadena de consulta i el fragment de destinació.

Exemples

Demostracions interactives de processos físics

Un curs de física en línia utilitza un llenguatge de modelatge propietari per oferir demostracions interactives de processos físics. L'agent d'usuari del llenguatge de modelatge no és compatible amb les tecnologies de suport. El lloc inclou un script que utilitza la capçalera HTTP referer per garantir que, tret que els usuaris intentin accedir a la demostració interactiva des d'una pàgina que conté una descripció conforme del procés i dels models, el servidor redirigeixi la petició a una pàgina conforme que conté un enllaç a la versió no conforme. Els estudiants poden optar per accedir a la versió interactiva no conforme, però els qui no ho facin poden, tot i així, aprendre sobre el procés.

Utilitzar la capçalera HTTP referer en PHP

L'exemple següent il·lustra com es pot utilitzar aquesta tècnica en PHP. Inclou dos fitxers, conforming.php i non-conforming.php, que treballen conjuntament per garantir que l'única manera d'accedir al contingut no conforme sigui des del contingut conforme.

PHP conforme

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Conforming Content</title>
</head>
<body>
  <h1>This is a conforming page</h1>
  <p>From here, you can visit the <a href="non-conforming.php">non-conforming
    page</a>.</p>
</body>
</html>

PHP no conforme

<?php
// if the request comes from a file that contains the string "conforming.php"
// then render the page
  if(stristr($_SERVER['HTTP_REFERER'], "conforming.php")) {
?>
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Non-Conforming Content</title>
</head>
<body>
  <h1>This is a non-conforming page</h1>
  <p>Because you came from <?php echo $_SERVER['HTTP_REFERER']; ?>,
   you are able to view the content on this page.</p>
</body>
</html>
<?php
 }
// if the referring page is not conforming.php, then redirect the user to
// the conforming version
else  {
header("Location: conforming.php");
}
?>

Hi ha disponible un exemple pràctic: contingut conforme.

Proves

Procediment

Quan es proporcionen alternatives conformes amb les WCAG per a contingut no conforme:

  1. Identificar les pàgines que no compleixen les WCAG en el nivell de conformitat declarat en què les alternatives accessibles se serveixen en funció de la capçalera HTTP Referrer.
  2. Visitar l'URI del contingut no conforme.
  3. Verificar que la pàgina resultant és una de les següents:

    1. una versió alternativa conforme del contingut no conforme
    2. una pàgina que inclou un enllaç tant a la versió alternativa conforme com al contingut no conforme

Resultats esperats

  • La comprovació núm. 3.1 o la núm. 3.2 és certa.

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 SVR3 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.