카드 안쪽 여백은 세 단위, 알림은 두 단위가 필요하다. 일반 CSS로 계산할 수 있다. 예제는 다음 HTML을 함께 쓴다.
<article class="site-card">
<h2>설치 가이드</h2>
<p>프로젝트의 첫 페이지부터 시작하세요.</p>
</article>
<aside class="site-notice">
<h2>버전 안내</h2>
<p>업데이트 전에 변경 기록을 확인하세요.</p>
</aside>:root {
--space-unit: 0.5rem;
}
.site-card {
padding: calc(var(--space-unit) * 3);
}
.site-notice {
padding: calc(var(--space-unit) * 2);
}루트 글자 크기가 16px이면 한 단위는 8px, 여백은 24px과 16px이다. 이 두 계산만 필요하다면 원래 코드를 남겨도 된다. 여러 컴포넌트가 수식을 함께 관리해야 할 때 함수 이름을 붙인다.
:root {
--space-unit: 0.5rem;
}
@function --space(--steps <number>: 1, --unit <length>: 0.5rem)
returns <length> {
result: calc(var(--steps) * var(--unit));
}
.site-card {
padding: --space(3, var(--space-unit));
}
.site-notice {
padding: --space(2, var(--space-unit));
}함수로 바꿔도 결과는 24px과 16px이다. 계산에 이름이 생기고 배수와 단위를 호출하는 곳에서 전달한다는 점이 달라진다. 아래 예제는 Chrome 139부터 제공된 @function 지원을 전제로 한다. 16px은 비교 조건이며 사용자 글자 크기를 고정하라는 뜻이 아니다. 여러 브라우저를 위한 기본 스타일은 마지막에 제시한다.
인수를 쓰면 의존성도 보인다
함수와 매개변수 이름은 --로 시작한다. 속성 값에 padding: --space(...)라고 직접 쓴다. @apply나 var(--space(...))는 필요 없다. var(--steps)는 매개변수를 읽고, result는 결과를, returns <length>는 출력 타입을 정한다. 함수 정의
--space()는 0.5rem, --space(3)은 1.5rem, --space(3, 6px)은 18px이다. <length>에는 백분율이 포함되지 않는다. 타입과 기본값은 생략할 수 있지만 남겨 두면 받을 수 있는 입력이 분명해진다.
기본값 0.5rem은 함수 정의에 적힌 값이다. 루트의 --space-unit을 0.75rem으로 바꿔도 자동으로 바뀌지 않는다. token을 쓰려면 var(--space-unit)을 전달해야 한다. 특히 다른 사람이 관리할 공통 함수라면 의존성을 명시하는 방식부터 선택하겠다.
단위를 바꿨는데 왜 여전히 24px일까?
다음 CSS를 앞의 HTML과 독립적으로 사용하자. 카드의 단위는 0.25rem으로 바뀌지만 여백은 24px이다.
:root {
--space-unit: 0.5rem;
--card-space: calc(var(--space-unit) * 3);
}
.site-card {
--space-unit: 0.25rem;
padding: var(--card-space);
}--card-space 안의 var(--space-unit)은 루트에서 먼저 해석된 뒤 상속된다. 카드의 새 단위가 루트의 참조를 다시 계산하지 않는다. 사용자 지정 속성의 평가와 상속
카드 자체에 calc(var(--space-unit) * 3)을 쓰면 카드의 단위를 사용하게 된다. 계산을 함께 관리할 필요가 있다면 사용하는 요소의 단위를 읽는 함수로 만들 수도 있다.
:root {
--space-unit: 0.5rem;
}
@function --local-space(--steps <number>: 1) returns <length> {
result: calc(var(--space-unit, 0.5rem) * var(--steps));
}
.site-card {
--space-unit: 0.25rem;
padding: --local-space(3);
}
.site-notice {
padding: --local-space(2);
}카드는 12px, 알림은 16px이 된다. 함수 안에 --space-unit이라는 매개변수나 지역 변수가 없으므로 사용 요소의 사용자 지정 속성을 읽는다. 함수 스코프
앞의 --space(3, var(--space-unit))에 카드의 0.25rem을 명시적으로 넘겨도 12px이다. --local-space(3)은 짧지만 외부 의존성을 숨기므로 사용 규약에 밝혀야 한다. 같은 이름의 매개변수나 지역 변수는 외부 값을 가린다. 인수가 하나 적다고 추적하기 쉬운 것은 아니다.
result는 중간에 반환하지 않는다
다음 버전은 viewport가 40rem 이하일 때 간격을 4분의 3으로 줄인다. 예제의 배치 결정이며 모바일의 일반 정의가 아니다.
:root {
--space-unit: 0.5rem;
}
@function --responsive-space(--steps <number>: 1) returns <length> {
--density: 1;
@media (width <= 40rem) {
--density: 0.75;
}
result: calc(var(--space-unit, 0.5rem) * var(--steps) * var(--density));
}
.site-card {
padding: --responsive-space(3);
}
.site-notice {
padding: --responsive-space(2);
}루트와 기본 글자 크기가 모두 16px이면 800px 화면에서 24px과 16px, 600px 화면에서 18px과 12px을 얻는다. --density는 함수 안의 지역 변수이며 다른 CSS가 요소에서 읽을 token이 되지 않는다.
미디어 조건이 바꾸는 것은 평가에 참여하는 선언이다. result가 중간에 실행을 끝내는 명령이 되지는 않는다. 다음 함수는 좁은 화면 조건이 맞아도 1rem을 낸다.
@function --always-one() returns <length> {
@media (width <= 40rem) {
result: 0.75rem;
}
result: 1rem;
}뒤의 result가 앞의 값을 덮는다. JavaScript의 return처럼 첫 결과에서 멈추지 않는다. 실행 모델과 조건
기본값을 앞에, 조건별 덮어쓰기를 뒤에 두거나 앞 예제처럼 지역 변수로 마지막 식을 하나만 쓰겠다. 두 컴포넌트가 같은 폭 조건을 공유하지 않는다면 미디어 쿼리도 각 규칙에 남긴다.
앞선 padding이 모든 오류의 대안은 아니다
다음 함수는 배수에 기본값이 없는데 red를 받는다.
@function --strict-space(--steps <number>) returns <length> {
result: calc(var(--steps) * 0.5rem);
}
.site-card {
padding: 24px;
padding: --strict-space(red);
}지원 브라우저에서는 <number>에 맞지 않아 계산값 단계에서 무효가 된다. padding은 초기값 0이 되며 앞의 24px 선언을 다시 선택하지 않는다. 필수 인수를 생략한 --strict-space()도 실패한다. 다른 속성은 각자의 상속 동작을 따라야 하므로 모두 0이라고 생각하면 안 된다. 계산값 단계의 무효화
기본값이 있으면 다르다. 앞의 --space()는 배수 기본값이 1이므로 --space(red)는 이를 사용해 0.5rem을 낸다. 인수 평가 규칙이 허용하는 동작이라 잘못된 호출도 정상처럼 보일 수 있다.
함수의 타입 검사를 통과해도 값을 사용하는 속성의 제약은 남는다. 음수는 <number>에 맞고 음수 길이는 margin에 쓸 수 있지만 padding에는 쓸 수 없다. 함수가 길이를 내는지만 보지 말고 호출 위치도 확인해야 한다.
도입할 때 어떤 기본 스타일을 남길까?
2026년 10월 30일 재확인한 MDN 호환성 데이터에서도 Chrome·Chrome Android와 Edge는 139부터 지원하고, Firefox는 미지원, Safari·iOS Safari는 preview로 기록되어 있다. preview가 안정 버전에 널리 제공된다는 뜻은 아니다. CSSWG 편집 초안도 바뀔 수 있다.
여러 브라우저의 화면을 유지하려면 기존 계산을 기본값으로 두고 향상된 버전을 분리할 수 있다. 다음은 전체 CSS다.
:root {
--space-unit: 0.5rem;
}
.site-card {
padding: calc(var(--space-unit) * 3);
}
.site-notice {
padding: calc(var(--space-unit) * 2);
}
@supports at-rule(@function) {
@function --space(--steps <number>: 1, --unit <length>: 0.5rem)
returns <length> {
result: calc(var(--steps) * var(--unit));
}
.site-card {
padding: --space(3, var(--space-unit));
}
.site-notice {
padding: --space(2, var(--space-unit));
}
}at-rule(@function) 쿼리 자체도 지원이 필요하다. 함수를 실행할 수 있어도 쿼리를 모르면 기본 스타일을 유지한다. 여기서는 두 경로의 외관이 같은 대신 당분간 두 계산을 관리한다.
@supports (padding: --space(3))로 함수 존재 여부를 검사하지 말자. 사용자 지정 함수를 지원하는 엔진은 정의하지 않은 이름에도 true를 반환할 수 있다. 선언을 파싱할 수 있다고 호출이 성공하는 것은 아니다. at-rule()도 개별 인수를 검사하지 않는다.
예제 결과와 기본 스타일은 2026년 10월 27일 로컬 Chromium, Playwright WebKit, CSSFunctions를 끈 Chromium에서 확인했다. Playwright WebKit은 Safari 안정 버전이 아니며, 이 테스트가 Firefox 지원을 입증하지도 않는다.
나는 계산을 함께 관리하려고 함수를 쓰겠다. 모든 연산을 감쌀 필요는 없고 곱셈 두 번이라면 calc()도 충분히 읽기 쉽다. 여러 선언과 중첩 규칙을 묶고 싶다면 다음 @mixin 초안의 문제다. @function의 일은 값 하나를 만드는 데서 끝난다.
