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

An “img” element must have an “alt” attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.

Pe scurt

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): alt descrie 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

Greșit
HTML
<img src="cana-albastra.jpg" width="240" height="160">
Corect
HTML
<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

Greșit
HTML
<img src="val.svg" class="decor">
Corect
HTML
<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

Greșit
HTML
<img src="logo.svg" title="Logo Ceramica">
<img src="logo.svg" atl="Logo Ceramica">
Corect
HTML
<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ă tu

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

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

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

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