ConfigProvider 全局配置
uni-appH5微信小程序App
全局配置提供者。theme 渲染为容器上的 data-rn-theme 属性(配合 uniapp-themes.css 的 [data-rn-theme] 变量覆盖换肤);size/locale 通过 'rnConfig' provide/inject 下发给后代组件。纯配置组件,跨端无 DOM 依赖。
何时使用
局部子树换肤、统一下发默认尺寸等全局配置。
何时不使用
整应用换肤直接用 setRnTheme()(配合页面根节点 :data-rn-theme 绑定)。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
theme | string | - | 子树主题覆盖(classic/mono/mono-dark/aurora/aurora-dark),渲染为 data-rn-theme 属性;不传则不渲染该属性 |
size | string:'sm' | 'md' | 'lg' | - | 后代组件默认尺寸,经 rnConfig provide 下发(消费方自行 inject 兜底) |
locale | string | - | 语言包名(预留,如 zh-CN / en) |
Slots
| 名称 | 说明 |
|---|---|
default | 需要应用配置的子树 |
示例
局部主题
vue
<ConfigProvider theme="mono">
<view class="row">
<Button variant="primary">mono 主题</Button>
<Tag variant="primary">标签</Tag>
</view>
</ConfigProvider>局部尺寸与语言
vue
<ConfigProvider size="sm" locale="en">
<view class="row">
<Button variant="primary">Small</Button>
<Button loading>Loading</Button>
</view>
</ConfigProvider>极光主题
vue
<ConfigProvider theme="aurora">
<view class="row">
<Button variant="primary">aurora</Button>
<Progress :percent="70" style="flex:1" />
</view>
</ConfigProvider>