Empty heading.
Un titlu (h1–h6) nu are niciun text: e gol sau conține doar o imagine cu alt="" ori o iconiță. Cititoarele de ecran anunță un titlu fără nume. Scrie text în titlu sau dă imaginii din el un alt descriptiv; dacă titlul e doar spațiere, șterge-l și folosește margin.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
„Empty heading.” este un avertisment al validatorului: a găsit un h1, h2... h6 al cărui nume accesibil este gol. Contează textul din titlu și textul alternativ al imaginilor din el, deci un titlu care conține doar <img alt=""> sau o iconiță SVG fără etichetă este tot „gol”.
Titlurile sunt cuprinsul paginii: utilizatorii de cititoare de ecran sar de la un titlu la altul, iar Google le folosește ca să înțeleagă subiectul. Un h1 gol înseamnă că pagina nu are titlu principal.
Cauze frecvente:
- logo-ul pus în
h1cualt=""; - un
h2gol lăsat ca „spațiu” între secțiuni; - un titlu completat din JavaScript, care e gol în HTML-ul inițial.
Repară dând titlului un text real: alt descriptiv pentru imagine, text vizibil sau ascuns vizual cu o clasă .sr-only.
De ce apare: cauzele frecvente
1Logo în h1 cu alt gol
<h1><img src="logo.svg" alt=""></h1><h1><img src="logo.svg" alt="Cafeneaua Boabe"></h1>Textul alternativ devine numele titlului, deci h1 spune cum se numește site-ul.
2Titlu gol folosit pentru spațiere
<section>...</section>
<h2></h2>
<section>...</section><section class="cu-spatiu">...</section>
<section>...</section>Spațiul dintre secțiuni se face din CSS cu margin. Un titlu gol strică cuprinsul paginii.
Repară eroarea, direct în pagină
Titlul principal h1 conține doar logo-ul, cu alt="", iar validatorul spune „Empty heading.”. Dă imaginii din h1 textul alternativ Cafeneaua Boabe, ca titlul principal să aibă un nume.
<!DOCTYPE html>
<html lang="ro">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Cafeneaua Boabe</title>
<style>
body {
font-family: system-ui, Arial, sans-serif;
padding: 20px;
color: #1f2937;
}
</style>
</head>
<body>
<header>
<h1><img src="logo.svg" alt="" width="160" height="40"></h1>
</header>
<main>
<h2>Meniul zilei</h2>
<p>Supă de legume și plăcintă cu brânză.</p>
</main>
</body>
</html>Indiciu
Textul alternativ al imaginii devine textul titlului.
Reparația
<!DOCTYPE html>
<html lang="ro">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Cafeneaua Boabe</title>
<style>
body {
font-family: system-ui, Arial, sans-serif;
padding: 20px;
color: #1f2937;
}
</style>
</head>
<body>
<header>
<h1><img src="logo.svg" alt="Cafeneaua Boabe" width="160" height="40"></h1>
</header>
<main>
<h2>Meniul zilei</h2>
<p>Supă de legume și plăcintă cu brânză.</p>
</main>
</body>
</html>De ce merge
Numele unui titlu se calculează din textul lui și din textul alternativ al imaginilor din el. Cu alt="", imaginea era marcată ca decorativă, deci h1 nu avea niciun nume și pagina rămânea fără titlu principal.
Cu alt="Cafeneaua Boabe", logo-ul arată la fel, dar cititorul de ecran anunță „titlu nivel 1, Cafeneaua Boabe”, iar validatorul nu mai dă avertismentul.
Cum o eviți pe viitor
- Fiecare titlu trebuie să aibă text, vizibil sau ca
altal imaginii din el. - Nu folosi titluri pentru spațiere sau pentru text mare: pentru aspect folosește CSS.
- Dacă titlul se completează din JavaScript, pune în HTML un text implicit.
- Verifică structura titlurilor cu validatorul sau cu panoul Accessibility din DevTools.
Întrebări frecvente
E bine să pun logo-ul în h1?
Pe pagina principală e o practică întâlnită des și e în regulă, dacă imaginea are alt cu numele site-ului. Pe celelalte pagini e mai bine ca h1 să fie titlul paginii (de exemplu numele produsului).
Ce este o clasă sr-only?
O clasă care ascunde textul vizual, dar îl lasă disponibil pentru cititoarele de ecran (prin position: absolute, dimensiune de 1px și clip). E utilă când titlul este doar o iconiță.
Erori înrudite
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. Heading cannot be a child of another heading. Ai deschis un titlu (h1–h6) în interiorul altui titlu, de obicei pentru că ai scris <h1> în loc de </h1> la închidere. Parserul închide automat primul titlu și deschide unul nou, care înghite textul de după. Verifică închiderea titlului: </h1>, cu bară. Section lacks heading. Consider using “h2”-“h6” elements to add identifying headings to all sections, or else use a “div” element instead for any cases where no heading is needed. Este un avertisment: ai folosit <section> fără niciun titlu în interior. O secțiune înseamnă o parte de conținut cu temă proprie, deci are nevoie de un titlu h2–h6. Adaugă titlul sau, dacă elementul e doar pentru așezare în pagină, folosește <div>. Î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.
