通过 VxeUI.setConfig() 方法,你可以为组件设置全局默认参数


全局默认参数:setConfig

通过 VxeUI.setConfig() 方法,你可以为组件设置全局默认参数。表格组件的几乎所有参数都支持全局配置,当需要统一调整系统配置时,只需修改全局参数即可,无需逐个组件修改。

import { VxeUI } from 'vxe-table'// VxeUI 是 Vxe 库通用全局实例(也可以使用旧别名 VXETable)VxeUI.setConfig({  // 全局尺寸(可选值:'medium', 'small', 'mini')
  // size: 'medium',
  
  // 全局 zIndex 起始值。如果项目中其他组件的 z-index 样式值过大,
  // 需要相应设置更大的值,避免下拉框、弹窗等被遮挡
  // 新版本可以使用 dom-zindex 共享配置
  zIndex: 2000,  
  // 版本号,用于某些带数据缓存的功能。升级版本号可以重置缓存数据
  // version: 1,
  
  // 表格专属配置(table 组件)
  table: {    // 自动监听窗口尺寸变化,调整表格高度和宽度
    autoResize: true,    
    // 横向虚拟滚动配置,用于高效渲染大量列
    virtualXConfig: {      enabled: true,      // 自动启用横向虚拟滚动
      gt: 30,             // 当列数超过该阈值时自动启用虚拟滚动
      preSize: 2          // 可视区域外预先渲染的列数(越大滚动越平滑,但内存占用更多)
    },    
    // 纵向虚拟滚动配置,用于高效渲染大量行
    virtualYConfig: {      enabled: true,      // 自动启用纵向虚拟滚动
      gt: 100,            // 当行数超过该阈值时自动启用虚拟滚动
      preSize: 5          // 可视区域外预先渲染的行数(越大滚动越平滑,但内存占用更多)
    },    
    // 键盘行为统一配置
    // keyboardConfig: { isBack: true }, // 例如升级后恢复旧版键盘行为
  },  
  // 其他组件(如工具栏、分页等)的配置同理
  // ...})

常见场景:解决弹窗层级遮挡问题

当与等其他 UI 库混用时,不同组件的 z-index 层级不一致可能导致下拉框被遮挡。通过全局设置 zIndex 可以统一解决:

