Config Provider 全局配置

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

i18n 配置

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

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

Config Provider 全局配置 - 图1

  1. <template>
  2. <div>
  3. <el-button mb-2 @click="toggle">Switch Language</el-button>
  4. <br />
  5. <el-config-provider :locale="locale">
  6. <el-table mb-1 :data="[]" />
  7. <el-pagination :total="100" />
  8. </el-config-provider>
  9. </div>
  10. </template>
  11. <script lang="ts" setup>
  12. import { computed, ref } from 'vue'
  13. import zhCn from 'element-plus/dist/locale/zh-cn.mjs'
  14. import en from 'element-plus/dist/locale/en.mjs'
  15. const language = ref('zh-cn')
  16. const locale = computed(() => (language.value === 'zh-cn' ? zhCn : en))
  17. const toggle = () => {
  18. language.value = language.value === 'zh-cn' ? 'en' : 'zh-cn'
  19. }
  20. </script>

对按钮进行配置

Config Provider 全局配置 - 图2

  1. <template>
  2. <div>
  3. <div m="b-2">
  4. <el-checkbox v-model="config.autoInsertSpace"
  5. >autoInsertSpace</el-checkbox
  6. >
  7. </div>
  8. <el-config-provider :button="config">
  9. <el-button>中文</el-button>
  10. </el-config-provider>
  11. </div>
  12. </template>
  13. <script lang="ts" setup>
  14. import { reactive } from 'vue'
  15. const config = reactive({
  16. autoInsertSpace: true,
  17. })
  18. </script>

对消息进行配置

Config Provider 全局配置 - 图3

  1. <template>
  2. <div>
  3. <el-config-provider :message="config">
  4. <el-button @click="open">OPEN</el-button>
  5. </el-config-provider>
  6. </div>
  7. </template>
  8. <script lang="ts" setup>
  9. import { reactive } from 'vue'
  10. import { ElMessage } from 'element-plus'
  11. const config = reactive({
  12. max: 3,
  13. })
  14. const open = () => {
  15. ElMessage('This is a message.')
  16. }
  17. </script>

实验性功能

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

// TODO

Config Provider 属性

参数说明类型可选值默认值
locale翻译文本对象Language Config Provider 全局配置 - 图4languages Config Provider 全局配置 - 图5English Config Provider 全局配置 - 图6
size全局组件大小stringlarge / default /smalldefault
zIndex全局初始化 zIndex 的值number--
namespace全局组件类名称前缀 (需要配合 $namespace Config Provider 全局配置 - 图7 使用)string-el
button按钮相关的配置详细配置见下表ButtonGlobalConfig-详见下表
message消息相关配置, 详见下表MessageGlobalConfig-详见下表
experimental-features将要添加的实验阶段的功能,所有功能都是默认设置为 falseObject--

Button 属性

参数描述类型可选值默认值
autoInsertSpace自动在两个中文字符之间插入空格boolean-false

Message 属性

参数描述类型可选值默认值
max可同时显示的消息最大数量number--

ConfigProvider 插槽

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

源代码

组件 Config Provider 全局配置 - 图8 文档 Config Provider 全局配置 - 图9

贡献者

Config Provider 全局配置 - 图10 三咲智子

Config Provider 全局配置 - 图11 JeremyWuuuuu

Config Provider 全局配置 - 图12 云游君

Config Provider 全局配置 - 图13 msidolphin

Config Provider 全局配置 - 图14 zz

Config Provider 全局配置 - 图15 iamkun

Config Provider 全局配置 - 图16 btea

Config Provider 全局配置 - 图17 C.Y.Kun

Config Provider 全局配置 - 图18 qiang

Config Provider 全局配置 - 图19 Delyan Haralanov

Config Provider 全局配置 - 图20 Alan Wang

Config Provider 全局配置 - 图21 0song

Config Provider 全局配置 - 图22 kooriookami