...
Eroare HTML și CSS · Imagini de fundal, video, iframe și CDN

background-image nu apare (elementul gol nu are înălțime sau calea url() este greșită)

Pe scurt

Imaginea de fundal se desenează doar în suprafața elementului. Un div gol are înălțimea 0, deci nu se vede nimic. Dă-i o înălțime (height, min-height sau aspect-ratio). Dacă tot nu apare, verifică în Network calea din url(): e relativă la fișierul CSS, nu la pagină.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

background-image nu creează spațiu: pictează fundalul cutiei existente. Un div fără conținut și fără înălțime are 0px înălțime, deci fundalul există, dar nu are unde să se vadă. În DevTools, la hover pe element, vezi o bară subțire sau nimic.

A doua cauză frecventă este calea. În url() din fișierul css/style.css, calea se calculează față de fișierul CSS, nu față de HTML. Dacă imaginea este în img/cafea.jpg, din css/style.css calea corectă este url("../img/cafea.jpg"). În DevTools → Network vezi cererea cu 404 și adresa exactă încercată.

Alte cauze: lipsesc ghilimelele la o cale cu spații, numele fișierului diferă la majuscule pe hosting (Linux), sau o regulă background: #fff scrisă după a suprascris imaginea (proprietatea scurtă resetează și background-image).

De ce apare: cauzele frecvente

1div gol fără înălțime

Greșit
HTML
.banner {
  background-image: url("img/cafea.jpg");
  background-size: cover;
}
Corect
HTML
.banner {
  background-image: url("img/cafea.jpg");
  background-size: cover;
  min-height: 240px;
}

Cu min-height, cutia are suprafață, iar imaginea o acoperă. aspect-ratio: 16 / 9 este o alternativă care păstrează proporțiile.

2Cale relativă la HTML scrisă în fișierul CSS

Greșit
HTML
/* fișier: css/style.css */
.banner {
  background-image: url("img/cafea.jpg");
}
Corect
HTML
/* fișier: css/style.css */
.banner {
  background-image: url("../img/cafea.jpg");
}

Din folderul css, img/cafea.jpg ar fi css/img/cafea.jpg. ../ urcă la rădăcina proiectului.

3background scurt scris după imagine

Greșit
HTML
.banner {
  background-image: url("../img/cafea.jpg");
  background: #1f2937;
}
Corect
HTML
.banner {
  background: #1f2937 url("../img/cafea.jpg") center / cover;
}

background resetează toate subproprietățile, inclusiv imaginea. Pune totul în proprietatea scurtă sau folosește background-color.

Repară tu

Repară eroarea, direct în pagină

Bannerul .banner are o imagine de fundal cu calea corectă, dar pe pagină nu apare nimic: div-ul este gol și are înălțimea 0. Adaugă în regula .banner o înălțime minimă de 240px, păstrând imaginea, background-size și background-position.

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>Banner</title>
    <style>
      body {
        font-family: system-ui, Arial, sans-serif;
        padding: 20px;
        color: #1f2937;
      }

      .banner {
        background-image: url("img/cafea.jpg");
        background-size: cover;
        background-position: center;
      }
    </style>
  </head>
  <body>
    <div class="banner"></div>
    <h1>Cafeneaua din centru</h1>
  </body>
</html>
Indiciu

Un element gol are nevoie de o dimensiune pentru ca fundalul să se vadă.

Alte forme ale mesajului

  • GET http://127.0.0.1:5500/css/img/cafea.jpg 404 (Not Found)
  • Imaginea de fundal nu se vede, deși calea este corectă

Cum o eviți pe viitor

  • Când elementul nu are conținut, dă-i mereu o dimensiune: min-height, height sau aspect-ratio.
  • În fișierele CSS, gândește căile pornind din folderul fișierului CSS.
  • Folosește background-color când vrei doar o culoare, ca să nu resetezi imaginea.
  • Verifică în DevTools → Network (filtrul Img) dacă imaginea a fost cerută și ce răspuns a primit.

Întrebări frecvente

Cum fac imaginea de fundal să acopere tot elementul fără să se deformeze?

Cu background-size: cover și background-position: center. Imaginea este mărită cât să acopere cutia, iar ce iese în afară este tăiat egal pe margini.

Când folosesc img și când background-image?

img (cu alt) pentru imagini care fac parte din conținut. background-image pentru decor: texturi, bannere peste care pui text. Imaginile de fundal nu sunt citite de cititoarele de ecran.

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.