Appearance
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>