Table #

A table displays rows of data.

• <Table> Table component
• <Table.Column> Table definition column component
• <Table.ColumnGroup> Used for column header grouping
• <Table.HeaderCell> Column Header cell component
• <Table.Cell> Cell component
• <Table.Pagination> Table paging component

Import #

Examples #

Fixed Column #

Virtualized #

Support virtualized, effectively render large tabular data.

Resizable #

Move the mouse to the column split line, will display a blue move handle, click Not to loosen and drag left and right to adjust the width of the column.

To support this feature, you need to set a resizable attribute in Column.

Fluid #

If you need to set a column to automatic width, you need to configure the flexGrow property. flexGrow is a number type. Will fill the Table remaining width according to the sum of all flexGrow.

Note: After setting flexGrow, you cannot set the width and resizable properties. You can set a minimum width by minwidth.

<Column flexGrow="{1}">
  <HeaderCell>City <code>flexGrow={1}</code></HeaderCell>
  <Cell dataKey="city" />
</Column>

<Column flexGrow="{2}">
  <HeaderCell>Company Name <code>flexGrow={2}</code></HeaderCell>
  <Cell dataKey="companyName" />
</Column>

...

Custom Cell #

Depending on your business scenario, you can define what you want to display in a cell, such as displaying a picture, like adding a few buttons, or displaying a text box that you can customize, and simply redefining the Cell component.

For example, display a picture, define a Imagecell component:

const ImageCell = ({ rowData, dataKey, ...props }) => (
  <Cell {...props}>
    <img src={rowData[dataKey]} width="50" />
  </Cell>
);

Use:

<Column width="{200}">
  <HeaderCell>Avartar</HeaderCell>
  <ImageCell dataKey="avartar" />
</Column>

The children property support function on <Cell> can get rowData to return a new children.

Use:

<Column width="{200}">
  <HeaderCell>Date</HeaderCell>
  <Cell>{rowData => rowData.date.toLocaleString()}</Cell>
</Column>

Custom row height

If you need to define row heights based on the content of your data in practical applications, you can use the following methods:

<Table
  onRerenderRowHeight={rowData => {
    if (rowData.firstName === 'Janis') {
      return 30;
    }
  }}
>
  ...
</Table>

Sort #

Set a sortable attribute in the column <Column> that you want to sort.

While the <Table> defines a onSortColumn callback function, clicking the column header to sort the icon triggers the method and returns sortColumn and sortType.

<Table onSortColumn={(sortColumn, sortType) => { console.log(sortColumn, sortType); }} >

<Column width="{50}" sortable>
  <HeaderCell>Id</HeaderCell>
  <Cell dataKey="id" />
</Column>

<Column width="{130}" sortable>
  <HeaderCell>First Name</HeaderCell>
  <Cell dataKey="firstName" />
</Column>

...

Pagination #

Tree #

A tree table, primarily to show structured data, requires a isTree attribute to be set on the Table component, while the data is used to define the relational structure through children.

const data = [
  {
    id: '1',
    labelName: 'Car',
    status: 'ENABLED',
    children: [
      {
        id: '1-1',
        labelName: 'Mercedes Benz',
        status: 'ENABLED',
        count: 460
      }
    ]
  }
];
<Table data={data} isTree rowKey="id" />;

Dealing with related properties for a tree table

• defaultExpandAllRows:boolean :Expand all nodes By default
• expandedRowKeys (controlled) and defaultExpandedRowKeys are used to configure the rows that need to be expanded. Note that the parameters that these two properties receive are an array of Rowkey in the array.。
• rowKey: Give each row of data to a unique key, corresponding to a unique value in the key. (You can set the rowKey in <Table>, the default value is key)
• renderTreeToggle:() => ReactNode : Custom Toggle
• onExpandChange:(expanded:boolean,rowData:object) => void: To open/close a node's callback function

Expandable #

To implement a Table that can be expanded, a combination of the following attributes is required.

Step 1: Set properties for Table

• renderRowExpanded(rowData) => ReactNode: Used to return content that needs to be rendered in the expansion panel
• rowExpandedHeight: Sets the height of the expandable area. The default is 100
• expandedRowKeys (controlled) and defaultExpandedRowKeys are used to configure the rows that need to be expanded. Note that the parameters that these two properties receive are an array of Rowkey in the array.。
• rowKey: Give each row of data to a unique key, corresponding to a unique value in the key.

Step 2：Custom Cell

Customize a Cell and put a button inside to manipulate the value in expandedRowKeys.

Editable #

Editable tables, just customize a Cell on the line

export const EditCell = ({ rowData, dataKey, onChange, ...props }) => {
  return (
    <Cell {...props}>
      {rowData.status === 'EDIT' ? (
        <input
          className="input"
          defaultValue={rowData[dataKey]}
          onChange={event => {
            onChange && onChange(rowData.id, dataKey, event.target.value);
          }}
        />
      ) : (
        rowData[dataKey]
      )}
    </Cell>
  );
};

Loading #

When the data is in an asynchronous fetch, you need to display a loading state, just set the loading property on the <Table>.

Colspan #

In some cases, you need to merge the relationships between columns to organize your data, and you can set a ColSpan attribute on the <Column> component，and set the header grouping through<ColumnGroup>. for example:

<ColumnGroup header="Name">
  <Column width={130} colSpan={2}>
    <HeaderCell>First Name</HeaderCell>
    <Cell dataKey="firstName" />
  </Column>

  <Column width={130}>
    <HeaderCell>Last Name</HeaderCell>
    <Cell dataKey="lastName" />
  </Column>
</ColumnGroup>

When lastName corresponds to a column value of null or undefined, it is merged by the firstName column.

Summary #

Word Wrap #

If you want the cell to wrap, you just need to set wordWrap

Affix header & scrollbar #

• autoHeight: Table will expand the height according to the content.
• affixHeader: Affix the table header to the specified location on the page.
• affixHorizontalScrollbar: Affix the table horizontal scrollbar to the specified position on the page.

Draggable(with react-dnd) #

https://codesandbox.io/s/rsuite-table-with-react-dnd-m06cm

Accessibility #

• <Table> has role grid.
• <Table> has role treegrid, when <Table> is set with isTree.
• <HeanderCell> has role columnheader.
• <Cell> has role gridcell.
• Rows dynamically generated from data in the <Table> has role row.
• Use the aria-rowcount prop to identify the total number of rows available, and the aria-rowindex prop to identify the index of the row.
• Use the aria-colcount prop to identify the total number of available columns, and the aria-colindex prop to identify the index of the column.
• When sorting a column, you can apply the aria-sort prop to the column header to indicate the sorting method.

Props #

<Table> #

Form methods #

• scrollTop

The vertical scroll bar scrolls to the specified position

scrollTop: (top: number) => void;

• scrollLeft

The horizontal scroll bar scrolls to the specified position

scrollLeft: (left: number) => void;

<Table.Column> #

sortable is used to define whether the column is sortable, but depending on what key sort needs to set a dataKey in Cell. The sort here is the service-side sort, so you need to handle the logic in the ' Onsortcolumn ' callback function of <Table>, and the callback function returns sortColumn, sortType values.

<Table.ColumnGroup> #

<Table.Cell> #

<Table.Pagination> #