VxeUI.setConfig({  zIndex: 3000  // 将所有 Vxe 组件的层级起始值调高})

常见场景:不同大版本的默认参数兼容

vxe-table 在不同版本间可能调整某些参数的默认值(如 keyboard-config.isBack)。通过全局配置可以快速恢复旧版行为,避免已有功能出现异常

VxeUI.setConfig({  table: {    keyboardConfig: { isBack: true }  // 将新版默认值 false 恢复为旧版 true
  }
})

设置默认图标:setIcon

通过 VxeUI.setIcon() 方法,你可以全局替换组件内置的图标。这对于保持系统图标风格统一或适配第三方图标库(如 Font Awesome)非常实用。

import { VxeUI } from 'vxe-table'VxeUI.setIcon({  // ...
  // 表格排序相关图标
  TABLE_SORT_ASC: 'vxe-icon-caret-up',     // 升序图标
  TABLE_SORT_DESC: 'vxe-icon-caret-down',  // 降序图标
  
  // 表格筛选相关图标
  TABLE_FILTER_NONE: 'vxe-icon-funnel',     // 未筛选时的漏斗图标
  TABLE_FILTER_MATCH: 'vxe-icon-funnel',    // 有筛选条件时的高亮图标
  TABLE_EDIT: 'vxe-icon-edit',              // 编辑图标
  
  // 其他常见内置图标键名
  // BUTTON_DROPDOWN: 'vxe-icon-arrow-down',  // 按钮下拉箭头
  // MODAL_CLOSE: 'vxe-icon-close',          // 弹窗关闭按钮
  // TREE_NODE_OPEN: 'vxe-icon-caret-right'  // 树节点展开图标
  // ...})

不同组件的图标键名遵循统一命名规范,如 BUTTON_DROPDOWN、MODAL_CLOSE、TREE_NODE_OPEN 等,具体可查阅官方文档的图标配置章节。

集成第三方图标库

如果你希望使用 Font Awesome、Iconfont 等自定义图标,可在安装对应图标库后,将全局图标指向自定义的 CSS 类名即可。



https://vk.com/topic-238761085_64682292 https://vk.com/topic-238761093_64939687 https://vk.com/topic-238761104_64770134 https://vk.com/topic-238761108_65279909 https://vk.com/topic-238761121_66433112 https://vk.com/topic-238761437_66210034 https://vk.com/topic-238761708_65279934 https://vk.com/topic-238761719_65557793 https://vk.com/topic-238761738_65279963 https://vk.com/topic-238761731_66433167 https://vk.com/topic-238761746_65091146 https://vk.com/topic-238761757_66210093 https://vk.com/topic-238761762_65382347 https://vk.com/topic-238761769_65557874 https://vk.com/topic-238761773_64939862 https://vk.com/topic-238761783_64939878 https://vk.com/topic-238761791_66433251 https://vk.com/topic-238761803_64939909 https://vk.com/topic-238761811_66433275 https://vk.com/topic-238761821_66433290 https://vk.com/topic-238761827_66210193 https://vk.com/topic-238761837_66210209 https://vk.com/topic-238761849_65558033 https://vk.com/topic-238761858_65280161 https://vk.com/topic-238761864_64770420 https://vk.com/topic-238761879_65558071 https://vk.com/topic-238761887_66210250 https://vk.com/topic-238761900_65828172 https://vk.com/topic-238761914_64770474 https://vk.com/topic-238761935_64682714 https://vk.com/topic-238761085_64682731 https://vk.com/topic-238761093_64940118 https://vk.com/topic-238761104_64770530 https://vk.com/topic-238761108_65280267 https://vk.com/topic-238761121_66433462 https://vk.com/topic-238761437_66210339 https://vk.com/topic-238761708_65280296 https://vk.com/topic-238761719_65558239 https://vk.com/topic-238761738_65280312 https://vk.com/topic-238761731_66433521 https://vk.com/topic-238761746_65091582 https://vk.com/topic-238761757_66210390 https://vk.com/topic-238761762_65382767 https://vk.com/topic-238761769_65558314 https://vk.com/topic-238761773_64940254 https://vk.com/topic-238761783_64940261 https://vk.com/topic-238761791_66433613 https://vk.com/topic-238761803_64940289 https://vk.com/topic-238761811_66433640 https://vk.com/topic-238761821_66433658 https://vk.com/topic-238761827_66210478 https://vk.com/topic-238761837_66210491 https://vk.com/topic-238761849_65558434 https://vk.com/topic-238761858_65280463 https://vk.com/topic-238761864_64770769 https://vk.com/topic-238761879_65558468 https://vk.com/topic-238761887_66210539 https://vk.com/topic-238761900_65828550 https://vk.com/topic-238761914_64770819 https://vk.com/topic-238761935_64683067 https://vk.com/topic-238761085_64683077 https://vk.com/topic-238761093_64940470 https://vk.com/topic-238761104_64770857 https://vk.com/topic-238761108_65280560 https://vk.com/topic-238761121_66433862 https://vk.com/topic-238761437_66210616 https://vk.com/topic-238761708_65280585 https://vk.com/topic-238761719_65558598 https://vk.com/topic-238761738_65280601 https://vk.com/topic-238761731_66433914 https://vk.com/topic-238761746_65091966 https://vk.com/topic-238761757_66210671 https://vk.com/topic-238761762_65383195 https://vk.com/topic-238761769_65558661 https://vk.com/topic-238761773_64940607 https://vk.com/topic-238761783_64940618 https://vk.com/topic-238761791_66433975 https://vk.com/topic-238761803_64940635 https://vk.com/topic-238761811_66433989 https://vk.com/topic-238761821_66433995 https://vk.com/topic-238761827_66210731 https://vk.com/topic-238761837_66210743 https://vk.com/topic-238761849_65558733 https://vk.com/topic-238761858_65280733 https://vk.com/topic-238761864_64771055 https://vk.com/topic-238761879_65558765 https://vk.com/topic-238761887_66210780 https://vk.com/topic-238761900_65828880 https://vk.com/topic-238761914_64771103 https://vk.com/topic-238761935_64683331 https://vk.com/topic-238761085_64683337 https://vk.com/topic-238761093_64940782 https://vk.com/topic-238761104_64771143 https://vk.com/topic-238761108_65280826 https://vk.com/topic-238761121_66434128 https://vk.com/topic-238761437_66210873 https://vk.com/topic-238761708_65280851 https://vk.com/topic-238761719_65558860 https://vk.com/topic-238761738_65280869 https://vk.com/topic-238761731_66434182 https://vk.com/topic-238761746_65092264 https://vk.com/topic-238761757_66210924 https://vk.com/topic-238761762_65383507 https://vk.com/topic-238761769_65558928 https://vk.com/topic-238761773_64940927 https://vk.com/topic-238761783_64940935 https://vk.com/topic-238761791_66434274 https://vk.com/topic-238761803_64940951 https://vk.com/topic-238761811_66434292 https://vk.com/topic-238761821_66434298 https://vk.com/topic-238761827_66210997 https://vk.com/topic-238761837_66211007 https://vk.com/topic-238761849_65558997 https://vk.com/topic-238761858_65280979 https://vk.com/topic-238761864_64771396 https://vk.com/topic-238761879_65559015 https://vk.com/topic-238761887_66211046 https://vk.com/topic-238761900_65829098 https://vk.com/topic-238761914_64771442 https://vk.com/topic-238761935_64683568 https://vk.com/topic-238761085_64683575 https://vk.com/topic-238761093_64941075 https://vk.com/topic-238761104_64771488 https://vk.com/topic-238761108_65281049 https://vk.com/topic-238761121_66434490 https://vk.com/topic-238761437_66211122 https://vk.com/topic-238761708_65281070 https://vk.com/topic-238761719_65559097 https://vk.com/topic-238761738_65281088 https://vk.com/topic-238761731_66434538 https://vk.com/topic-238761746_65092509 https://vk.com/topic-238761757_66211173 https://vk.com/topic-238761762_65383808 https://vk.com/topic-238761769_65559152 https://vk.com/topic-238761773_64941213 https://vk.com/topic-238761783_64941224 https://vk.com/topic-238761791_66434629 https://vk.com/topic-238761803_64941243 https://vk.com/topic-238761811_66434663 https://vk.com/topic-238761821_66434685 https://vk.com/topic-238761827_66211265 https://vk.com/topic-238761837_66211277 https://vk.com/topic-238761849_65559238 https://vk.com/topic-238761858_65281227 https://vk.com/topic-238761864_64771726 https://vk.com/topic-238761879_65559264 https://vk.com/topic-238761887_66211330 https://vk.com/topic-238761900_65829375 https://vk.com/topic-238761914_64771770 https://vk.com/topic-238761935_64683846 https://vk.com/topic-238761085_64683856 https://vk.com/topic-238761093_64941392 https://vk.com/topic-238761104_64771809 https://vk.com/topic-238761108_65281317 https://vk.com/topic-238761121_66434878 https://vk.com/topic-238761437_66211407 https://vk.com/topic-238761708_65281347 https://vk.com/topic-238761719_65559359 https://vk.com/topic-238761738_65281369 https://vk.com/topic-238761731_66434936 https://vk.com/topic-238761746_65092779 https://vk.com/topic-238761757_66211461 https://vk.com/topic-238761762_65384151 https://vk.com/topic-238761769_65559409 https://vk.com/topic-238761773_64941518 https://vk.com/topic-238761783_64941528 https://vk.com/topic-238761791_66434994 https://vk.com/topic-238761803_64941541 https://vk.com/topic-238761811_66435012 https://vk.com/topic-238761821_66435018 https://vk.com/topic-238761827_66211528 https://vk.com/topic-238761837_66211536 https://vk.com/topic-238761849_65559475 https://vk.com/topic-238761858_65281479 https://vk.com/topic-238761864_64772012 https://vk.com/topic-238761879_65559501 https://vk.com/topic-238761887_66211586 https://vk.com/topic-238761900_65829666 https://vk.com/topic-238761914_64772044 https://vk.com/topic-238761935_64684091 https://vk.com/topic-238761085_64684101 https://vk.com/topic-238761093_64941679 https://vk.com/topic-238761104_64772077 https://vk.com/topic-238761108_65281558 https://vk.com/topic-238761121_66435218 https://vk.com/topic-238761437_66211675 https://vk.com/topic-238761708_65281581 https://vk.com/topic-238761719_65559597 https://vk.com/topic-238761738_65281597 https://vk.com/topic-238761731_66435283 https://vk.com/topic-238761746_65093007 https://vk.com/topic-238761757_66211729 https://vk.com/topic-238761762_65384501 https://vk.com/topic-238761769_65559640 https://vk.com/topic-238761773_64941839 https://vk.com/topic-238761783_64941855 https://vk.com/topic-238761791_66435380 https://vk.com/topic-238761803_64941887 https://vk.com/topic-238761811_66435410 https://vk.com/topic-238761821_66435426 https://vk.com/topic-238761827_66211819 https://vk.com/topic-238761837_66211830 https://vk.com/topic-238761849_65559711 https://vk.com/topic-238761858_65281760 https://vk.com/topic-238761864_64772266 https://vk.com/topic-238761879_65559731 https://vk.com/topic-238761887_66211891 https://vk.com/topic-238761900_65829978 https://vk.com/topic-238761914_64772301 https://vk.com/topic-238761935_64684360 https://vk.com/topic-238761085_64684367 https://vk.com/topic-238761093_64942066 https://vk.com/topic-238761104_64772326 https://vk.com/topic-238761108_65281881 https://vk.com/topic-238761121_66435681 https://vk.com/topic-238761437_66211968 https://vk.com/topic-238761708_65281920 https://vk.com/topic-238761719_65559829 https://vk.com/topic-238761738_65281945 https://vk.com/topic-238761731_66435770 https://vk.com/topic-238761746_65093257 https://vk.com/topic-238761757_66212027 https://vk.com/topic-238761762_65384892 https://vk.com/topic-238761769_65559894 https://vk.com/topic-238761773_64942231 https://vk.com/topic-238761783_64942243 https://vk.com/topic-238761791_66435880 https://vk.com/topic-238761803_64942264 https://vk.com/topic-238761811_66435925 https://vk.com/topic-238761821_66435939 https://vk.com/topic-238761827_66212086 https://vk.com/topic-238761837_66212095 https://vk.com/topic-238761849_65559972 https://vk.com/topic-238761858_65282144 https://vk.com/topic-238761864_64772536 https://vk.com/topic-238761879_65559997 https://vk.com/topic-238761887_66212135 https://vk.com/topic-238761900_65830284 https://vk.com/topic-238761914_64772575 https://vk.com/topic-238761935_64684629 https://vk.com/topic-238761085_64684642 https://vk.com/topic-238761093_64942398 https://vk.com/topic-238761104_64772625 https://vk.com/topic-238761108_65282287 https://vk.com/topic-238761121_66436212 https://vk.com/topic-238761437_66212193 https://vk.com/topic-238761708_65282315 https://vk.com/topic-238761719_65560100 https://vk.com/topic-238761738_65282337 https://vk.com/topic-238761731_66436284 https://vk.com/topic-238761746_65093574 https://vk.com/topic-238761757_66212228 https://vk.com/topic-238761762_65385196 https://vk.com/topic-238761769_65560147 https://vk.com/topic-238761773_64942492 https://vk.com/topic-238761783_64942502 https://vk.com/topic-238761791_66436384 https://vk.com/topic-238761803_64942516 https://vk.com/topic-238761811_66436417 https://vk.com/topic-238761821_66436431 https://vk.com/topic-238761827_66212287 https://vk.com/topic-238761837_66212297 https://vk.com/topic-238761849_65560223 https://vk.com/topic-238761858_65282515 https://vk.com/topic-238761864_64772818 https://vk.com/topic-238761879_65560258 https://vk.com/topic-238761887_66212335 https://vk.com/topic-238761900_65830605 https://vk.com/topic-238761914_64772858 https://vk.com/topic-238761935_64684855 https://vk.com/topic-238761085_64684862 https://vk.com/topic-238761093_64942625 https://vk.com/topic-238761104_64772888 https://vk.com/topic-238761108_65282624 https://vk.com/topic-238761121_66436646 https://vk.com/topic-238761437_66212410 https://vk.com/topic-238761708_65282652 https://vk.com/topic-238761719_65560384 https://vk.com/topic-238761738_65282671 https://vk.com/topic-238761731_66436705 https://vk.com/topic-238761746_65093952 https://vk.com/topic-238761757_66212474 https://vk.com/topic-238761762_65385534 https://vk.com/topic-238761769_65560452 https://vk.com/topic-238761773_64942719 https://vk.com/topic-238761783_64942727 https://vk.com/topic-238761791_66436787 https://vk.com/topic-238761803_64942738 https://vk.com/topic-238761811_66436812 https://vk.com/topic-238761821_66436823 https://vk.com/topic-238761827_66212564 https://vk.com/topic-238761837_66212577 https://vk.com/topic-238761849_65560560 https://vk.com/topic-238761858_65282816 https://vk.com/topic-238761864_64773111 https://vk.com/topic-238761879_65560598 https://vk.com/topic-238761887_66212627 https://vk.com/topic-238761900_65830942 https://vk.com/topic-238761914_64773151 https://vk.com/topic-238761935_64685079 https://vk.com/topic-238761085_64685090 https://vk.com/topic-238761093_64942835 https://vk.com/topic-238761104_64773191 https://vk.com/topic-238761108_65282918 https://vk.com/topic-238761121_66436993 https://vk.com/topic-238761437_66212707 https://vk.com/topic-238761708_65282949 https://vk.com/topic-238761719_65560739 https://vk.com/topic-238761738_65282969 https://vk.com/topic-238761731_66437046 https://vk.com/topic-238761746_65094225 https://vk.com/topic-238761757_66212763 https://vk.com/topic-238761762_65385861 https://vk.com/topic-238761769_65560812 https://vk.com/topic-238761773_64942938 https://vk.com/topic-238761783_64942941 https://vk.com/topic-238761791_66437093 https://vk.com/topic-238761803_64942956 https://vk.com/topic-238761811_66437119 https://vk.com/topic-238761821_66437136 https://vk.com/topic-238761827_66212849 https://vk.com/topic-238761837_66212862 https://vk.com/topic-238761849_65560911 https://vk.com/topic-238761858_65283120 https://vk.com/topic-238761864_64773401 https://vk.com/topic-238761879_65560951 https://vk.com/topic-238761887_66212912 https://vk.com/topic-238761900_65831330 https://vk.com/topic-238761914_64773429 https://vk.com/topic-238761935_64685363 https://vk.com/topic-238761085_64685380 https://vk.com/topic-238761093_64943091 https://vk.com/topic-238761104_64773470 https://vk.com/topic-238761108_65283227 https://vk.com/topic-238761121_66437272 https://vk.com/topic-238761437_66213010 https://vk.com/topic-238761708_65283257 https://vk.com/topic-238761719_65561065 https://vk.com/topic-238761738_65283285 https://vk.com/topic-238761731_66437303 https://vk.com/topic-238761746_65094478 https://vk.com/topic-238761757_66213068 https://vk.com/topic-238761762_65386165 https://vk.com/topic-238761769_65561119 https://vk.com/topic-238761773_64943202 https://vk.com/topic-238761783_64943213 https://vk.com/topic-238761791_66437355 https://vk.com/topic-238761803_64943228 https://vk.com/topic-238761811_66437366 https://vk.com/topic-238761821_66437371 https://vk.com/topic-238761827_66213153 https://vk.com/topic-238761837_66213161 https://vk.com/topic-238761849_65561189


请使用浏览器的分享功能分享到微信等