shop-wx/doc/wot-design-uni/docs/guide/custom-theme.md

122 lines
5.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 自定义主题
Wot UI 每个组件基本都有自定义类名 custom-class可以在组件根节点加入你页面上的类名进行样式修改。
## 主题介绍
### 主要变量介绍
以下样式变量在多个组件中被使用,通过修改这些主要变量,可以快速定义一套自定义主题。
**主题色**为:
<div class="style-block" style="background: #4D80F0;">
<p>Theme Color</p>
<p>$-color-theme: #4D80F0</p>
</div>
**主题品牌色-小渐变(按钮,渐变更弱)色**
<div class="color-wrapper">
<span class="style-block liner-color" style="background: linear-gradient(315deg, rgba(79,124,248,1) 0%,rgba(102,141,248,1) 100%);">
<span class="a-dot"></span>
<span class="b-dot"></span>
</span>
<div class="demo-right">
<i>渐变倾斜角度45度左上角较浅右下角较深</i>
<ul>
<li>A: <span class="color-block" style="background: #668DF8">#668DF8</span></li>
<li>B: <span class="color-block" style="background: #4F7CF8">#4F7CF8</span></li>
</ul>
</div>
</div>
**品牌色-大渐变(大面积背景色/插件icon底色渐变更强**
<div class="color-wrapper">
<span class="style-block liner-color liner-color1" style="background: linear-gradient(315deg, rgba(81,124,240,1) 0%,rgba(118,158,245,1) 100%);">
<span class="a-dot"></span>
<span class="b-dot"></span>
</span>
<div class="demo-right">
<i>渐变倾斜角度45度右上角较浅左下角较深</i>
<ul>
<li>A: <span class="color-block" style="background: #769EF5">#769EF5</span></li>
<li>B: <span class="color-block" style="background: #517CF0">#517CF0</span></li>
</ul>
</div>
</div>
**功能色**
<div class="style-block" style="background: #4D80F0;">
<p>Theme Color</p>
<p>$-color-theme: #4D80F0</p>
</div>
<div class="style-block" style="background: #34d19d;">
<p>Success Color</p>
<p>$-color-success: #34d19d</p>
</div>
<div class="style-block" style="background: #f0883a;">
<p>Warning Color</p>
<p>$-color-warning: #f0883a</p>
</div>
<div class="style-block" style="background: #fa4350;">
<p>Danger Color</p>
<p>$-color-danger: #fa4350</p>
</div>
**辅助色**
<div class="style-block" style="background: #8268de;">
<p>#8268de</p>
</div>
<div class="style-block" style="background: #fa4350;">
<p>#fa4350</p>
</div>
<div class="style-block" style="background: #f0883a;">
<p>#f0883a</p>
</div>
<div class="style-block" style="background: #f0cf1d;">
<p>#f0cf1d</p>
</div>
<div class="style-block" style="background: #34d19d;">
<p>#34d19d</p>
</div>
<div class="style-block" style="background: #2bb3ed;">
<p>#2bb3ed</p>
</div>
### 中性色
中性色用于文本、背景和边框颜色。通过运用不同的中性色,来表现层次结构。
<ul class="color-group">
<li class="color-group-line" style="background: rgba(0,0,0,1);color: #fff">100%<div>重要文字</div></li>
<li class="color-group-line" style="background: rgba(0,0,0,0.85);color: #fff">85%<div>普通文字</div></li>
<li class="color-group-line" style="background: rgba(0,0,0,0.65);color: #fff">65%<div>遮罩、次要文字<br/>仅在层级复杂时使用</div></li>
<li class="color-group-line" style="background: rgba(0,0,0,0.45);color: #fff">45%<div>辅助文字、次级按钮边框线</div></li>
<li class="color-group-line" style="background: rgba(0,0,0,0.25);color: rgba(0,0,0,0.65)">25%<div>失效、默认提示文字</div></li>
<li class="color-group-line" style="background: rgba(0,0,0,0.15);color: rgba(0,0,0,0.65)">15%<div>控件边框线</div></li>
<li class="color-group-line" style="background: rgba(0,0,0,0.09);color: rgba(0,0,0,0.65)">9%<div>若交叉使用则为实色#E8E8E8</div></li>
<li class="color-group-line" style="background: rgba(0,0,0,0.04);color: rgba(0,0,0,0.65)">4%<div>背景色、禁用填充色</div></li>
<li class="color-group-line" style="background: rgba(0,0,0,0.02);color: rgba(0,0,0,0.65)">2%<div>表头填充色</div></li>
</ul>
<ul class="color-group dark">
<li class="color-group-line" style="background: rgba(255,255,255,1);color: rgba(0,0,0,0.65)">100%<div>重要文字</div></li>
<li class="color-group-line" style="background: rgba(255,255,255,0.85);color: rgba(0,0,0,0.65)">85%<div>普通文字</div></li>
<li class="color-group-line" style="background: rgba(255,255,255,0.65);color: rgba(0,0,0,0.65)">65%<div>遮罩、次要文字<br/>仅在层级复杂时使用</div></li>
<li class="color-group-line" style="background: rgba(255,255,255,0.45);color: rgba(255,255,255,0.65)">45%<div>辅助文字、次级按钮边框线</div></li>
<li class="color-group-line" style="background: rgba(255,255,255,0.25);color: rgba(255,255,255,0.65)">25%<div>失效、默认提示文字</div></li>
<li class="color-group-line" style="background: rgba(255,255,255,0.15);color: rgba(255,255,255,0.65)">15%<div>控件边框线</div></li>
<li class="color-group-line" style="background: rgba(255,255,255,0.09);color: rgba(255,255,255,0.65)">9%<div>若交叉使用则为实色#E8E8E8</div></li>
<li class="color-group-line" style="background: rgba(255,255,255,0.04);color: rgba(255,255,255,0.65)">4%<div>背景色、禁用填充色</div></li>
<li class="color-group-line" style="background: rgba(255,255,255,0.02);color: rgba(255,255,255,0.65)">2%<div>表头填充色</div></li>
</ul>
## 定制主题
我们为每个组件提供了`css 变量`,可以参考[config-provider](../component/config-provider)组件的使用介绍来定制主题。