Shadcn Filters Table Filtering

When to use

• Toolbars of removable filter chips over a table or list, one field, condition and value per chip
• Nested AND and OR condition builders, hung off a trigger over a report or laid out inline
• Attribute catalogs too large or deep to list at once, and option lists paged from a server

When not to use

• Conditions that need OR groups nested inside an AND: use the Filters Popover Builder example
• A finished record table with its chip bar, paging and row actions already built: use the Filtering blocks
• Storefront product facets with price sliders, color swatches and department pills: use the Filter Sidebar blocks
• One day or span of days picked on its own, with no attribute or condition: use the Date Selector component

Agent notes

• matches filters STAFF in the browser; send the query to your API and feed the rows it returns to useTable once data lives on a server
• readField maps a field id to a row value, and staff searches name and email together; add a case for any field that is not a plain row key
• renderValue, icon and a component editor count toward the schema index by presence only, so swapping one alone keeps serving the old one
• A rule reaches onQueryChange unfinished: an empty operator, or a value still undefined or empty where its arity is not none; skip it when compiling
• Negate swaps to an operator's inverse where one exists and otherwise sets negated, as on starts_with, so a compiler must read negated

Third-party API docs

• TanStack Table v9: API reference, docs