@mixin이 하려는 일은 작은 예제로 보인다. 테두리 스타일을 한 번 정의하고 두 선택자에서 각각 적용한다.

/* Draft syntax: definition and application */
@mixin --panel-frame() {
  border: 1px solid #777777;
  border-radius: 0.5rem;
  padding: 1.5rem;
}
 
.site-card {
  @apply --panel-frame();
}
 
.site-notice {
  @apply --panel-frame();
}

--panel-frame은 mixin 이름이고 @apply는 적용할 위치다. 재사용 단위는 선언 묶음이다. @function은 값 하나를 계산해 padding 같은 속성에 넘긴다.

정의할 곳과 적용할 곳

정의 규칙에 따르면 이름은 --로 시작하고 일반 스타일 규칙 안에는 mixin을 정의할 수 없다. 그래서 예제는 최상위에 정의하고 .site-card, .site-notice 안에서 적용한다. @apply는 스타일 규칙이나 그 안의 중첩 그룹 규칙에서 쓴다.

인수가 없으면 @apply --panel-frame;처럼 괄호를 생략할 수 있다. 여기서는 다음에 인수를 추가하기 쉽게 남겼다. 기존 class가 아니라 정의된 mixin 이름을 참조한다.

첫 예제를 ‘여기에 이 규칙 묶음을 넣는다’고 읽으면 두 컴포넌트가 외곽 스타일을 공유하는 방식을 이해할 수 있다. 매개변수를 추가한 뒤에는 그 값이 어디서 보이는지도 따라가야 한다. 문자열 치환만으로는 이 스코프를 설명할 수 없다. 적용된 스타일에는 출처, layer, 명시도, 순서를 포함한 cascade가 그대로 작동한다.

두 차이를 호출 위치에 남기기

글 카드와 버전 알림은 모서리 반경을 공유하고 테두리와 제목은 같은 강조색을 쓴다고 하자. 알림의 안쪽 여백은 더 좁다. 이후 예제는 이 HTML을 쓴다.

<article class="site-card">
  <h2 class="site-panel-title">Installation guide</h2>
  <p>Start with your project's first page.</p>
</article>
 
<aside class="site-notice">
  <h2 class="site-panel-title">Release notice</h2>
  <p>Read the changelog before upgrading.</p>
</aside>

처음 CSS를 다음으로 대체한다. 매개변수는 색과 여백만 받고 모서리는 공통으로 둔다.

/* Draft syntax: parameters, defaults, and nested rules */
@mixin --panel-frame(
  --accent <color>: #777777,
  --space <length>: 1.5rem
) {
  border: 1px solid var(--accent);
  border-radius: 0.5rem;
  padding: var(--space);
 
  & > .site-panel-title {
    margin-block: 0 0.75rem;
    color: var(--accent);
  }
}
 
.site-card {
  @apply --panel-frame();
}
 
