useTableFiltering@astryxdesign/core v0.7.17 · useTableFiltering

Usage

Table plugin that adds inline column filters with popover or inline controls. Pairs with useTableFilterState for managed state. Supports text, select, multi-select, date, and number filter types via PowerSearch field definitions. The plugin renders the filter controls only; it does not remove rows. Filter the data yourself (toSearchFilters with applyFilters from usePowerSearchConfig) and pass the result to Table. When no row matches, Table shows its emptyState prop.

ts
import {useTableFiltering} from '@astryxdesign/core/Table'

Parameters

ParamTypeDescription
filtersrequired

Current filter state: map from column key to filter value.

onFilterChangerequired
(columnKey: string, value:
| null) => void

Called when the user changes a filter value. null clears the filter.

variant
'popover' | 'inline' | 'inline-compact' (default: 'popover')

Display variant for filter controls.

searchConfigrequired

Defines the filter fields. A column sets filter: '<field key>' to show the control for that field. Build it with usePowerSearchConfig or createPowerSearchConfig; PowerSearch can use the same config.

Examples

Common configurations, variations, and states.
Table — Inline Filters
Open in Playground

Table with inline filter controls rendered directly below each column header.

Table — Popover Filters
Open in Playground

Table with popover filter controls triggered by icons in column headers.

Use with shadcn

Already using the shadcn registry workflow? Install the real Astryx package and a local public re-export. Component implementation source stays in Astryx.

This install URL expires with the draft preview.
bash
npx shadcn@4.19.0 add https://astryx-15uv3wkoy-fbopensource.vercel.app/shadcn/hooks/use-table-filtering.json