...
Eroare React · Atribute, stiluri și evenimente

img elements must have an alt prop, either with meaningful text, or an empty string for decorative images.

Pe scurt

Regula ESLint jsx-a11y/alt-text cere atributul alt pe fiecare <img>. Cititoarele de ecran citesc alt-ul în locul imaginii, iar el apare și când imaginea nu se încarcă. Scrie un text care descrie imaginea (alt="Cană albastră de 300 ml") sau alt="" pentru imaginile pur decorative.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

alt este textul alternativ al unei imagini. Îl folosesc cititoarele de ecran (pentru oamenii cu deficiențe de vedere), browserul când imaginea nu se poate încărca și motoarele de căutare. Fără alt, un cititor de ecran citește de obicei numele fișierului („img_4821.jpg”), ceea ce nu ajută pe nimeni.

Mesajul vine de la ESLint, regula jsx-a11y/alt-text din eslint-plugin-jsx-a11y (inclusă în Create React App, Next.js și configurația Airbnb). Ea cere ca fiecare <img> să aibă alt:

  • cu text descriptiv, dacă imaginea transmite informație (produsul, o diagramă, o persoană);
  • gol (alt=""), dacă e doar decor (un fundal, o linie, o iconiță lângă un text care spune deja același lucru): cititorul de ecran o va sări.

Nu scrie „imagine cu” sau „poză”: cititorul anunță deja că e o imagine. Regula se plânge și de alt={undefined} sau de un alt care lipsește doar uneori, când vine dintr-un prop.

De ce apare: cauzele frecvente

1Imagine de produs fără alt

Greșit
JSX
<img src={produs.poza} />
Corect
JSX
<img src={produs.poza} alt={produs.nume} />

Numele produsului descrie imaginea pentru cine nu o poate vedea.

2Imagine decorativă

Greșit
JSX
<img src="/val.svg" />
<h2>Oferte de vară</h2>
Corect
JSX
<img src="/val.svg" alt="" />
<h2>Oferte de vară</h2>

alt="" spune explicit că imaginea e decor, iar cititorul de ecran o ignoră.

3alt care poate lipsi

Greșit
JSX
function Avatar({ src, nume }) {
  return <img src={src} alt={nume} />;
}
<Avatar src="/ana.png" />
Corect
JSX
function Avatar({ src, nume = "Utilizator" }) {
  return <img src={src} alt={"Fotografia lui " + nume} />;
}

Cu o valoare implicită, alt nu ajunge niciodată undefined.

Repară tu

Repară eroarea, direct în pagină

Cardurile de produs de mai jos nu au text alternativ, iar ESLint spune „img elements must have an alt prop”. Repară-le ca fiecare imagine de produs să aibă ca alt numele produsului (prima: „Cană albastră”), iar linia decorativă .decor să aibă alt="".

Codul care dă eroarea
JSX
const produse = [
  { id: 1, nume: "Cană albastră", poza: "/img/cana.png" },
  { id: 2, nume: "Ceainic", poza: "/img/ceainic.png" },
];

export default function App() {
  return (
    <div>
      <img className="decor" src="/img/val.svg" />
      {produse.map((p) => (
        <figure key={p.id}>
          <img className="produs" src={p.poza} />
          <figcaption>{p.nume}</figcaption>
        </figure>
      ))}
    </div>
  );
}
Indiciu

alt={p.nume} pentru produse și alt="" pentru decor.

Alte forme ale mesajului

  • img elements must have an alt prop, either with meaningful text, or an empty string for decorative images. jsx-a11y/alt-text
  • Redundant alt attribute. Screen-readers already announce `img` tags as an image. You don’t need to use the words `image`, `photo,` or `picture` (or any specified custom words) in the alt prop.
  • Image elements must have an alt prop, either with meaningful text, or an empty string for decorative images.
  • Warning: Using `<img>` could result in slower LCP and higher bandwidth. Consider using `<Image />` from `next/image`

Cum o eviți pe viitor

  • Scrie alt odată cu src, ca pe o pereche obligatorie.
  • Pentru imaginile din date (produse, profiluri), folosește un câmp descriptiv al lor (numele produsului).
  • Pentru decor, pune alt="" și nu lăsa atributul să lipsească.
  • Testează pagina cu un cititor de ecran (VoiceOver, NVDA) sau cu Lighthouse, secțiunea Accessibility.

Întrebări frecvente

E același lucru alt="" și fără alt?

Nu. alt="" înseamnă „imaginea e decor, sari peste ea”. Fără alt, cititorul de ecran nu știe nimic și citește, de obicei, numele fișierului.

Contează alt-ul pentru Google?

Da, Google folosește textul alternativ ca să înțeleagă imaginea, mai ales în căutarea de imagini. Dar scrie-l pentru oameni, nu ca listă de cuvinte-cheie.

Erori înrudite

← Toate erorile React

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ță React de la zero, cu exerciții la fiecare lecție

Curs React: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.