React Table Component API

Table API

Explore the API reference for the React Table component and discover how to effectively utilize its props for customization.

CTable#

import { CTable } from '@coreui/react'
// or
import CTable from '@coreui/react/src/components/table/CTable'
PropertyDefaultType
align#-string

Set the vertical aligment.

borderColor#-'primary', 'secondary', 'success', 'danger', 'warning', 'info', 'dark', 'light', string

Sets the border color of the component to one of CoreUI’s themed colors.

bordered#-boolean

Add borders on all sides of the table and cells.

borderless#-boolean

Remove borders on all sides of the table and cells.

caption#-string

Put the caption on the top if you set caption="top" of the table or set the text of the table caption.

captionTop#4.3.0+-string

Set the text of the table caption and the caption on the top of the table.

className#-string

A string of all className you want applied to the component.

color#-'primary', 'secondary', 'success', 'danger', 'warning', 'info', 'dark', 'light', string

Sets the color context of the component to one of CoreUI’s themed colors.

columns#4.3.0+-(string | Column)[]

Prop for table columns configuration. If prop is not defined, table will display columns based on the first item keys, omitting keys that begins with underscore (e.g. '_props')

In columns prop each array item represents one column. Item might be specified in two ways:
String: each item define column name equal to item value.
Object: item is object with following keys available as column configuration:

  • key (required)(String) - define column name equal to item key.
  • label (String) - define visible label of column. If not defined, label will be generated automatically based on column name, by converting kebab-case and snake_case to individual words and capitalization of each word.
  • _props (Object) - adds classes to all cels in column, ex. _props: { scope: 'col', className: 'custom-class' },
  • _style (Object) - adds styles to the column header (useful for defining widths)

Array of objects or strings, where each element represents one cell in the table footer.

Example items:
['FooterCell', 'FooterCell', 'FooterCell']
or
[{ label: 'FooterCell', _props: { color: 'success' }, ...]

hover#-boolean

Enable a hover state on table rows within a <CTableBody>.

items#4.3.0+-Item[]

Array of objects, where each object represents one item - row in table. Additionally, you can add style classes to each row by passing them by 'props' key and to single cell by 'cellProps'.

Example item:
{ name: 'John' , age: 12, _props: { color: 'success' }, _cellProps: { age: { className: 'fw-bold'}}}

responsive#-boolean, 'sm', 'md', 'lg', 'xl', 'xxl'

Make any table responsive across all viewports or pick a maximum breakpoint with which to have a responsive table up to.

small#-boolean

Make table more compact by cutting all cell padding in half.

striped#-boolean

Add zebra-striping to any table row within the <CTableBody>.

stripedColumns#4.3.0+-boolean

Add zebra-striping to any table column.

tableFootProps#4.3.0+-CTableFootProps

Properties that will be passed to the table footer component.

tableHeadProps#4.3.0+-CTableHeadProps

Properties that will be passed to the table head component.

CTableBody#

import { CTableBody } from '@coreui/react'
// or
import CTableBody from '@coreui/react/src/components/table/CTableBody'
PropertyDefaultType
className#-string

A string of all className you want applied to the component.

color#-'primary', 'secondary', 'success', 'danger', 'warning', 'info', 'dark', 'light', string

Sets the color context of the component to one of CoreUI’s themed colors.

CTableDataCell#

import { CTableDataCell } from '@coreui/react'
// or
import CTableDataCell from '@coreui/react/src/components/table/CTableDataCell'
PropertyDefaultType
active#-boolean

Highlight a table row or cell.

align#-string

Set the vertical aligment.

className#-string

A string of all className you want applied to the component.

color#-'primary', 'secondary', 'success', 'danger', 'warning', 'info', 'dark', 'light', string

Sets the color context of the component to one of CoreUI’s themed colors.

CTableFoot#

import { CTableFoot } from '@coreui/react'
// or
import CTableFoot from '@coreui/react/src/components/table/CTableFoot'
PropertyDefaultType
className#-string

A string of all className you want applied to the component.

color#-'primary', 'secondary', 'success', 'danger', 'warning', 'info', 'dark', 'light', string

Sets the color context of the component to one of CoreUI’s themed colors.

CTableHead#

import { CTableHead } from '@coreui/react'
// or
import CTableHead from '@coreui/react/src/components/table/CTableHead'
PropertyDefaultType
className#-string

A string of all className you want applied to the component.

color#-'primary', 'secondary', 'success', 'danger', 'warning', 'info', 'dark', 'light', string

Sets the color context of the component to one of CoreUI’s themed colors.

CTableHeaderCell#

import { CTableHeaderCell } from '@coreui/react'
// or
import CTableHeaderCell from '@coreui/react/src/components/table/CTableHeaderCell'
PropertyDefaultType
className#-string

A string of all className you want applied to the component.

color#-'primary', 'secondary', 'success', 'danger', 'warning', 'info', 'dark', 'light', string

Sets the color context of the component to one of CoreUI’s themed colors.

CTableRow#

import { CTableRow } from '@coreui/react'
// or
import CTableRow from '@coreui/react/src/components/table/CTableRow'
PropertyDefaultType
active#-boolean

Highlight a table row or cell..

align#-string

Set the vertical aligment.

className#-string

A string of all className you want applied to the component.

color#-'primary', 'secondary', 'success', 'danger', 'warning', 'info', 'dark', 'light', string

Sets the color context of the component to one of CoreUI’s themed colors.