React 溢出隐藏

超长文本的两种处理方式，全局配 textOverflow，列上同名字段可覆盖：

取值	行为
ellipsis	单行 + 省略号，不提供查看完整内容的手段
tooltip	省略号 + 内置浮层：只在文本真被裁掉时弹出，延迟可调（tooltip: { delay }，默认 150ms），长文本自动换行，贴边自动翻转/夹取，跟随明暗主题

使用的 API

type Column = {
  key: string;  // 列标识(必填)
  title: string;  // 列标题(必填)
  width: number;  // 列宽(必填)
  textOverflow: 'ellipsis' | 'tooltip';  // 列级覆盖全局设置
}

type Options = {
  list: T[];  // 数据列表
  itemKey: string;  // 行唯一标识字段名
  estimatedSize: number;  // 行预估高度(px)
  buffer: number;  // 缓冲区行数
  border: boolean;  // 是否显示边框
  textOverflow: 'ellipsis' | 'tooltip';  // 全局文本溢出处理
}

示例

微应用尚未挂载。

源码

点击查看源码

import React from 'react';
import { VirtTableReact, type ReactTableColumn, type VirtTableRef } from '@virt-table/react';
import { faker } from '@faker-js/faker';

/** 两种溢出处理交替，方便横向对比 */
const MODES = ['ellipsis', 'tooltip'] as const;
const COL_COUNT = 6;
const ROW_COUNT = 200;

const columns: ReactTableColumn[] = Array.from({ length: COL_COUNT }, (_, i) => {
  const mode = MODES[i % MODES.length];
  return {
    key: `extra_${i}`,
    title: `列 ${i} · ${mode}`,
    width: 220,
    // 列级覆盖全局的 textOverflow
    textOverflow: mode,
  };
});

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}`] = c % 2 === 1 && i % 4 === 0 ? '短' : faker.lorem.sentences(3);
  }
  return row;
});

export default function OverflowTable() {
  const tableRef = React.useRef<VirtTableRef>(null);
  const status = 'ellipsis 仅省略号　·　tooltip 省略号 + 自绘浮层（悬停 150ms，仅在真被裁时弹）';
  return (
    <div className="demo-wrapper">
      <h3 className="demo-title">React 文字溢出处理</h3>
      <div className="virt-table-controls" />
      <div className="status-text">{status}</div>
      <div style={{ width: 800, height: 600 }} className="demo-container">
        <VirtTableReact
          ref={tableRef}
          columns={columns}
          options={{
            list,
            itemKey: 'id',
            estimatedSize: 40,
            buffer: 4,
            border: true,
            textOverflow: 'ellipsis',
          }}
        />
      </div>
    </div>
  );
}