이 글의 내용
컴포넌트의 시각적 스타일, 크기, 상태 또는 구조를 바꿔야 한다면 베리언트를 사용합니다. 기존 레이어를 표시하거나 숨기기만 하면 된다면 Boolean(불리언) 표시 속성을 사용합니다. 선택지의 개수만으로 결정할 수는 없습니다. 기본 상태와 비활성 상태만 있는 버튼도 여러 시각적 속성이 함께 바뀐다면 베리언트가 필요할 수 있습니다.
사용하기 좋은 컴포넌트 라이브러리는 이 방법들을 함께 활용합니다. Pixso 디자인 시스템에서는 의미 있는 디자인 차이에 베리언트를 쓰고, 선택적 요소는 레이어 표시 속성으로 제어하도록 합니다. 레이블이나 중첩된 컴포넌트가 바뀐다면 Text 또는 Instance 속성을 사용합니다. 목표는 사용자가 올바르게 설정할 수 있으면서 유지 관리할 중복 버전은 적은 컴포넌트를 만드는 것입니다.

1. 베리언트와 Boolean 표시 속성 구분하기
베리언트는 컴포넌트 세트 안에 있는 서로 다른 버전의 컴포넌트입니다. 기본형과 보조형 버튼, 작은 크기와 큰 크기, 기본 상태와 비활성 상태의 모양 등을 베리언트의 선택지로 표현할 수 있습니다. 각 버전에는 고유한 속성 값 조합을 지정합니다.
Boolean은 true 또는 false 값을 가집니다. 레이어 표시 속성으로 쓰면 기존 하위 레이어를 보여 줄지 제어합니다. 앞쪽 아이콘의 유무만 다르다면 각각 별도의 버튼 베리언트를 만들 필요가 없습니다. 레이어를 숨겼다고 해서 해당 레이어 자체가 삭제되는 것은 아닙니다.

어느 속성도 그 자체로 성능을 자동 개선하지는 않습니다. 베리언트를 줄이면 중복 디자인 작업은 줄일 수 있지만 숨겨진 레이어, 중첩 인스턴스, 효과, 이미지 등 파일의 다른 요소도 영향을 줍니다. 먼저 유지 관리하는 정의의 수를 세고, 속도나 파일 크기가 개선됐다고 판단하기 전에 느리게 느껴지는 구체적인 작업을 측정하세요.
2. Pixso에서 올바른 레이어에 속성 설정하기
Pixso의 컴포넌트 가이드(영문)는 Variant, Layer, Instance, Text 속성을 구분합니다. 여기서 Boolean 표시 제어로 설명하는 기능은 Layer 속성에 해당합니다. 속성은 실제로 바뀌는 객체에 설정해야 합니다. 하위 요소와 연결하지 않은 채 모든 제어 항목을 부모에 두는 것만으로는 동작이 정의되지 않습니다.
- 버튼의 선택지를 정의합니다. 메인 컴포넌트나 컴포넌트 세트에
size,state처럼 이름이 있는 베리언트 속성을 만듭니다. 각 베리언트에 고유한 값 조합을 지정합니다. - 선택적 아이콘을 제어할 수 있게 합니다. 메인 컴포넌트 안에서 앞쪽 아이콘 하위 레이어를 선택합니다. Layer 영역의 속성 제어를 사용해 이름을
showLeadingIcon으로 지정하고 기본 표시 여부를 정합니다. - 표시 여부와 교체를 구분합니다. 협업자가 다른 아이콘을 선택해야 한다면 중첩된 아이콘 인스턴스에 Instance 속성을 사용합니다. 아이콘을 보여 줄지와 어떤 아이콘을 쓸지는 서로 다른 결정입니다.
- 레이블을 편집할 수 있게 합니다. 버튼 레이블에는 Text 속성을 사용합니다. ‘저장’, ‘변경 사항 저장’, ‘초대 보내기’라는 문구 때문에 베리언트를 늘리지 않습니다.
- 인스턴스로 확인합니다. 아이콘 표시를 전환하고, 아이콘 컴포넌트를 교체하고, 레이블을 편집하고, 크기나 상태를 바꿉니다. 각 변경 후 간격과 텍스트 줄 바꿈을 확인합니다.
공식 가이드에는 프로토타입의 제약도 나옵니다. 표시 속성은 상호작용 상태로 연결할 수 있는 별개의 객체 두 개를 만들지 않습니다. 프로토타입에 서로 다른 연결 대상이 필요하다면 해당 대상을 명시적으로 구성해야 합니다. 속성 패널과 프로토타입 흐름은 관련이 있지만 해결하는 문제는 서로 다릅니다.
3. 변화의 종류에 따라 선택하기
실제로 무엇이 바뀌는지부터 살펴보세요. ‘선택지가 두 개면 Boolean’이라는 기준은 활성·비활성 모양, 조밀한 크기·여유 있는 크기처럼 여러 속성이 함께 바뀌는 두 가지 중 하나를 고르는 경우에는 맞지 않습니다.
| 요구사항 | 검토할 속성 | 이유와 확인 사항 |
|---|---|---|
| 앞쪽 아이콘 표시 또는 숨기기 | Layer 표시 제어 / Boolean | 같은 선택적 하위 요소를 표시하거나 숨깁니다. 남은 레이블의 간격을 확인합니다. |
| 기본형, 보조형, 고스트 스타일 전환 | Variant(베리언트) | 채우기, 테두리, 텍스트 스타일이 함께 바뀝니다. |
| 기본, 호버, 누름, 비활성 상태의 모양 전환 | Variant(베리언트) | 여러 시각적 속성이 연동되는 상태는 레이어 하나를 숨기는 것만으로 표현할 수 없습니다. |
| 모달의 선택적 닫기 버튼 표시 | Layer 표시 제어 / Boolean | 허용된 설정에서도 대화상자를 닫거나 작업을 완료하는 방법이 명확하게 남아 있을 때만 적절합니다. |
| 다운로드 아이콘을 화살표로 교체 | Instance(인스턴스) | 슬롯은 그대로 있고 안에 중첩된 컴포넌트가 바뀝니다. |
| ‘저장’을 ‘변경 사항 저장’으로 변경 | Text(텍스트) | 내용이 바뀌는 경우입니다. 새 베리언트를 만들지 않고 더 긴 레이블을 테스트합니다. |

