디자인 시스템 라이브러리에 바인딩하기
제품 화면은 로컬 레이어가 아닌 프로젝트의 디자인 시스템을 사용해야 합니다.
프리셋 선택
각 디자인 시스템에는 presets/에 하나의 프리셋이 있습니다. 사용자에게 프로젝트가 어떤 프리셋을 사용하는지 묻거나, 프로젝트의 종속성을 확인하세요(예: 프로젝트가 디자인 토큰 패키지에 의존하는 경우 일치하는 프리셋 사용). 형식은 presets/README.md를 참조하세요. 프리셋이 없으면 아래 "자동 바인딩 작동 방식"에 따라 한 번 조회한 다음, 결과를 새 프리셋으로 저장하세요. 프로젝트에 라이브러리가 없으면 "없음"을 작성하고 보고서에 명시하세요.
시작하기 전에 get_libraries를 사용하여 모든 라이브러리가 libraries_added_to_file에 있는지 확인하세요. 누락된 라이브러리가 있으면 사용자에게 Figma의 Assets › Libraries에서 추가하도록 요청하고, 추가될 때까지 진행하지 마세요.
바인딩 규칙
화면을 변경하는 것보다 무언가를 바인딩하지 않은 상태로 두는 것이 좋습니다. 도구는 아래만 수행하며, 그 외의 모든 것은 로컬로 유지되고 보고됩니다.
| 유형 | 규칙 | 하지 말아야 할 것 |
|---|---|---|
| 색상 | 불투명도를 포함하여 정확히 일치하는 경우에만 바인딩합니다. 반투명 색상은 해당 투명도를 가진 토큰이 필요합니다. Figma에서 바인딩 시 불투명도를 1로 재설정하기 때문입니다 | 가장 가까운 색상으로 스냅하지 마세요 |
| 반경, 선 두께, 간격, 글자 크기 | 값이 정확히 동일한 경우에만 바인딩합니다 | 3px를 2px 또는 4px로 변경하지 마세요 |
| 별칭 토큰 | 다른 토큰을 가리키는 토큰(기본 토큰 위의 시맨틱 토큰)은 체인 끝의 값을 기준으로 계산됩니다. 값에 둘 다 있는 경우, 자체 값을 가진 토큰이 우선합니다. 별칭은 다른 값이 없는 값에만 사용됩니다 | 값이 같은 두 시맨틱 토큰 중에서 추측하여 선택하지 말고 보고하세요 |
| 텍스트 스타일 | 글꼴, 크기, 줄 높이가 모두 동일한 경우에만 바인딩합니다 | 글꼴이 다른 경우 크기만 바인딩하세요 |
| 아이콘 | 라이브러리에 동일한 이름의 컴포넌트가 있는 경우에만 교체합니다. 동일한 용도로 확인된 매핑에 대해서만 이전 이름을 허용합니다 | 의미는 비슷하지만 모양이 다른 아이콘을 사용하지 마세요 |
| 컴포넌트 | 라이브러리 컴포넌트가 제품의 것과 모양이 동일한 경우에만 교체합니다. 제품의 크기는 유지합니다 | 모양이 다르면 로컬 컴포넌트를 유지하고 제품 화면을 변경하지 마세요 |
가장 가까운 값으로 스냅하지 않는 이유: 일치하는 값이 반드시 일치하는 의미를 의미하는 것은 아니며, 상태 보드가 코드와 불일치하게 만듭니다. 일치하는 토큰이 없는 값은 디자인 시스템의 간격입니다. 도구가 임의로 선택하게 하는 대신 디자인 팀이 결정할 수 있도록 나열하세요.
자동 바인딩 작동 방식
프리셋이 있는 경우, al-capture.cjs 설정에서 preset을 설정하고 네 번째 인수로 프리셋 이름을 al-pack.py에 전달하세요. 화면이 빌드될 때 자동으로 바인딩됩니다. 프리셋이 없는 경우에만 아래 프로세스를 따르고 결과를 presets/<name>.json으로 저장하세요: libs는 바인딩 설정이고, extract는 추출 중 사용되는 스프라이트 매핑입니다.
- 레이아웃 트리를 추출한 후, JSON에서 모든
lib(아이콘 이름)을 나열합니다. - 각 이름에 대해
search_design_system으로 아이콘 시스템을 검색합니다:system:cross는icon / system / cross에 매핑됩니다. 정확한 이름 일치만 허용합니다. search_design_system을 사용하여 컴포넌트 세트를 찾고, 인스턴스를 몇 개 배치하고, 스크린샷을 찍고, 제품의 모양과 비교하여buttons.rules를 결정합니다.opts.libs를 구성합니다. 먼저 3-4개의 카드를 빌드하고log.drift와 스크린샷을 확인합니다. 제대로 보이는 경우에만 일괄 처리합니다.
const libs = {
tokens: ['My DS - Foundation'], // 이 라이브러리에서 변수 읽기
icons: { 'system:cross': '<componentKey>' },
buttons: {
set: '<componentSetKey>',
rules: { FFE13A: { Type: 'primary', Size: 'medium', Compact: 'false', Status: 'default' } }, // 키는 버튼 배경색입니다
},
words: { value: 'Price' }, // 팀 용어와 일치하도록 텍스트 속성 이름 변경
};
al-capture.cjs 출력에는 이번에 사용되었지만 프리셋에 아직 매핑되지 않은 아이콘을 나열하는 unmappedIcons가 포함됩니다. search_design_system으로 조회하고 정확한 이름 일치를 프리셋에 추가하세요. 다음 번에 자동으로 바인딩되므로 프리셋이 사용됨에 따라 더 완전해집니다.
__alBuild가 반환하는 stat에는 바인딩 결과가 포함됩니다: boundColors, boundLayout, libIcons, dsButtons, unboundColors, localIcons.
기존 화면 바인딩
al-bind.js는 단독으로 사용할 수 있습니다. 토큰만 바인딩하고 아이콘이나 컴포넌트는 교체하지 않습니다. 전체 스크립트를 use_figma에 붙여넣거나(또는 eval로 로드)한 다음 호출하세요:
return await __alBind(['<frame id>'], { tokens: ['<library name>'] });
boundColors, boundLayout, unboundColors(토큰이 없는 색상)를 반환합니다. skippedText는 글꼴을 로드할 수 없어 크기가 바인딩되지 않은 텍스트의 개수를 나타냅니다.
화면이 __alBuild로 빌드될 때, 토큰 테이블은 _registry에 캐시되므로 이후 화면에서 모든 변수를 다시 가져오지 않습니다. 프리셋이 다른 토큰 라이브러리를 나열하면 재구축됩니다. 라이브러리가 새 토큰이나 변경된 토큰을 게시한 후에는 다음 __alBuild 호출에 refreshTokens: true를 전달하세요.
컴포넌트
- Auto Layout으로 가운데 정렬: 패딩이나 텍스트 상자 너비가 아닌 Auto Layout을 사용하여 텍스트가 변경되어도 위치가 이동하지 않도록 합니다.
- 컨테이너는 컴포넌트가 아님: 이미 컴포넌트를 포함하는 반복 구조는 단순한 컨테이너입니다.
- 상태는 변형(variant)으로 처리: 선택 및 비활성화 상태는 인스턴스 색상을 재정의하는 것이 아니라 속성을 통해 전환 가능해야 합니다.
- 작은 컴포넌트를 속성으로 분할:
Type및State라는 두 개의 변형 속성; 텍스트를 컴포넌트 속성으로 만듭니다. - 메인 컴포넌트는 완전해야 함: 뷰포트에 의해 잘리는 요소를 컴포넌트로 만들지 마세요.
보고서
항상 다음을 나열하세요:
- 바인딩 비율: 색상, 레이아웃 값
- 라이브러리 버전으로 교체된 아이콘 및 컴포넌트 수
- 디자인 팀이 결정할 수 있도록 토큰이 없는 색상(상위 몇 개)
- 로컬로 유지된 아이콘 및 컴포넌트와 그 이유