Skip to content
On this page

ThemeProvider

我们提供了主题配置组件 ThemeProvider,可以很方便的对主题进行配置。

使用示例

vue
<template>
  <ThemeProvider :color="color" :size="size">
    <stepin-view ...>
      ...
    </stepin-view>
  </ThemeProvider>
</template>
<script lang="ts" setup>
  import { ThemeProvider } from 'stepin/es/theme-provider'

  const color = {
    middle: {
      'bg-base': '#134562'
    },
    primary: {
      DEFAULT: '#1865f4'
    },
    error: {
      DEFAULT: '#ff0000'
    },
  }

  const size = {
    'width-side': '240px',
    'width-side-collapsed': '96px'
  }
</script>

ThemeProvider

props类型默认值描述
colorThemeColor--颜色配置
sizeSize--尺寸配置
paddingPadding--内间距配置
marginMargin--外间距配置
fontFont--字体配置
shadowShadow--阴影配置
radiusRadius--圆角配置
isRootbooleanfalse主题配置是否挂载到根节点(:root)
themeClassNamestring--主题配置挂载目标样式类名。如 themeClassName="myClass",则表明主题配置的相关 css 变量都将添加至 myClass 类上
applyStylebooleantrue是否给ThemeProvider的一级子节点添加基础样式。如果为 true, 则会为一级子节点添加 text-textbg-container

ThemeColor

props类型默认值描述
primarySeriesColor--主题色系列色
infoSeriesColor--信息色系列色
successSeriesColor--成功色系列色
warningSeriesColor--警告色系列色
errorSeriesColor--错误色系列色
middleMiddleColor--中性色系列色

SeriesColor

props类型默认值描述
DEFAULTstring--默认色
bgstring--背景色
bg-hoverstring--背景色悬浮态
borderstring--边框色
border-hoverstring--边框色悬浮态
hoverstring--悬浮色
activestring--激活色
textstring--文本色
text-hoverstring--文本色悬浮态
text-activestring--文本色激活态

MiddlerColor

props类型默认值描述
text-basestring--文本基色
textstring--文本色
text-1string--一级文本色
text-2string--二级文本色
text-3string--三级文本色
text-4string--四级文本色
subtextstring--次级文本色
text-disabledstring--禁用文本色
fillstring--填充色
fill-1string--一级填充色
fill-2string--二级填充色
fill-3string--三级填充色
fill-4string--四级填充色
shadowstring--阴影
shadow-lightstring--淡色阴影
borderstring--边框色
border-1string--一级边框色
border-2string--二级边框色
bg-basestring--背景基色
bg-layoutstring--布局背景色
bg-containerstring--容器背景色
bg-container-lightstring--容器背景色(淡)
bg-popoverstring--浮窗背景色
bg-spotlightstring--焦点背景色
bg-maskstring--遮罩背景色
bg-hoverstring--悬浮背景色
bg-disabledstring--禁用背景色
bg-sidestring--侧边背景色
bg-headerstring--顶部背景色
bg-menustring--菜单背景色
bg-submenustring--子级菜单背景色

Size

props类型默认值描述
width-sidestring--侧边宽度
width-side-collapsedstring--侧边收缩宽度
height-headerstring--顶部高度
height-footerstring--底部高度

Padding

props类型默认值描述
basestring--基础间距
defaultstring--默认间距
xxsstring--xxs 间距
xsstring--xs 间距
smstring--sm 间距
mdstring--md 间距
lgstring--lg 间距
xlstring--xl 间距

Margin

props类型默认值描述
basestring--基础间距
defaultstring--默认间距
xxsstring--xxs 间距
xsstring--xs 间距
smstring--sm 间距
mdstring--md 间距
lgstring--lg 间距
xlstring--xl 间距

Font

props类型默认值描述
font-sizestring--默认字号
font-size-xsstring--xs 字号
font-size-smstring--sm 字号
font-size-mdstring--md 字号
font-size-lgstring--lg 字号
font-size-xlstring--xl 字号
font-size-xxlstring--xxl 字号
font-size-xxxlstring--xxxl 字号
leadingstring--默认行高
leading-smstring--sm 行高
leading-lgstring--lg 行高
leading-head-1string--1号标题行高
leading-head-2string--2号标题行高
leading-head-3string--3号标题行高
leading-head-4string--4号标题行高
leading-head-5string--5号标题行高

Shadow

props类型默认值描述
box-shadow-1string--一级阴影
box-shadow-2string--二级阴影
box-shadow-3string--三级阴影

Radius

props类型默认值描述
radius-basestring--基础圆角
radius-xsstring--xs 圆角
radius-smstring--sm 圆角
radius-mdstring--md 圆角
radius-lgstring--lg 圆角