メインコンテンツへスキップ
menu palettetanreidark_modetranslate

カラーモード

コントラスト

デザインシステム

ギャラリーのシステムは、Tanrei でどこまで表現できるかを示すために、ほかのデザインシステムを模して作ったものです。サポート対象のデザインではなく、あくまで例です。

リンクをコピーテーマを編集
palettetanrei

カラーモード

コントラスト

デザインシステム

ギャラリーのシステムは、Tanrei でどこまで表現できるかを示すために、ほかのデザインシステムを模して作ったものです。サポート対象のデザインではなく、あくまで例です。

リンクをコピーテーマを編集
はじめにWebReactSwiftUIJetpack ComposeFlutterReact Nativeプリセット自分のデザインシステムを作るAI エージェントと Tanrei を使うブランドデザイントークンデザインシステムとカスタマイズTheme Studioカラータイポグラフィアイコン形状エレベーションモーションインタラクション状態振る舞いレイアウトサイズと密度アクセシビリティ言葉カラートークンタイプスケールトークン形状トークンエレベーショントークンモーショントークン状態トークンスペースと寸法のトークンコンポーネントボタンメインアクションボタンセグメントボタンcupertino, m3-like にありボタングループメニュー付きボタンツールバーコピーボタンチェックボックスラジオボタンスイッチチップメニュースライダースライダーフィールドカレンダーDateTimePickerフィールドグループラジオグループチェックボックスグループセレクトセレクトフィールドメニューバーファイルアップロードファイルピッカー 上級者向けドロップゾーンレーティングテキスト入力欄 上級者向けテキストフィールドチップフィールドフィールドコンボボックス 上級者向けコンボボックスフィールド数値入力欄 上級者向け数値フィールドカラー入力欄 上級者向けカラーフィールドワンタイムコード入力欄 上級者向けワンタイムコードフィールド埋め込みテキスト入力欄 上級者向けチャットコンポーザーカード区切り線モーダルレイヤー 上級者向けダイアログリストリスト行ボトムシートサイドシートカルーセルコードブロックテーブルポップオーバーステップアコーディオン説明リスト図アプリシェルページヘッダーツリービュータイムライン画像プレビューハンドルサイズ変更できる枠分割ビュースクロールエリアサイズトランジションバッジプログレスインジケーターメーターナンバーティッカーローディングインジケータースナックバーツールチップキーボードショートカットタグインラインコードコールアウトアバター空の状態タググループスケルトンファイル項目色見本マーキーテキストタブタブビューアプリバーナビゲーションバーナビゲーションドロワー検索リンクページネーション前後のリンクステッパーパンくずリスト目次リンクカードFAB メニューm3-like にありステータスTanrei の作り方コントリビューションライセンスと帰属
ホーム基礎サイズと密度

サイズと密度

コントロールのサイズのための 5 段の高さ、押せるものを描く最小の大きさ、そしてコンテナが中のものに渡すサイズ。

content_copyMarkdown で表示

コントロールや行の高さは、3 つの値で決まります。コントロールの高さと最小ターゲットはデザインシステム全体のもので、プロダクトはそれぞれをレイヤで一度だけ設定します。サイズは 1 つのコンポーネント、またはそのグループのもので、ボタンは置かれた場所で small、medium、large のどれかになります。

サイズの段

段は tanrei.sys.control.height.* の 5 つの高さで、コントロールのサイズはここを読みます。medium はコントロールの高さ tanrei.dial.control.height(既定では 40)で、ほかの段はそこからサイズ単位(dial.size.unit、既定では 4px)の整数倍だけ下と上にあります。small は 2 つ、extra-small は 4 つ下、large は 4 つ、extra-large は 8 つ上です。いくつかのコントロールの高さでの値を、トークン自身のルールから計算して示します。

トークン dial.control.height 36px dial.control.height 40px dial.control.height 44px dial.control.height 48px dial.control.height 56px
--tanrei-sys-control-height-extra-small 20px 24px 28px 32px 40px
--tanrei-sys-control-height-small 28px 32px 36px 40px 48px
--tanrei-sys-control-height-medium 36px 40px 44px 48px 56px
--tanrei-sys-control-height-large 52px 56px 60px 64px 72px
--tanrei-sys-control-height-extra-large 68px 72px 76px 80px 88px

生成元 design/tokens/tanrei.light.tokens.json, tokens/sys/measure.tokens.json

多くのコンポーネントが高さをこの段から読み、同じ段を読むもの同士は、どのコントロールの高さでも同じ高さのままです。Button の small、medium、large は、small、medium、large の段を読みます。段そのものには下限がありません。extra-small は、タグやキーボードショートカットのように、誰も押さないもののための段だからです。

最小ターゲット

tanrei.sys.target.minimum は、人が押すものを描く最小の高さで、アイコンだけのコントロールでは最小の幅でもあります。押せる箱や行の高さはどれもこれを下限として導出されるので、どのサイズでも、これより低くは描かれません。これは開発者が決める値で、どのダイヤルも拡大縮小しません。下限が、下限をかける相手と一緒に縮んでしまえば、下限の意味がないからです。

既定のシステムでは、最小は 36 で、ポインターでも指でも同じです。Button の高さを見ると、その働きがわかります。かっこ内の値はサイズとコントロールの高さが与える高さで、その前の高さが、最小ターゲットによってボタンが保たれている高さです。

トークン dial.control.height 36px dial.control.height 40px dial.control.height 44px dial.control.height 48px dial.control.height 56px
--tanrei-comp-button-container-height-small 36px (28px) 36px (32px) 36px 40px 48px
--tanrei-comp-button-container-height-medium 36px 40px 44px 48px 56px
--tanrei-comp-button-container-height-large 52px 56px 60px 64px 72px