연관된 개념도 구분해야 합니다. 로딩 중인 버튼에는 스피너, 너비 유지, 다른 레이블, 중복 제출 방지가 필요할 수 있습니다. 스피너의 표시 여부는 Boolean으로 제어할 수 있지만 이 전환만으로 로딩 동작 전체가 정의되지는 않습니다. 허용할 로딩 상태를 정하고 어떤 제어 요소가 함께 바뀌는지 설명하세요.
4. 192개를 48개로 줄이는 예시 검토하기
버튼 라이브러리에 크기 3종, 색상 스타일 4종, 시각적 상태 4종이 있다고 가정합니다. 모든 조합이 유효하다면 기본 베리언트는 3 × 4 × 4 = 48개입니다. 아이콘 없음, 앞쪽만, 뒤쪽만, 양쪽 모두를 별도 베리언트로 만들면 네 배인 48 × 4 = 192개가 됩니다.
독립적인 표시 속성 두 개를 사용하면 48개 기본 베리언트 각각에서 네 가지 아이콘 조합을 표현할 수 있습니다. 앞쪽과 뒤쪽 아이콘을 각각 켜거나 끄는 방식입니다. 이 예시에서는 중복된 컴포넌트 정의 144개를 줄입니다. 임의의 레이어 144개를 삭제한다는 뜻도, 파일 크기가 75% 줄어든다는 증거도, 렌더링 성능 개선을 측정한 결과도 아닙니다.

