Skip to contentKino
Skip to Content

Table

Rows of records with their numbers lined up. One highlight glides from row to row, picked rows join into one block, and rows glide to their new places as they are sorted, added or removed.

npx shadcn add https://kinoui.com/r/table.json
Share on

Examples

Invoices

6 invoices · November 2026

Invoices, issued in November 2026, in US dollars.
InvoiceCustomerStatus
KN-1048MCHalcyon LabsMaya ChenPaidNov 12$4,280.00
KN-1047TAOrbital CoffeeTomás AlvarezDueNov 10$865.50
KN-1046PRJuniper HealthPriya RamanOverdueNov 3$12,400.00
KN-1045JLKestrel & Co.Jonas LindqvistPaidNov 2$2,150.00
KN-1044AOAtlas FreightAmara OkaforDraftOct 30$640.00
KN-1043KWMosaic LearningKenji WatanabePaidOct 28$7,925.00
Total$28,260.50

Default

Pick rows, sort by date or amount, archive and restore: rows glide to their new places, and the empty state takes their place without the page jumping.

Invoices

42 invoices · October and November 2026
InvoiceStatus
KN-1090MCHalcyon LabsMaya ChenPaidNov 14$240.00
KN-1089TLFjord SupplyTobias LindqvistDueNov 13$1,613.50
KN-1088JLKestrel & Co.Jonas LindqvistPaidNov 12$2,987.00
KN-1087NHParcel PostNoah HaddadOverdueNov 11$4,359.00
KN-1086LFBrightlineLucía FernándezPaidNov 10$5,732.50
KN-1085PRJuniper HealthPriya RamanDraftNov 9$7,106.00
KN-1084SRLumen AudioSofia RossiDueNov 8$8,478.00
KN-1083KWMosaic LearningKenji WatanabePaidNov 7$9,851.50
KN-1082TAOrbital CoffeeTomás AlvarezDueNov 6$11,225.00
KN-1081MLCedar & StoneMei LinPaidNov 5$797.00

1–10 of 42

Rows

Data

Search, filter by status, sort by a column or Shift-click to add another, pick rows across pages with Shift for a range, and hide columns: useTableData does the work in the browser.

Invoice history

42 invoices · October and November 2026
InvoiceStatus
KN-1090MCHalcyon LabsMaya ChenPaidNov 14$240.00
KN-1089TLFjord SupplyTobias LindqvistDueNov 13$1,613.50
KN-1088JLKestrel & Co.Jonas LindqvistPaidNov 12$2,987.00
KN-1087NHParcel PostNoah HaddadOverdueNov 11$4,359.00
KN-1086LFBrightlineLucía FernándezPaidNov 10$5,732.50
KN-1085PRJuniper HealthPriya RamanDraftNov 9$7,106.00
KN-1084SRLumen AudioSofia RossiDueNov 8$8,478.00
KN-1083KWMosaic LearningKenji WatanabePaidNov 7$9,851.50
KN-1082TAOrbital CoffeeTomás AlvarezDueNov 6$11,225.00
KN-1081MLCedar & StoneMei LinPaidNov 5$797.00

1–10 of 42

Rows

Server

The same table with a server doing the work: the hook hands over the whole view as one object to fetch with, and the rows there are stay while the next ones load, with a line sliding under the header.

Latest orders

Open an order to see what was in it.
ItemsOrderCustomerStatus
KO-2318MCMaya ChenProcessingNov 14$1,850.00
KO-2317TATomás AlvarezShippedNov 12$747.00
KO-2316PRPriya RamanDeliveredNov 9$3,030.00
KO-2315JLJonas LindqvistDeliveredNov 4$249.00

Expandable rows

Each order opens a TableDetail under it with its items; the rows below glide to make room.

Spend this quarter

$34,675 of $43,000
Name
EngineeringComponents and the site$19,19577%
Kenji Watanabe, in EngineeringEngineer$9,140102%, over budget
Noah Haddad, in EngineeringEngineer$6,07576%
Sofia Rossi, in EngineeringEngineer$3,98050%
GrowthDocs, launches and the waitlist$8,35093%
DesignProduct design and research$7,13079%

Sub-rows

Each team holds its people as rows of its own, indented and sorted with it; a search opens the teams whose people match.

Customers

