# config-provider (w-config-provider)

- **Import**: `WConfigProvider` from `win-design-next`
- **Tag**: `<w-config-provider>`
- **说明**: Config Provider 全局配置
- **分类**: other
- **Skill 版本**: V1.1.0
- **适配组件库**: win-design-next 1.2.2
- **API 来源**: `docs/zh-CN/component/config-provider.md`

## API

## API

### Config Provider Attributes

| 属性名                 | 说明                                                   | 类型                                                                                                    | 默认值   |
| ---------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- | -------- |
| locale                 | 翻译文本对象                                           | ^[object]`{name: string, el: TranslatePair}`                                                            | en       |
| size                   | 全局组件大小                                           | ^[enum]`'large' \| 'default' \| 'mini' \| 'small'`                                                      | default  |
| zIndex                 | 全局初始化 zIndex 的值                                 | ^[number]                                                                                               | —        |
| namespace              | 全局组件类名称前缀 (需要配合 $namespace 使用)          | ^[string]                                                                                               | w3       |
| button                 | 按钮相关配置，[详见下表](#button-attribute)            | ^[object]`{autoInsertSpace?: boolean, debounce?: boolean, debounceTime?: number, winmonitor?: boolean}` | 详见下表 |
| message                | 消息相关配置， [详见下表](#message-attribute)          | ^[object]`{max?: number}`                                                                               | 详见下表 |
| experimental-features  | 将要添加的实验阶段的功能，所有功能都是默认设置为 false | ^[object]                                                                                               | —        |
| empty-values           | 输入类组件空值                                         | ^[array]                                                                                                | —        |
| value-on-clear         | 输入类组件清空值                                       | ^[string] / ^[number] / ^[boolean] / ^[Function]                                                        | —        |
| theme                  | 全局主题                                               | ^[enum]`'' \| 'sauce-purple' \| 'calendula' \| 'maternity-pink' \| 'innovation-green'`                  |          |
| fontSizeBase ^(1.1.18) | 全局字体大小基础值                                     | ^[enum]`'' \| '14px' \| '16px' \| '18px'`                                                               | 14px     |

### Button Attribute

| 参数            | 说明                                                                      | 类型       | 默认值 | Version |
| --------------- | ------------------------------------------------------------------------- | ---------- | ------ | ------- |
| autoInsertSpace | 两个中文字符之间自动插入空格(仅当文本长度为 2 且所有字符均为中文时才生效) | ^[boolean] | false  |
| debounce        | 是否开启防抖                                                              | ^[boolean] | false  | V0.0.7  |
| debounce-time   | 防抖时间                                                                  | ^[number]  | 200    | V0.0.7  |
| winmonitor      | 是否开启按钮点击上报日志                                                  | ^[boolean] | true   | V1.0.2  |

### Message Attribute

| 参数      | 描述                                         | 类型       | 默认值 |
| --------- | -------------------------------------------- | ---------- | ------ |
| max       | 可同时显示的消息最大数量                     | ^[number]  | —      |
| grouping  | 合并内容相同的消息，不支持 VNode 类型的消息  | ^[boolean] | —      |
| duration  | 显示时间，单位为毫秒。 设为 0 则不会自动关闭 | ^[number]  | —      |
| showClose | 是否显示关闭按钮                             | ^[boolean] | —      |
| offset    | Message 距离窗口顶部的偏移量                 | ^[number]  | —      |

### Config Provider Slots

| 名称    | 描述           | Scope                              |
| ------- | -------------- | ---------------------------------- |
| default | 自定义默认内容 | config: 提供全局配置（从顶部继承） |
