Possible misuse of “aria-label”. (If you disagree with this warning, file an issue report or send e-mail to www-validator@w3.org.)
Validatorul te avertizează că ai pus aria-label pe un element fără rol potrivit, de obicei un div sau un span simplu, unde eticheta nu are voie să stea și e citită inconsecvent. Pune aria-label pe un element interactiv sau de reper (button, a, nav) ori adaugă un rol, de exemplu role="img" pe o iconiță.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Atributul aria-label dă unui element un nume accesibil, pe care îl citește cititorul de ecran. Specificația ARIA interzice însă numele pentru unele roluri: generic (rolul lui div și span), paragraph, code, strong, emphasis, presentation și altele. Pe aceste elemente, unele cititoare de ecran ignoră eticheta, altele o citesc, deci comportamentul nu e sigur.
Validatorul W3C nu știe ce ai vrut să faci, așa că îți dă un avertisment („Possible misuse”), nu o eroare. Partea din paranteză este doar invitația de a raporta un avertisment greșit.
Cele mai frecvente situații: o iconiță făcută dintr-un span gol cu aria-label, un card div căruia i s-a pus o „descriere” pentru cititorul de ecran, sau un div folosit ca buton. Reparația depinde de intenție: rol potrivit (role="img" pentru o iconiță cu sens), element nativ (button, a, nav) sau text vizibil în locul etichetei.
De ce apare: cauzele frecvente
1Iconiță făcută dintr-un span gol
<span class="icon-telefon" aria-label="Telefon"></span> 0722 000 111<span class="icon-telefon" role="img" aria-label="Telefon"></span> 0722 000 111Un span are rolul generic, care nu are voie să primească nume. Cu role="img", iconița devine o imagine cu text alternativ, iar aria-label este permis.
2Div folosit ca buton
<div class="inchide" aria-label="Închide" onclick="inchide()">x</div><button type="button" class="inchide" aria-label="Închide" onclick="inchide()">x</button>Un button are rol interactiv, primește nume, focus din tastatură și se activează cu Enter. Div-ul nu are nimic din toate acestea.
3„Descriere” pusă pe un card
<div class="card" aria-label="Card cu oferta zilei">
<h2>Oferta zilei</h2>
</div><div class="card">
<h2>Oferta zilei</h2>
</div>Titlul vizibil descrie deja cardul. Eticheta în plus de pe un div nu ajută și e citită inconsecvent, deci se șterge.
Repară eroarea, direct în pagină
Validatorul afișează „Possible misuse of “aria-label”.” pentru cele două iconițe din secțiunea de contact. Iconițele au sens (spun ce e fiecare rând), deci păstrează-le eticheta, dar dă fiecărui span.icon rolul potrivit pentru o imagine.
<!DOCTYPE html>
<html lang="ro">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Contact</title>
<style>
body {
font-family: system-ui, Arial, sans-serif;
padding: 20px;
color: #1f2937;
}
.contact p {
margin: 8px 0;
}
.icon {
display: inline-block;
width: 16px;
height: 16px;
border-radius: 50%;
background: #0f766e;
vertical-align: middle;
}
</style>
</head>
<body>
<section class="contact">
<h2>Contact</h2>
<p><span class="icon icon-telefon" aria-label="Telefon"></span> 0722 000 111</p>
<p><span class="icon icon-email" aria-label="E-mail"></span> salut@cafenea-boabe.ro</p>
</section>
</body>
</html>Indiciu
Rolul care face dintr-un span o imagine cu nume este img.
Reparația
<!DOCTYPE html>
<html lang="ro">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Contact</title>
<style>
body {
font-family: system-ui, Arial, sans-serif;
padding: 20px;
color: #1f2937;
}
.contact p {
margin: 8px 0;
}
.icon {
display: inline-block;
width: 16px;
height: 16px;
border-radius: 50%;
background: #0f766e;
vertical-align: middle;
}
</style>
</head>
<body>
<section class="contact">
<h2>Contact</h2>
<p><span class="icon icon-telefon" role="img" aria-label="Telefon"></span> 0722 000 111</p>
<p><span class="icon icon-email" role="img" aria-label="E-mail"></span> salut@cafenea-boabe.ro</p>
</section>
</body>
</html>De ce merge
Un span simplu are rolul generic, pe care ARIA nu-l lasă să primească nume, de aceea validatorul semnala aria-label ca posibilă greșeală, iar unele cititoare de ecran l-ar fi ignorat.
Cu role="img", fiecare iconiță devine o imagine cu text alternativ: cititorul de ecran spune „Telefon, imagine” înainte de număr, iar avertismentul dispare. Vizual, nimic nu se schimbă.
Cum o eviți pe viitor
- Pune
aria-labeldoar pe elemente interactive (button,a,input) sau de reper (nav,section,form) și pe roluri care acceptă nume (img,dialog). - Preferă textul vizibil sau elementele native în locul etichetelor ARIA.
- La iconițele decorative folosește
aria-hidden="true", nuaria-label. - Testează pagina cu un cititor de ecran (NVDA, VoiceOver) când adaugi ARIA.
Întrebări frecvente
Pagina se strică din cauza acestui avertisment?
Nu. Pagina arată și funcționează la fel. Problema este doar pentru cititoarele de ecran, care pot ignora eticheta, deci un utilizator nevăzător poate rata informația.
Și dacă iconița e doar decorativă?
Atunci nu-i pune nume deloc: scoate aria-label și adaugă aria-hidden="true", ca cititorul de ecran să o sară. Textul de lângă ea (numărul de telefon) e suficient.
Erori înrudite
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. The “banner” role is unnecessary for element “header”. Avertisment: ai pus pe un element semantic rolul ARIA pe care îl are deja implicit (header = banner, nav = navigation, footer = contentinfo, main = main). Rolul nu strică nimic, dar este cod în plus. Șterge atributul role de pe aceste elemente. 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. Î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.
