在 Excel 中,双击单元格右下角的填充柄,会自动把当前值向下填充到相邻数据区域的末尾。vxe-table 通过 areaConfig.extendByDblclickCopy 提供了等价能力:双击填充柄后,表格会根据「连续数据区域」自动判定填充行数,将当前单元格的值向下复制。
vxe-table 如何启用双击填充柄向下填充?
在 areaConfig 中设置 extendByDblclickCopy: true,同时确保 mouseConfig.area: true 与 mouseConfig.extension: true 已开启。选中单元格后双击其右下角填充柄,即可按连续数据区域向下复制。
- 生效前提:
- mouseConfig.area 必须为 true,区域选取与填充柄都依赖它。
- mouseConfig.extension 必须为 true,否则单元格右下角不显示扩展按钮(填充柄),双击无从触发。
- areaConfig.extendByDblclickCopy 为 true,这是双击填充的开关。
- 活动列下方需存在可判定的连续数据区域,否则填充行数为 0,双击无效果。
双击填充柄后,当前单元格的值向下复制,填充到「连续数据区域」的末尾;若活动列右侧或左侧相邻列数据更长,填充范围会相应扩展。
双击填充的「连续数据区域」如何判定?
这是该功能的核心逻辑,决定了填充到第几行、涉及哪些列。规则分两步:
1. 确定列范围:从活动列向左右逐列判断
- 从活动列出发,先向右逐列判断:若某列在 活动行, 当前行终点 区间内存在任一非空单元格,该列纳入范围,继续判断下一列;若某列在该区间内整列为空,立即停止向右扩展,该列及更外侧列均不纳入。
- 再向左逐列判断,规则相同:有非空则纳入并继续,整列为空则停止。
2. 确定行终点:在列范围内向下逐行判断
- 在已确定的列范围内,自活动行向下逐行判断:若某行在 左边界列, 右边界列 区间内存在任一非空单元格,继续下一行;若某行在该区间内整行为空,立即停止,行终点为上一行。
举例:活动单元格在第 3 行 b 列,b 列下方第 4 行为空,但 c 列第 4 行有值。此时列范围会纳入 c 列,行判断也会因 c 列第 4 行非空而继续,填充范围被延长。这正是"连续数据区域"判定比单纯看活动列更符合 Excel 行为的地方。
代码

html
<template>
<div>
<vxe-grid v-bind="gridOptions"></vxe-grid>
</div>
</template>
<script setup>
import { reactive } from 'vue'
const gridOptions = reactive({
border: true,
height: 500,
showOverflow: true,
columnConfig: {
resizable: true
},
editConfig: {
mode: 'cell',
// 单元格编辑模式
trigger: 'dblclick'
// 双击单元格激活编辑状态
},
mouseConfig: {
area: true,
// 是否开启区域选取
extension: true
// 是否开启区域扩展选取功能,开启后可以通过鼠标左键按住区域内右下角扩展按钮,将区域横向或纵向扩大
},
areaConfig: {
extendByCopy: true,
// 是否启用扩展区域自动填充,当选取一个单元格时,自动将当前内容填充到扩展区域的所有单元格中(同时按住 ctrl 键可取消值自动识别数字功能)
extendByDblclickCopy: true
// 是否启用双击自动填充,双击填充柄后自动根据两侧相邻列中连续数据最长的那一列得数据为基准进行向下填充
},
keyboardConfig: {
arrowCursorLock: true,
// 方向键光标锁,开启后处于非聚焦式编辑状态,将支持在编辑状态中通过方向键切换单元格。(切换为聚焦编辑状态,可以按 F2 键或者鼠标左键点击输入框,就可以用方向键左右移动输入框的光标)
isAll: true,
// 是否启用快捷键全选
isClip: true,
// 是否开启复制粘贴
isArrow: true,
// 是否开启方向键功能
isShift: true,
// 是否开启同时按住方向键以活动区域为起始,向指定方向扩展单元格区域
isTab: true,
// 是否开启 Tab 键功能
isEnter: true,
// 是否开启回车键功能
isEdit: true,
// 是否开启任意键进入编辑(功能键除外)
isDel: true,
// 是否开启删除键功能
isEsc: true,
// 是否开启Esc键关闭编辑功能
isFNR: true
// 是否开启查找与替换
},
columns: [
{ type: 'seq', width: 60 },
{ field: 'a', title: 'A', editRender: { name: 'input' } },
{ field: 'b', title: 'B', editRender: { name: 'input' } },
{ field: 'c', title: 'C', editRender: { name: 'input' } },
{ field: 'd', title: 'D', editRender: { name: 'input' } },
{ field: 'e', title: 'E', editRender: { name: 'input' } },
{ field: 'f', title: 'F', editRender: { name: 'input' } },
{ field: 'g', title: 'G', editRender: { name: 'input' } },
{ field: 'h', title: 'H', editRender: { name: 'input' } }
],
data: [
{ id: 10001, a: 'Test1', b: 'Develop', c: 'Women', d: '', e: '', f: '', g: '', h: '' },
{ id: 10002, a: 'Test2', b: 'Test', c: 'Women', d: '', e: '', f: '', g: '', h: '' },
{ id: 10003, a: 'Test3', b: 'PM', c: 'Man', d: '', e: '', f: '', g: '', h: '' },
{ id: 10004, a: 'Test4', b: '', c: 'Women', d: '', e: '', f: '', g: '', h: '' },
{ id: 10005, a: 'Test5', b: 'Designer', c: 'Women', d: '', e: '', f: '', g: '', h: '' },
{ id: 10006, a: 'Test6', b: 'Designer', c: 'Women', d: '', e: '', f: '', g: '', h: '' },
{ id: 10007, a: 'Test7', b: '', c: 'Man', d: '', e: '', f: '', g: '', h: '' },
{ id: 10008, a: 'Test8', b: '', c: 'Man', d: '', e: '', f: '', g: '', h: '' },
{ id: 10009, a: 'Test9', b: '', c: 'Man', d: '', e: '', f: '', g: '', h: '' },
{ id: 10010, a: 'Test10', b: '', c: 'Women', d: '', e: '', f: '', g: '', h: '' }
]
})
</script>
extendByDblclickCopy 与 extendByCopy 的区别
两者都涉及区域扩展与填充,但触发方式与行为不同,容易混淆:
| 配置项 | 触发方式 | 行为 | 适用场景 |
|---|---|---|---|
| extendByCopy | 鼠标按住填充柄拖拽 | 拖拽到哪就填充到哪,自动识别数字规律递增;按住 Ctrl 可取消数字识别 | 用户手动控制填充范围 |
| extendByDblclickCopy | 双击填充柄 | 自动按「连续数据区域」判定填充范围,不依赖手动拖拽 | 快速填充到数据末尾,接近 Excel 双击行为 |
两者可同时开启,互不冲突:想手动控制范围时拖拽,想快速填满时双击。
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| mouseConfig.area | Boolean | false | 区域选取总开关,填充柄的前提 |
| mouseConfig.extension | Boolean | false | 是否显示区域右下角扩展按钮(填充柄) |
| areaConfig.extendByCopy | Boolean | false | 拖拽填充柄时是否自动填充内容 |
| areaConfig.extendByDblclickCopy | Boolean | false | 双击填充柄是否按连续数据区域向下复制 |
| editConfig.mode | String | 'cell' | 编辑模式,cell 为单元格编辑 |
| editConfig.trigger | String | 'click' | 鼠标触发编辑方式,示例为 dblclick |
| 列 editRender | Object | --- | 配置后该列可编辑,填充值才会写入数据 |