npm 包 ttop 使用教程

阅读时长 5 分钟读完

什么是 ttop

ttop 是一个基于 React 的交互式的表格组件,适用于中大型数据的展示。

ttop 具有以下特性:

  • 可以选择不同的排序方式;
  • 可以对单元格进行操作,如复制、粘贴、剪切等;
  • 可以自定义单元格的渲染方式;
  • 可以通过插件扩展功能。

安装

使用 npm 安装:

使用

基本用法

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

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

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

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

其中,columns 为表格的列定义数组,data 为表格数据数组。field 属性指定数据中的键名,header 属性指定表格头的显示文本。

排序

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

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

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

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

将列定义数组中的 sortable 属性设为 true,即可开启排序功能。

自定义单元格渲染

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

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

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

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

将列定义数组中的 render 属性设为一个函数,即可自定义单元格的渲染方式。该函数接收一个对象参数,包含以下属性:

  • rowIndex:当前行的索引;
  • columnIndex:当前列的索引;
  • rowData:当前行的数据;
  • column:当前列的定义。

插件扩展功能

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

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

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

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

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

使用 plugins 属性即可传入插件,示例中使用了 ttop 自带的 Selection 插件,开启了选中功能。

总结

通过本文的介绍,你已经了解了 npm 包 ttop 的使用方法,并学会了如何进行排序、自定义单元格的渲染方式、插件扩展功能等。

在实际项目中,ttop 可以快速帮助你完成中大型数据的展示工作,提高效率。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60055fd181e8991b448dd5e8

纠错
反馈