모던 웹 개발에서 CSS 변수(Custom Properties)는 스타일 시트의 재사용성과 동적 제어 능력을 극적으로 향상시키는 핵심 도구입니다. 기존 Sass나 Less 같은 전처리기에 의존하던 방식에서 벗어나, 브라우저가 런타임에 직접 이해하고 조작할 수 있는 CSS 변수의 문법과 실전 활용법을 살펴보겠습니다.
1. CSS 변수의 기본 문법과 명명 규칙
CSS 변수는 두 가지 단계로 작동합니다. 하이픈 두 개(--)를 접두어로 사용하여 변수를 선언하고, var() 함수를 사용하여 이를 호출합니다.
.container {
/* 변수 선언 */
--primary-color: #3498db;
--base-padding: 20px;
/* 변수 사용 */
color: var(--primary-color);
padding: var(--base-padding);
}
CSS 변수는 대소문자를 구분하며, 명명 규칙이 매우 자유롭습니다. 숫자로 시작할 수 없는 일반적인 식별자와 달리, 숫자로 시작하거나 한글과 같은 유니코드 문자를 사용하는 것도 가능합니다.
:root {
--메인-테마-색상: #2ecc71;
--10-두께: 10px;
}
.box {
background-color: var(--메인-테마-색상);
border-width: var(--10-두께);
}
2. 대체값(Fallback)과 유효성 검사
변수가 정의되지 않았을 경우를 대비해 var() 함수의 두 번째 인자로 기본값을 지정할 수 있습니다. var(--variable, default-value) 형식을 따릅니다.
.alert {
/* --alert-bg가 정의되지 않았다면 #f8d7da를 사용 */
background-color: var(--alert-bg, #f8d7da);
}
여기서 주의할 점은 변수의 유효성입니다. 만약 변수값이 해당 속성에 적절하지 않은 경우(예: color 속성에 20px 대입), 브라우저는 대체값을 사용하는 대신 해당 속성의 초깃값(Initial value)을 적용합니다.
.invalid-example {
--size: 50px;
background-color: #000;
/* --size는 배경색으로 부적절하므로 background-color는 transparent가 됨 */
background-color: var(--size, #ff0000);
}
3. JavaScript를 이용한 동적 스타일 제어
CSS 변수의 가장 큰 강점은 자바스크립트와의 연동성입니다. getPropertyValue와 setProperty 메소드를 통해 런타임에 스타일을 실시간으로 변경할 수 있습니다.
const rootElement = document.documentElement;
// 변수 값 읽기
const primaryColor = getComputedStyle(rootElement).getPropertyValue('--primary-color');
// 변수 값 수정
rootElement.style.setProperty('--primary-color', '#e74c3c');
4. 전처리기(Sass/Less) 변수와의 차별점
Sass 변수는 컴파일 시점에 정적인 값으로 변환되지만, CSS 변수는 브라우저에서 실시간으로 평가됩니다. 이로 인해 다음과 같은 차이가 발생합니다.
- 동적 스코프와 상속: CSS 변수는 DOM 구조를 따르며 상속됩니다. 부모 요소에서 정의한 변수를 자식 요소에서 재정의하면 해당 자식과 그 하위 노드에만 적용됩니다.
- 미디어 쿼리 대응: Sass 변수는 미디어 쿼리 내부에서 값을 변경해도 외부 구조에 영향을 주지 못하지만, CSS 변수는 미디어 쿼리에 따라 실시간으로 값이 변합니다.
- 상호운용성: 별도의 빌드 도구 없이도 외부 라이브러리와 변수를 공유하거나 조작할 수 있습니다.
5. 실전 사례: 미디어 쿼리를 활용한 반응형 레이아웃
CSS 변수를 사용하면 미디어 쿼리마다 모든 속성을 다시 작성할 필요 없이, 변수 값만 교체하여 효율적인 반응형 웹을 구축할 수 있습니다.
:root {
--grid-gap: 30px;
--column-count: 3;
--title-size: 2.5rem;
}
/* 태블릿 크기 */
@media (max-width: 1024px) {
:root {
--grid-gap: 20px;
--column-count: 2;
}
}
/* 모바일 크기 */
@media (max-width: 600px) {
:root {
--grid-gap: 15px;
--column-count: 1;
--title-size: 1.5rem;
}
}
.main-title {
font-size: var(--title-size);
}
.gallery-grid {
display: grid;
gap: var(--grid-gap);
grid-template-columns: repeat(var(--column-count), 1fr);
}
.item {
background: #f0f0f0;
padding: var(--grid-gap);
border-radius: 8px;
}
위 코드에서 보듯, 미디어 쿼리 내부에서는 변수만 업데이트하고 실제 스타일 정의는 상위에서 한 번만 작성하면 됩니다. 이는 코드의 가독성을 높이고 유지보수 비용을 획기적으로 줄여주는 강력한 패턴입니다.