el-config-provider

ConfigProvider Component

ConfigProvider provides global configurations accessible throughout the application.

When to Use

• Internationalization
• Global component size
• Theme configuration
• Component defaults

i18n Configuration

<template>
  <el-config-provider :locale="locale">
    <App />
  </el-config-provider>
</template>

## Global Size

```vue
<template>
  <el-config-provider size="small">
    <App />
  </el-config-provider>
</template>

Button Configuration

<template>
  <el-config-provider :button="{ autoInsertSpace: true, type: 'primary' }">
    <App />
  </el-config-provider>
</template>

Message Configuration

<template>
  <el-config-provider :message="{ max: 3 }">
    <App />
  </el-config-provider>
</template>

Empty Values Configuration

<template>
  <el-config-provider
    :empty-values="[null, undefined]"
    :value-on-clear="null"
  >
    <App />
  </el-config-provider>
</template>

API Reference

Attributes

Name	Description	Type	Default
locale	Locale object	{ name: string, el: TranslatePair }	English
size	Global component size	'large' | 'default' | 'small'	'default'
zIndex	Initial zIndex	number	—
namespace	Component class prefix	string	'el'
button	Button configuration	{ autoInsertSpace?, type?, plain?, text?, round?, dashed? }	—
link	Link configuration	{ type?, underline? }	—
dialog	Dialog configuration	{ alignCenter?, draggable?, overflow?, transition? }	—
message	Message configuration	{ max?, grouping?, duration?, showClose?, offset?, plain?, placement? }	—
table	Table configuration	{ showOverflowTooltip?, tooltipEffect?, tooltipOptions?, tooltipFormatter? }	—
empty-values	Empty values for components	array	['', null, undefined]
value-on-clear	Value when cleared	string | number | boolean | Function	undefined

Slots

Name	Description	Type
default	Default content	{ config }

Best Practices

1. Use for global i18n configuration
2. Set size for consistent component sizing
3. Use empty-values for form handling