Lliçó 9 de 10 · 9 min de lectura · Revisada el 26/10/2026
Anotar l'accessibilitat en els dissenys (Figma): lliurables per a desenvolupament
Estàs llegint una lliçó oberta. Matricula't gratis per fer els tests i els exercicis, desar el teu progrés i aconseguir el certificat.
Un disseny a Figma mostra com es veu la interfície, però no com se sent, com es recorre amb el teclat ni quin nom té cada botó d'icona. Si aquesta informació no viatja amb el disseny, l'equip de desenvolupament se la inventa, i se la inventa de manera diferent a cada component. Les anotacions d'accessibilitat són la manera de tancar aquest buit: una capa de notes sobre el disseny que especifica semàntica, ordre, noms i comportaments. Aquesta lliçó explica què cal anotar, com fer-ho a Figma i com convertir-ho en un lliurable que desenvolupament i QA puguin fer servir. És l'últim pas del disseny: anota quan el disseny ja ha passat les proves d'estrès de la lliçó anterior.
Per què anotar
Una part molt important dels problemes d'accessibilitat que apareixen a les auditories té l'origen en decisions de disseny o de contingut, no de codi: un botó sense nom, un ordre de lectura confús, un estat de focus inexistent, un color sense contrast. Anotar-los en el disseny costa minuts; corregir-los després del desenvolupament costa dies. A més, les anotacions converteixen l'accessibilitat en un requisit explícit i verificable: QA pot comprovar el resultat contra l'anotació, igual que comprova un color o un marge.
Què cal anotar
| Què | Com anotar-ho | Criteri relacionat |
|---|---|---|
| Nivells d'encapçalament | Etiqueta «H1», «H2», «H3» al costat de cada títol | 1.3.1, 2.4.6 |
| Regions (landmarks) | Marc amb nom: header, nav «Principal», main, aside, footer | 1.3.1, 2.4.1 |
| Ordre de focus i de lectura | Números sobre cada element interactiu en l'ordre de tabulació | 2.4.3, 1.3.2 |
| Nom accessible dels botons d'icona i dels enllaços d'imatge | Nota amb el text exacte: «Cerca», «Tanca el diàleg», «Menú principal» | 4.1.2, 1.1.1, 2.5.3 |
| Text alternatiu de les imatges | Nota amb l'alt o «decorativa» | 1.1.1 |
| Estats | Variants de cada component: focus, hover, actiu, deshabilitat, error, desplegat, seleccionat | 2.4.7, 1.4.11, 4.1.2 |
| Rol del component | «Enllaç» o «Botó»; «Pestanyes», «Acordió», «Diàleg modal» amb referència al patró APG (s'obre en una finestra nova) | 4.1.2 |
| Interacció de teclat | Tecles que fan funcionar el component i on va el focus en obrir i tancar | 2.1.1, 2.4.3 |
| Anuncis dinàmics | Què s'anuncia i quan: «En afegir al carretó s'anuncia: Producte afegit» | 4.1.3 |
| Contrast i mides | Ràtio comprovada de cada parell de colors; mida mínima dels objectius | 1.4.3, 1.4.11, 2.5.8 |
| Comportament responsive | Què s'apila, què es plega, què no s'amaga mai | 1.4.10, 1.4.4 |
Com anotar a Figma
- Crea una pàgina o una capa «A11y» per pantalla, separada del disseny visual, que es pugui amagar en presentar-ho al client i mostrar a desenvolupament.
- Fes servir un kit d'anotacions. N'hi ha diversos de gratuïts a la comunitat de Figma i connectors pensats per a això: Include (d'eBay), A11y Annotation Kit, Stark, Axe for Designers (de Deque) o A11y - Focus Order. Tria'n un i fes-lo servir en tot el projecte; la coherència importa més que l'eina.
- Numera l'ordre de focus amb marcadors sobre cada element interactiu. Si l'ordre visual i el de focus difereixen, és un senyal que cal replantejar el disseny, no que cal anotar més.
- Anota els noms accessibles amb el text literal, entre cometes, en l'idioma de la interfície. Evita «posar un aria-label descriptiu»: decideix tu el text.
- Documenta els components a la biblioteca, no a cada pantalla: l'estat de focus, les tecles i el rol s'anoten una vegada al component del sistema de disseny i s'hereten.
- Comprova el contrast al mateix Figma amb un connector (Stark, Contrast, A11y - Color Contrast Checker) i anota la ràtio al costat de la paleta. Defineix als estils de color parells «text sobre fons» ja validats.
- Inclou els estats d'error i buits de cada formulari i llista, amb el text exacte. Són els que més s'obliden.
Exemple
Anotació d'una targeta de producte en una botiga en línia:
- Contenidor:
article; títol del producte: H3. - Imatge: decorativa (el títol ja identifica el producte):
alt="". - Un únic enllaç: el títol, que embolcalla tota la targeta de manera visual però el text de l'enllaç és només el títol.
- Botó «Afegeix al carretó»: botó (no enllaç); nom accessible «Afegeix Sabatilla Trail X al carretó» (inclou el text visible, 2.5.3); en activar-lo s'anuncia «Sabatilla Trail X afegida al carretó. 3 productes al carretó» (regió
status). - Focus: anell de 3 px #0B3D91 amb offset de 2 px (variant «focus» del component).
- Preu anterior ratllat: inclou un text visualment ocult «Preu anterior» abans de la xifra.
- Objectiu del botó: 44 per 44 px; separació amb la icona de preferits: 8 px.
Del disseny al desenvolupament i a QA
- Revisió conjunta: una sessió curta de disseny i desenvolupament per pantalla per repassar les anotacions evita malentesos.
- Criteris d'acceptació: cada anotació es converteix en una condició verificable a la història d'usuari («el botó de tancar té el nom accessible Tanca el diàleg i en tancar el focus torna al botó que l'ha obert»).
- Llista de comprovació de QA derivada de les anotacions: recorregut amb el teclat, lectura amb lector de pantalla, zoom al 200 i al 400 %, contrast mesurat.
- Manteniment: quan un component canvia, canvia la seva anotació. Les anotacions desactualitzades són pitjors que cap.
Error freqüent
Lliurar el disseny amb una nota general «ha de complir WCAG 2.2 AA» i res més. No és una especificació: és traslladar totes les decisions a desenvolupament. L'accessibilitat s'especifica igual que l'espaiat o la tipografia: component per component.
Punt clau
El que no s'anota, no es construeix. Encapçalaments, landmarks, ordre de focus, noms accessibles, alt, estats, tecles i anuncis han de viatjar amb el disseny i convertir-se en criteris d'acceptació.
Resum
- Moltes barreres neixen en el disseny i el contingut; anotar-les a Figma és la manera més barata d'evitar-les.
- Anota encapçalaments, landmarks, ordre de focus, noms accessibles literals, alt, estats, rol, teclat, anuncis, contrast i comportament responsive.
- Capa «A11y» separada, kit d'anotacions únic, documentació als components de la biblioteca, contrast validat als estils de color.
- Les anotacions es converteixen en criteris d'acceptació i en la llista de comprovació de QA.
- Mantén les anotacions al dia quan canviï el component.
Portes 6 lliçons d'aquest curs: que no es perdin
Crea el teu compte gratis i desa el que ja has llegit i segueix el curs amb tot:
- El test d'aquesta lliçó (3 preguntes) per comprovar el que has après
- Exercicis pràctics amb pàgines reals
- El teu progrés desat: continues on ho vas deixar, des de qualsevol dispositiu
- Constància del curs amb les hores i certificat gratuït del nivell 2 quan aprovis l'examen
Entres amb el teu compte de Google o només amb el teu correu electrònic. No cal contrasenya.