跳到主要内容

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 演示。

9:41
ConfigProvider 全局配置 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
themestring-子树主题覆盖(classic/mono/mono-dark/aurora/aurora-dark),渲染为 data-rn-theme 属性;不传则不渲染该属性
sizestring:'sm' | 'md' | 'lg'-后代组件默认尺寸,经 rnConfig provide 下发(消费方自行 inject 兜底)
localestring-语言包名(预留,如 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>