When the “srcset” attribute has any image candidate string with a width descriptor, the “sizes” attribute must also be present.
Ai pus în srcset imagini cu lățimi (400w, 800w), dar nu ai spus cât de lată va fi imaginea în pagină. Fără sizes, browserul presupune că imaginea ocupă toată lățimea ecranului (100vw) și poate descărca o variantă prea mare. Adaugă sizes, de exemplu sizes="(max-width: 800px) 100vw, 800px".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În srcset, descriptorul w spune cât de lat este fișierul (cafea-800.jpg 800w are 800 de pixeli). Ca să aleagă varianta potrivită, browserul are nevoie și de a doua informație: cât de lată va fi imaginea afișată. Aceasta vine din sizes, iar mesajul validatorului spune că lipsește.
Browserul nu poate aștepta CSS-ul ca să afle lățimea, pentru că alege fișierul înainte de layout. Fără sizes, presupune 100vw. Pe un laptop cu ecran de 1440px și densitate 2, asta înseamnă că descarcă varianta de 1600px pentru o imagine care, în articol, are doar 800px. Pagina se încarcă mai greu, fără niciun câștig vizibil.
sizes este o listă de condiții media urmate de o lățime: (max-width: 800px) 100vw, 800px înseamnă „pe ecrane de până la 800px imaginea ocupă tot ecranul, altfel are 800px”. Dacă variantele diferă doar prin densitate, folosește descriptori x (cafea@2x.jpg 2x), care nu au nevoie de sizes.
De ce apare: cauzele frecvente
1srcset cu w fără sizes
<img src="cafea-800.jpg"
srcset="cafea-400.jpg 400w, cafea-800.jpg 800w"
alt="Cafea"><img src="cafea-800.jpg"
srcset="cafea-400.jpg 400w, cafea-800.jpg 800w"
sizes="(max-width: 800px) 100vw, 800px"
alt="Cafea">Cu sizes, browserul calculează lățimea afișată și alege cel mai mic fișier suficient de clar.
2Logo de lățime fixă descris cu w
<img src="logo.png"
srcset="logo.png 160w, logo@2x.png 320w"
alt="Boabe"><img src="logo.png"
srcset="logo.png 1x, logo@2x.png 2x"
width="160" height="40" alt="Boabe">Pentru o imagine cu lățime fixă, descriptorii de densitate 1x și 2x sunt mai simpli și nu cer sizes.
Repară eroarea, direct în pagină
Imaginea are srcset cu descriptori 400w, 800w, 1600w, dar fără sizes, iar validatorul spune „the “sizes” attribute must also be present”. Adaugă imaginii sizes="(max-width: 800px) 100vw, 800px": pe ecrane mici ocupă tot ecranul, altfel are 800px.
<!DOCTYPE html>
<html lang="ro">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Ghid</title>
<style>
body {
font-family: system-ui, Arial, sans-serif;
padding: 20px;
color: #1f2937;
}
img {
max-width: 100%;
height: auto;
}
</style>
</head>
<body>
<article>
<h1>Ghid de cafea la filtru</h1>
<img src="img/cafea-800.jpg"
srcset="img/cafea-400.jpg 400w, img/cafea-800.jpg 800w, img/cafea-1600.jpg 1600w"
alt="Ceașcă de cafea la filtru pe o masă de lemn" width="800" height="533">
</article>
</body>
</html>Indiciu
sizes descrie lățimea afișată a imaginii, nu a fișierelor.
Reparația
<!DOCTYPE html>
<html lang="ro">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Ghid</title>
<style>
body {
font-family: system-ui, Arial, sans-serif;
padding: 20px;
color: #1f2937;
}
img {
max-width: 100%;
height: auto;
}
</style>
</head>
<body>
<article>
<h1>Ghid de cafea la filtru</h1>
<img src="img/cafea-800.jpg"
srcset="img/cafea-400.jpg 400w, img/cafea-800.jpg 800w, img/cafea-1600.jpg 1600w"
sizes="(max-width: 800px) 100vw, 800px"
alt="Ceașcă de cafea la filtru pe o masă de lemn" width="800" height="533">
</article>
</body>
</html>De ce merge
Descriptorii 400w, 800w, 1600w spun cât de late sunt fișierele, dar browserul trebuie să știe și cât de lată va fi imaginea în pagină. Fără sizes, presupunea că ocupă tot ecranul și descărca adesea varianta de 1600px.
Cu sizes="(max-width: 800px) 100vw, 800px", browserul știe că imaginea are cel mult 800px și alege cea mai mică variantă clară pentru ecranul și densitatea dispozitivului.
Cum o eviți pe viitor
- Folosește descriptori
xpentru imagini cu lățime fixă (logo, avatar) și descriptoriwdoar împreună cusizes. - Scrie
sizesdupă layout-ul tău: aceleași praguri ca media queries, cu lățimea reală a imaginii la fiecare. - Verifică în DevTools → Network ce fișier s-a descărcat la diferite lățimi de ecran.
- Pune și
widthșiheightpe imagine, ca pagina să nu sară la încărcare.
Întrebări frecvente
Ce valoare pun în sizes dacă imaginea e într-o grilă cu 3 coloane?
Lățimea unei coloane: de exemplu sizes="(max-width: 600px) 100vw, 33vw". Nu trebuie să fie exactă la pixel, o aproximare bună e suficientă pentru alegerea fișierului.
Ce este sizes="auto"?
O valoare nouă, valabilă doar pentru imaginile cu loading="lazy": browserul folosește lățimea din layout, pentru că oricum o află înainte să încarce imaginea. Nu toate browserele o suportă încă, așa că pune și o valoare de rezervă.
Erori înrudite
Imaginea iese din ecran pe telefon și apare scroll orizontal O imagine cu lățime fixă (atributul width="1200" sau width: 1200px în CSS) nu se micșorează pe ecrane înguste și împinge pagina în lateral. Pune img { max-width: 100%; height: auto; }: imaginea nu mai depășește containerul și își păstrează proporțiile. Element “img” is missing required attribute “src”. Un <img> nu are atributul src, deci browserul nu știe ce imagine să încarce și afișează doar textul alternativ sau nimic. Adaugă src cu calea imaginii; dacă folosești lazy loading, folosește loading="lazy", nu data-src fără script. Image elements do not have explicit width and height Imaginile nu au atributele width și height, așa că browserul nu știe cât loc să le rezerve până nu se descarcă, iar textul de sub ele sare în jos (layout shift, CLS). Pune pe fiecare img width și height cu dimensiunile reale ale fișierului; cu height: auto în CSS, imaginea rămâne responsivă. Î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.
