mirror of
https://github.com/gosticks/react-bootstrap-table2.git
synced 2025-10-16 11:55:39 +00:00
63 lines
3.4 KiB
Markdown
63 lines
3.4 KiB
Markdown
---
|
|
id: basic-row-select
|
|
title: Row Selection
|
|
sidebar_label: Row Selection
|
|
---
|
|
|
|
For the table row selection functionality, the usage is almost same as `react-bootstrap-table`. If you are a user from legacy `react-bootstrap-table`, you can consider to skip this part.
|
|
|
|
**[Live Demo For Row Selection](../storybook/index.html?selectedKind=Row%20Selection)**
|
|
**[API & Props Definition](./row-select-props.html)**
|
|
|
|
-----
|
|
|
|
## Selection Mode
|
|
|
|
We support the single and multiple selection on table, config the [`selectRow.mode`](./row-select-props.html#selectrowmode-string) on `BootstrapTable` will enable the selection on the table.
|
|
|
|
By default behavior, user need to click on the selection column or the checkbox/radio to select/unselect a row, for a user experience perspective, we have [`selectoRow.clickToSelect`](./row-select-props.html#selectrowclicktoselect-bool) to allow user to select/unselect row by clicking on the row.
|
|
|
|
## Selection Management
|
|
Please check [`selectoRow.selected`](./row-select-props.html#selectrowselected-array), it's used for default selection usually but also can be used as a external selection control.
|
|
|
|
This is an example for [selection management](../storybook/index.html?selectedKind=Row%20Selection&selectedStory=Selection%20Management).
|
|
|
|
|
|
In addition, this is another example for [selection management](../storybook/index.html?selectedKind=Row%20Selection&selectedStory=Advance%20Selection%20Management)
|
|
|
|
## Customization
|
|
|
|
|
|
### Style/Class
|
|
Like column, we support to custom the style, class on the selecting row easily via following `selectRow` props:
|
|
|
|
* [`selectRow.bgColor`](row-select-props.html#selectrowbgcolor-string-function)
|
|
* [`selectRow.style`](./row-select-props.html#selectrowstyle-object-function)
|
|
* [`selectRow.classes`](./row-select-props.html#selectrowclasses-string-function)
|
|
|
|
If you configure some specific rows as non-selectable, you can also custom them via:
|
|
|
|
* [`selectRow.nonSelectableStyle`](./row-select-props.html#selectrownonselectablestyle-object-function)
|
|
* [`selectRow.nonSelectableClasses`](./row-select-props.html#selectrownonselectableclasses-string-function)
|
|
|
|
### Selection Column
|
|
|
|
* For Custom header cell: [`selectRow.selectionRenderer`](./row-select-props.html#selectrowselectionrenderer-function)
|
|
* For Custom normal cell: [`selectRow.selectionHeaderRenderer`](./row-select-props.html#selectrowselectionheaderrenderer-function)
|
|
* For Custom header cell style: [`selectRow.headerColumnStyle`](./row-select-props.html#selectrowheadercolumnstyle-object-function)
|
|
* For Custom normal cell style: [`selectRow.selectColumnStyle`](./row-select-props.html#selectrowselectcolumnstyle-object-function)
|
|
|
|
### Position
|
|
Default we render selection column in the left side of table, you can use [`selectRow.selectColumnPosition`](./row-select-props.html#selectrowselectcolumnposition-string) to make it on the right.
|
|
|
|
<br/>
|
|
|
|
In addition, `react-bootstrap-table2` offer below props to hide selection column:
|
|
|
|
* [`selectRow.hideSelectColumn`](./row-select-props.html#selectrowhideselectcolumn-bool): Hide the selection column.
|
|
* [`selectRow.hideSelectAll`](./row-select-props.html#selectrowhideselectall-bool): Hide the select all checkbox in the selection header cell.
|
|
|
|
## Event Listening
|
|
|
|
[`selectRow.onSelect`](./row-select-props.html#selectrowonselect-function) allow you to listen a row is select or unselect. For the multiple selection, we also have [`selectRow.onSelectAll`](./selectrowonselectall-function) to listen the select/unselect all event.
|