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 | 設定停用狀態的圖示顏色。 預設為深色,深色主題下為淺色。 |