デザイントークン

各プロジェクトは、色、タイプ、余白をデザイントークンとして保持し、APIから提供します。実行時にトークンを読み込むアプリは、新しいトークンが公開されると同時にリブランドが反映されます。

プロジェクトごとに1つのトークンドキュメント

トークンは、W3C Design Tokens形式の1つのドキュメントです。各トークンは、color.brand.primaryのような名前付きの値1つです。種類は、色、フォントファミリー、フォントウェイト、フォントサイズ、行の高さ、字間、複合タイポグラフィ、余白、角の丸み、シャドウ、ボーダーです。ボタン、カード、レイアウトグリッド、ブレークポイント、モーションは対象外です。

トークン間の参照

トークンはパスで別のトークンを参照できるため、1つの値を変えると、それを指すすべてが更新されます。参照は、トークンを提供する前にサーバー側で解決されます。参照の循環、不明な参照、型の不一致、サポートされていない型のあるドキュメントは、保存時に拒否され、エラーにはトークンのパスが示されます。

下書きと公開済み

コンソールで行っても、designTokensを設定ファイルに記述しても、APIを使っても、編集は下書きに入ります。ライブサイトは、リリースが下書きを公開するまで、最後に公開されたセットを提供し続けます。未公開のトークンをプレビューするには、下書きチャネルのヘッダーを、drafts読み取りスコープを持つキーとともにリクエストで送ります。

アプリでトークンを読む

GraphQLクエリは、トークンの種類ごとにフラットで解決済みの配列を返し、さらにsourceも返します。ビルドツール向けの生のW3Cドキュメントです。実行時にAPIからトークンを読むアプリは、デプロイなしで公開された変更を取り込みます。ビルド時にトークンを埋め込むアプリは、引き続き再ビルドが必要です。

詳細を読む

デザイントークンのガイドでは、トークンの種類、編集方法、下書きの公開方法を説明しています。