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
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
- Afegiu
titlea cada<iframe>:title="Vídeo: com demanar cita prèvia". - Descriviu el contingut, no la tecnologia. Eviteu «iframe», «YouTube video player» o «Contingut extern».
- Si hi ha diversos marcs, doneu a cadascun un títol diferent.
- 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.
- Amagueu els marcs que no tenen contingut per a l'usuari, com els de seguiment, amb
hiddenodisplay: 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.

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
Errors freqüents en auditories
- Codis d'inserció de vídeos i mapes copiats tal qual, sense
titleo 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
namecreient 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
hiddenodisplay: 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
- Comprovar que cada element
iframedel codi font HTML té un atributtitle. - Comprovar que l'atribut
titleconté 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.
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.