全局配置
全局配置组件用于提供全局的配置选项,让你的应用下的所有组件都能访问到这些配置。
国际化配置
通过全局配置组件来配置国际化相关的属性,来实现语言切换的功能。
按钮配置
链接配置 2.9.11
卡片配置 2.10.5
对话框配置 2.10.7
消息配置
空值配置 2.7.0
支持的组件列表
- 级联选择器
- 颜色选择器 2.10.3
- 日期选择器
- 选择器
- 虚拟化选择器
- 时间选择器
- 时间选择
- 树形选择
设置 empty-values 来支持组件的空值。后备值是 ['', null, undefined]。如果你认为空字符串是有意义的,请写成 [undefined, null]。
设置 value-on-clear 来设置清空时的返回值。后备值是 undefined。在日期组件中是 null。如果你想设置为 undefined,请使用 () => undefined。
实验性功能
在本节中,你可以学习如何使用全局配置来提供实验性功能。目前我们还没有添加任何实验性功能,但在未来的路线图中,我们会添加一些实验性功能。你可以使用此配置来管理你想要或不想要的功能。
API
Config Provider 属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| 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 | — |
Button 属性
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| 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 |
Link 属性
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| type 2.9.11 | type | 枚举 | default |
| underline 2.9.11 | 何时应出现下划线 | 枚举 | 悬浮时 |
Card 属性
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| shadow 2.10.5 | 何时显示卡片阴影 | 枚举 | — |
Dialog 属性
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| 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 属性
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| 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 | 消息放置位置 | 枚举 | — |
Config Provider 插槽
| 名称 | 描述 | 类型 |
|---|---|---|
| default | 自定义默认内容 | config:提供的全局配置(从顶部继承) |