Copy column
Prop enableCopyColumn — engine behaviour, default true.
Guide
When to use it
Keep (or remove) the "copy the whole column" affordance — Ctrl/Cmd+Space and the columns-menu copy button.
How it works
A sub-toggle of clipboard (on by default). It gates selectColumn / copyColumn at the runtime
choke point — the keyboard gesture and the menu button — copying the column across all pages.
Gotchas
- Only relevant when
enableClipboardis on. - Set it
falseto allow range/row copy but forbid whole-column copy (e.g. for very wide columns).
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}
enableCellSelection enableClipboard showStatusBar />
)
}
Overview
| Layer | enable* (engine, resolved in useBstTable) |
| Type | boolean |
| Default | true |
| Maps to | custom — sub-toggle of clipboard; gates selectColumn/copyColumn (the Ctrl/⌘+Space gesture and the Columns-menu copy button) at the runtime choke point. In settings ("Selection & clipboard", always shown) |
| Status | ✅ done |
| Since | v0.27.0 |
| Settings sheet | Selection & clipboard |
Copy a whole column across all pages — the Ctrl/Cmd+Space gesture and the Columns-menu "Copy column" button. A sub-toggle of clipboard; set false to disable column-copy while keeping the rest of the clipboard. Default: true.
Enable it
<BstTableMui
data={rows}
columns={columns}
enableCopyColumn
/>
Swap
BstTableMuiforBstTableShadcn(and the CSS import) for the shadcn skin — same props.
Behavior & interactions
- Requires
enableClipboardto be on — this flag is a no-op otherwise. - Defaults to ON — set false to disable Ctrl/⌘+Space column copy while keeping the rest of the clipboard.
Spec coverage
Spec codes (
A1,C2,X8, …) are Bst-Table's internal requirement IDs from the capability matrix;P0–P2mark the delivery phase. They are traceability tags, not part of the public API.
- H3 · Copy column — ✅ built. fixed — runtime.copyColumn / Ctrl+Space selects the whole column and copies all pages (pre-pagination, filter+sort order); copyRow/Shift+Space too. Server-tier export rides the Phase-4 foundation