react-infinite-table v1.3.0

React Infinite Table

A browser-ready efficient scrolling table with fixed header and footer, and much more!

Check out the demo

Features

• ✅ Render only the visibile rows
• ✅ Fixed header
• ✅ Fixed footer
• ✅ Fixed left column(s)
• ✅ Column resize
• ✅ Column order changes (by dragging)
• ✅ Row selection (handling shift/modifier during click)
• ✅ Multiple rows selection
  • ⌘/Ctrl + Click: toggle selection
  • ⇧ + Click: select all the rows between the previously clicked row and the currently clicked row.
• 🔜 Rows with different heights / free height
• 🎉 Uses the HTML <table> standard tags!
• 🎉 No use of javascript to sync scroll between fixed columns/rows!

Getting started

Install react-infinite-table using npm.

npm install react-infinite-table --save

Import and use as follows:

import {Table} from 'react-infinite-table';

const rows = [
  { /* the row's data */ }, 
  //...
]

const columns = [
  { 
    cellRenderer: ({ columnIndex, column, rowData, rowIndex, className }) => {
      return (
        <td className={className}>
          {rowData.xxx}
        </td>
      )
    },
    headerRenderer: ({ columnIndex, column, className }) => {
      return (
        <th className={className}>
          {column.name}
        </th>
      )
    },
    footerRenderer: ({ columnIndex, column, className }) => {
      return (
        <td className={className}>
          {column.xxx}
        </td>
      )
    },
    width: 90,
    name: '...'
  },
  //...
]

<Table
  className='example-table'
  tableClassName='table table-bordered table-striped' // example using bootstrap
  height={200}
  rowHeight={30}
  rows={rows}
  columns={columns}
  headerCount={1}
  footerCount={1}
  fillTableWidth={true|false}
  rowIdKey='id'
  noRowsRenderer={() => 'No rows'}
  // keep the first column fixed:
  fixedColumnsCount={1}
  // row selection
  selectedRows={this.state.selectedRows}
  onSelectionChange={selectedRows => { this.setState({selectedRows}) }}
  canSelectMultipleRows={true|false}
  // infinite load:
  infiniteLoadBeginEdgeOffset={150}
  isInfiniteLoading={true|false}
  onInfiniteLoad={() => { /* fetch your data ... */ }}
  getLoadingSpinner={() => <div>Loading...</div>}
  // display from bottom upwards, like a Chat or Message Box 
  displayBottomUpwards={displayBottomUpwards}
  // allows column resize
  onColumnWidthChange={(columnIndex, width) => { /* update columns... */ }}
  // allows column reorder (by dragging)
  onColumnOrderChange={(fromIndex, toIndex) => { /* update columns... */ }}
/>

Similar packages

This package has been inspired by some existing library dealing with tables in react.

The initial code started from a "fork" of the react-infinite package, that implements a scrollable container with a lot of items by rendering only DOM nodes that the user is able to see (or might soon see).

The definition of the columns and the rendering of the cells is inspired by react-virtualized.

CSS is used to fix header, footer and some columns, using position: sticky. This has been inspired by ember-table.

Comparison of similar packages:

Feature	react-infinite-table	react-virtualized	react-base-table
HTML <table> standard tags	✅	❌	❌
Fixed columns	✅	❌	✅
Fixed header	✅	✅	✅
Fixed footer	✅	❌	❌
Column resize (by dragging)	✅	❌	✅
Column reorder (by dragging)	✅	❌	❌
Row selection	✅	❌	✅
No use of javascript to sync scroll between fixed columns/rows	✅	❌	❌
Size

Dependencies

react-infinite-table has very few dependencies that are managed by npm.

The following peer dependencies must be specified by your project in order to avoid version conflicts: react, react-dom. NPM will not automatically install these for you but it will show you a warning message with instructions on how to install them.

Documentation

Table Prop Types

Table is the main component and it's responsible of rendering your table.

Column Prop Types

cellRenderer

Callback responsible for rendering a cell's contents. It should implement the following signature:

({
  className: string,
  columnIndex: number,
  column: object,
  rowIndex: number,
  rowData: object
}) => {
  return <td className={className}>{/*...*/}</td>
}

You should return a <td> node (or a Component that renders a td) since this node will be rendered in the tbody > tr section of the table. You should always pass the className prop.

headerRenderer

Callback responsible for rendering a cell's header column. It should implement the following signature:

({
  className: string,
  columnIndex: number,
  column: object
}) => {
  return <th className={className}>{/*...*/}</th>
}

You should return a <th> node (or a Component that renders a th) since this node will be rendered in the thead > tr section of the table. You should always pass the className prop.

footerRenderer

Callback responsible for rendering a cell's footer column. It should implement the following signature:

({
  className: string,
  columnIndex: number,
  column: object
}) => {
  return <td className={className}>{/*...*/}</td>
}

You should return a <td> node (or a Component that renders a td) since this node will be rendered in the tfoot > tr section of the table. You should always pass the className prop.

Utils

reorderColumns

This function is provided as an helper to update the columns array after the columns have been reorderer.

import { reorderColumns } from 'react-infinite-table'

// ...

const newColumns = reorderColumns(oldColumns, fromIndex, toIndex)

Style

You should import the react-infinite-table/dist/style.css file, or if you use scss, you can import the styles as follows:

@import "~react-infinite-table/src/style.scss";

If you want to use the "row selection" feature, you should apply a style on the tr.tr-selected rows as follows:

.react-infinite-table tbody tr.tr-selected td {
  background-color: #007bff;
  border-color: #007bff;
  color: #ffffff;
}

If you use bootstrap, you need to apply the following fixes:

@import "~bootstrap/scss/bootstrap.scss";

// For "Striped" Tables
// by default, bootstrap apply the background color to the <tr>
// and it's a semi-transparent color.

// we need an opaque color
$table-accent-bg: #F2F2F2;

// and we need to apply the backgrounds on td, not on tr!
.table-striped {
  tbody tr:nth-of-type(#{$table-striped-order}) {
    background-color: unset;
  }
  tbody tr:nth-of-type(#{$table-striped-order}) td {
    background-color: $table-accent-bg;
  }
}

// For "Bordered" Tables
// we need to apply the table border on the "wrapper" and not on 
// the <table> so that it is not hidden when scrolling.
.react-infinite-table {
  .table-bordered {
    border: none;
  }
  .react-infinite-table-wrapper {
    border: $table-border-width solid $table-border-color;
  }
}

Development

You can run the demo:

npm start

and make changes to the code. The browser will automatically load the changes.

Contributions

Use GitHub issues for requests.

I welcome pull requests. Please ask first before embarking on any significant pull request, otherwise you risk spending a lot of time working on something that the project's developers might not want to merge into the project.

Changelog

Changes are tracked in the changelog.

License

react-infinite-table is available under the MIT License.