Drag a column’s edge to resize it; double-click it, or press Enter on it, to put it back.
CustomerPlanSeatsMonthlyCountryCustomer sinceOwnerActions
Halcyon Labsbilling@halcyon.devTeam24$1,176United StatesMar 18, 2025MCMaya Chen
Juniper Healthops@juniper.healthTeam12$588IndiaJul 2, 2025PRPriya Raman
Kestrel & Co.hello@kestrel.coPro3$87SwedenJan 11, 2026JLJonas Lindqvist
Orbital Coffeeteam@orbital.coffeePro2$58SpainMay 27, 2026TATomás Alvarez
Mosaic Learningadmin@mosaic.schoolFree1$0JapanSep 30, 2026KWKenji Watanabe

Resizable columns

Drag a column’s edge, or focus it and press the arrow keys, to resize it; the name and the actions stay in view as the rest scrolls.

The Kino team and the issues each closed in November.
NameRoleEmailClosed in November
AOAmara OkaforLeadamara@kinoui.com48
KWKenji WatanabeEngineerkenji@kinoui.com31
LFLucía FernándezDesignerlucia@kinoui.com27
TLTobias LindqvistProducttobias@kinoui.com9

Lined

variant="lined" draws a hairline between rows and a square highlight, for dense records read across.

Installation

npx shadcn@latest add https://kinoui.com/r/table.json
Files
lib/reduce-motion.tslib/scroll.tslib/refs.tslib/resize.tslib/swap.tsxlib/popup.tslib/glide.tsxcomponents/kino/tooltip.tsxlib/cut.tsxcomponents/kino/spinner.tsxcomponents/kino/button.tsxcomponents/kino/collapsible.tsxlib/run-progress.tslib/highlight.tslib/flow.tslib/track.tscomponents/kino/progress.tsxlib/placeholder.tscomponents/kino/skeleton.tsxlib/announce.tsxlib/controllable.tslib/dates.tslib/table-data.tsxcomponents/kino/table.tsx
Packages
@base-ui/react@tanstack/react-table@~9.3.1class-variance-authority

New to Kino? Installation covers what your project needs first and the @kino namespace.

API reference

Table

PropTypeDefaultDescription
variant"default""lined""default"Default has no lines between rows, and picked rows next to each other join into one block. Lined draws a hairline between rows.
containerClassNamestringNoneClasses for the box: a max-h- makes it scroll under a sticky header.
loadingbooleanfalseNew rows are on their way: the rows there are stay, readable, and a line slides along the header’s edge once it lasts 200ms, for at least 300ms. Before the first rows arrive, put a TableSkeleton in the body.

TableRow

PropTypeDefaultDescription
selectedbooleanfalseTints the row, for one picked by its checkbox.

TableHead

PropTypeDefaultDescription
numericbooleanfalseLines the column up at its end edge in figures of one width. Give it to the head and every cell of a column of amounts or counts.
sort"ascending""descending""none"NoneHow the column is sorted now. Only the column sorted first is named as sorted.
sortIndexnumberNoneIts place in a sort by several columns, from 1, shown beside the arrow.
onSort(event: { shiftKey: boolean }) => voidNoneCalled when its label is pressed. Shift adds the column to the sort.
sticky"start""end"NoneKeeps the column in view at the table’s start or end edge as the rest scrolls under it, with a line along its inner edge once something is hidden past it. Give its head and every cell the same.
widthnumberNoneThe column’s width in px once resized; its laid-out width until then. useTableData’s widthProps(column) gives it with the three below.
onWidthChange(width: number | undefined) => voidNoneMakes the column resizable: its end edge drags, and its handle takes the arrow keys (Shift for farther), Home and End. A double-click passes undefined, to put it back. The table then lays out by its columns’ widths and scrolls sideways past its box.
minWidthnumber64The narrowest a resize takes the column, in px.
maxWidthnumber800The widest a resize takes the column, in px.
resizeLabelstringNoneThe resize handle’s name: “Resize” and the label by default.

TableCell

PropTypeDefaultDescription
numericbooleanfalseLines the column up at its end edge in figures of one width. Give it to the head and every cell of a column of amounts or counts.
sticky"start""end"NoneKeeps the column in view at the table’s start or end edge as the rest scrolls under it, with a line along its inner edge once something is hidden past it. Give its head and every cell the same.

TableExpand

PropTypeDefaultDescription
expandedbooleanNoneWhether the row is open.
onExpandedChange(expanded: boolean) => voidNoneCalled when it is pressed.
expandablebooleantrueWhether the row has anything to open. Without, it keeps its room empty, so a sub-row’s text lines up.
depthnumber0How deep a sub-row is: each step indents it by --table-indent.

