Skip to content

Vue 单元格选区

启用单元格选区后,可拖动鼠标选择矩形区域,并通过回调获取选区范围。

使用的 API

ts
type Column = {
  key: string;  // 列标识(必填)
  title: string;  // 列标题(必填)
  width: number;  // 列宽(必填)
}

type Options = {
  list: T[];  // 数据列表
  itemKey: string;  // 行唯一标识字段名
  estimatedSize: number;  // 行预估高度(px)
  buffer: number;  // 缓冲区行数
  border: boolean;  // 是否显示边框
  plugins: [vtCellSelection()];  // 单元格选区(插件)
  onCellSelectionChange: (range) => void;  // 选区变化回调
}

示例

微应用尚未挂载。

源码

点击查看源码
vue
<template>
  <div class="demo-wrapper">
    <h3 class="demo-title">Vue 单元格选区</h3>
    <div class="status-text">{{ status }}</div>
    <div style="width: 800px; height: 600px" class="demo-container">
      <VirtTableVue :columns="columns" :options="options" />
    </div>
  </div>
</template>

<script setup lang="ts">
import { ref } from 'vue';
import { VirtTableVue, type VueTableColumn,
  vtCellSelection,
} from '@virt-table/vue';
import { faker } from '@faker-js/faker';

const COL_COUNT = 10;
const ROW_COUNT = 200;

const columns: VueTableColumn[] = Array.from({ length: COL_COUNT }, (_, i) => ({
  key: `extra_${i}`,
  title: `列 ${i}`,
  width: 200,
}));

const list = Array.from({ length: ROW_COUNT }, (_, i) => {
  const row: Record<string, unknown> = { id: i };
  for (let c = 0; c < COL_COUNT; c++) {
    row[`extra_${c}`] = `${i}-${c}-${faker.lorem.words(3)}`;
  }
  return row;
});

const status = ref(
  `单元格选区:${ROW_COUNT} 行(按住左键拖动选择单元格区域)`,
);

const options = {
  list,
  itemKey: 'id',
  plugins: [vtCellSelection()],
  estimatedSize: 40,
  buffer: 4,
  border: true,
  onCellSelectionChange: (
    range: { startRow: number; startCol: number; endRow: number; endCol: number } | null,
  ) => {
    if (range) {
      status.value = `选区: 行 ${range.startRow}-${range.endRow}, 列 ${range.startCol}-${range.endCol}`;
    } else {
      status.value = '选区已清除';
    }
  },
};
</script>