Skip to main content

Column resizing

Prop enableColumnResizing — engine behaviour, default true.

Guide

When to use it

On by default — users drag a column's border to resize it, or double-click the border to auto-fit.

How it works

Drag the header edge to set a width; double-click the resize handle to auto-size to the column's content (sampled canvas.measureText, clamped to minSize / maxSize).

Gotchas

  • fitColumns suppresses the resize handles — it owns column widths while on.
  • Set it false to lock widths (users can't resize).

Live example

Example source
import React from 'react'
import { BstTableMui } from '@bloomskill/table-mui'
import type { BstTableColumn } from '@bloomskill/table-engine'
import '@bloomskill/table-engine/styles.css'

type Row = { id: string; name: string; team: string; role: string; score: number }
const seed: Row[] = [
{ id: '1', name: 'Ada Lovelace', team: 'Platform', role: 'Engineer', score: 92 },
{ id: '2', name: 'Alan Turing', team: 'Research', role: 'Scientist', score: 88 },
{ id: '3', name: 'Grace Hopper', team: 'Platform', role: 'Engineer', score: 95 },
{ id: '4', name: 'Katherine J.', team: 'Research', role: 'Analyst', score: 90 },
{ id: '5', name: 'Edsger Dijkstra',team: 'Platform', role: 'Architect',score: 84 },
]
const columns: BstTableColumn<Row>[] = [
{ id: 'name', accessorKey: 'name', header: 'Name' },
{ id: 'team', accessorKey: 'team', header: 'Team' },
{ id: 'role', accessorKey: 'role', header: 'Role' },
{ id: 'score', accessorKey: 'score', header: 'Score', sortFn: 'basic' },
]

export default function App() {
return (
<BstTableMui data={seed} columns={columns} getRowId={(r) => r.id}
enableColumnPinning enableColumnOrdering showColumnsMenu />
)
}
Loading live example…

Overview

Layerenable* (engine, resolved in useBstTable)
Typeboolean
Defaulttrue
Maps tov9 enableColumnResizing
Status✅ done
Settings sheetColumns

Column resizing. Maps to v9 enableColumnResizing. Default: true.

Enable it

<BstTableMui
data={rows}
columns={columns}
enableColumnResizing
/>

Swap BstTableMui for BstTableShadcn (and the CSS import) for the shadcn skin — same props.

Behavior & interactions

  • Conflicts with fitColumns — manual column resizing is suppressed while fitColumns is on.