ConfigProvider 全局配置
全局配置的注入入口,统一管理包裹子树的 locale / size / theme。组件读取顺序:自身属性 > config-provider > 全局默认。
Locale 注入
config-provider 的 locale 就近优先于全局 setLocale():包裹内的组件用注入的 locale 翻译内置文案。
Locale 切换
Size 注入
包裹内组件的 size 未显式设置时走注入值;自身显式设置了 size 的组件仍以自身为准。size 支持 xs / small / medium(默认)/ large / xl 五档。
Size 注入
Theme 注入
config-provider 的 theme 会写入 data-theme 到自身,包裹的子树(含 Shadow DOM)继承对应主题 token。
Theme 注入
就近优先
内层 config-provider 覆盖外层:内层包裹的组件用内层配置,外层(未再嵌套)的组件用外层配置。
就近优先
API
属性
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
locale | 包裹子树的内置文案语言(需已注册),就近优先于全局 setLocale() | — | — |
size | 包裹组件的默认尺寸,组件自身未显式设置时生效 | — | — |
theme | 包裹子树的主题,写入 data-theme | — | — |
插槽
| 名称 | 说明 |
|---|---|
| 默认 | — |
- 组件读取顺序:自身属性 > config-provider > 全局默认。
locale需先registerLocale()注册语言包,未注册时回退全局 translator。