Skip to content

ConfigProvider 全局配置

全局配置的注入入口,统一管理包裹子树的 locale / size / theme。组件读取顺序:自身属性 > config-provider > 全局默认。

Locale 注入

config-provider 的 locale 就近优先于全局 setLocale():包裹内的组件用注入的 locale 翻译内置文案。

Locale 切换

中文English可关闭标签这是一条警告提示

Size 注入

包裹内组件的 size 未显式设置时走注入值;自身显式设置了 size 的组件仍以自身为准。size 支持 xs / small / medium(默认)/ large / xl 五档。

Size 注入

超小小号中号大号超大注入按钮自身小号注入标签

Theme 注入

config-provider 的 theme 会写入 data-theme 到自身,包裹的子树(含 Shadow DOM)继承对应主题 token。

Theme 注入

浅色深色主题按钮跟随主题

就近优先

内层 config-provider 覆盖外层:内层包裹的组件用内层配置,外层(未再嵌套)的组件用外层配置。

就近优先

外层 en内层 zh-CN

API

属性

属性说明类型默认值
locale包裹子树的内置文案语言(需已注册),就近优先于全局 setLocale()
size包裹组件的默认尺寸,组件自身未显式设置时生效
theme包裹子树的主题,写入 data-theme

插槽

名称说明
默认
  • 组件读取顺序:自身属性 > config-provider > 全局默认。
  • locale 需先 registerLocale() 注册语言包,未注册时回退全局 translator。