Buttons do not have an accessible name
Lighthouse a găsit butoane (sau linkuri) care au doar o iconiță, fără text. Cititorul de ecran anunță doar „buton”, fără să spună ce face. Dă-i un nume: aria-label="Coșul de cumpărături" pe buton, un text ascuns vizual sau un alt descriptiv pe imaginea din el.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fiecare element interactiv are nevoie de un nume accesibil: textul pe care îl citește cititorul de ecran și pe care îl folosesc comenzile vocale („apasă Coșul de cumpărături”). Numele se calculează din textul din interior, din aria-label, din aria-labelledby sau din alt-ul imaginilor din buton.
Un buton care conține doar un SVG, o iconiță de font (<i class="fa fa-cart">) sau o imagine cu alt="" nu are niciun nume. Lighthouse îl raportează la Accesibilitate cu „Buttons do not have an accessible name”, iar pentru linkuri mesajul este „Links do not have a discernible name”.
Cum îl repari, în ordinea preferinței:
- text vizibil lângă iconiță („Coș”);
aria-label="Coșul de cumpărături"pe buton, când designul nu are loc de text;- text ascuns vizual cu o clasă
.sr-only; - pentru o imagine în buton,
altdescriptiv.
SVG-ul decorativ primește aria-hidden="true", ca să nu fie citit separat. Un title pe buton nu este suficient pentru toate cititoarele de ecran.
De ce apare: cauzele frecvente
1Buton doar cu iconiță SVG
<button class="cos">
<svg aria-hidden="true">...</svg>
</button><button class="cos" aria-label="Coșul de cumpărături">
<svg aria-hidden="true">...</svg>
</button>aria-label dă butonului un nume, citit de cititorul de ecran în locul iconiței.
2Link cu iconiță de font
<a href="https://facebook.com/florariairis">
<i class="fa fa-facebook"></i>
</a><a href="https://facebook.com/florariairis">
<i class="fa fa-facebook" aria-hidden="true"></i>
<span class="sr-only">Florăria Iris pe Facebook</span>
</a>Textul ascuns vizual devine numele linkului, iar iconița este ignorată de cititoarele de ecran.
3Imagine fără alt într-un buton
<button><img src="cauta.svg" alt=""></button><button><img src="cauta.svg" alt="Caută"></button>Textul alternativ al imaginii devine numele butonului.
Repară eroarea, direct în pagină
Lighthouse raportează „Buttons do not have an accessible name” pentru butonul coșului, care conține doar o iconiță SVG. Dă butonului .cos numele accesibil Coșul de cumpărături printr-un atribut aria-label.
<!DOCTYPE html>
<html lang="ro">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Florăria Iris</title>
<style>
body {
font-family: system-ui, Arial, sans-serif;
padding: 20px;
color: #1f2937;
}
.antet {
display: flex;
justify-content: space-between;
align-items: center;
}
</style>
</head>
<body>
<header class="antet">
<a href="/">Florăria Iris</a>
<button type="button" class="cos">
<svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true">
<path d="M3 4h2l2 12h11l2-8H7" fill="none" stroke="currentColor" stroke-width="2"/>
</svg>
</button>
</header>
</body>
</html>Indiciu
Numele se pune pe buton, nu pe SVG.
Reparația
<!DOCTYPE html>
<html lang="ro">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Florăria Iris</title>
<style>
body {
font-family: system-ui, Arial, sans-serif;
padding: 20px;
color: #1f2937;
}
.antet {
display: flex;
justify-content: space-between;
align-items: center;
}
</style>
</head>
<body>
<header class="antet">
<a href="/">Florăria Iris</a>
<button type="button" class="cos" aria-label="Coșul de cumpărături">
<svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true">
<path d="M3 4h2l2 12h11l2-8H7" fill="none" stroke="currentColor" stroke-width="2"/>
</svg>
</button>
</header>
</body>
</html>De ce merge
Butonul conținea doar o iconiță marcată aria-hidden, deci nu avea niciun text din care să i se calculeze numele. Cititorul de ecran anunța doar „buton”.
Cu aria-label="Coșul de cumpărături", butonul are un nume clar: cititorul de ecran anunță „Coșul de cumpărături, buton”, iar Lighthouse nu mai raportează problema. Aspectul vizual rămâne același.
Alte forme ale mesajului
Links do not have a discernible name
Cum o eviți pe viitor
- Verifică fiecare buton și link doar cu iconiță: are text,
aria-labelsaualt? - Pune
aria-hidden="true"pe iconițele decorative. - Folosește același nume pentru același tip de buton pe tot site-ul.
- Rulează Lighthouse → Accessibility după fiecare componentă nouă.
Întrebări frecvente
E suficient atributul title?
Nu e recomandat. title apare doar la hover cu mouse-ul, nu pe telefon, și nu e citit consecvent de toate cititoarele de ecran. aria-label sau text ascuns sunt variantele sigure.
Contează pentru Google?
Pentru linkuri da: textul linkului (sau aria-label, alt) ajută motoarele de căutare să înțeleagă pagina spre care duce. Pentru butoane contează mai ales accesibilitatea.
Erori înrudite
An “img” element must have an “alt” attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images. Fiecare img are nevoie de atributul alt: textul citit de cititoarele de ecran și afișat când imaginea nu se încarcă. Pune o descriere scurtă pentru imaginile cu informație și alt="" (gol) pentru imaginile pur decorative. No label associated with a form field Chrome (panoul Issues) a găsit un câmp fără etichetă legată de el. placeholder nu este o etichetă: dispare când scrii și nu e citit sigur de toate cititoarele de ecran. Adaugă <label for="id-ul câmpului">, sau pune câmpul în interiorul etichetei. Background and foreground colors do not have a sufficient contrast ratio. Textul e prea deschis față de fundal și e greu de citit, mai ales pe telefon, în soare sau pentru cei cu vedere slabă. Textul normal are nevoie de un raport de contrast de cel puțin 4.5:1 (3:1 pentru text mare). Închide culoarea textului: în loc de #aaaaaa pe alb folosește #595959 sau mai închis. Învață HTML și CSS de la zero, cu exerciții la fiecare lecție
Curs HTML & CSS: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
