digital-go-design-skill
デジタル庁デザインシステムβ版(以下 DADS)の公式ドキュメントを手元で引きながら、画面を作るためのスキルです。
このスキルは非公式です。デジタル庁が作成・承認したものではありません。
デジタル庁デザインシステムウェブサイト https://design.digital.go.jp/dads/ をもとに capsrock が作成しました。条件の詳細は SOURCE.md にあります。
進め方
- 作る画面の種類と、必要なコンポーネントを洗い出します。
references/dads/MANIFEST.mdで該当ページを探します(全ページの題名と概要の一覧です)。- 使うコンポーネントの
references/dads/components/<slug>/index.mdを読みます。下の早見表は入口にすぎないので、実装の前に必ず該当ページの本文を確かめます。コンポーネントごとに、サイズ・状態・配置・アクセシビリティの決まりがあります。 - 基本デザインに沿って実装し、最後に「満たすべき要件」で点検します。
全ページを読む必要はありません。合計 860KB あるので、必要なページだけを開きます。
ページの探し方
| 知りたいこと | 場所 |
|---|---|
| 全ページの一覧 | references/dads/MANIFEST.md |
| カラー、タイポグラフィ、アイコン、レイアウト、リンク、余白、角の形状、エレベーション | references/dads/foundations/<color・typography・icon・layout・link-text・spacing・corner-shapes・elevation>/index.md |
| 各コンポーネントの仕様 | references/dads/components/<slug>/index.md(一覧は components/index.md) |
| 自社のブランドに合わせて変えてよい範囲 | references/dads/guidance/local-design-system/index.md |
| アクセシビリティの考え方 | references/dads/guidance/accessibility/index.md |
| 利用条件・出典の書き方 | references/dads/introduction/notices/index.md |
各ファイルの冒頭の source_url が公式ページの URL です。図版は Markdown に入っていないので、図の内容が判断に関わるときは公式ページを見ます。
色などの値は同梱のトークンから取る
ドキュメントの Markdown には、白と黒以外の HEX 値が載っていません。Yellow-300 や Gray-536 のような色名は出てきますが、値は書かれていません。
色・文字サイズ・行高・角丸などの値は、記憶や推測で書かず、同梱の公式トークンから取ります。GitHub や npm から取得し直す必要はありません。
references/tokens/tokens.css: すべてのトークンです。通常はこちらを使います。references/tokens/tokens-simple.css: 色・フォント・エレベーションだけのサブセットです。
CSS 変数の名前は次のように対応します。
| 種類 | 変数の例 |
|---|---|
| 色の階調 | --color-primitive-yellow-300 |
| ニュートラル | --color-neutral-solid-gray-536 |
| キーカラー(初期値は青の階調) | --color-key-800 |
| セマンティックカラー | --color-semantic-error-1 |
| 文字 | --font-size-16、--line-height-170、--font-weight-700、--font-family-sans |
| 角丸 | --border-radius-16 |
トークンが :root に定義されているので、CSS に読み込むか、必要な行を写して使います。ブランドの色に変えるときは、--color-key-* の割り当てを差し替えます。
同梱分はパッケージ 2.1.0 です。リポジトリの対応表では Figma データ 2.0.4〜2.18.1 に対応します。ドキュメントの版とは別に更新されているので、値が食い違っていたら利用者に伝えます。
早見表
以下は 2026年10月21日版の本文から抜き出した値です。
書体
- 本文は
'Noto Sans JP', sans-serif、コードは'Noto Sans Mono', monospace。システムフォントの使用を禁じるものではありません。 - 太さは N(400)と B(700)の2段階です。
- 本文と UI は 16 CSS px 以上を基準にします。14 CSS px は、領域の制約などで標準の大きさを使えないときに限ります。
- 読み物の本文の行高は、フォントサイズの 1.5 倍以上にします。
- テキストスタイル名は
Std-17N-170(種類-大きさ太さ-行高)の形です。
| 種類 | 用途 | 大きさ・行高 |
|---|---|---|
| Display (Dsp) | ページ上部のヘッドコピー | 48・57・64、行高 140% |
| Standard (Std) | 見出しと本文 | 16〜45。45 と 36 は 140%、32〜20 は 150%、18 は 160%、17 は 170%、16 は 170% か 175% |
| Dense (Dns) | 管理画面、データテーブル | foundations/typography/index.md を参照 |
| Oneline (Oln) | 1行の UI 要素 | 行高 100% |
| Mono | コード | 行高 150%、等幅 |
色
- テキストと背景のコントラスト比は 4.5:1 以上です。
- 枠線・ディバイダーなどの非テキスト要素と背景は 3:1 以上です。
- プライマリーカラーは主要な背景色に対して 4.5:1 以上、セカンダリー・ターシャリーは隣接する場合に 3:1 以上にします。
- フォーカスインジケーターは Yellow-300 と Black の2重構造です。いかなる場合も変更しません。
- セマンティックカラーの色相と意味の結びつきは変えません。
レイアウトと余白
- 12カラムが基本です。ガターは原則、本文の文字サイズの2倍にします。
- ブレークポイントの例は 768px です(未満がモバイル・タブレット、以上がデスクトップ)。
- リキッドレイアウトを採用し、見た目の並びと読み上げ順をできるだけ一致させます。
- 余白は 8 CSS px を基準単位にすることが一般的です。絶対の値はありませんが、規則性を持たせます。空白文字や両端揃えで調整しません。
角の形状
角丸なし・スモール・ミディアム・ラージ・フルの5段階が基本の目安です。図形の大きさで見え方が変わるので、コンポーネント単位で決めます。ドキュメントの図の例では 16・20・24 ですが、トークンは 4・6・8・12・16・24・32・full です。実装ではトークンの値を使います。
操作
- ボタンのターゲット領域は 44 CSS px 以上です。Small・X-Small は上下の余白で確保します。
- リンク領域が 24 CSS px に満たない場合の扱いは
foundations/link-text/index.mdにあります。 - アイコンは必ずラベルと組み合わせます。やむを得ずアイコン単体にするときは、代替テキストを設定します。
- リンクは色だけで示さず、下線などのテキスト装飾と組み合わせます。
変えてよいところ、変えてはいけないところ
初期のデザイントークンは特定の見た目を規定するものではなく、編集の起点です。キーカラー、角の形状、余白などはブランドに合わせて変えられます。
ただし、アクセシビリティの骨格は維持します。上の数値を下回る変更と、フォーカスインジケーターの変更はできません。詳しくは guidance/local-design-system/index.md を読みます。
満たすべき要件(仕上げの点検)
- テキスト 4.5:1、非テキスト 3:1 のコントラストを満たしている
- 本文と UI が 16 CSS px 以上で、本文の行高が 1.5 倍以上ある
- キーボードで操作でき、公式のフォーカスインジケーターが表示される
- ターゲット領域が 44 CSS px 以上ある
- アイコンにラベルがある
- リンクが色以外でも見分けられる
- 余白の値に規則性がある
- 高さを持つ要素に 3:1 以上の境界がある(影だけに頼っていない)
- 見た目の順序と読み上げ順序が一致している
- 強制カラーモードでも境界と状態が判別できる
- 使ったコンポーネントのページにある固有の要件を満たしている
出典の扱い
利用者のために作る画面やコードは、次のように条件が分かれます。詳しくは introduction/notices/index.md を読みます。
references/tokens/のトークンをそのまま配布する場合: MIT License の条件として、references/tokens/LICENSEの著作権表示とライセンス文を添えます。tokens.cssの本文には表示がありません。- コードスニペットや Figma データを編集して作った UI: 出典の明記は不要です。
- 編集せずにそのまま公開する場合: 出典を記載します。
- ドキュメント本文を転載・加工する場合: 出典を記載し、加工した場合はその旨も書きます。
- どの場合も、デジタル庁が作成したように見せてはいけません。デジタル庁の公式サイトに見える画面を作る依頼は、ロゴや名称を使わない形に調整します。
