...
Eroare HTML și CSS · CSS care nu se aplică

var(--culoare) nu se aplică (variabila CSS nu este definită, are alt nume sau nu e în scope)

Pe scurt

O proprietate cu var(--nume) primește valoarea variabilei doar dacă variabila e definită (cu -- în față) pe element sau pe un părinte, cu exact același nume. Altfel, proprietatea devine „invalidă la calcul” și revine la valoarea implicită, fără nicio eroare. Verifică numele și locul definiției.

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

Ce înseamnă

Variabilele CSS (custom properties) se definesc cu două liniuțe, de obicei în :root: --culoare-principala: #0f766e;, și se folosesc cu var(--culoare-principala). Ele se moștenesc: un element vede variabilele definite pe el și pe strămoșii lui.

Când var() nu găsește variabila, CSS nu afișează nicio eroare. Declarația nu este tăiată în DevTools, pentru că sintaxa e corectă; doar valoarea calculată devine cea implicită (fundal transparent, culoare moștenită). De aceea pare că „variabila nu merge”.

Cauzele tipice:

  • o literă greșită în nume (--culoare-princpala); numele țin cont și de majuscule;
  • definiția fără liniuțe: culoare-principala: #0f766e; este o proprietate necunoscută, ignorată;
  • variabila e definită pe un element frate sau copil, nu pe un strămoș;
  • definiția e într-un media query sau într-un fișier CSS care nu se încarcă.

În DevTools → Computed, la hover pe var() vezi valoarea găsită sau mesajul că variabila nu e definită.

De ce apare: cauzele frecvente

1Nume scris greșit la folosire

Greșit
HTML
:root {
  --culoare-principala: #0f766e;
}
.buton {
  background-color: var(--culoare-princpala);
}
Corect
HTML
:root {
  --culoare-principala: #0f766e;
}
.buton {
  background-color: var(--culoare-principala);
}

var() caută exact numele scris. O literă diferită înseamnă altă variabilă, nedefinită.

2Definiție fără cele două liniuțe

Greșit
HTML
:root {
  culoare-principala: #0f766e;
}
Corect
HTML
:root {
  --culoare-principala: #0f766e;
}

Doar numele care încep cu -- sunt variabile. Fără ele, declarația este o proprietate necunoscută și este ignorată.

3Variabilă definită în alt loc din arbore

Greșit
HTML
.antet {
  --accent: #f59e0b;
}
.subsol a {
  color: var(--accent);
}
Corect
HTML
:root {
  --accent: #f59e0b;
}
.subsol a {
  color: var(--accent);
}

Variabila se moștenește doar de copiii lui .antet. Definită în :root, este vizibilă peste tot.

Repară tu

Repară eroarea, direct în pagină

Butonul ar trebui să aibă fundalul definit în variabila --culoare-principala din :root, dar apare fără fundal: în regula .buton, numele variabilei din var() este scris greșit. Corectează-l, ca butonul să folosească variabila definită.

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

      :root {
        --culoare-principala: #0f766e;
      }

      .buton {
        padding: 10px 16px;
        color: #ffffff;
        background-color: var(--culoare-princpala);
        border: 0;
      }
    </style>
  </head>
  <body>
    <button type="button" class="buton">Comandă acum</button>
  </body>
</html>
Indiciu

Compară literă cu literă numele din :root cu cel din var().

Alte forme ale mesajului

  • --culoare-principala is not defined

Cum o eviți pe viitor

  • Definește variabilele globale într-un singur loc, în :root, la începutul CSS-ului.
  • Folosește autocompletarea editorului pentru numele variabilelor, nu le tasta de fiecare dată.
  • Pune o valoare de rezervă: var(--culoare-principala, #0f766e) e folosită dacă variabila lipsește.
  • Verifică în DevTools → Computed valoarea reală a proprietății.

Întrebări frecvente

De ce nu apare nicio eroare dacă variabila nu există?

Pentru că sintaxa var(--orice) este mereu validă când CSS-ul este citit. Abia la calculul valorii browserul constată că variabila lipsește și folosește valoarea implicită a proprietății.

Pot folosi variabile în media queries?

Nu în condiția media query-ului (@media (max-width: var(--x)) nu funcționează). Poți însă redefini variabilele în interiorul unui media query, iar toate regulile care le folosesc se actualizează.

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.