디자인 토큰

각 프로젝트는 색상, 타이포그래피, 간격을 디자인 토큰으로 보관하고 API로 제공합니다. 런타임에 토큰을 읽는 앱은 새 토큰이 게시되면 리브랜딩을 바로 보여 줍니다.

프로젝트당 토큰 문서 하나

토큰은 W3C 디자인 토큰 형식의 단일 문서입니다. 각 토큰은 이름 붙은 값 하나이며, 예를 들면 color.brand.primary입니다. 종류는 색상, 폰트 패밀리, 폰트 굵기, 폰트 크기, 줄 높이, 자간, 복합 타이포그래피, 간격, 모서리 반경, 그림자, 테두리입니다. 버튼, 카드, 레이아웃 그리드, 브레이크포인트, 모션은 포함되지 않습니다.

토큰 간 참조

토큰은 경로로 다른 토큰을 참조할 수 있으므로, 값 하나를 바꾸면 그것을 가리키는 모든 항목이 갱신됩니다. 참조는 토큰이 제공되기 전에 서버에서 결정됩니다. 참조 순환, 알 수 없는 참조, 타입 불일치 또는 지원되지 않는 타입이 있는 문서는 저장할 때 거부되며, 오류에 토큰의 경로가 표시됩니다.

초안과 게시

편집은 초안으로 들어갑니다. 콘솔에서 하든 designTokens 아래 여러분의 설정 파일에 쓰든 API로 하든 마찬가지입니다. 라이브 사이트는 초안을 게시하는 릴리스 전까지는 마지막으로 게시된 세트를 계속 제공합니다. 게시되지 않은 토큰을 미리 보려면, 초안 읽기 스코프를 가진 키와 함께 초안 채널 헤더를 요청에 보냅니다.

앱에서 토큰 읽기

GraphQL 쿼리는 토큰 종류별로 평탄화되고 결정된 배열을 제공하며, 추가로 source, 빌드 도구용 원본 W3C 문서를 반환합니다. 런타임에 API에서 토큰을 읽는 앱은 배포 없이 게시된 변경을 반영합니다. 빌드 시점에 토큰을 포함하는 앱은 여전히 다시 빌드해야 합니다.

자세히 보기

디자인 토큰 가이드는 토큰 종류, 편집 방법, 초안을 게시하는 방법을 다룹니다.