.site-notice {
  @apply --panel-frame(#45687d, 1rem);
}

카드는 기본값, 알림은 #45687d와 1rem을 쓴다. --accent <color>는 색, --space <length>는 길이를 받으며 콜론 뒤는 기본값이다. 백분율은 이 <length>에 포함되지 않는다. 매개변수 문법

이 mixin은 색과 여백뿐 아니라 구조도 공유한다. .site-panel-title이 직계 자식이어야 한다는 조건이다. 카드 제목을 다른 요소로 감싸면 제목 규칙은 더 이상 일치하지 않는다. 그때는 제목과 외곽 스타일을 나누겠다. 그렇지 않으면 내부 구조가 하나 늘 때마다 단순한 외곽 스타일까지 고쳐야 한다.

var()로 읽는다고 매개변수가 일반 공개 사용자 지정 속성으로 요소에 추가되는 것은 아니다. 초안에서는 같은 이름의 외부 값을 가리는 private property이며 적용 요소와 자손에게만 값이 보인다. & + * 같은 형제 선택자로 바꾸면 전달한 색을 형제도 읽는다고 가정할 수 없다. 매개변수와 스코프

@contents로 호출자의 스타일을 받을 자리 만들기

조건도 재사용할 수 있다. 두 컴포넌트가 같은 viewport 폭에서 좁은 배치로 바뀌지만 카드는 배열을, 알림은 여백과 옆 테두리를 바꾼다고 하자. 앞 CSS에 다음을 덧붙인다.

/* Draft syntax: shared condition, caller-supplied content */
@mixin --compact-layout() {
  @media (width <= 40rem) {
    @contents;
  }
}
 
.site-card {
  @apply --compact-layout() {
    display: grid;
    gap: 0.75rem;
    padding: 1rem;
  }
}
 
.site-notice {
  @apply --compact-layout() {
    padding: 0.75rem;
    border-inline-start-width: 3px;
  }
}

@apply 뒤의 블록은 호출자가 주고 @contents는 들어갈 위치를 정한다. 공유하는 것은 40rem 조건이며 바뀌는 스타일은 각 컴포넌트 곁에 남는다. @contents 정의

각기 다른 컨테이너의 공간에 반응해야 한다면 공통 viewport 조건은 맞지 않는다. 40rem은 예제의 선택이며 모든 사이트에 쓸 기기 분류가 아니다.

@contents에 기본 블록을 둘 수도 있지만 호출자가 내용을 아예 넘기지 않을 때만 사용한다. 빈 블록도 내용을 넘긴 것으로 취급하며 선언만 없을 뿐이다. 이 예제에는 기본 블록이 없으므로 내용 없이 --compact-layout()만 호출하면 스타일이 추가되지 않는다.

여러 컴포넌트가 조건을 공유하면서 각자 다른 스타일을 바꿔야 할 때 이 기능을 쓸 이유가 생긴다. 지금처럼 두 개뿐이라면 하나의 @media에 두 규칙을 넣어도 충분히 읽기 쉽다. 다음 예제에서는 현재 쓸 수 있는 CSS로 같은 결과를 만든다.

오늘 이 테두리를 만든다면 일반 CSS부터 쓰겠다

같은 HTML은 mixin을 기다릴 필요가 없다. 선택자를 묶어 선언을 공유하고 사용자 지정 속성으로 차이를 준다.

:root {
  --panel-radius: 0.5rem;
}
 
.site-card,
.site-notice {
  border: 1px solid var(--panel-accent, #777777);
  border-radius: var(--panel-radius);
  padding: var(--panel-space, 1.5rem);
}
 
.site-card > .site-panel-title,
.site-notice > .site-panel-title {
  margin-block: 0 0.75rem;
  color: var(--panel-accent, #777777);
}
 
.site-notice {
  --panel-accent: #45687d;
  --panel-space: 1rem;
}

HTML을 바꿀 수 있다면 두 요소에 공통 .site-panel class를 붙여도 된다. var()는 값을 치환하며 선언 묶음을 삽입하지 않는다. 여기서는 그룹이나 공통 class가 선언 재사용을 이미 해결한다. 사용자 지정 속성 명세

나중에 이 규칙을 여러 컴포넌트 스타일에서 조합해야 한다면 mixin을 다시 검토하겠다. 호출 위치에 인수를 명시해야 하는 경우나 HTML에 공통 class를 붙이기 어려운 경우도 후보가 된다. 이때 호출부도 살펴봐야 한다. 매번 설정의 절반을 덮어쓰고 아이콘, 배경, 제목 크기 스위치까지 늘어난다면 블록의 역할이 너무 넓어진 것이다. 인수를 더하기 전에 나누는 편이 낫다.

Sass에 익숙해도 문법을 그대로 옮길 수는 없다. Sass는 $ 매개변수와 @include를 쓰고 컴파일러가 CSS를 출력한다. 네이티브 제안은 -- 이름, @apply, CSS 값 체계를 쓴다. Sass mixin

2026년 10월 30일 확인 시점에도 초안의 평가 절에는 새 @private 모델로 고치라는 TODO와 옛 @result 예제가 남아 있다. 따라서 위 설명은 5.1–5.4절의 공개 문법을 따른다. 5.5절의 내부 전개 단계는 아직 확정된 동작으로 볼 수 없다. 초안에 남은 작업

이 예제에서는 공유 블록의 역할을 외곽 스타일까지로 두겠다. 내용과 개별 변화는 각 컴포넌트의 스타일에서 처리한다. 나중에 알림에 이 외곽 스타일이 필요 없어지면 적용 한 번을 지워 빠져나올 수 있어야 한다. mixin에는 이런 조합 방식을 기대한다.