제품에서 실제 사용하는 조합부터 정리하세요. 위험한 작업에는 고스트 스타일을 쓰지 않거나 특정 크기를 지원하지 않는다면, 모든 경우의 수를 만드는 것이 올바른 목표는 아닙니다. 모든 조합을 만든 뒤 금지된 조합을 디자이너가 기억하게 하지 말고, 허용된 조합을 기록하세요.
실제 사용에 가까운 확인 방법으로, 중간 크기의 기본형 버튼에 ‘변경 사항 저장’ 레이블을 설정합니다. 아이콘 없음, 앞쪽만, 뒤쪽만, 양쪽 모두를 시도한 뒤 작은 크기와 더 긴 레이블로 바꿉니다. 앞쪽 아이콘을 없앴는데 빈 간격이 남으면 레이아웃을 수정합니다. 양쪽 아이콘이 레이블을 압박하면 패딩을 조정하거나 해당 조합을 제한합니다. 클릭 대상의 크기도 별도로 지정해야 합니다(영문). 아이콘을 숨기면서 의도치 않게 조작 영역까지 작아지지 않도록 합니다.
반대로 Boolean을 지나치게 늘려도 문제가 됩니다. 프로필, 제품, 기사처럼 관련 없는 레이아웃을 숨겨진 분기로 한 카드에 넣으면 구조를 이해하기 어려워집니다. 콘텐츠와 동작에 일관된 공통 구조가 없다면 서로 다른 컴포넌트 계열로 분리하세요. 인스턴스 하나를 설정할 때마다 추측해야 한다면 최상위 베리언트 수가 적어도 도움이 되지 않습니다.
5. 디자인과 코드의 대응 관계 합의하기
개발자는 보통 각 디자인마다 컴포넌트를 따로 작성하는 대신 속성을 받는 재사용 가능한 버튼을 구현합니다. 디자인의 size=large 같은 선택은 코드 속성에 대응할 수 있고, 선택적 아이콘은 Boolean, 슬롯 또는 선택적 값으로 표현할 수 있습니다. 모든 디자인 제어 항목이 같은 이름의 코드 prop이 된다고 가정하지 말고 개발팀과 실제 API를 합의하세요.

state="hover" prop이 아니라 상호작용에 따른 스타일로 구현되는 경우가 많습니다.지원하는 크기 값, 기본 스타일, 아이콘 슬롯을 전달하는 방식, 비활성 상태의 의미, 로딩 중의 동작을 컴포넌트 옆에 명세로 적습니다. ‘레이블 숨기기’가 이름 없는 아이콘 전용 조작 요소를 만들지 않도록 해야 합니다. 아이콘 전용 버튼을 허용한다면 모양, 조작 영역, 접근 가능한 이름의 요구사항을 명시적인 구성으로 정의합니다.
디자인 속성은 명세를 정리하는 수단입니다. 이것만으로 실제 서비스 코드의 의미 구조, 키보드 동작, 이벤트 처리가 의도대로임을 입증할 수는 없습니다. 대응 관계가 완성됐다고 판단하기 전에 구현된 인스턴스 하나를 합의한 명세와 비교하세요.
6. 사용 중인 화면을 깨뜨리지 않고 라이브러리 정리하기
세 가지를 점검합니다. 관련 없는 레이아웃이 거대한 컴포넌트 안에 숨겨져 있는가, 단순한 선택적 레이어가 많은 베리언트에 중복되어 있는가, 속성 이름이 일관되지 않은가? 기존 세트를 바로 삭제하지 말고 이 질문을 바탕으로 작은 범위의 마이그레이션을 진행합니다.
- 사용 중인 설정을 목록으로 만듭니다. 대표 화면을 살펴보고 현재 속성 값, 레이블, 아이콘 오버라이드를 기록합니다. 긴 레이블과 비활성 상태도 포함합니다.
- 기존 컴포넌트를 남겨 두고 대체 버전을 만듭니다. 가능한 한 이름을 안정적으로 유지합니다.
showLeadingIcon같은 이름을 일관되게 사용하고 아이콘 교체 속성과 구분합니다. - 같은 인스턴스를 재현합니다. 아이콘을 끈 상태의 간격, 레이블 줄 바꿈, 중첩 컴포넌트 교체, 치수, 포커스 표시를 비교합니다. 지원하지 않는 조합은 컴포넌트를 배포하기 전에 해결합니다.
- 팀과 라이브러리 업데이트를 검토합니다. 기존 설정이 어떤 새 값에 대응하는지 문서화합니다. 대표적인 사용 화면의 확인을 마칠 때까지 복원 가능한 사본을 보관합니다.
성능 때문에 변경했다면 같은 파일과 작업을 비슷한 조건에서 변경 전후로 비교합니다. 파일 열기, 인스턴스 삽입, 속성 변경은 각각 별도로 관찰해야 합니다. 개선된 점과 그렇지 않은 점을 기록하세요. 컴포넌트 개수 계산은 성능 벤치마크가 아닙니다.
다음 컴포넌트에 적용할 선택 기준
버튼 계열 하나와 실제 사용하는 설정부터 시작하세요. 함께 바뀌는 시각적 차이에는 베리언트, 선택적 레이어에는 표시 속성, 교체 가능한 컴포넌트에는 Instance, 레이블에는 Text 속성을 사용합니다. 인스턴스로 조합을 검증하고 구현 방식을 합의합니다. 작은 라이브러리는 올바르게 설정하고 유지 관리하며 사용하기도 쉬울 때 가치가 있습니다.