Skip to content

ResponsivePluginConfig

Since v1.1.0

Configuration options for the responsive plugin.

PropertyTypeDescription
breakpoint?numberWidth threshold in pixels to trigger responsive mode. When grid width < breakpoint, switches to card layout.
breakpoints?BreakpointConfig[]Multiple breakpoints for progressive degradation. Evaluated from smallest to largest maxWidth. When provided, the single breakpoint property is ignored.
cardRenderer?(row: T, rowIndex: number, column: ColumnConfig<any>) => HTMLElementCustom renderer function for card layout. If not provided, uses CSS-only default layout (header: value pairs).
hideHeader?booleanWhether to hide the per-field label rendered inside each card.
cardRowHeight?number | autoCard row height in pixels. Only applies when cardRenderer is provided. Use ‘auto’ for dynamic height based on content.
debounceMs?numberDebounce delay in ms for resize events.
hiddenColumns?HiddenColumnConfig[]Columns to hide in responsive mode (when using CSS-only default). Useful for hiding less important columns in card view. Supports enhanced syntax with showValue option.
animate?booleanEnable smooth animations when transitioning between modes.
animationDuration?numberAnimation duration in milliseconds.
breakpoints: [
{ maxWidth: 800, hiddenColumns: ['createdAt', 'updatedAt'] },
{ maxWidth: 600, hiddenColumns: ['createdAt', 'updatedAt', 'status'] },
{ maxWidth: 400, cardLayout: true },
]

Whether to hide the per-field label rendered inside each card.

In card mode each cell renders its column header as a label (e.g. Name: Alice) via the data-header attribute. Set this to true to suppress that label — only the value is shown.

Note: this does NOT control the column header row at the top of the grid; that row is always hidden in card mode (a card layout has no use for a tabular header).

Default: false


Default: 'auto'


Default: 100


hiddenColumns: [
'createdAt', // Entire cell hidden
{ field: 'email', showValue: true }, // Label hidden, value shown full-width
]

Default: true


Default: 200


AI assistants: For complete API documentation, implementation guides, and code examples for this library, see https://toolboxjs.com/llms-full.txt