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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Validatorul îți cere un text alternativ pentru imagine. Atributul alt este folosit de cititoarele de ecran (persoanele nevăzătoare „aud” imaginea), de browser când imaginea nu se încarcă (afișează textul în locul ei) și de Google Images.
„Except under certain conditions” se referă la cazuri rare (de exemplu imagini cu figcaption care le descrie în anumite contexte); în practică, pune alt la orice img.
Două situații:
- imagine cu informație (produs, grafic, logo cu link):
altdescrie ce transmite imaginea, scurt; - imagine decorativă (separator, fundal ornamental):
alt="", gol, ca cititorul de ecran să o sară.
Lipsa completă a atributului este cea mai rea variantă: unele cititoare de ecran citesc atunci numele fișierului.
De ce apare: cauzele frecvente
1Imagine de produs fără alt
<img src="cana-albastra.jpg" width="240" height="160"><img src="cana-albastra.jpg" alt="Cană de ceramică albastră, de 300 ml" width="240" height="160">Descrierea transmite ce ar vedea omul în imagine. Fără ea, imaginea nu există pentru cine nu o vede.
2Imagine decorativă fără alt gol
<img src="val.svg" class="decor"><img src="val.svg" class="decor" alt="">alt="" spune explicit că imaginea e decorativă. Validatorul acceptă alt-ul gol; lipsa atributului, nu.
3alt scris greșit sau pus în title
<img src="logo.svg" title="Logo Ceramica">
<img src="logo.svg" atl="Logo Ceramica"><img src="logo.svg" alt="Ceramica, pagina principală">title nu înlocuiește alt, iar un atribut scris greșit (atl) este ignorat și mai dă și eroarea „Attribute “atl” not allowed”.
Repară eroarea, direct în pagină
Validatorul raportează „An “img” element must have an “alt” attribute” pentru ambele imagini. Adaugă alt="Cană de ceramică albastră" la imaginea produsului (img.produs) și alt="" (gol) la linia decorativă (img.decor).
<!DOCTYPE html>
<html lang="ro">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Cană albastră</title>
<style>
body {
font-family: system-ui, Arial, sans-serif;
padding: 20px;
color: #1f2937;
}
.decor {
display: block;
margin: 12px 0;
}
</style>
</head>
<body>
<h1>Cană de ceramică</h1>
<img class="produs" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='240' height='160'%3E%3Crect width='240' height='160' fill='%233b82f6'/%3E%3C/svg%3E" width="240" height="160">
<img class="decor" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='240' height='6'%3E%3Crect width='240' height='6' fill='%23cbd5e1'/%3E%3C/svg%3E" width="240" height="6">
<p>Preț: 35 lei</p>
</body>
</html>Indiciu
Imaginea decorativă primește tot atributul alt, dar fără text.
Reparația
<!DOCTYPE html>
<html lang="ro">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Cană albastră</title>
<style>
body {
font-family: system-ui, Arial, sans-serif;
padding: 20px;
color: #1f2937;
}
.decor {
display: block;
margin: 12px 0;
}
</style>
</head>
<body>
<h1>Cană de ceramică</h1>
<img class="produs" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='240' height='160'%3E%3Crect width='240' height='160' fill='%233b82f6'/%3E%3C/svg%3E" alt="Cană de ceramică albastră" width="240" height="160">
<img class="decor" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='240' height='6'%3E%3Crect width='240' height='6' fill='%23cbd5e1'/%3E%3C/svg%3E" alt="" width="240" height="6">
<p>Preț: 35 lei</p>
</body>
</html>De ce merge
Imaginea produsului transmite o informație (ce cană cumperi), deci primește o descriere scurtă. Linia decorativă nu spune nimic, deci primește alt="": cititorul de ecran o sare, iar validatorul e mulțumit.
Diferența dintre alt="" și lipsa atributului contează: fără atribut, tehnologiile asistive nu știu dacă imaginea e decorativă sau doar nedescrisă și pot citi numele fișierului.
Alte forme ale mesajului
An img element must have an alt attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.
Cum o eviți pe viitor
Scrie alt în același timp cu src, nu „mai târziu”. Pune-ți întrebarea: dacă imaginea ar dispărea, ce informație s-ar pierde? Acea informație este alt-ul. Pentru imagini decorative pune alt="", iar pentru logo-ul care e link spre prima pagină descrie destinația („Ceramica, pagina principală”). Nu începe cu „Imagine cu...”: cititorul de ecran anunță deja că e o imagine.
Întrebări frecvente
Cât de lung trebuie să fie alt-ul?
De obicei o propoziție scurtă, sub 125 de caractere. Pentru grafice sau infografice complexe, pune un rezumat în alt și detaliile în text, lângă imagine.
Ajută alt-ul la SEO?
Da, Google folosește alt-ul ca să înțeleagă imaginea, mai ales în Google Images. Scrie-l însă pentru oameni, nu umple-l cu cuvinte-cheie.
Erori înrudite
Bad value “img/cana albastra.jpg” for attribute “src” on element “img”: Illegal character in path segment: space is not allowed. Calea din src (sau href) conține un spațiu, iar într-un URL spațiul nu e permis. Redenumește fișierul fără spații (cana-albastra.jpg) și actualizează calea. Ca soluție de moment, spațiul se poate scrie %20, dar numele fără spații e varianta corectă. GET http://127.0.0.1:5500/img/Logo.PNG 404 (Not Found) Imaginea nu există la adresa din src, așa că apare iconița de imagine spartă. Des, diferența e la litere mari și mici (Logo.PNG față de logo.png) sau la folder. Scrie în src numele exact al fișierului. Duplicate attribute “class”. Ai scris atributul class de două ori pe același element. Browserul îl păstrează doar pe primul și îl ignoră pe al doilea, așa că a doua clasă nu se aplică. Pune toate clasele într-un singur atribut, separate prin spațiu: class="card recomandat". Î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.
