Addaw, ir a inicio Donar

Técnica Scripts de cliente WCAG 2.2

SCR30Usar scripts para cambiar el texto de los enlaces

En resumen

Hay personas que prefieren enlaces cuyo texto se entienda por sí solo y otras a las que repetir el contexto en cada enlace les resulta molesto. Esta técnica propone ofrecer, al principio de la página, un enlace que amplíe mediante JavaScript el texto de todos los enlaces para que su propósito quede claro sin leer el contexto. Así cada usuario elige la opción que mejor le funciona.

Aplicabilidad

Scripts del lado del cliente usados con HTML

Descripción

El propósito de esta técnica es permitir que los usuarios elijan que se añada información adicional al texto de los enlaces, de modo que los enlaces puedan entenderse fuera de contexto.

Algunos usuarios prefieren enlaces autocontenidos, en los que no haga falta explorar el contexto del enlace. Otros usuarios consideran que incluir la información de contexto en cada enlace resulta repetitivo y reduce su capacidad para usar el sitio. Entre los usuarios de tecnologías de asistencia, las opiniones que ha recibido el grupo de trabajo sobre qué opción es preferible han estado divididas. Esta técnica permite que los usuarios elijan el enfoque que mejor les funcione.

Se proporciona un enlace cerca del principio de la página que ampliará el texto de los enlaces de la página, de modo que no haga falta ningún contexto adicional para entender el propósito de ningún enlace. Siempre debe ser posible entender el propósito del enlace de ampliación directamente a partir de su texto.

Esta técnica amplía los enlaces únicamente para la vista actual de la página. También es posible, y en algunos casos sería recomendable, guardar esta preferencia en una cookie o en un perfil de usuario del lado del servidor, de modo que los usuarios solo tengan que hacer la selección una vez por sitio.

Ejemplos

Este ejemplo usa JavaScript para añadir información contextual directamente al texto de un enlace. La clase del enlace se utiliza para determinar qué texto adicional debe añadirse. Cuando se activa el enlace «Expand Links» (ampliar enlaces), se examina cada enlace de la página para ver si debe añadírsele texto adicional.

...
<script>
  var expanded = false;
  var linkContext = {
    "hist":" version of The History of the Web",
    "cook":" version of Cooking for Nerds"
  };
  function doExpand() {
    var links = document.links;
    for (var i=0; i<links.length; i++) {
      var link = links[i];
      var cn = link.className;
      if (linkContext[cn]) {
        span = link.appendChild(document.createElement("span"));
        span.setAttribute("class", "linkexpansion");
        span.appendChild(document.createTextNode(linkContext[cn]));
      }
    }
    objUpdate = document.getElementById('expand');
    if (objUpdate) {
      objUpdate.childNodes[0].nodeValue = "Collapse links";
    }
    expanded = true;
  }
  function doCollapse() {
    objUpdate = document.getElementById('expand');
    var spans = document.getElementsByTagName("span");
    var span;
    // go backwards through the set as removing from the front changes indices
    // and messes up the process
    for (i = spans.length - 1; i >= 0; i--) {
      span = spans[i];
      if (span.getAttribute("class") == "linkexpansion")
        span.parentNode.removeChild(span);
      }
      if (objUpdate) {
      objUpdate.childNodes[0].nodeValue = "Expand links";
    }
    expanded = false;
  }
  function toggle() {
    if (expanded) doCollapse();
    else doExpand();
  }
</script>
...
<h1>Books for download</h1>
<p><button id="expand" onclick="toggle(); type="button">Expand Links</button></p>
<ul>
  <li>The History of the Web:
    <a href="history.docx" class="hist">Word</a>, 
    <a href="history.pdf" class="hist">PDF</a>, 
    <a href="history.html" class="hist">HTML</a>
  </li>
  <li>Cooking for Nerds: 
    <a href="history.docx" class="cook">Word</a>, 
    <a href="history.pdf" class="cook">PDF</a>, 
    <a href="history.html" class="cook">HTML</a>
  </li>
</ul>
...

Ejemplo funcional de este código: Providing link expansions on demand (ampliar los enlaces a petición).

Pruebas

Procedimiento

  1. Comprobar que hay un enlace cerca del principio de la página para ampliar los enlaces.
  2. Comprobar que el enlace identificado en el paso 1 puede identificarse únicamente a partir del texto del enlace.
  3. Localizar los enlaces de la página que no puedan identificarse únicamente a partir del texto del enlace.
  4. Activar el control identificado en el paso 1.
  5. Comprobar que ahora el propósito de los enlaces identificados en el paso 3 puede identificarse únicamente a partir del texto del enlace.

Resultados esperados

  • Las comprobaciones n.º 1, n.º 2 y n.º 5 son verdaderas.

Cómo lo comprobamos en ADDAW

En las auditorías de accesibilidad de ADDAW revisamos cada criterio de conformidad siguiendo este catálogo de técnicas: comprobamos si la web aplica una técnica suficiente y documentamos cada fallo común con capturas y el código afectado, para que el equipo de desarrollo sepa exactamente qué corregir. Los informes siguen la metodología del Observatorio de Accesibilidad y la norma UNE-EN 301 549.

Solicitar una auditoría

Fuente y licencia

Traducción al español, no oficial, realizada por ADDAW a partir de la técnica SCR30 del documento «Techniques for WCAG 2.2» del W3C (versión del repositorio público del W3C a 22/10/2026). Copyright © W3C® (MIT, ERCIM, Keio, Beihang). Se publica conforme a la licencia de documentos del W3C. El texto normativo de referencia es el original en inglés; si detecta un error en la traducción, escríbanos.

Financiado por la unión europea Gobierno de españa red.es Plan de recuperación transformación y resilencia kit digital