TableDetail

PropTypeDefaultDescription
colSpannumberNoneHow many columns the table has.

TableEmpty

PropTypeDefaultDescription
colSpannumberNoneHow many columns the table has.
showbooleanNoneWhether it shows: give its Empty the same. While hidden, it takes no room and isn’t read.

TableSkeleton

PropTypeDefaultDescription
columnsnumberNoneHow many columns the table has.
rowsnumber5How many rows stand in.

useTableData

PropTypeDefaultDescription
rowsRow[]NoneEvery row in the browser, or the page’s rows from a server.
columnsTableColumn<Row>[]NoneEach column’s id and label, the value it sorts, filters and searches by, the cell it shows, and whether it is sortable, searchable, numeric or hideable. filter: "options" picks among its values; filter: "range" keeps values between two. Keep the array the same between renders.
rowId(row: Row) => stringNoneWhat tells one row from another, kept across pages, sorts and filters.
manualbooleanfalseThe rows come sorted, searched, filtered and paged by a server: give rowCount, and each option’s count in a filter column’s options.
rowCountnumberNoneWith manual, how many rows match on the server.
viewPartial<TableView>NoneThe sort, search, filters, page, page size and hidden columns, as one object for the URL, a saved view or a server. A search, a filter or a page size goes back to page 1 in the same change.
onViewChange(view: TableView) => voidNoneCalled once for each change to the view.
selectedstring[]NoneThe ids of the picked rows, on every page.
allMatchingbooleanNoneWith manual, every row that matches is picked, beyond the ones loaded. It clears when the view changes.
subRows(row: Row) => Row[] | undefinedNoneA row’s own rows, shown under it, indented, once it is expanded. A page counts top rows, so sub-rows follow their row; a search or a filter opens the rows whose sub-rows match.
expandableboolean(row: Row) => booleanfalseWithout subRows, which rows open a TableDetail of their own.
expandedstring[]NoneThe ids of the rows open.
localestringThe visitor’sThe language text sorts in. The server sorts in en-US until the page has loaded.
searchWaitnumber0, or 300 with `manual`How long the search waits after the last keystroke, in ms, while the field shows each one.
messagesPartial<TableMessages>NoneThe words read out after a sort and a page turn, for another language.

Data attributes

AttributeOnDescription
data-variant<table>The variant.
data-resizable<table>Present while a column is resizable: the table lays out by its columns’ widths, and cells clip what they hold.
data-resizing<table>Present while a column’s edge is dragged.
data-row-idTableRow, TableDetailGive each row its id: a row put back while its copy still leaves, such as one expanded again mid-close, turns back from where it got to.
data-stickyTableHead, TableCellThe edge the column sticks to.
data-loading<table>Present while the line along the header shows that new rows are on their way.
data-sorted[data-slot=table-sort]Present while the head’s column is sorted.
data-selectedTableRowPresent while the row is picked.
data-scrolled[data-slot=table-scroller], inside the boxPresent while the box is scrolled down from its top.
data-flowingTableRowPresent while the row glides to a new place.
data-columns-moving<table>Present while columns glide to new widths. Cells clip what they hold.

CSS variables

VariableSet it onDefaultDescription
--table-indentTableExpand or anything above it1.25remHow far each level of sub-rows is indented.

Accessibility

  • A TableExpand says whether its row is open with aria-expanded, and points at its detail row with aria-controls.
  • A resize handle is a separator that takes focus: the arrow keys resize its column, Shift for farther, Home and End to its bounds, Enter puts it back, and it reads out its width. Focus that lands under a sticky column scrolls clear of it.
  • Give every table a TableCaption: it names the table, and the scrolling box takes the same name.
  • A box whose content is larger than it takes focus, so the arrow keys scroll it. When it stops scrolling, focus moves to the table’s first control.
  • A picked row is tinted and, in forced colours, takes the system’s highlight colour. Pair it with a checkbox, so the state isn’t shown by colour alone.
  • A TableHead with onSort holds a button, and aria-sort on the column sorted first. A screen reader hears each sort and page turn from status, and the Search field reads out how many rows match.
  • The checkboxes sit in a CheckboxGroup given selection: the box in the header picks this page, and Shift with a row’s box picks the rows from the last one pressed.
  • While new rows load, the table is busy, and the rows there stay until the new ones arrive.
  • When the system asks for less motion, rows and columns move at once and only fade.