CSS / Tutorial / 변수 사용하는 방법
CSS의 사용자 지정 속성(custom property)은 --이름: 값 형식으로 선언하고 var(--이름)으로 사용합니다. 흔히 CSS 변수라고 부르며, 반복되는 색과 간격을 한 곳에서 관리할 때 유용합니다. 값은 선언된 요소와 자손에 영향을 주고, 자손에서 다시 정의해 범위를 좁힐 수 있습니다.
공통 값 선언하고 사용하기
문서 전역에서 공유할 값은 :root에 선언할 수 있습니다. 이렇게 선언했다고 모든 요소에 자동으로 색이 입혀지는 것은 아니며, 실제 CSS 속성에서 var()로 참조해야 합니다.
:root {
--color-accent: #1d5f91;
--space-card: 1.25rem;
}
.card {
padding: var(--space-card);
border: 2px solid var(--color-accent);
}
값을 바꾸면 이를 참조하는 선언의 계산 결과가 함께 바뀝니다. 그렇지만 무조건 모든 수치를 변수로 만들면 읽기 어려워질 수 있으므로 여러 곳에서 재사용하거나 의미 있는 디자인 값부터 묶으세요.
구성 요소 안에서 값 덮어쓰기
사용자 지정 속성은 기본적으로 상속됩니다. .card에 선언한 값은 그 안의 자손에서 사용할 수 있지만 관계없는 형제 카드까지 전달되지는 않습니다. 자손이나 다른 카드에서 같은 이름을 다시 선언하면 해당 범위에서 새 값을 사용합니다.
.card { --color-accent: #1d5f91; }
.card.warning { --color-accent: #a63e32; }
.card h2 { color: var(--color-accent); }
.card.warning은 두 클래스를 모두 가진 카드에만 일치합니다. HTML의 클래스 순서가 아니라 CSS 선택자의 일치와 캐스케이드가 최종 값을 결정합니다.
값이 없을 때와 잘못된 값일 때
참조한 사용자 지정 속성이 정의되지 않았다면 var(--color, blue)처럼 두 번째 인수로 대체값을 줄 수 있습니다. 그러나 속성이 이미 정의돼 있어도 그 값이 사용하려는 CSS 속성에 맞지 않는다면 대체값이 자동으로 선택되는 것은 아닙니다.
.notice { color: var(--notice-color, #184d77); }
.broken { --notice-color: 20px; color: var(--notice-color, #184d77); }
.broken에서는 --notice-color가 정의돼 있으므로 var()의 대체값이 사용되지 않습니다. 하지만 20px은 color에 적합한 값이 아니므로 해당 선언은 계산 시 유효하지 않게 됩니다. 값이 보이지 않으면 변수가 존재하는지만 보지 말고 실제 참조 속성에 맞는 값인지 개발자 도구에서 확인하세요.
전체 예제로 범위 확인하기
다음 파일을 열면 기본 카드와 경고 카드가 서로 다른 강조색을 사용합니다. :root의 여백을 바꾸면 두 카드에 함께 반영되고, 경고 카드의 색은 그 카드에만 적용됩니다.
<!doctype html>
<html lang="ko">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>CSS 사용자 지정 속성</title>
<style>
:root { --space-card: 1.25rem; }
body { font-family: sans-serif; margin: 2rem; }
.card { --color-accent: #1d5f91; max-width: 22rem; margin-block: 1rem; padding: var(--space-card); border: 2px solid var(--color-accent); }
.card.warning { --color-accent: #a63e32; }
.card h2 { color: var(--color-accent); }
</style>
</head>
<body>
<article class="card"><h2>기본 카드</h2><p>파란 강조색</p></article>
<article class="card warning"><h2>경고 카드</h2><p>붉은 강조색</p></article>
</body>
</html>
더 자세한 상속과 대체값 규칙은 MDN의 사용자 지정 속성 사용 안내를 참고하세요.










