le-table: 一个高度可定制化的 npm 表格组件

阅读时长 4 分钟读完

le-table 是一个基于 React 的 npm 包,旨在提供高度可定制化的表格组件。它提供了许多强大的功能,例如排序、筛选、分页等,同时也支持自定义样式和渲染方式。

安装

你可以通过 npm 来安装 le-table:

或者使用 yarn:

使用

首先,你需要在你的 React 组件中引入 le-table:

然后,在你的渲染函数中,你可以像下面这样使用它:

-- -------------------- ---- -------
--------
  ----------
    - ------ ----- ---- ------ --
    - ------ ----- ---- ----- --
    - ------ ----- ---- -------- --
  --
  -------------
    - ----- ----- ---- --- ------- --- --
    - ----- ----- ---- --- ------- --- --
    - ----- ----- ---- --- ------- --- --
  --
--

上面的代码会渲染一个包含三列(姓名、年龄、性别)和三行数据的表格。

高级使用

le-table 提供了很多强大的功能,例如排序、筛选、分页等。你可以使用一些额外的属性来启用这些功能。

排序

你可以通过将 columns 属性中的某一列的 sorter 属性设置为一个函数来启用排序功能。这个函数接收两个参数(当前行和下一行),并且需要返回一个数字,表示它们的大小关系。

例如:

-- -------------------- ---- -------
--------
  ----------
    - ------ ----- ---- ------ --
    - ------ ----- ---- ------ ------- --- -- -- ----- - ----- --
    - ------ ----- ---- -------- --
  --
  -------------
    - ----- ----- ---- --- ------- --- --
    - ----- ----- ---- --- ------- --- --
    - ----- ----- ---- --- ------- --- --
  --
--

上面的代码会在年龄列上启用排序功能。

筛选

你可以通过将 columns 属性中的某一列的 filters 属性设置为一个筛选列表来启用筛选功能。筛选列表是一个数组,每个元素都是一个包含 textvalue 属性的对象。

例如:

-- -------------------- ---- -------
--------
  ----------
    - ------ ----- ---- ------ --
    -
      ------ -----
      ---- ------
      -------- -
        - ----- --- ----- ------ ------ --
        - ----- ------ --- ------ -------- --
        - ----- --- ----- ------ ------ --
      --
    --
    - ------ ----- ---- -------- --
  --
  -------------
    - ----- ----- ---- --- ------- --- --
    - ----- ----- ---- --- ------- --- --
    - ----- ----- ---- --- ------- --- --
  --
--

上面的代码会在年龄列上启用筛选功能。

分页

你可以通过将 pagination 属性设置为一个对象来启用分页功能。这个对象可以包含一些属性,例如 currentpageSizetotal 等。

例如:

-- -------------------- ---- -------
--------
  ----------
    - ------ ----- ---- ------ --
    - ------ ----- ---- ----- --
    - ------ ----- ---- -------- --
  --
  -------------
    - ----

- ----------------------------------------------------------- --------
----------------------------------------------------------------------------------
纠错
反馈