Skip to content

Config Provider 全局配置 ​

Config Provider 被用来提供全局的配置选项,让你的配置能够在全局都能够被访问到。

ts
import { createApp } from 'vue'
import { ElConfigProvider } from '@szhn/dh-design-pc'

const app = createApp()
app.use(ElConfigProvider)

i18n 配置 ​

通过 Config Provider 来配置多语言,让你的应用可以随时切换语言。

对按钮进行配置 ​

对链接进行配置 ​

对 Card 进行配置 ​

对 Dialog 进行配置 ​

对消息进行配置 ​

空值配置 ​

设置 empty-values 来配置组件的默认空值。 默认值是 ['', null, undefined]。 如果认为空字符串不是一个空值,可以设置成 [undefined, null]。

设置 value-on-clear 以设置清空选项的值。 组件默认值是 undefined。 在日期组件中是 null。 如果想设置成 undefined,请使用 () => undefined。

表格配置 ​

实验性功能 ​

在本节中,您可以学习如何使用 Config Provider 来提供实验性功能。 现在,我们还没有添加任何实验性功能,但在未来的规划中,我们将添加一些实验性功能。 您可以使用此配置来管理这些功能。

API ​

Config Provider Attributes ​

属性名说明类型默认值
locale翻译文本对象objecten
size全局组件大小enumdefault
zIndex全局初始化 zIndex 的值number—
namespace全局组件类名称前缀 (需要配合 $namespace 使用)stringel
button按钮相关配置,详见下表object详见下表
link链接相关的配置, 见下表object详见下表
dialogdialog 相关的配置, 见下表object详见下表
message消息相关配置, 详见下表object详见下表
experimental-features将要添加的实验阶段的功能,所有功能都是默认设置为 falseobject—
empty-values输入类组件空值array—
value-on-clear输入类组件清空值string / number / boolean / Function—
table表格相关配置, 详见下表object详见下表

Button Attribute ​

参数描述类型默认值
type按钮类型,在设置color时,后者优先。enum—
autoInsertSpace两个中文字符之间自动插入空格(仅当文本长度为 2 且所有字符均为中文时才生效)booleanfalse
plain是否为朴素按钮booleanfalse
text是否为文字按钮booleanfalse
round是否为圆角按钮booleanfalse
dashed是否是虚线按钮booleanfalse

链接属性 ​

参数描述类型默认值
type类型enumdefault
underline控制下划线是否出现enumhover

Card Attribute ​

属性描述类型默认值
shadow设置阴影显示时机enum—

Dialog 属性 ​

属性描述类型默认值
align-center是否水平垂直对齐对话框booleanfalse
draggable为 Dialog 启用可拖拽功能booleanfalse
overflow拖动范围可以超出可视区booleanfalse
transition对话框动画的自定义过渡配置。 可以是一个字符串(过渡名称),也可以是一个包含 Vue 过渡属性的对象。string / object—

Message Attribute ​

属性详情类型默认值
max可同时显示的消息最大数量number—
grouping合并内容相同的消息,不支持 VNode 类型的消息boolean—
duration显示时间,单位为毫秒。 设为 0 则不会自动关闭number—
showClose是否显示关闭按钮boolean—
offsetMessage 距离窗口顶部的偏移量number—
plain是否纯色boolean—
placement消息放置位置enum—

Table Attribute ​

属性详情TypeDefault
show-overflow-tooltip是否隐藏额外内容并在单元格悬停时使用 Tooltip 显示它们。这将影响全部列的展示,详请参考tooltip-optionsboolean—
tooltip-effect溢出的 tooltip 的 effectenumdark
tooltip-options溢出 tooltip 的选项,参见下述 tooltip 组件objectobject
tooltip-formatter使用 show-overflow-tooltip 时自定义 tooltip 内容Function—

Config Provider Slots ​

名称DescriptionType
default自定义默认内容config: 提供全局配置(从顶部继承)