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

Tècnica HTML WCAG 2.2

H64Donar un title que descrigui el contingut de cada iframe

Nom oficial al W3C: Utilitzar l'atribut title de l'element iframe

Versión en castellano

En poques paraules

Un iframe (marc) posa a la pàgina contingut d'un altre web, com un mapa, un vídeo o un formulari de reserva. El seu atribut title ha de dir què conté, per exemple «Mapa de l'oficina de turisme». Així el lector de pantalla l'anuncia i l'usuari decideix si hi entra o continua.

Per què és important

Els lectors de pantalla anuncien els marcs quan hi arriben i permeten saltar de l'un a l'altre. Sense title, només diuen «marc» o un text tècnic del servei extern, sovint en anglès.

La persona ha d'entrar al marc i explorar-lo per saber què és. Amb un bon títol el pot saltar si no li interessa. El criteri 4.1.2 demana que cada component tingui nom. El 2.4.1 demana que es puguin saltar blocs de contingut.

Com es fa

  1. Afegiu title a cada <iframe>: title="Vídeo: com demanar cita prèvia".
  2. Descriviu el contingut, no la tecnologia. Eviteu «iframe», «YouTube video player» o «Contingut extern».
  3. Si hi ha diversos marcs, doneu a cadascun un títol diferent.
  4. Reviseu els codis d'inserció que copieu de serveis de vídeo o de mapes. Canvieu el títol o traduïu-lo a l'idioma de la pàgina.
  5. Amagueu els marcs que no tenen contingut per a l'usuari, com els de seguiment, amb hidden o display: none.

Exemple pràctic

Els iframe serveixen sobretot per inserir contingut d'altres webs: mapes, vídeos, formularis de reserva, passarel·les de pagament o finestres de xat. En l'exemple, el mapa se simula amb srcdoc. En un web real, src apuntaria al servei de mapes.

Així no: Mapa inserit en un iframe sense title

L'iframe no té nom. En anar de marc en marc, el lector de pantalla només diu «marc». Com a molt, llegeix el títol intern del document inserit, que no es controla i sol estar en anglès. Per notar-ho cal recórrer la demo amb NVDA o VoiceOver.

Captura de pantalla de l'exemple incorrecte: Mapa inserit en un iframe sense title
Així es veu l'exemple incorrecte.

La demostració conté, a propòsit, l'error d'accessibilitat que s'explica.

Mostra el codi de l'exemple incorrecte
<h2>On som</h2>
<p>Oficina de turisme, Plaza de España, 1.</p>
<iframe width="300" height="120"
  srcdoc="<div lang='ca' style='font-family:sans-serif;background:#e6eef5;height:100px;padding:8px'>Mapa: Plaza de España, 1</div>"></iframe>

Així sí: iframe amb un title que descriu el seu contingut

S'afegeix title amb una descripció del contingut del marc. El lector l'anuncia quan arriba al marc i a la llista de marcs. Així l'usuari decideix si hi entra o passa de llarg.

Proveu-ho aquí:

Mostra el codi de l'exemple correcte
<h2>On som</h2>
<p>Oficina de turisme, Plaza de España, 1.</p>
<iframe width="300" height="120"
  title="Mapa amb la ubicació de l'Oficina de turisme"
  srcdoc="<div lang='ca' style='font-family:sans-serif;background:#e6eef5;height:100px;padding:8px'>Mapa: Plaza de España, 1</div>"></iframe>

Com comprovar-ho

Lector de pantalla (NVDA o VoiceOver)

  1. A NVDA, prémer M (anar al marc següent) fins a arribar al mapa. A VoiceOver, utilitzar el rotor (VO + U).
  2. Comprovar que s'anuncia un nom que diu què conté el marc, i no només «marc».

Hauria d'anunciar: «Mapa amb la ubicació de l'Oficina de turisme, marc»

Eines del navegador

  1. Obrir les eines de desenvolupament (F12). Seleccionar l'<iframe> a Elements i obrir el tauler Accessibilitat.
  2. Comprovar que el camp Nom (Name) surt de l'atribut title i que el text descriu el contingut.
  3. A la Consola, [...document.querySelectorAll('iframe:not([title])')] mostra els marcs sense title.

Validació automàtica

  1. axe DevTools detecta els iframe sense nom (regla frame-title). També els que tenen el mateix nom (regla frame-title-unique).
  2. No detecta títols genèrics o en anglès, com ara «iframe», «Contingut» o «YouTube video player». La qualitat del text es revisa a mà.

Errors freqüents en auditories

  • Codis d'inserció de vídeos i mapes copiats tal qual, sense title o amb el text en anglès del servei.
  • Títols genèrics que no diuen què hi ha a dins, com ara «iframe», «Mapa» o «Contingut extern».
  • Utilitzar name creient que dona nom al marc. Només serveix per a scripts i destinacions d'enllaços, i l'usuari no el sent.
  • Marcs tècnics sense contingut per a l'usuari, com els de seguiment o publicitat, que el lector anuncia. Cal amagar-los amb hidden o display: none.
Veure el text complet del W3C (traducció al català)

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

Documents HTML que utilitzen iframe

Descripció

L'objectiu d'aquesta tècnica és mostrar l'ús de l'atribut title de l'element iframe per descriure'n el contingut. Això proporciona una etiqueta per al marc, de manera que els usuaris puguin decidir en quin marc volen entrar per explorar-lo amb detall. No etiqueta el contingut que hi ha dins de l'iframe.

L'atribut title etiqueta els iframe, i és diferent de l'element title, que etiqueta documents. Cal proporcionar tots dos, ja que el primer facilita la navegació entre iframe i el segon aclareix quina és la pàgina actual de l'usuari.

L'atribut title no és intercanviable amb l'atribut name. El title etiqueta el marc per als usuaris; el name l'etiqueta per als scripts i per a la destinació de les finestres. El name no es presenta a l'usuari; només es presenta el title.

Exemples

Ús de l'atribut title en un iframe per descriure el contingut de l'iframe

<!doctype html>
<html lang="en">
<head>
   <title>A document using an iframe</title>
</head>
...
<iframe src="banner-ad.html" name="ad-iframe" title="Advertisement"></iframe>
...
</html>

Proves

Procediment

  1. Comprovar que cada element iframe del codi font HTML té un atribut title.
  2. Comprovar que l'atribut title conté un text que descriu el contingut de l'iframe.

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