生成元 design/tokens/tanrei.light.tokens.json, tokens/comp/button.tokens.json

さらに 2 つの値が、押されたことをどれだけの範囲で受け取るかを決めます。指では sys.target.touch、細かいポインターでは sys.target.pointer です。どちらも既定では最小ターゲットと同じなので、1 つの値で 3 つすべてが決まります。プラットフォームのガイドラインに従うシステムは、これらを大きくします。そのとき、単独で置かれたコントロールは、描いた範囲を越えてその広い範囲から押されたことを受け取り、隣と接する行はその高さで描かれます。チェックボックスの箱や小さいチップのように、ターゲットより小さく描かれるしるしは、大きさを変えずに、ヒット領域をターゲットまで広げます。同梱の各システムの設定は次のとおりです。

デザインシステム minimum touch pointer
tanrei 36px 36px 36px
cupertino 28px 44px 28px
m3-like 32px 48px 44px

生成元 tokens/systems/*.system.json, design/tokens/<system>/tanrei.light.tokens.json

ビルドはすべてのシステムを確かめます。3 つのどれも 24px(WCAG 2.5.8)を下回らないこと、touch と pointer が最小ターゲットを下回らないこと、最小ターゲットがコントロールの高さを超えないこと、そして下限のある高さが最小ターゲットを下回らないことです。プロダクト自身のレイヤがターゲットを 24px 未満にした場合は、警告として知らされます。押されたことを受け取る範囲が最小ターゲットを下回る場合と、最小ターゲットがコントロールの高さを超える場合は、どのシステムでも拒否されます。

レイヤでの設定

どちらも、レイヤが理由を添えて設定するトークンです。

"tokens": {
  "tanrei.dial.control.height": { "$value": { "value": 32, "unit": "px" }, "reason": "A tool used all day with a mouse: controls and rows lower." },
  "tanrei.sys.target.minimum": { "$value": { "value": 32, "unit": "px" }, "reason": "Used with a mouse; 32 is the least we draw." }
}

Web では高さがダイヤルの CSS 式になっているので、ルート要素に --tanrei-dial-control-height を設定すると、ビルドし直さなくても、それに従う高さがすべて一度に動きます。Theme Studio では、「サイズ」の行にコントロールの高さ、サイズ単位、最小ターゲットがあります。

コンテナに設定するサイズ

サイズは、コンポーネントが置かれる場所で設定します。Web では、ボタングループの size を設定すると、それが中の Button のうち自分のサイズを持たないすべてのサイズになります。

<tanrei-button-group size="small">
  <tanrei-button variant="outlined">Cancel</tanrei-button>
  <tanrei-button variant="filled">Publish</tanrei-button>
  <tanrei-button variant="text" size="medium">Details</tanrei-button>
</tanrei-button-group>
  • コンポーネント自身のサイズが優先されます。 上の 3 つめの Button は medium です。
  • 渡されるのは、設定されたサイズだけです。 size のないグループは何も渡さないので、中の Button はそれぞれ自分の既定である medium か、グループを囲むコンテナが設定するサイズで描かれます。コンテナが入れ子になっているときは、サイズを設定しているいちばん近いコンテナで決まります。
  • コンポーネントにないサイズは、いちばん近いサイズになります。 近さは extra-small、small、medium、large、extra-large の段の並びで測り、同じだけ近いものが 2 つあれば大きいほうになります。
  • ボタングループとツールバーは、サイズによって自分では何も描き変えません。 間隔、角、区切り線はバリアントのとおりのままで、描かれる高さの項目を囲みます。

コンテナから渡されたサイズで描かれるコンポーネントも、自分のサイズで描かれるときと同じように、サイズの段と最小ターゲットに従います。コンテナのサイズを変えたり、コンポーネントをコンテナに入れたり出したりすると、その場で新しいサイズで描かれます。

サイズを渡すもの、受け取るもの

設定されたサイズを中のものに渡すコンテナは 3 つです。

  • ボタングループは、中の Button に渡します。
  • ツールバーは、グループの中かどうかにかかわらず Button とメニュー付きボタンに渡し、オーバーフローボタンにも渡します。
  • リストは、中のリスト行に渡します。

次のコンポーネントは、自分のサイズを設定していなければ、これらのうちいちばん近いコンテナのサイズを受け取り、サイズを設定するコンテナがなければ medium で描かれます。Button、メニュー付きボタン、コピーボタン、リスト行、そして自分の行や部分をすべてそのサイズで描くリスト、ツリービュー、アコーディオン、目次、説明リスト、テーブルです。

サイズが届くのはそこまでです。アコーディオン、説明リスト、テーブルは、中に置かれたものにサイズを渡しません。テーブルのセルに置いた Button は、自分のサイズか、テーブルを囲むコンテナのサイズで描かれます。また、コンテナからサイズをまったく受け取らないコンポーネントもあります。

  • メニュー(コンテキストメニューやメニューバーのメニューを含みます)、検索のビュー、セレクトとコンボボックスのリスト。どれもページの上に、周りのコントロールとは別に開くので、ツールバーを small にしても、そこにある Button が開くメニューは小さくなりません。メニューと検索は、自分の size を設定しなければ medium です。セレクトとコンボボックスの選択肢は、ボックスのサイズに従います。
  • ツールバーの中のセレクト、数値入力、テキスト入力、スライダー。どれも指定したサイズのままです。
  • タイムライン。サイズはテキストの大きさを表します。