HelixOverviewComponentsMapsGraphIntroductionInstallationDeriving a themeSandboxTheme builderVisual testingCortexDocsEngramActiveTraceActiveRecallActiveServicesInsightsGet in touchSource on GitHub
Loading the reference
Column ManagerView sourceEdit in SandboxView MarkdownCopy MarkdownOpen in ClaudeOpen in CursorA list of a Data Table's columns, to show, hide, reorder, and pin them.ExperimentalSince 0.238.0DataUsageimport'@fusion.dev/helix/column-manager'import'@fusion.dev/helix-headless/column-manager'Preview
API referenceRoothelix-column-managerA list of a Data Table's columns, to show, hide, reorder, and pin them.
PropTypeDescriptiondroppedLabelstringDefault"Hidden at this width"The note on a column the table leaves out at its width.fallbackLabelstringDefault"Columns"The name the element gives itself where label is empty.forstringDefault""The id of the DataTable whose columns the list holds, in the same
document or shadow root.labelstringDefault""The name of the list, which a screen reader announces before its items.movedLabelstringDefault"{name} moved to {position} of {count}"What a screen reader hears after a move. {name} is the column's heading,
{position} its place and {count} the number of columns.moveLabelstringDefault"Move {name}"The name of a column's grip. {name} is the column's heading.pinEndLabelstringDefault"Pin {name} to the end"The name of the pin button on a column pinned to the start. {name} is its heading.pinnedLabelstringDefault"Pinned"The note on a pinned column.pinStartLabelstringDefault"Pin {name} to the start"The name of the pin button on a column that is not pinned. {name} is its heading.resetLabelstringDefault"Reset"The words on the button that puts the columns back.unpinLabelstringDefault"Unpin {name}"The name of the pin button on a column pinned to the end. {name} is its heading.
ReadTypeDescriptiontableToolTable|nullThe bound table, once it is in the tree.whenSettledPromise<void>Resolves a frame after the first update, when transitions are switched on.
MethodTypeDescriptionmoveColumn(field: string, by: number) => booleanMoves one column by some places among the columns, and says where it went.pinColumn(field: string, edge: "end" | "start" | undefined) => booleanPins a column to an end of the row, or unpins it with undefined.reset() => booleanPuts the columns back as they were when the list first read the table.toggleColumn(field: string, shown: boolean) => booleanShows or hides one column.
PartDescriptioncheckboxThe checkbox that shows or hides a column.gripThe button that moves a column.grip-markThe icon on the grip.headerThe row above the list that holds the title and the reset button.itemOne column's row.item-draggingAdded to item while it is being dragged.item-hiddenAdded to item while its column is hidden.listThe list of columns.liveThe region that says a move. Visually hidden in the styled tier.nameA column's name, which labels its checkbox.noteSays "Pinned" or "Hidden at this width" beside a column's name.pinThe button that pins a column.pin-markThe icon on the pin button.pin-pinnedAdded to pin while its column is pinned.resetThe button that puts the columns back.titleThe list's heading.
CSS PropertyDescription--column-manager-gapThe space between the parts of a row.--column-manager-item-hover-background-colorThe fill of a row under the pointer.--column-manager-pinned-colorThe ink of a pinned column's pin.
Custom stateDescriptionsettledSet one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
Roothelix-headless-column-managerA list of a Data Table's columns, to show, hide, reorder, and pin them.
PropTypeDescriptiondroppedLabelstringDefault"Hidden at this width"The note on a column the table leaves out at its width.fallbackLabelstringDefault"Columns"The name the element gives itself where label is empty.forstringDefault""The id of the DataTable whose columns the list holds, in the same
document or shadow root.labelstringDefault""The name of the list, which a screen reader announces before its items.movedLabelstringDefault"{name} moved to {position} of {count}"What a screen reader hears after a move. {name} is the column's heading,
{position} its place and {count} the number of columns.moveLabelstringDefault"Move {name}"The name of a column's grip. {name} is the column's heading.pinEndLabelstringDefault"Pin {name} to the end"The name of the pin button on a column pinned to the start. {name} is its heading.pinnedLabelstringDefault"Pinned"The note on a pinned column.pinStartLabelstringDefault"Pin {name} to the start"The name of the pin button on a column that is not pinned. {name} is its heading.resetLabelstringDefault"Reset"The words on the button that puts the columns back.unpinLabelstringDefault"Unpin {name}"The name of the pin button on a column pinned to the end. {name} is its heading.
ReadTypeDescriptiontableToolTable|nullThe bound table, once it is in the tree.whenSettledPromise<void>Resolves a frame after the first update, when transitions are switched on.
MethodTypeDescriptionmoveColumn(field: string, by: number) => booleanMoves one column by some places among the columns, and says where it went.pinColumn(field: string, edge: "end" | "start" | undefined) => booleanPins a column to an end of the row, or unpins it with undefined.reset() => booleanPuts the columns back as they were when the list first read the table.toggleColumn(field: string, shown: boolean) => booleanShows or hides one column.
PartDescriptioncheckboxThe checkbox that shows or hides a column.gripThe button that moves a column.grip-markThe icon on the grip.headerThe row above the list that holds the title and the reset button.itemOne column's row.item-draggingAdded to item while it is being dragged.item-hiddenAdded to item while its column is hidden.listThe list of columns.liveThe region that says a move. Visually hidden in the styled tier.nameA column's name, which labels its checkbox.noteSays "Pinned" or "Hidden at this width" beside a column's name.pinThe button that pins a column.pin-markThe icon on the pin button.pin-pinnedAdded to pin while its column is pinned.resetThe button that puts the columns back.titleThe list's heading.
Custom stateDescriptionsettledSet one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
Examples
NameDescriptionPreviewA list of an invoice table's columns beside the table, with one column pinned and one hidden.PreviewA list of an invoice table's columns beside the table, with one column pinned and one hidden.