...
Eroare HTML și CSS · Validatorul HTML: atribute, id-uri și imagini

Possible misuse of “aria-label”. (If you disagree with this warning, file an issue report or send e-mail to www-validator@w3.org.)

Pe scurt

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

Greșit
HTML
<span class="icon-telefon" aria-label="Telefon"></span> 0722 000 111
Corect
HTML
<span class="icon-telefon" role="img" aria-label="Telefon"></span> 0722 000 111

Un 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

Greșit
HTML
<div class="inchide" aria-label="Închide" onclick="inchide()">x</div>
Corect
HTML
<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

Greșit
HTML
<div class="card" aria-label="Card cu oferta zilei">
  <h2>Oferta zilei</h2>
</div>
Corect
HTML
<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ă tu

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.

Codul care dă eroarea
HTML
<!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.

Cum o eviți pe viitor

  • Pune aria-label doar 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", nu aria-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

← Toate erorile HTML și CSS

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

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