Data Table Params

GitHub

Reads and writes data-table query state using readable URL parameters.

Installation

bash
pnpm dlx shadcn@latest add @cs/data-table-params

Usage

tsx
import { dataTableParamKeys } from "@/lib/cs/data-table-params";
tsx
const keys = dataTableParamKeys("orders_");

API Reference

dataTableParamKeys

Builds readable URL parameter keys for an optional per-table prefix.

Parameters

NameTypeDefaultDescription
prefix *unknown--

Returns: unknown

writeDataTableQuery

Serializes table query state into readable params using the shared convention.

Parameters

NameTypeDefaultDescription
search *URLSearchParams--
query *DataTableQuery--
prefix *unknown--

Returns: unknown

readTableQuery

Parses readable params into table query state, falling back to defaults (e.g. a saved view).

Parameters

NameTypeDefaultDescription
get *TableParamGetter--
prefix *unknown--
defaultsPartial<DataTableQuery>--

Returns: DataTableQuery