UniApp 组件 · 实验

UGConfigProvider 全局配置

向组件树提供命名空间、尺寸和禁用状态等全局默认值。

组件预览

以下画面来自同一组件源码的 H5 构建，用于检查内容、状态和主题；MP-WEIXIN 最终外观仍以开发者工具和真机为准。

使用方式

配置 easycom 后直接使用 <ug-config-provider>，无需在页面脚本中导入组件。

vue

<template>
  <ug-config-provider mode="dark" size="lg" motion="standard">
    <ug-space direction="vertical" block>
      <ug-text tone="secondary">深色小程序区域</ug-text>
      <ug-button>主要操作</ug-button>
    </ug-space>
  </ug-config-provider>
</template>

easycom 公开入口：@ug666/ui-uniapp/components/ug-config-provider/ug-config-provider.vue

属性

属性	类型	默认值	说明
mode	'light' \| 'dark'	继承，根节点 light	设置当前子树的明暗模式。
size	'sm' \| 'md' \| 'lg'	继承，根节点 md	设置支持继承的控件默认尺寸。
disabled	boolean	继承，根节点 false	设置支持继承的控件默认禁用状态。
namespace	string	继承，根节点 ug	设置调试和数据标记使用的命名空间。
motion	'reduced' \| 'standard' \| 'lively'	继承，根节点 standard	统一设置当前子树的状态反馈与持续加载动效。
tokens	Partial<UGUniThemeTokens>	{}	局部覆盖当前平台 Token。

事件

当前组件没有公开事件。

注意事项

Provider 可以嵌套，未传属性继续继承父级配置。
当前 Token 是 UniApp 平台本地映射，不读取 Web CSS 变量。
reduced 会关闭按压缩放和持续加载动画；系统减少动效偏好同样会关闭 CSS 动画。

平台边界

总览中的画面来自同一组件源码的 H5 构建，只用于辅助浏览；小程序真实外观仍以 Demo 在微信开发者工具和真机中的结果为准。

MP-WEIXIN 已编译开发者工具与真机待验证