Search documentation

Search for a page or heading...

tablecn
24

What's new in each release of the blocks and the @querycn packages, and what to do when you update.

Newest first. A release can change the npm packages, the registry blocks, or both:

  • Packages (@querycn/*) update with npm install @querycn/table-react@latest ….
  • Blocks (data-table, filter-builder) are files in your project, so they only change when you add them again. See Updating.

The full list of package changes is in each package's CHANGELOG.md on GitHub.

October 10, 2026

Changes to the blocks only: they now need @querycn/table-react 0.4.0.

New

  • Bulk edit. While rows are selected, the floating bar shows Bulk edit for tables with editable columns. Its dialog picks columns and a value for each, with the column's own editor, and saves them in every selected row: one onBulkEdit call, or onCellEdit per changed cell. See Bulk edit.
  • DataTableToolbar and DataTableSelectionBar take cellEditors, for your own editors in the dialog.

Changed

  • The selection bar shows for editable tables even without selectionActions, to offer Bulk edit.

Updating

  1. Update the package: npm install @querycn/table-react@latest.
  2. Add the data-table block again with --overwrite: npx shadcn@latest add @tablecn/data-table --overwrite. It brings four new files, data-table-bulk-edit-dialog.tsx, data-table-bulk-edit-field.tsx, use-bulk-edit.ts and bulk-edit-fields.ts, and shadcn's dialog. Commit your changes first.
  3. If you pass your own editors to DataTable, pass them to DataTableToolbar too.

October 9, 2026

PackageVersion
@querycn/table-react0.4.0

New

  • Bulk edit in @querycn/table-react. useDataTable's new onBulkEdit saves the same values in every selected row in one call: it gets { rowIds, rows, changes, options }, where changes holds the new value of each column and options the picked option of each select column. If it throws, applyBulkEdit rejects with the error. Without onBulkEdit, a bulk edit calls onCellEdit for each changed cell. getBulkEditColumns(table, rows) lists the columns a bulk edit can change, those with meta.edit that canEditCell allows in every row, and applyBulkEdit(table, rows, changes, options) saves the edit. The data-table block doesn't have a bulk edit dialog yet; these are for building your own.
  • Cards and a stacked toolbar on small screens. When the table's container is narrower than 36rem (576px), each row shows as a card: the selection checkbox, the first column as the title, the columns pinned to the end beside it, and the other visible columns below with their labels. Selection, the floating bar, onRowClick and rowClassName work on cards; editing stays in the table. A virtualized table keeps the table layout. The toolbar stacks too: the search on its own line, the filter beside the buttons, then the chips, and Columns shows only its icon. Both follow their container's width, not the screen's, with Tailwind container queries you can change. See Responsive.

Changed

  • The selection bar floats over the table. It's a pill at the bottom of the table, like a toast: × to clear the selection, the count, then your selectionActions. It stays in view while the table scrolls past and never covers the pagination. Its colors are the theme's swapped, and it's a toolbar you can move through with the arrow keys. selectionActions is unchanged; give its buttons variant="ghost". Clear selection is now an × button with that name. See The floating bar.

Updating

  1. Update the package for bulk edit: npm install @querycn/table-react@latest. If you pass a complete message object instead of using mergeTableMessages, add the new bulkEdit group. TypeScript points out what's missing.
  2. Add the data-table block again with --overwrite: npx shadcn@latest add @tablecn/data-table --overwrite. It brings three new files, use-floating-selection-bar.ts, toolbar-arrow-keys.ts and data-table-cards.tsx. Commit your changes first.
  3. If your tests render the table in jsdom, query inside the table: within(screen.getByRole("table")). The cards repeat each value, and jsdom doesn't run the container queries that hide them.

September 29, 2026

Changes to the blocks only: no package release.

Fixed

  • cn comes from the cn package, like shadcn/ui's current styles, so the blocks build in projects without lib/utils.ts. The blocks list cn as a dependency. (#7)
  • The table fills its border. When the columns add up to less than the container, a filler cell takes the rest, so rows and their hover and selection colors reach the border. Columns pinned to the end stay against the end edge. (#8)
  • One line under the header, instead of two stacked 1px lines. (#9)
  • No react-hooks/refs errors in data-table-editable-cell.tsx with eslint-config-next 16. (#6)

Updating

Add the blocks again with --overwrite: npx shadcn@latest add @tablecn/data-table @tablecn/filter-builder --overwrite. Commit your changes first.

September 28, 2026

PackageVersion
@querycn/table-react0.3.0
@querycn/filter-core, @querycn/filter-react, @querycn/filter-next0.3.0

New

  • @tablecn is in the shadcn registry directory. npx shadcn@latest add @tablecn/data-table works right away, without adding the registry to components.json first.
  • Inline editing. Users edit a cell where it is: Enter, F2 or a double click opens its editor, Enter saves. Turn it on with meta.edit on a column and onCellEdit in useDataTable, which can save to your API and throw to show an error under the cell. Editors for text, numbers, selects and yes/no, a select can search your API with loadOptions, and you can add your own. See Inline editing.
  • A time field type for a time of day with no date, like 09:30, with is at, is after, is between and the other time operators. See Fields.
  • Time and date-time pickers. The filter picks times and date-times from scrolling hour and minute columns, with Now and OK. Both pickers are also standalone components you can copy: Time picker and Date time picker.
  • A Full example page: one orders table with every feature on, and all of its code.
  • A Right-to-left page, with a live Arabic-direction table and the setup for Radix UI, Base UI and React Aria.

Fixed

  • While dragging a column's edge, the resize cursor stays on, even when the pointer leaves the header.
  • On right-to-left pages, headers and cells align to the right, the selection checkbox keeps its space from the table's edge, the resize line is centered on the edge, and the filter's range arrow points from the start to the end.
  • Popovers (the filter panel, pickers, the Columns menu, the API select editor) and the filter's calendars follow the direction of your primitive library's provider, even when only part of the page is right-to-left. The Radix UI and Base UI blocks now list radix-ui / @base-ui/react as dependencies for it.
  • The blocks ask for the package versions they use. data-table asked for @querycn/table-react@^0.1.0, so a new install could get an older version than the block needs.

Updating

  1. Update the packages: npm install @querycn/table-react@latest @querycn/filter-react@latest (and @querycn/filter-next@latest on Next.js).
  2. Add the blocks again to get inline editing and the pickers: npx shadcn@latest add @tablecn/data-table @tablecn/filter-builder --overwrite. Commit your changes first.
  3. If you pass complete message objects instead of using mergeTableMessages / mergeMessages, add the new texts: the table's editing group, and the filter's placeholders.time, placeholders.hour, placeholders.minute, actions.now and actions.ok. TypeScript points out what's missing.

September 26, 2026

PackageVersion
@querycn/table-react0.2.0

New

  • Turn a feature off for the whole table: enableSorting, enableColumnResizing and enableColumnOrdering in useDataTable. Pass enableSorting to useTableQuery too, so your backend never gets a sort the table ignores. See Columns.

Changed

  • The selection bar under the toolbar only shows when you pass selectionActions. Without actions, the pagination already counts the selected rows. See Row selection.

Fixed

  • The selection column has no ⋯ menu, which used to cover its select-all checkbox.

Updating

Update @querycn/table-react, and add @tablecn/data-table again with --overwrite.

September 25, 2026: first release

PackageVersion
@querycn/filter-core, @querycn/filter-react, @querycn/filter-next0.2.0
@querycn/table-react0.1.0
  • The data-table block: search, sorting by one or several columns, pages, row selection, loading, empty and error states, and virtualization. Users move, resize, pin, hide and color columns, and their layout is saved in the browser.
  • The filter-builder block: conditions like Status is Paid and Amount is between 10 and 50, with AND / OR, chips, and options loaded from your API.
  • Everything in the URL: ?q=nguyen&status__eq=paid&sort=-amount&page=2, through adapters for Next.js, react-router and the browser.
  • Client or server data, with request builders for JSON:API-style APIs, django-filter and PostgREST.
  • Radix UI, Base UI and React Aria versions of both blocks, and English and Vietnamese texts.