vue vxe-table 复制数据到 Excel:支持带表头复制

在日常数据处理中,用户经常需要将表格中的数据复制到 Excel 进行二次编辑或存档。vxe-table 提供了强大的剪贴板功能,通过简单的配置即可实现复制单元格区域时自动包含表头,让粘贴到 Excel 的数据完整且规范。

配置

配置项 类型 说明
clipConfig.isCopyHeader Boolean 设为 true 后,复制时自动将表头行一起复制到剪贴板。
mouseConfig.area Boolean 必须设为 true,开启区域选取功能(用户可框选单元格)。
keyboardConfig.isClip Boolean 必须设为 true,启用键盘复制快捷键(Ctrl + C)。
areaConfig.multiple Boolean 可选,设为 true 支持同时选取多个不连续区域(按住 Ctrl)。
  • clipConfig.isCopyHeader 会影响粘贴行为——当启用该配置后,从表格复制的数据将默认包含表头,粘贴时需要注意格式匹配。如果不需要此行为,请保持默认 false。

代码

  • 选中区域:鼠标左键拖拽框选一组单元格,或按住 Ctrl 同时选中多个不连续区域。
  • 复制:按下 Ctrl + C(或右键菜单复制,需自行实现)。
  • 粘贴到 Excel:打开 Excel,选中对应起始单元格,按 Ctrl + V。
  • 结果:Excel 中将出现完整的表头和数据行,与表格中框选的区域结构一致。
  • 注意:由于开启了 isCopyHeader: true,复制的数据第一行为表头。如果只想复制数据而不包含表头,可将该配置设为 false。

table_clip_copy_head

<template>
  <div>
    <vxe-grid v-bind="gridOptions"></vxe-grid>
  </div>
</template>

<script setup>
import { reactive } from 'vue'

const sexEditRender = reactive({
  name: 'VxeSelect',
  options: [
    { label: '女', value: '0' },
    { label: '男', value: '1' }
  ]
})

const gridOptions = reactive({
  border: true,
  height: 500,
  showOverflow: true,
  columnConfig: {
    resizable: true
  },
  mouseConfig: {
    area: true // 是否开启区域选取
  },
  areaConfig: {
    multiple: true // 是否启用多区域选取功能
  },
  clipConfig: {
    isCopyHeader: true // 是否启用复制自动带表头,启用后影响粘贴功能
  },
  editConfig: {
    mode: 'cell', // 单元格编辑模式
    trigger: 'dblclick' // 双击单元格激活编辑状态
  },
  keyboardConfig: {
    isAll: true, // 是否启用快捷键全选
    isClip: true, // 是否开启复制粘贴
    isEdit: true, // 是否开启任意键进入编辑(功能键除外)
    isDel: true, // 是否开启删除键功能
    isEsc: true // 是否开启Esc键关闭编辑功能
  },
  columns: [
    { type: 'seq', fixed: 'left', width: 60 },
    { field: 'name', fixed: 'left', title: '名字', editRender: { name: 'input' } },
    { field: 'role', title: '角色', editRender: { name: 'input' } },
    { field: 'sex', title: '性别', editRender: sexEditRender },
    { field: 'num', title: '分数', editRender: { name: 'VxeNumberInput' } },
    { field: 'age', title: '年龄', editRender: { name: 'VxeNumberInput' } },
    { field: 'address', title: '地址', width: 200, editRender: { name: 'input' } }
  ],
  data: [
    { id: 10001, name: '张三', role: '前端开发', sex: '0', num: 23, age: 28, address: '北京市17号' },
    { id: 10002, name: '李四', role: '测试人员', sex: '1', num: 23, age: 22, address: '江苏省27号' },
    { id: 10003, name: '老六', role: '项目经理', sex: '0', num: 23, age: 32, address: '深圳市19号' },
    { id: 10004, name: '小李', role: '后端开发', sex: '1', num: 456, age: 24, address: '江苏省47号' },
    { id: 10005, name: '老万', role: '设计师', sex: '1', num: 23, age: 42, address: '北京市18号' },
    { id: 10006, name: '小刘', role: '前端开发', sex: '0', num: 23, age: 38, address: '上海市17号' },
    { id: 10007, name: '老徐', role: '测试人员', sex: '1', num: 100, age: 24, address: '北京市19号' },
    { id: 10008, name: '老二', role: '设计师', sex: '0', num: 345, age: 34, address: '上海市11号' },
    { id: 10009, name: '小牛', role: '前端开发', sex: '1', num: 67, age: 52, address: '深圳市29号' },
    { id: 10010, name: '小帅', role: '测试人员', sex: '1', num: 23, age: 44, address: '北京市37号' },
    { id: 10011, name: '老魏', role: '后端开发', sex: '0', num: 56, age: 52, address: '深圳市12号' },
    { id: 10012, name: '小徐', role: '测试人员', sex: '1', num: 23, age: 16, address: '广州市16号' },
    { id: 10013, name: '小张', role: '设计师', sex: '1', num: 69, age: 16, address: '广州市46号' },
    { id: 10014, name: '老冯', role: '前端开发', sex: '0', num: 36, age: 36, address: '广州市66号' },
    { id: 10015, name: '小哥', role: '后端开发', sex: '0', num: 33, age: 47, address: '广州市56号' },
    { id: 10016, name: '李哥', role: '测试人员', sex: '1', num: 2, age: 42, address: '深圳市16号' }
  ]
})
</script>
  • 通过 clipConfig.isCopyHeader = true,vxe-table 可以轻松实现“复制带表头”的功能,极大提升了与 Excel 交互的效率。配合区域选取、多选等功能,用户可以快速导出所需数据片段。这一配置在实际业务报表、数据导出场景中非常实用。

https://vxetable.cn

posted @ 2026-06-13 15:26  你个老六  阅读(0)  评论(0)    收藏  举报