Collection Preferences Table

ProNew

A data table that applies every collection preference for real: visible and ordered columns, row density, wrapped or truncated text, striped rows and page size with working pagination.

Customize

Derived from this item’s props table, because it declares no controls of its own. This item has no standalone playground, so changes update the code, the share link and the AI prompt.

caption

Guide and examples

When to use it

Use this when a table has more columns than most people need and people disagree about density, wrapping and page size.

Do not use it when the table has three columns and one sensible layout.

Installation

This item is part of tealmac UI Pro

The source for this item installs with a Pro licence key. Log in with your key to see the install command, or read the Pro setup page.

Props

Prop	Type	Required	Description
`columns`	`CollectionColumnOption[]`	required	-
`rows`	`Record<string, string>[]`	required	-
`initial`	`Partial<CollectionPreferencesValue>`	optional	-
`caption`	`string`	required	-

Accessibility

Preferences apply only on Confirm, so a table never half-changes.
The row range is a status message; pagination buttons disable at the ends.
Column order follows the dialog and uses real table headers.

Testing

The pattern ships with a Testing Library test (collection-preferences-table.test.tsx) that covers the first page, paging, applying page size and columns, density and striping.

Guide and examples

When to use it

Use this when a table has more columns than most people need and people disagree about density, wrapping and page size.

Do not use it when the table has three columns and one sensible layout.

Installation

This item is part of tealmac UI Pro

The source for this item installs with a Pro licence key. Log in with your key to see the install command, or read the Pro setup page.

Props

Prop	Type	Required	Description
`columns`	`CollectionColumnOption[]`	required	-
`rows`	`Record<string, string>[]`	required	-
`initial`	`Partial<CollectionPreferencesValue>`	optional	-
`caption`	`string`	required	-

Accessibility

Preferences apply only on Confirm, so a table never half-changes.
The row range is a status message; pagination buttons disable at the ends.
Column order follows the dialog and uses real table headers.

Testing

The pattern ships with a Testing Library test (collection-preferences-table.test.tsx) that covers the first page, paging, applying page size and columns, density and striping.