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 | 비활성화 상태의 아이콘 색상을 설정합니다. 기본은 어두운 색이며, 다크 테마에서는 밝은 색입니다. |