Config Provider 全局配置

Config Provider 用于提供全局配置,使应用内任意位置都能访问这些配置。

国际化

通过 Config Provider 配置语言相关属性,即可实现语言切换。

使用 localei18n 等属性提供国际化配置。


暂无数据
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 10
前往
共 100 条

按钮

链接

Type:
Underline:
Link desu!

卡片

Shadow:
Card desu!

对话框

transition: string

消息

空值与清空

支持的组件
  • Cascader
  • ColorPicker
  • DatePicker
  • Select
  • SelectV2
  • TimePicker
  • TimeSelect
  • TreeSelect

通过 empty-values 定义哪些值视为「空」。默认相当于 ['', null, undefined]。若认为空字符串是有意义的取值,可改为 [undefined, null]

通过 value-on-clear 设置清空后的返回值。默认一般为 undefined;日期类组件中多为 null。若需要返回 undefined,可传入 () => undefined

表格

实验性功能

本节说明如何通过 Config Provider 开启实验特性。当前尚未内置具体实验项;后续路线图中会逐步加入,可用该配置统一管理是否启用。

API

Config Provider 属性

名称说明类型默认值
locale语言包对象object 语言列表en
size全局组件尺寸enumdefault
zIndex全局初始 z-indexnumber
namespace组件类名前缀(与 $namespace 配合)stringel
button按钮相关默认配置,见下表object见下表
link链接相关默认配置,见下表object见下表
dialog对话框相关默认配置,见下表object见下表
message消息相关默认配置,见下表object见下表
experimental-features实验特性开关,未列出的项默认为 falseobject
empty-values全局「空值」列表array
value-on-clear全局清空后的返回值string / number / boolean / Function
table表格相关默认配置,见下表object见下表

按钮默认项

属性说明类型默认值
type按钮类型;若同时设置 color,以后者为准enum
autoInsertSpace是否在两个汉字之间自动插入空格(仅当文案长度为 2 且均为中文时生效)booleanfalse
plain是否为朴素按钮booleanfalse
text是否为文字按钮booleanfalse
round是否为圆角按钮booleanfalse
dashed是否为虚线按钮booleanfalse
属性说明类型默认值
type类型enumdefault
underline下划线出现时机enumhover

卡片默认项

属性说明类型默认值
shadow阴影展示时机enum

对话框默认项

属性说明类型默认值
align-center是否在水平、垂直方向居中booleanfalse
draggable是否可拖拽booleanfalse
overflow可拖拽时是否允许超出视口较长距离booleanfalse
transition自定义过渡,可为过渡名称字符串或 Vue Transition 配置对象string / object

消息默认项

属性说明类型默认值
max同时最多展示条数number
grouping是否合并相同内容(VNode 类型消息不支持)boolean
duration显示时长(毫秒);为 0 时不自动关闭number
showClose是否显示关闭按钮boolean
offset距离视口顶部的偏移number
plain是否为朴素样式boolean
placement出现位置enum

表格默认项

属性说明类型默认值
show-overflow-tooltip单元格内容过长时是否省略并以 Tooltip 展示;作用于全部列,详见 tooltip-optionsboolean / [object]
tooltip-effect溢出提示的主题enumdark
tooltip-options溢出提示的配置,参见 Tooltip 属性objectobject
tooltip-formatter使用 show-overflow-tooltip 时自定义提示内容Function

Config Provider 插槽

名称说明类型
default自定义默认内容config:由上层继承而来的全局配置对象