全局配置 Config Provider
Config Provider 用于提供全局配置,使您的整个应用可以在任何地方访问这些配置。
国际化配置 i18n Configurations
通过 Config Provider 配置国际化相关属性,以获得语言切换功能。
使用两个属性提供国际化相关配置
按钮配置 Button Configurations
链接配置 Link Configurations 2.9.11
类型
下划线
卡片配置 Card Configurations 2.10.5
对话框配置 Dialog Configurations 2.10.7
消息提示配置 Message Configurations
空值配置 Empty Values Configurations 2.7.0
支持的组件列表
- 级联选择器
- 颜色选择器 ColorPicker 2.10.3
- 日期选择器 DatePicker
- 选择器
- 虚拟化选择器 SelectV2
- 时间选择器 TimePicker
- 时间选择 TimeSelect
- 树形选择 TreeSelect
设置 empty-values 以支持组件的空值。回退值为 ['', null, undefined]。如果您认为空字符串是有意义的,请写成 [undefined, null]。
设置 value-on-clear 以设置清除时的返回值。回退值为 undefined。在日期组件中为 null。如果要设置 undefined,请使用 () => undefined。
表格配置 Table Configurations 2.13.3
实验性特性 Experimental features
在本节中,您可以了解如何使用 Config Provider 提供实验性特性。目前我们还没有添加任何实验性特性,但在特性路线图中,我们将添加一些实验性特性。您可以使用此配置来管理您想要或不需要的特性。
API
全局配置属性 Config Provider Attributes
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| locale | 语言对象 | object 语言列表 | en |
| size | 全局组件大小 | 枚举 | default |
| zIndex | 全局初始 zIndex | number | — |
| namespace | 全局组件类名前缀(与 $namespace 配合使用) | string | el |
| button | 按钮相关配置,详见下表 | object | 详见下表 |
| link | 链接相关配置,详见下表 | object | 详见下表 |
| 对话框 dialog 2.10.7 | 对话框相关配置,详见下表 | object | 详见下表 |
| message | 消息相关配置,详见下表 | object | 详见下表 |
| experimental-features | 待添加的实验阶段特性,所有特性默认为 false | object | — |
| empty-values 2.7.0 | 组件的全局空值 | array | — |
| value-on-clear 2.7.0 | 全局清除返回值 | string / number / boolean / Function | — |
| 表格 table 2.13.3 | 表格相关配置,详见下表 | object | 详见下表 |
按钮属性 Button Attribute
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| type 2.9.11 | 按钮类型,当设置 color 时,后者优先 | 枚举 | — |
| autoInsertSpace | 自动在两个中文字符之间插入一个空格(这只在文本长度为2且所有字符都是中文时生效。) | boolean | false |
| plain 2.9.11 | 判断是否为朴素按钮 | boolean | false |
| text 2.11.0 | 判断是否为文本按钮 | boolean | false |
| round 2.9.11 | 判断是否为圆形按钮 | boolean | false |
| 虚线 2.13.3 | 决定是否为虚线按钮 | boolean | false |
链接属性 Link Attribute
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| type 2.9.11 | type | 枚举 | default |
| underline 2.9.11 | 何时应出现下划线 | 枚举 | 悬浮时 |
卡片属性 Card Attribute
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| shadow 2.10.5 | 何时显示卡片阴影 | 枚举 | — |
对话框属性 Dialog Attribute
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| align-center 2.10.7 | 对话框是否水平和垂直对齐 | boolean | false |
| draggable 2.10.7 | 为 Dialog 启用可拖拽功能 | boolean | false |
| overflow 2.10.7 | 可拖拽对话框是否可以超出视口边界 | boolean | false |
| transition 2.10.7 | 对话框动画的自定义过渡配置。可以是一个字符串 (过渡名称) 或一个带有 Vue 过渡 props 的对象 | string / object | — |
消息属性 Message Attribute
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| max | 同时显示的消息最大数量 | number | — |
| grouping 2.8.2 | 合并内容相同的消息,不支持 VNode 类型的消息 | boolean | — |
| duration 2.8.2 | 显示时长,毫秒。设为 0 则不会自动关闭 | number | — |
| showClose 2.8.2 | 是否显示关闭按钮 | boolean | — |
| offset 2.8.2 | 设置距离视口顶部的距离 | number | — |
| plain 2.9.11 | 消息是否为朴素样式 | boolean | — |
| placement 2.11.0 | 消息放置位置 | 枚举 | — |
表格属性 Table Attribute 2.13.3
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| show-overflow-tooltip | 当内容超出单元格时,是否隐藏额外内容并悬浮显示 tooltip。这会影响所有表格列,请参考表格 tooltip-options | boolean / [object] | — |
| tooltip-effect | 超出部分 tooltip 的 effect 属性 | 枚举 | 暗黑模式 |
| tooltip-options | 超出部分 tooltip 的配置项,详见下方的 tooltip 组件 | object | object |
| tooltip-formatter | 使用 show-overflow-tooltip 时自定义 tooltip 内容 | Function | — |
全局配置插槽 Config Provider Slots
| 名称 | 描述 | 类型 |
|---|---|---|
| default | 自定义默认内容 | config:提供的全局配置(继承自顶部) |