Row Selection Props

Following we list all props for selectRow props

const selectRow = {
  mode: 'checkbox',
  ...
});

<BootstrapTable selectRow={ selectRow } ... />

Required

Optional

selectRow.mode - [String]

Specifying the selection way for single(radio) or multiple(checkbox). If radio was assigned, there will be a radio button in the selection column; otherwise, the checkbox instead.

Available values

  • radio
  • checkbox

Following is a quick example for single selection:

const selectRow = {
  mode: 'radio' // single row selection
};

<BootstrapTable
  keyField='id'
  data={ products }
  columns={ columns }
  selectRow={ selectRowProp }
/>

selectRow.selected - [Array]

selectRow.selected allow you have default selections on table.

const selectRow = {
  mode: 'checkbox',
  selected: [1, 3] // should be a row keys array
};

selectRow.style - [Object | Function]

selectRow.style allow you to have custom style on selected rows:

const selectRow = {
  mode: 'checkbox',
  style: { background: 'red' }
};

If you wanna more flexible customization, selectRow.style also accept a function:

const selectRow = {
  mode: 'checkbox',
  style: (row, rowIndex) => { return ...; }
};

selectRow.classes - [String | Function]

selectRow.classes allow you to add css class on selected rows:

const selectRow = {
  mode: 'checkbox',
  classes: 'custom-class'
};

If you wanna more flexible customization, selectRow.classes also accept a function:

const selectRow = {
  mode: 'checkbox',
  classes: (row, rowIndex) => { return ...; }
};

selectRow.bgColor - [String | Function]

A quick way to specify the background color when row is selected

const selectRow = {
  mode: 'checkbox',
  bgColor: 'red'
};

There's also a more good way to custom it:

const selectRow = {
  mode: 'checkbox',
  bgColor: (row, rowIndex) => {
    return ....;  // return a color code
  }
};

selectRow.nonSelectable - [Array]

This prop allow you to restrict some rows which can not be selected by user. selectRow.nonSelectable accept an rowkeys array.

const selectRow = {
  mode: 'checkbox',
  nonSelectable: [1, 3 ,5]
};

selectRow.clickToSelect - [Bool]

Allow user to select row by clicking on the row.

const selectRow = {
  mode: 'checkbox',
  clickToSelect: true
};

Note: When you also enable cellEdit, the selectRow.clickToSelect will deactivate the functionality of cell editing. If you want to click on row to select row and edit cell simultaneously, you are suppose to enable selectRow.clickToEdit

selectRow.clickToExpand - [Bool]

Default is false, enable it will let user able to expand and select row when user clicking on the row.

const selectRow = {
  mode: 'checkbox',
  clickToExpand: true
};

selectRow.clickToEdit - [Bool]

Able to click to edit cell and select row at the same time.

const selectRow = {
  mode: 'checkbox',
  clickToSelect: true
  clickToEdit: true
};

selectRow.onSelect - [Function]

This callback function will be called when a row is select/unselect and pass following four arguments: row, isSelect, rowIndex and e.

const selectRow = {
  mode: 'checkbox',
  onSelect: (row, isSelect, rowIndex, e) => {
    // ...
  }
};

selectRow.onSelectAll - [Function]

This callback function will be called when select/unselect all and it only work when you configure selectRow.mode as checkbox.

const selectRow = {
  mode: 'checkbox',
  onSelectAll: (isSelect, results, e) => {
    // ...
  }
};

selectRow.hideSelectColumn - [Bool]

Default is false, if you don't want to have a selection column, give this prop as true

const selectRow = {
  mode: 'radio',
  hideSelectColumn: true,
  clickToSelect: true,
  bgColor: 'red'
};

selectRow.hideSelectAll - [Bool]

Default is false, if you don't want to render the select all checkbox ine the header of selection column, give this prop as true!

const selectRow = {
 mode: 'checkbox',
 hideSelectAll: true
};

selectRow.selectionRenderer - [Function]

Provide a callback function which allow you to custom the checkbox/radio box. This callback only have one argument which is an object and contain following properties:

const selectRow = {
  mode: 'checkbox',
  selectionRenderer: ({ mode, checked, disabled }) => (
    // ....
  )
};

selectRow.selectionHeaderRenderer - [Function]

Provide a callback function which allow you to custom the checkbox/radio box in the selection header column. This callback only have one argument which is an object and contain following properties:

const selectRow = {
  mode: 'checkbox',
  selectionHeaderRenderer: ({ mode, checked, indeterminate }) => (
    // ....
  )
};
← Pagination PropsRow Expand Props →