...
Eroare HTML și CSS · Lighthouse: accesibilitate, SEO și performanță

Buttons do not have an accessible name

Pe scurt

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, alt descriptiv.

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

Greșit
HTML
<button class="cos">
  <svg aria-hidden="true">...</svg>
</button>
Corect
HTML
<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

Greșit
HTML
<a href="https://facebook.com/florariairis">
  <i class="fa fa-facebook"></i>
</a>
Corect
HTML
<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

Greșit
HTML
<button><img src="cauta.svg" alt=""></button>
Corect
HTML
<button><img src="cauta.svg" alt="Caută"></button>

Textul alternativ al imaginii devine numele butonului.

Repară tu

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.

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

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-label sau alt?
  • 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

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