img elements must have an alt prop, either with meaningful text, or an empty string for decorative images.
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
<img src={produs.poza} /><img src={produs.poza} alt={produs.nume} />Numele produsului descrie imaginea pentru cine nu o poate vedea.
2Imagine decorativă
<img src="/val.svg" />
<h2>Oferte de vară</h2><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
function Avatar({ src, nume }) {
return <img src={src} alt={nume} />;
}
<Avatar src="/ana.png" />function Avatar({ src, nume = "Utilizator" }) {
return <img src={src} alt={"Fotografia lui " + nume} />;
}Cu o valoare implicită, alt nu ajunge niciodată undefined.
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="".
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.
Reparația
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" alt="" />
{produse.map((p) => (
<figure key={p.id}>
<img className="produs" src={p.poza} alt={p.nume} />
<figcaption>{p.nume}</figcaption>
</figure>
))}
</div>
);
}De ce merge
Fără alt, imaginile nu aveau nicio descriere: un cititor de ecran ar fi citit adresa fișierului, iar regula jsx-a11y/alt-text a semnalat fiecare <img>.
alt={p.nume} dă fiecărei imagini de produs un text care o descrie. Linia decorativă primește alt="", care spune explicit că nu transmite informație, deci tehnologiile de asistare o sar.
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-textRedundant 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
altodată cusrc, 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
The href attribute is required for an anchor to be keyboard accessible. Provide a valid, navigable address as the href value. If you cannot provide an href, but still need the element to resemble a link, use a button and change it with appropriate styles. Regula ESLint jsx-a11y/anchor-is-valid vede un <a> fără href (sau cu href="#") folosit ca buton, cu onClick. Un astfel de link nu poate fi folosit de la tastatură și nu e anunțat corect. Dacă face o acțiune, folosește <button type="button">; dacă duce la o pagină, dă-i href sau folosește <Link to> din React Router. Warning: Invalid ARIA attribute `ariaLabel`. Did you mean `aria-label`? Atributele ARIA se scriu în JSX exact ca în HTML, cu cratimă și litere mici: aria-label, aria-hidden, aria-expanded. Spre deosebire de className sau onClick, ele nu se transformă în camelCase. Scrie aria-label="..." în loc de ariaLabel. Using target="_blank" without rel="noreferrer" (which implies rel="noopener") is a security risk in older browsers: see https://mathiasbynens.github.io/rel-noopener/#recommendations Regula ESLint react/jsx-no-target-blank cere rel="noreferrer" pe linkurile cu target="_blank" către alte site-uri. Fără el, în browserele vechi, pagina deschisă poate controla fereastra ta prin window.opener. Adaugă rel="noreferrer" (sau rel="noopener noreferrer") pe link. Î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.
