vxe-table 3.15.38 → 3.15.40

package/packages/table/module/custom/panel.ts

@@ -100,10 +100,12 @@ const renderSimplePanel = (h: CreateElement, _vm: any) => {
   const props = _vm
 
   const $xeTable = _vm.$xeTable as VxeTableConstructor & VxeTablePrivateMethods
+  const tableProps = $xeTable
   const reactData = $xeTable as unknown as TableReactData
   const $xeGrid = $xeTable.$xeGrid
 
   const { customStore } = props
+  const { treeConfig, rowGroupConfig, aggregateConfig } = tableProps
   const { isCustomStatus, customColumnList } = reactData
   const customOpts = $xeTable.computeCustomOpts
   const { immediate } = customOpts
@@ -276,124 +278,135 @@ const renderSimplePanel = (h: CreateElement, _vm: any) => {
       : {}
   }, customStore.visible
     ? [
+        !treeConfig && (aggregateConfig || rowGroupConfig) && $xeTable.getPivotTableAggregateSimplePanel
+          ? h($xeTable.getPivotTableAggregateSimplePanel(), {
+            props: {
+              customStore
+            }
+          })
+          : renderEmptyElement($xeTable),
         h('div', {
-          class: 'vxe-table-custom--header'
-        }, headerSlot
-          ? $xeTable.callSlot(headerSlot, params, h)
-          : [
-              h('ul', {
-                class: 'vxe-table-custom--panel-list'
-              }, [
-                h('li', {
-                  class: 'vxe-table-custom--option'
+          class: 'vxe-table-custom--handle-wrapper'
+        }, [
+          h('div', {
+            class: 'vxe-table-custom--header'
+          }, headerSlot
+            ? $xeTable.callSlot(headerSlot, params, h)
+            : [
+                h('ul', {
+                  class: 'vxe-table-custom--panel-list'
                 }, [
-                  allowVisible
-                    ? h('div', {
-                      class: ['vxe-table-custom--checkbox-option', {
-                        'is--checked': isAllChecked,
-                        'is--indeterminate': isAllIndeterminate
-                      }],
-                      attrs: {
-                        title: getI18n('vxe.table.allTitle')
-                      },
-                      on: {
-                        click: _vm.allOptionEvent
-                      }
-                    }, [
-                      h('span', {
-                        class: ['vxe-checkbox--icon', isAllIndeterminate ? getIcon().TABLE_CHECKBOX_INDETERMINATE : (isAllChecked ? getIcon().TABLE_CHECKBOX_CHECKED : getIcon().TABLE_CHECKBOX_UNCHECKED)]
-                      }),
-                      h('span', {
+                  h('li', {
+                    class: 'vxe-table-custom--option'
+                  }, [
+                    allowVisible
+                      ? h('div', {
+                        class: ['vxe-table-custom--checkbox-option', {
+                          'is--checked': isAllChecked,
+                          'is--indeterminate': isAllIndeterminate
+                        }],
+                        attrs: {
+                          title: getI18n('vxe.table.allTitle')
+                        },
+                        on: {
+                          click: _vm.allOptionEvent
+                        }
+                      }, [
+                        h('span', {
+                          class: ['vxe-checkbox--icon', isAllIndeterminate ? getIcon().TABLE_CHECKBOX_INDETERMINATE : (isAllChecked ? getIcon().TABLE_CHECKBOX_CHECKED : getIcon().TABLE_CHECKBOX_UNCHECKED)]
+                        }),
+                        h('span', {
+                          class: 'vxe-checkbox--label'
+                        }, getI18n('vxe.toolbar.customAll'))
+                      ])
+                      : h('span', {
                         class: 'vxe-checkbox--label'
-                      }, getI18n('vxe.toolbar.customAll'))
-                    ])
-                    : h('span', {
-                      class: 'vxe-checkbox--label'
-                    }, getI18n('vxe.table.customTitle'))
+                      }, getI18n('vxe.table.customTitle'))
+                  ])
                 ])
-              ])
-            ]),
-        h('div', {
-          ref: 'bodyElemRef',
-          class: 'vxe-table-custom--body'
-        }, [
-          topSlot
-            ? h('div', {
-              class: 'vxe-table-custom--panel-top'
-            }, $xeTable.callSlot(topSlot, params, h))
-            : renderEmptyElement($xeTable),
-          defaultSlot
-            ? h('div', {
-              class: 'vxe-table-custom--panel-body'
-            }, $xeTable.callSlot(defaultSlot, params, h))
-            : h('transition-group', {
-              class: 'vxe-table-custom--panel-list',
-              props: {
-                name: 'vxe-table-custom--list',
-                tag: 'ul'
-              },
-              on: customWrapperOns
-            }, colVNs),
-          bottomSlot
+              ]),
+          h('div', {
+            ref: 'bodyElemRef',
+            class: 'vxe-table-custom--body'
+          }, [
+            topSlot
+              ? h('div', {
+                class: 'vxe-table-custom--panel-top'
+              }, $xeTable.callSlot(topSlot, params, h))
+              : renderEmptyElement($xeTable),
+            defaultSlot
+              ? h('div', {
+                class: 'vxe-table-custom--panel-body'
+              }, $xeTable.callSlot(defaultSlot, params, h))
+              : h('transition-group', {
+                class: 'vxe-table-custom--panel-list',
+                props: {
+                  name: 'vxe-table-custom--list',
+                  tag: 'ul'
+                },
+                on: customWrapperOns
+              }, colVNs),
+            bottomSlot
+              ? h('div', {
+                class: 'vxe-table-custom--panel-bottom'
+              }, $xeTable.callSlot(bottomSlot, params, h))
+              : renderEmptyElement($xeTable),
+            renderDragTip(h, _vm)
+          ]),
+          customOpts.showFooter
             ? h('div', {
-              class: 'vxe-table-custom--panel-bottom'
-            }, $xeTable.callSlot(bottomSlot, params, h))
-            : renderEmptyElement($xeTable),
-          renderDragTip(h, _vm)
-        ]),
-        customOpts.showFooter
-          ? h('div', {
-            class: 'vxe-table-custom--footer'
-          }, footerSlot
-            ? $xeTable.callSlot(footerSlot, params, h)
-            : [
-                h('div', {
-                  class: 'vxe-table-custom--footer-buttons'
-                }, [
-                  h(VxeUIButtonComponent, {
-                    props: {
-                      mode: 'text',
-                      content: customOpts.resetButtonText || getI18n('vxe.table.customRestore'),
-                      disabled: !isCustomStatus
-                    },
-                    on: {
-                      click: _vm.resetCustomEvent
-                    }
-                  }),
-                  immediate
-                    ? h(VxeUIButtonComponent, {
-                      props: {
-                        mode: 'text',
-                        content: customOpts.closeButtonText || getI18n('vxe.table.customClose')
-                      },
-                      on: {
-                        click: _vm.cancelCloseEvent
-                      }
-                    })
-                    : h(VxeUIButtonComponent, {
+              class: 'vxe-table-custom--footer'
+            }, footerSlot
+              ? $xeTable.callSlot(footerSlot, params, h)
+              : [
+                  h('div', {
+                    class: 'vxe-table-custom--footer-buttons'
+                  }, [
+                    h(VxeUIButtonComponent, {
                       props: {
                         mode: 'text',
-                        content: customOpts.resetButtonText || getI18n('vxe.table.customCancel')
+                        content: customOpts.resetButtonText || getI18n('vxe.table.customRestore'),
+                        disabled: !isCustomStatus
                       },
                       on: {
-                        click: _vm.cancelCustomEvent
+                        click: _vm.resetCustomEvent
                       }
                     }),
-                  immediate
-                    ? renderEmptyElement($xeTable)
-                    : h(VxeUIButtonComponent, {
-                      props: {
-                        mode: 'text',
-                        status: 'primary',
-                        content: customOpts.confirmButtonText || getI18n('vxe.table.customConfirm')
-                      },
-                      on: {
-                        click: _vm.confirmCustomEvent
-                      }
-                    })
+                    immediate
+                      ? h(VxeUIButtonComponent, {
+                        props: {
+                          mode: 'text',
+                          content: customOpts.closeButtonText || getI18n('vxe.table.customClose')
+                        },
+                        on: {
+                          click: _vm.cancelCloseEvent
+                        }
+                      })
+                      : h(VxeUIButtonComponent, {
+                        props: {
+                          mode: 'text',
+                          content: customOpts.resetButtonText || getI18n('vxe.table.customCancel')
+                        },
+                        on: {
+                          click: _vm.cancelCustomEvent
+                        }
+                      }),
+                    immediate
+                      ? renderEmptyElement($xeTable)
+                      : h(VxeUIButtonComponent, {
+                        props: {
+                          mode: 'text',
+                          status: 'primary',
+                          content: customOpts.confirmButtonText || getI18n('vxe.table.customConfirm')
+                        },
+                        on: {
+                          click: _vm.confirmCustomEvent
+                        }
+                      })
+                  ])
                 ])
-              ])
-          : null
+            : null
+        ])
       ]
     : [])
 }

package/packages/table/src/body.ts

@@ -6,7 +6,7 @@ import { getOffsetSize, calcTreeLine, getRowid, createHandleGetRowId, getCellRes
 import { updateCellTitle } from '../../ui/src/dom'
 import { getSlotVNs } from '../../ui/src/vn'
 
-import type { VxeTableConstructor, VxeTableDefines, TableInternalData, VxeTablePrivateMethods, TableReactData, VxeComponentStyleType } from '../../../types'
+import type { VxeTableConstructor, VxeTableDefines, TableInternalData, VxeTablePrivateMethods, TableReactData, VxeComponentStyleType, VxeComponentSlotType } from '../../../types'
 
 const { getI18n, renderer, renderEmptyElement } = VxeUI
 
@@ -22,7 +22,7 @@ const isVMScrollProcess = ($xeTable: VxeTableConstructor & VxeTablePrivateMethod
   return !!(isDragResize || (lastScrollTime && Date.now() < lastScrollTime + (delayHover as number)))
 }
 
-function renderLine (h: CreateElement, $xeTable : VxeTableConstructor & VxeTablePrivateMethods, rowid: string, params: VxeTableDefines.CellRenderBodyParams, cellHeight: number) {
+function renderLine (h: CreateElement, $xeTable : VxeTableConstructor & VxeTablePrivateMethods, rowid: string, params: VxeTableDefines.CellRenderBodyParams, cellHeight: number): VxeComponentSlotType[] {
   const tableProps = $xeTable
   const tableInternalData = $xeTable as unknown as TableInternalData
 
@@ -286,7 +286,7 @@ function renderTdColumn (
     if (mEndRow) {
       const meRowRest = fullAllDataRowIdData[getRowid($xeTable, mEndRow)]
       if (meRowRest) {
-        cellHeight += meRowRest.oTop - rowRest.oTop + getCellRestHeight(meRowRest, cellOpts, rowOpts, defaultRowHeight)
+        cellHeight += meRowRest.oTop + getCellRestHeight(meRowRest, cellOpts, rowOpts, defaultRowHeight) - rowRest.oTop - getCellRestHeight(rowRest, cellOpts, rowOpts, defaultRowHeight)
       }
     }
   }
@@ -310,7 +310,7 @@ function renderTdColumn (
     tcStyle.minHeight = `${cellHeight}px`
   }
 
-  const tdVNs = []
+  const tdVNs: VxeComponentSlotType[] = []
   if (fixedHiddenColumn && isAllOverflow) {
     tdVNs.push(
       h('div', {
@@ -614,7 +614,7 @@ function renderRows (h: CreateElement, _vm: any, fixedType: 'left' | 'right' | '
         const { showOverflow } = expandColumn || {}
         const colid = expandColumn.id
         const colRest = fullColumnIdData[colid] || {}
-        const hasEllipsis = (XEUtils.isUndefined(showOverflow) || XEUtils.isNull(showOverflow)) ? isAllOverflow : showOverflow
+        const hasEllipsis = XEUtils.eqNull(showOverflow) ? isAllOverflow : showOverflow
         let columnIndex = -1
         let $columnIndex = -1
         let _columnIndex = -1
@@ -735,8 +735,9 @@ export default {
     const tableReactData = $xeTable as unknown as TableReactData
     const tableInternalData = $xeTable as unknown as TableInternalData
     const $xeGrid = $xeTable.$xeGrid
+    const slots = $xeTable.$scopedSlots
 
-    const { xID, $scopedSlots } = $xeTable
+    const { xID } = $xeTable
     const { fixedColumn, fixedType, tableColumn } = props
 
     const { spanMethod, footerSpanMethod, mouseConfig } = tableProps
@@ -819,13 +820,15 @@ export default {
     }
 
     let emptyContent
-    if ($scopedSlots.empty) {
-      emptyContent = $scopedSlots.empty.call(this, { $table: $xeTable, $grid: $xeGrid })
+    const emptySlot = slots ? slots.empty : null
+    const emptyParams = { $table: $xeTable, $grid: $xeGrid }
+    if (emptySlot) {
+      emptyContent = emptySlot.call($xeTable, emptyParams)
     } else {
       const compConf = emptyOpts.name ? renderer.get(emptyOpts.name) : null
       const rtEmptyView = compConf ? (compConf.renderTableEmpty || compConf.renderTableEmptyView || compConf.renderEmpty) : null
       if (rtEmptyView) {
-        emptyContent = getSlotVNs(rtEmptyView.call(this, h, emptyOpts, { $table: $xeTable }))
+        emptyContent = getSlotVNs(rtEmptyView.call($xeTable, h, emptyOpts, emptyParams))
       } else {
         emptyContent = tableProps.emptyText || getI18n('vxe.table.emptyText')
       }
@@ -875,7 +878,7 @@ export default {
          */
           h('colgroup', {
             ref: 'refBodyColgroup'
-          }, renderColumnList.map((column: any, $columnIndex: any) => {
+          }, renderColumnList.map((column, $columnIndex) => {
             return h('col', {
               attrs: {
                 name: column.id
@@ -915,7 +918,7 @@ export default {
                   h('span', {
                     class: 'vxe-table--cell-main-area-btn',
                     on: {
-                      mousedown (evnt: any) {
+                      mousedown (evnt: MouseEvent) {
                         if ($xeTable.triggerCellAreaExtendMousedownEvent) {
                           $xeTable.triggerCellAreaExtendMousedownEvent(evnt, { $table: $xeTable, fixed: fixedType, type: renderType })
                         }

package/packages/table/src/cell.ts

@@ -377,18 +377,6 @@ export const Cell = {
     const { isRowGroupStatus } = tableReactData
     const { field, slots, editRender, cellRender, rowGroupNode, aggFunc } = column
     const renderOpts = editRender || cellRender
-    if (slots && slots.default) {
-      return renderCellBaseVNs(h, params, $table.callSlot(slots.default, params, h))
-    }
-    if (renderOpts) {
-      const compConf = renderer.get(renderOpts.name)
-      const rtDefault = compConf ? (compConf.renderTableDefault || compConf.renderDefault) : null
-      const rtCell = compConf ? (compConf.renderTableCell || compConf.renderCell) : null
-      const renderFn = editRender ? rtCell : rtDefault
-      if (renderFn) {
-        return renderCellBaseVNs(h, params, getSlotVNs(renderFn.call($table, h, renderOpts, Object.assign({ $type: editRender ? 'edit' : 'cell' }, params))))
-      }
-    }
     let cellValue: string | number | null = ''
     if (isRowGroupStatus && field && row.isAggregate) {
       const aggRow: VxeTableDefines.AggregateRowInfo = row
@@ -434,6 +422,18 @@ export const Cell = {
         }
       }
     } else {
+      if (slots && slots.default) {
+        return renderCellBaseVNs(h, params, $table.callSlot(slots.default, params, h))
+      }
+      if (renderOpts) {
+        const compConf = renderer.get(renderOpts.name)
+        const rtDefault = compConf ? (compConf.renderTableDefault || compConf.renderDefault) : null
+        const rtCell = compConf ? (compConf.renderTableCell || compConf.renderCell) : null
+        const renderFn = editRender ? rtCell : rtDefault
+        if (renderFn) {
+          return renderCellBaseVNs(h, params, getSlotVNs(renderFn.call($table, h, renderOpts, Object.assign({ $type: editRender ? 'edit' : 'cell' }, params))))
+        }
+      }
       cellValue = $table.getCellLabel(row, column)
     }
     const cellPlaceholder = editRender ? editRender.placeholder : ''

package/packages/table/src/methods.ts

@@ -30,6 +30,10 @@ function eqCellValue (row1: any, row2: any, field: any) {
   return XEUtils.isEqual(val1, val2)
 }
 
+function hangleStorageDefaultValue (value: boolean | null | undefined, isAll: boolean) {
+  return XEUtils.isBoolean(value) ? value : isAll
+}
+
 function getNextSortOrder ($xeTable: VxeTableConstructor & VxeTablePrivateMethods, column: any) {
   const sortOpts = $xeTable.computeSortOpts
   const { orders = [] } = sortOpts
@@ -174,13 +178,13 @@ function restoreCustomStorage ($xeTable: VxeTableConstructor & VxeTablePrivateMe
   const { customConfig } = props
   const tableId = $xeTable.computeTableId
   const customOpts = $xeTable.computeCustomOpts
-  const { storage, restoreStore } = customOpts
+  const { storage, restoreStore, storeOptions } = customOpts
   const isAllCustom = storage === true
-  const storageOpts: VxeTableDefines.VxeTableCustomStorageObj = isAllCustom ? {} : Object.assign({}, storage || {})
-  const isCustomResizable = isAllCustom || storageOpts.resizable
-  const isCustomVisible = isAllCustom || storageOpts.visible
-  const isCustomFixed = isAllCustom || storageOpts.fixed
-  const isCustomSort = isAllCustom || storageOpts.sort
+  const storageOpts: VxeTableDefines.VxeTableCustomStorageObj = isAllCustom ? {} : Object.assign({}, storage || {}, storeOptions)
+  const isCustomResizable = hangleStorageDefaultValue(storageOpts.resizable, isAllCustom)
+  const isCustomVisible = hangleStorageDefaultValue(storageOpts.visible, isAllCustom)
+  const isCustomFixed = hangleStorageDefaultValue(storageOpts.fixed, isAllCustom)
+  const isCustomSort = hangleStorageDefaultValue(storageOpts.sort, isAllCustom)
   if ((customConfig ? isEnableConf(customOpts) : customOpts.enabled) && (isCustomResizable || isCustomVisible || isCustomFixed || isCustomSort)) {
     if (!tableId) {
       errLog('vxe.error.reqProp', ['id'])
@@ -2714,13 +2718,18 @@ function handleRecalculateLayout ($xeTable: VxeTableConstructor & VxeTablePrivat
 const handleUpdateRowGroup = ($xeTable: VxeTableConstructor & VxeTablePrivateMethods, groupFields?: string[]) => {
   const reactData = $xeTable as unknown as TableReactData
 
-  reactData.rowGroupList = groupFields
-    ? (XEUtils.isArray(groupFields) ? groupFields : [groupFields]).map(field => {
-        return {
-          field
-        }
+  const aggFields: string[] = []
+  const aggConfs: { field: string }[] = []
+  if (groupFields) {
+    (XEUtils.isArray(groupFields) ? groupFields : [groupFields]).forEach(field => {
+      aggFields.push(field)
+      aggConfs.push({
+        field
       })
-    : []
+    })
+  }
+  reactData.rowGroupList = aggConfs
+  reactData.aggHandleFields = aggFields
 }
 
 function handleeGroupSummary ($xeTable: VxeTableConstructor & VxeTablePrivateMethods, aggList: VxeTableDefines.AggregateRowInfo[]) {
@@ -2910,9 +2919,9 @@ function loadTableData ($xeTable: VxeTableConstructor & VxeTablePrivateMethods,
   internalData.cvCacheMaps = {}
   reactData.isRowLoading = true
   reactData.scrollVMLoading = false
-  internalData.treeExpandedMaps = {}
+  // internalData.treeExpandedMaps = {}
   reactData.treeExpandedFlag++
-  internalData.rowExpandedMaps = {}
+  // internalData.rowExpandedMaps = {}
   reactData.rowExpandedFlag++
   internalData.insertRowMaps = {}
   reactData.insertRowFlag++
@@ -5112,13 +5121,13 @@ const Methods = {
     const { customConfig } = props
     const tableId = $xeTable.computeTableId
     const customOpts = $xeTable.computeCustomOpts
-    const { storage, restoreStore } = customOpts
+    const { storage, restoreStore, storeOptions } = customOpts
     const isAllCustom = storage === true
-    const storageOpts: VxeTableDefines.VxeTableCustomStorageObj = isAllCustom ? {} : Object.assign({}, storage || {})
-    const isCustomResizable = isAllCustom || storageOpts.resizable
-    const isCustomVisible = isAllCustom || storageOpts.visible
-    const isCustomFixed = isAllCustom || storageOpts.fixed
-    const isCustomSort = isAllCustom || storageOpts.sort
+    const storageOpts: VxeTableDefines.VxeTableCustomStorageObj = isAllCustom ? {} : Object.assign({}, storage || {}, storeOptions)
+    const isCustomResizable = hangleStorageDefaultValue(storageOpts.resizable, isAllCustom)
+    const isCustomVisible = hangleStorageDefaultValue(storageOpts.visible, isAllCustom)
+    const isCustomFixed = hangleStorageDefaultValue(storageOpts.fixed, isAllCustom)
+    const isCustomSort = hangleStorageDefaultValue(storageOpts.sort, isAllCustom)
     if ((customConfig ? isEnableConf(customOpts) : customOpts.enabled) && (isCustomResizable || isCustomVisible || isCustomFixed || isCustomSort)) {
       if (!tableId) {
         errLog('vxe.error.reqProp', ['id'])
@@ -5147,13 +5156,13 @@ const Methods = {
     const { id } = props
     const customOpts = $xeTable.computeCustomOpts
     const { collectColumn } = internalData
-    const { storage, checkMethod } = customOpts
+    const { storage, checkMethod, storeOptions } = customOpts
     const isAllCustom = storage === true
-    const storageOpts: VxeTableDefines.VxeTableCustomStorageObj = isAllCustom ? {} : Object.assign({}, storage || {})
-    const isCustomResizable = isAllCustom || storageOpts.resizable
-    const isCustomVisible = isAllCustom || storageOpts.visible
-    const isCustomFixed = isAllCustom || storageOpts.fixed
-    const isCustomSort = isAllCustom || storageOpts.sort
+    const storageOpts: VxeTableDefines.VxeTableCustomStorageObj = isAllCustom ? {} : Object.assign({}, storage || {}, storeOptions)
+    const isCustomResizable = hangleStorageDefaultValue(storageOpts.resizable, isAllCustom)
+    const isCustomVisible = hangleStorageDefaultValue(storageOpts.visible, isAllCustom)
+    const isCustomFixed = hangleStorageDefaultValue(storageOpts.fixed, isAllCustom)
+    const isCustomSort = hangleStorageDefaultValue(storageOpts.sort, isAllCustom)
     const resizableData: Record<string, number> = {}
     const sortData: Record<string, number> = {}
     const visibleData: Record<string, boolean> = {}

package/packages/table/src/props.ts

@@ -150,11 +150,20 @@ export default {
   showFooterOverflow: { type: [Boolean, String], default: () => getConfig().table.showFooterOverflow },
 
   /** 高级属性 */
-  // （即将废弃）columnKey 已废弃，被 column-config.useKey 替换
+  /**
+   * （即将废弃）columnKey 已废弃，被 column-config.useKey 替换
+   * @deprecated
+   */
   columnKey: Boolean,
-  // （即将废弃）rowKey 已废弃，被 row-config.useKey 替换
+  /**
+   * （即将废弃）rowKey 已废弃，被 row-config.useKey 替换
+   * @deprecated
+   */
   rowKey: Boolean,
-  // （即将废弃）rowId 已废弃，被 row-config.keyField 替换
+  /**
+   * （即将废弃）rowId 已废弃，被 row-config.keyField 替换
+   * @deprecated
+   */
   rowId: { type: String, default: () => getConfig().table.rowId },
   zIndex: Number,
   emptyText: { type: String, default: () => getConfig().table.emptyText },
@@ -179,11 +188,17 @@ export default {
   rowConfig: Object as PropType<VxeTablePropTypes.RowConfig>,
   // 数据聚合配置项
   aggregateConfig: Object as PropType<VxeTablePropTypes.AggregateConfig>,
-  //  已废弃，被 aggregateConfig 替换
+  /**
+   * 已废弃，被 aggregateConfig 替换
+   * @deprecated
+   */
   rowGroupConfig: Object as PropType<VxeTablePropTypes.RowGroupConfig>,
   // 当前行配置项
   currentRowConfig: Object as PropType<VxeTablePropTypes.CurrentRowConfig>,
-  // 已废弃，被 rowDragConfig 替换
+  /**
+   * 已废弃，被 rowDragConfig 替换
+   * @deprecated
+   */
   dragConfig: Object as PropType<VxeTablePropTypes.DragConfig>,
   // 行拖拽排序配置项
   rowDragConfig: Object as PropType<VxeTablePropTypes.RowDragConfig>,
@@ -215,7 +230,10 @@ export default {
   treeConfig: [Boolean, Object],
   // 快捷菜单配置项
   menuConfig: [Boolean, Object],
-  // 在 v4 中废弃 contextMenu
+  /**
+   * 在 v4 中废弃 contextMenu
+   * @deprecated
+   */
   contextMenu: [Boolean, Object],
   // 鼠标配置项
   mouseConfig: Object,
@@ -239,9 +257,15 @@ export default {
   emptyRender: [Boolean, Object],
   // 自定义列配置项
   customConfig: Object as PropType<VxeTablePropTypes.CustomConfig>,
-  // （即将废弃）横向虚拟滚动配置项
+  /**
+   * （即将废弃）横向虚拟滚动配置项
+   * @deprecated
+   */
   scrollX: Object as PropType<VxeTablePropTypes.ScrollX>,
-  // （即将废弃）纵向虚拟滚动配置项
+  /**
+   * （即将废弃）纵向虚拟滚动配置项
+   * @deprecated
+   */
   scrollY: Object as PropType<VxeTablePropTypes.ScrollY>,
   // 横向虚拟滚动配置项
   virtualXConfig: Object as PropType<VxeTablePropTypes.VirtualXConfig>,