Config Provider 全局配置 ​

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

字体大小配置 1.3.4 ​

通过 Config Provider 来配置字体大小,让你的应用可以随时切换字体大小。必须在应用根节点的 ConfigProvider 上设置 fontSizeBase。

字号 class 与 CSS 变量挂在 ConfigProvider 的父级元素上(找不到则回退 <html>),不额外包一层 DOM。例如示例中外层挂到 .parent、内层挂到 .child。组件树内的 Teleport 浮层(DatePicker / Dropdown / Select / Tooltip / Dialog / Modal / Drawer 等)跟随最近的 ConfigProvider,把字号 CSS 变量写回浮层根节点。WMessage / WNotification / WMessageBox / v-loading 等命令式 API 跟随全局配置(应用根上的 ConfigProvider)。

使用 fontSizeBase 属性来提供字体大小相关配置(含 DatePicker 面板、Dialog / Modal 等 teleport 浮层)

外层 16px:
内层(切换 14px):

5 种主题配置 ​

通过 Config Provider 来配置 5 种主题,让你的应用可以随时切换主题。

使用 theme 属性来提供主题相关配置

i18n 配置 ​

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

使用两个属性来提供 i18n 相关配置


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

对按钮进行配置 ​

开启防抖

对开关进行配置 ​

通过 switch 属性对开关进行全局配置,例如 width 与 inline-prompt,组件未显式设置时将继承全局配置。

开

对链接进行配置 ​

通过 link 属性对链接进行全局配置。

Type:
Underline:
Link desu!

对 Card 进行配置 ​

通过 card 属性对卡片进行全局配置。

Shadow:
Card desu!

对 Dialog 进行配置 ​

通过 dialog 属性对对话框进行全局配置,支持 align-center、draggable、overflow 与自定义 transition。

transition: string

对消息进行配置 ​

空值配置 ​

支持的组件
  • Cascader 级联选择器
  • DatePicker 日期选择器
  • Select 选择器
  • SelectV2 选择器
  • TimePicker 时间选择器
  • TimeSelect 时间选择
  • TreeSelect 树形选择

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

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

Select

表格配置 ​

通过 table 属性对表格进行全局配置,例如 show-overflow-tooltip 与 tooltip-effect,未在列上显式设置时将继承全局配置。

实验性功能 ​

通过 experimental-features 配置实验阶段的功能,所有功能默认设置为 false。目前暂未添加任何实验性功能,后续规划中会通过该配置进行管理。

API ​

Config Provider Attributes ​

属性名说明类型默认值
locale翻译文本对象objecten
size全局组件大小enumdefault
zIndex全局初始化 zIndex 的值number—
namespace全局组件类名称前缀 (需要配合 $namespace 使用)stringw3
button按钮相关配置,详见下表object详见下表
switch开关相关配置,详见下表object详见下表
link链接相关配置, 详见下表object详见下表
card卡片相关配置, 详见下表object详见下表
dialogdialog 相关的配置, 详见下表object详见下表
message消息相关配置, 详见下表object详见下表
experimental-features将要添加的实验阶段的功能,所有功能都是默认设置为 falseobject—
empty-values输入类组件空值array—
value-on-clear输入类组件清空值string / number / boolean / Function—
table表格相关配置, 详见下表object详见下表
theme全局主题enum
fontSizeBase 1.1.18全局基础字号,须在应用根设置;挂到父级元素(找不到则 <html>);组件树 Teleport 浮层经注入同步,命令式 Message 等跟随全局配置enum14px

Button Attribute ​

参数说明类型默认值
autoInsertSpace两个中文字符之间自动插入空格(仅当文本长度为 2 且所有字符均为中文时才生效)booleanfalse
debounce是否开启防抖booleanfalse
debounce-time防抖时间number200
winmonitor是否开启按钮点击上报日志booleantrue

Switch Attribute ​

参数说明类型默认值
widthswitch 的宽度number / string—
inline-prompt无论图标或文本是否显示在点内,只会呈现文本的第一个字符booleanfalse
参数描述类型默认值
type链接类型enumdefault
underline控制下划线是否出现enumhover

Card Attribute ​

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

Dialog Attribute ​

属性描述类型默认值
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 ​

属性详情类型默认值
show-overflow-tooltip是否隐藏额外内容并在单元格悬停时使用 Tooltip 显示它们,将影响全部列的展示boolean / object—
tooltip-effect溢出的 tooltip 的 effectenumlight
tooltip-options溢出 tooltip 的选项,参见 tooltip 组件objectobject
tooltip-formatter使用 show-overflow-tooltip 时自定义 tooltip 内容Function—

Config Provider Slots ​

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

Copyright 2025 Winning Health 版权所有