mduiには、Material Designの19のプライマリカラーと16のアクセントカラーが組み込まれています。すべての色(背景色におけるテキストの色、テキストの不透明度を含む)は、Material Designの公式ドキュメントと一致しています。
Material Designにおけるカラーは、プライマリカラー(Primary)とアクセントカラー(Accent)に分けられ、各カラーには複数の異なる彩度があります。
以降のドキュメントのCSSクラス名では、[color] はカラー名、[degree] は彩度を表します。
背景色のクラス名は .mdui-color-[color]-[degree] です。これは背景色を設定すると同時に、その背景色に適したテキストの色とテキストの不透明度も設定します。
また、プライマリカラーとアクセントカラーには、それぞれデフォルトの背景色クラスがあります:
.mdui-color-[color] は .mdui-color-[color]-500 と等価です。.mdui-color-[color]-accent は .mdui-color-[color]-a200 と等価です。<div class="mdui-color-blue-200">mdui-color-blue-200</div>
<div class="mdui-color-blue">mdui-color-blue</div>
<div class="mdui-color-pink-accent">mdui-color-pink-accent</div>
<div class="mdui-color-pink-a200">mdui-color-pink-a200</div>利用可能なすべての背景色クラス名は、下のカラーリファレンスにリストされています。
テキストカラーのクラス名は .mdui-text-color-[color]-[degree] です。
また、プライマリカラーとアクセントカラーには、それぞれデフォルトのテキストカラークラスがあります:
.mdui-text-color-[color] は .mdui-text-color-[color]-500 と等価です。.mdui-text-color-[color]-accent は .mdui-text-color-[color]-a200 と等価です。<div class="mdui-text-color-blue-900">mdui-text-color-blue-900</div>
<div class="mdui-text-color-blue">mdui-text-color-blue</div>
<div class="mdui-text-color-blue-a200">mdui-text-color-blue-a200</div>
<div class="mdui-text-color-blue-accent">mdui-text-color-blue-accent</div>さらに、mduiは不透明度を持つ黒と白のテキストカラーおよびアイコンカラーを提供しています。
.mdui-text-color-black-* はライト背景用です。.mdui-text-color-white-* はダーク背景用です。mduiはテーマ機能を提供しており、bodyにいくつかのクラスを追加するだけで、プライマリカラー、アクセントカラー、背景色を切り替えることができます。
mduiのほとんどのコンポーネントにはデフォルトの色がありますが、テーマカラーを設定すると、これらのコンポーネントの色もデフォルトからテーマカラーに置き換わります。
bodyにクラス .mdui-theme-primary-[color] を追加して、プライマリカラーを設定します。
ページ内で以下のクラスを使用すると、bodyで設定されたテーマカラーの変化に合わせて色が自動的に変わります:
.mdui-color-theme.mdui-color-theme-[degree].mdui-text-color-theme.mdui-text-color-theme-[degree]bodyにクラス .mdui-theme-accent-[color] を追加して、アクセントカラーを設定します。
ページ内で以下のクラスを使用すると、bodyで設定されたテーマカラーの変化に合わせて色が自動的に変わります:
.mdui-color-theme-accent.mdui-color-theme-[degree].mdui-text-color-theme-accent.mdui-text-color-theme-[degree]bodyにクラス .mdui-theme-layout-dark を追加するだけで、ページ全体(コンポーネントを含む)をダークテーマに設定できます。
bodyにクラス .mdui-theme-layout-auto を追加すると、オペレーティングシステムのテーマに合わせて、ページ全体(コンポーネントを含む)の背景色が自動的に調整されます。
また、ページ内で以下のクラスを使用すると、テーマカラーに応じて色が変化します。ライトテーマのときは暗く、ダークテーマのときは明るく表示されます。
.mdui-text-color-theme-text.mdui-text-color-theme-secondary.mdui-text-color-theme-disabled.mdui-text-color-theme-divider.mdui-text-color-theme-icon.mdui-text-color-theme-icon-disabledページの右上にある color_lens アイコンをクリックして、テーマカラーを設定できます。以下のカラーチャートのプライマリカラー、アクセントカラー、テーマカラーもそれに応じて変化します。
| クラス名 | 説明 |
|---|---|
.mdui-theme-primary-[color] | テーマのプライマリカラーを設定します(<body> 要素に追加します)。 |
.mdui-theme-accent-[color] | テーマのアクセントカラーを設定します(<body> 要素に追加します)。 |
.mdui-theme-layout-dark | ダークテーマに設定します(<body> 要素に追加します)。 |
| クラス名 | 説明 |
|---|---|
.mdui-color-[color] | 指定したプライマリカラーの背景色を設定します。 |
.mdui-color-[color]-accent | 指定したアクセントカラーの背景色を設定します。 |
.mdui-color-[color]-[degree] | 指定したカラーと彩度の背景色を設定します。 |
.mdui-color-theme | bodyで定義されたプライマリカラーのテーマに基づいて背景色を設定します。 |
.mdui-color-theme-accent | bodyで定義されたアクセントカラーのテーマに基づいて背景色を設定します。 |
.mdui-color-theme-[degree] | bodyで定義されたプライマリカラーまたはアクセントカラーのテーマに基づいて、指定した彩度の背景色を設定します。 |
.mdui-color-black | 完全な黒の背景色を設定します。 |
.mdui-color-white | 完全な白の背景色を設定します。 |
.mdui-color-transparent | 透明な背景色を設定します。 |
| クラス名 | 説明 |
|---|---|
.mdui-text-color-[color] | 指定したプライマリカラーのテキストカラーを設定します。 |
.mdui-text-color-[color]-accent | 指定したアクセントカラーのテキストカラーを設定します。 |
.mdui-text-color-[color]-[degree] | 指定したカラーと彩度のテキストカラーを設定します。 |
.mdui-text-color-theme | bodyでのプライマリカラーのテーマに基づいてテキストカラーを設定します。 |
.mdui-text-color-theme-accent | bodyでのアクセントカラーのテーマに基づいてテキストカラーを設定します。 |
.mdui-text-color-theme-[degree] | bodyでのプライマリカラーまたはアクセントカラーに基づいて、指定した彩度のテキストカラーを設定します。 |
ダークテキストカラー。ライト背景で使用します:
| クラス名 | 説明 |
|---|---|
.mdui-text-color-black | 完全な黒のテキストカラーを設定します。 |
.mdui-text-color-black-text | メインテキストのカラーを設定します。 |
.mdui-text-color-black-secondary | サブテキストのカラーを設定します。 |
.mdui-text-color-black-disabled | 無効状態のテキストカラーを設定します。 |
.mdui-text-color-black-divider | 区切り線のカラーを設定します。 |
.mdui-text-color-black-icon | アイコンのカラーを設定します。 |
.mdui-text-color-black-icon-disabled | 無効状態のアイコンカラーを設定します。 |
ライトテキストカラー。ダーク背景で使用します:
| クラス名 | 説明 |
|---|---|
.mdui-text-color-white | 完全な白のテキストカラーを設定します。 |
.mdui-text-color-white-text | メインテキストのカラーを設定します。 |
.mdui-text-color-white-secondary | サブテキストのカラーを設定します。 |
.mdui-text-color-white-disabled | 無効状態のテキストカラーを設定します。 |
.mdui-text-color-white-divider | 区切り線のカラーを設定します。 |
.mdui-text-color-white-icon | アイコンのカラーを設定します。 |
.mdui-text-color-white-icon-disabled | 無効状態のアイコンカラーを設定します。 |
テーマカラーに応じて変化するダークまたはライトのテキストカラー:
| クラス名 | 説明 |
|---|---|
.mdui-text-color-theme-text | メインテキストのカラーを設定します。 デフォルトはダークで、ダークテーマではライトになります。 |
.mdui-text-color-theme-secondary | サブテキストのカラーを設定します。 デフォルトはダークで、ダークテーマではライトになります。 |
.mdui-text-color-theme-disabled | 無効状態のテキストカラーを設定します。 デフォルトはダークで、ダークテーマではライトになります。 |
.mdui-text-color-theme-divider | 区切り線のカラーを設定します。 デフォルトはダークで、ダークテーマではライトになります。 |
.mdui-text-color-theme-icon | アイコンのカラーを設定します。 デフォルトはダークで、ダークテーマではライトになります。 |
.mdui-text-color-theme-icon-disabled | 無効状態のアイコンカラーを設定します。 デフォルトはダークで、ダークテーマではライトになります。 |