...
Eroare HTML și CSS · Validatorul HTML: structura documentului

Empty heading.

Pe scurt

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 h1 cu alt="";
  • un h2 gol 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

Greșit
HTML
<h1><img src="logo.svg" alt=""></h1>
Corect
HTML
<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

Greșit
HTML
<section>...</section>
<h2></h2>
<section>...</section>
Corect
HTML
<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ă tu

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.

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

Cum o eviți pe viitor

  • Fiecare titlu trebuie să aibă text, vizibil sau ca alt al 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

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