@pluve/lego-table-react v0.0.2

@pluve/lego-table-react

乐高系列之 table 组件系列

@pluve/lego-table-react 已经投入了我们的生产环境中使用，经受住了来自真实业务的考验，并伴随着我们的业务需求不断完善。

安装

# npm
npm i @pluve/lego-table-react

# yarn
yarn add @pluve/lego-table-react

LegoTable

基于 antd Table 组件进行二次封装的 Table 组件，建议配合 useAntdTable 使用。样式部分建议配合 YF antd 公用样式文件 antd-rest-1.0.0.css 使用。

特性

• 基于 antd Table 组件进行二次封装
• 与 antd Table 组件 API 完全对齐
• 提供部分属性默认配置，使用者可以针对属性自定义配置

默认配置

pagination

LegoTableColEllipsis

一般用于 table 列超长展示缩略场景。

为了适应在不同屏幕宽度下缩略宽度自适应，组件对其做了一些处理，最大宽度计算公式为：${((props.maxWidth ?? 576) * 100) / (props.screenWidthBase ?? 1920)}vw。

使用时，按照 1920 屏幕宽度展示时该列最大能展示多少 maxWidth 直接赋值即可。

建议：在需要进行缩略处理的 column 这一列，设置一个宽度(保证该列表表头不会换行即可)，此时在屏幕宽度变化时，缩略的这一列始终能够撑满。见下面例子

API

效果展示

使用示例

import { LegoTable, LegoTableColEllipsis } from '@pluve/lego-table-react';
import { ColumnsType, TablePaginationConfig } from 'antd/es/table';
import { FC, useEffect, useState } from 'react';

const Demo: FC = () => {
  const columns: ColumnsType<any> = [
    {
      title: '姓名',
      dataIndex: 'name',
    },
    {
      title: '手机号',
      dataIndex: 'phone',
    },
    {
      title: '年龄',
      dataIndex: 'age',
    },
    {
      title: '工作',
      dataIndex: 'work',
      width: 80, // 设置该列的宽度，小于该字段缩略时设置的mxWidth即可，建议设置值保证表头该列不换行即可
      render: (text: string) => {
        return (
          <LegoTableColEllipsis
            title={text}
            maxWidth={600}
          ></LegoTableColEllipsis>
        );
      },
    },
  ];

  const [list, setList] = useState<
    {
      name: string;
      age: number;
      work: string;
      phone: string;
      id: string;
    }[]
  >([]);
  const [pagination, setPagination] = useState<{
    current: number;
    pageSize: number;
    total: number;
  }>({
    current: 1,
    pageSize: 10,
    total: 100,
  });

  useEffect(() => {
    setList(
      [...new Array(10)].map((item, index) => ({
        name: `杨坤${index}`,
        age: 30 + Math.ceil(index * Math.random()),
        work: `我是一个很长的字符串我是一个很长的字符串我是一个很长的字符串我是一个很长的字符串我是一个很长的字符串我是一个很长的字符串我是一个很长的字符串我是一个很长的字符串我是一个很长的字符串${index}`,
        phone: `188****345${index}`,
        id: `${index + 1}`,
      })),
    );
  }, []);

  const onChange = (paginationConfig: TablePaginationConfig) => {
    setPagination({
      ...pagination,
      current: paginationConfig.current!,
      pageSize: paginationConfig.pageSize!,
    });

    setList(
      [...new Array(pagination.pageSize)].map((item, index) => ({
        name: `杨坤${index}`,
        age: 50 + Math.ceil(index * Math.random()),
        work: `我是一个很长的字符串我是一个很长的字符串我是一个很长的字符串我是一个很长的字符串我是一个很长的字符串我是一个很长的字符串我是一个很长的字符串我是一个很长的字符串我是一个很长的字符串${index}`,
        phone: `184****345${index}`,
        id: `${index + 1}`,
      })),
    );
  };

  return (
    <div style={{ width: '100%' }}>
      <LegoTable
        bordered
        columns={columns}
        dataSource={list}
        pagination={pagination}
        onChange={onChange}
        rowKey="id"
        size="small"
        scroll={{ x: 'max-content' }}
      ></LegoTable>
    </div>
  );
};

export default Demo;

TODO

• 支持虚拟化