var(--culoare) nu se aplică (variabila CSS nu este definită, are alt nume sau nu e în scope)
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
:root {
--culoare-principala: #0f766e;
}
.buton {
background-color: var(--culoare-princpala);
}: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
:root {
culoare-principala: #0f766e;
}: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
.antet {
--accent: #f59e0b;
}
.subsol a {
color: var(--accent);
}: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ă 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ă.
<!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().
Reparația
<!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-principala);
border: 0;
}
</style>
</head>
<body>
<button type="button" class="buton">Comandă acum</button>
</body>
</html>De ce merge
var(--culoare-princpala) căuta o variabilă care nu există, așa că background-color devenea invalidă la calcul și revenea la valoarea implicită: transparent. CSS nu semnalează asta ca eroare.
Cu numele corect, var(--culoare-principala) găsește variabila definită în :root (moștenită de toate elementele), iar butonul primește fundalul #0f766e. Dacă schimbi culoarea în :root, se schimbă peste tot unde e folosită.
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
CSS: stilul nu se aplică deloc (selectorul nu găsește elementul) Regula e corectă, dar selectorul nu se potrivește cu niciun element: clasa din CSS e scrisă altfel decât în HTML (pret_nou față de pret-nou), lipsește punctul sau ai folosit # pentru o clasă. Fă selectorul identic cu atributul din HTML. Invalid property value DevTools taie declarația și afișează „Invalid property value”: proprietatea există, dar valoarea nu e validă pentru ea, deci browserul o ignoră. Cel mai des lipsește unitatea (width: 300 în loc de 300px) sau valoarea e scrisă greșit. Corectează valoarea. calc() nu funcționează: lipsesc spațiile din jurul lui + și - (Invalid property value) În calc(), operatorii + și - trebuie să aibă spațiu de ambele părți: calc(100% - 240px), nu calc(100%-240px). Fără spații, „-240px” este citit ca un număr negativ lipit de 100%, valoarea e invalidă și declarația este ignorată. Î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.
