@nxgt/material 3.22.0 → 3.23.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +13 -0
- package/README.md +1 -1
- package/dist/{components-B0oezhGe.js → components-BaUx5Nax.js} +10099 -10047
- package/dist/components.js +1 -1
- package/dist/lib/components/ui/collections/data-table/partials/data-table-page-control.d.ts +7 -2
- package/dist/lib/components/ui/collections/data-table/partials/data-table-toolbar.d.ts +6 -2
- package/dist/lib/components/ui/collections/data-table/types.d.ts +4 -0
- package/dist/lib/components/ui/collections/data-table/use-pager-focus.d.ts +30 -0
- package/dist/lib/components/ui/collections/server-table/partials/server-table-band-classes.d.ts +6 -0
- package/dist/lib/components/ui/collections/server-table/partials/server-table-band.d.ts +3 -1
- package/dist/lib/components/ui/collections/server-table/types.d.ts +3 -0
- package/dist/main.js +1 -1
- package/dist/material.css +1 -1
- package/docs/components/data-table-filter-and-lists.md +24 -2
- package/docs/troubleshooting.md +19 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,18 @@
|
|
|
1
1
|
# @nxgt/material
|
|
2
2
|
|
|
3
|
+
## 3.23.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- [#1617](https://github.com/softistx/nxgt-material/pull/1617) [`fe1a728`](https://github.com/softistx/nxgt-material/commit/fe1a728d019f7ce548b238202706e82c9175fe79) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `ServerTable` and `DataTable` paging, band and touch fixes ([#1609](https://github.com/softistx/nxgt-material/issues/1609), [#1611](https://github.com/softistx/nxgt-material/issues/1611), [#1612](https://github.com/softistx/nxgt-material/issues/1612), [#1599](https://github.com/softistx/nxgt-material/issues/1599)).
|
|
8
|
+
|
|
9
|
+
- **Focus ([#1609](https://github.com/softistx/nxgt-material/issues/1609)).** Previous / Next keep the focus while the next page loads: the control stays the same element, `aria-disabled` (a click on it does nothing), instead of being swapped for a disabled button that dropped the focus to `<body>`. When a control goes (Next on the last page), the focus moves to its counterpart, or to the pagination `<nav>` (`tabindex="-1"`). The selected count of the server footer is a polite status.
|
|
10
|
+
- **No reserved bulk row ([#1611](https://github.com/softistx/nxgt-material/issues/1611)).** New `DataTable` prop `reserveActions` (default `true`, unchanged); `ServerTable` passes `false`: no empty 68px row under the band while nothing is selected, the bulk bar arrives with the first selection (a short grow, none under reduced motion).
|
|
11
|
+
- **Phone actions ([#1612](https://github.com/softistx/nxgt-material/issues/1612)).** New `ServerTable` prop `bandActions: 'stacked' | 'inline'` (default `'stacked'`, unchanged): `'inline'` keeps a lone icon action on the search's row below 768px.
|
|
12
|
+
- **44px page controls ([#1599](https://github.com/softistx/nxgt-material/issues/1599)).** `pageControls="icon"` Previous / Next are 44x44 boxes on a coarse pointer (painted 32px, layout unchanged).
|
|
13
|
+
|
|
14
|
+
**Visual change:** a `ServerTable` with `bulkActions` no longer shows an empty row under its band; its rows move down by the bar's height on the first selection.
|
|
15
|
+
|
|
3
16
|
## 3.22.0
|
|
4
17
|
|
|
5
18
|
### Minor Changes
|
package/README.md
CHANGED
|
@@ -627,7 +627,7 @@ Not components: what the stylesheet gives any element.
|
|
|
627
627
|
| Preview | Component | What it does | @nxgt/material-vue |
|
|
628
628
|
| --- | --- | --- | --- |
|
|
629
629
|
| <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-datatable.webp" width="120" alt="DataTable"> | [`DataTable`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#datatable), `DataTableColumnHeader`, `DataTablePagination`, `DataTableServerFooter`, `DataTableViewOptions` | TanStack Table v9 with sorting, filtering, selection, expandable rows, pagination or load-more, column visibility, skeleton rows while loading and your own empty state — or one server page at a time, with controlled sorting and selection, cursor Previous / Next links and row links. On a phone it keeps its header row and scrolls sideways in a keyboard-reachable region; the page does not. Or cards and tiles instead of the table (`layout`, `renderCard`, `renderTile`), and `layout={{ phone: 'tiles', wide: 'table' }}` for tiles on a phone ([cards and tiles guide](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/cards-and-tiles.md)). Long lists render only the rows in view (`virtual`). | `DataTable`, `DataTableColumnHeader`, `DataTablePagination`, `DataTableServerFooter`, `DataTableViewOptions` |
|
|
630
|
-
| <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-servertable.webp" width="120" alt="ServerTable"> | [`ServerTable`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#servertable), `createSorting`, `tableFilters`, `defineFilterModel`, `parseFilterQuery`, `serializeFilterQuery`, `paramsFromQuery`, `serverPagination`… | A server-mode `DataTable` driven by the URL's search params, for any router: the Filter in its top band with the page's title (optional), description and actions, the sort, forward cursor paging, a selection reset on a new query, the empty page (a scene and an action for "nothing yet", the filters as removable chips), a compact band (`bandDensity`), icon-only Previous / Next (`pageControls`), a `filterRef` to focus the Filter, a page past the last (rows deleted) that says so and links back to the first, an error state with Retry for a failed fetch (`error`, `onRetry`), and one count announced. | `ServerTable`, `createSorting`, `tableFilters`, `serverPagination` |
|
|
630
|
+
| <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-servertable.webp" width="120" alt="ServerTable"> | [`ServerTable`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#servertable), `createSorting`, `tableFilters`, `defineFilterModel`, `parseFilterQuery`, `serializeFilterQuery`, `paramsFromQuery`, `serverPagination`… | A server-mode `DataTable` driven by the URL's search params, for any router: the Filter in its top band with the page's title (optional), description and actions, the sort, forward cursor paging, a selection reset on a new query, the empty page (a scene and an action for "nothing yet", the filters as removable chips), a compact band (`bandDensity`), icon-only Previous / Next (`pageControls`, 44px targets on a touch screen, focus kept while a page loads), actions that stay on the search's row on a phone (`bandActions`), a bulk bar that reserves no row until a selection, a `filterRef` to focus the Filter, a page past the last (rows deleted) that says so and links back to the first, an error state with Retry for a failed fetch (`error`, `onRetry`), and one count announced. | `ServerTable`, `createSorting`, `tableFilters`, `serverPagination` |
|
|
631
631
|
| <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-listempty.webp" width="120" alt="ListEmpty"> | [`ListEmpty`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#listempty) | A list's empty page: nothing yet (a title, or a scene, a line and an action), or nothing matches with what narrows it and a way out (a button or a link); its title is an `h2` (`headingLevel`). | `ListEmpty` |
|
|
632
632
|
| <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-datagrid.webp" width="120" alt="DataGrid"> | [`DataGrid`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#datagrid) | An editable grid over `DataTable`'s columns: spreadsheet keys, a selected range, editors for text, numbers (with codes such as "abs"), options, dates and checkboxes, or your own; paste from Excel or Sheets, a fill handle that continues series, resizable, hideable and reorderable columns, undo, totals, and saving per cell, per row or in a batch with versions and conflicts ([guide](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/guides/data-grid.md)). Long grids render only what is in view; on a phone it is a list of rows that open a panel. | — (later) |
|
|
633
633
|
| <img src="https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/previews/data-table-filter-lists-daygroupedlist.webp" width="120" alt="DayGroupedList"> | [`DayGroupedList`](https://cdn.jsdelivr.net/npm/@nxgt/material@3/docs/components/data-table-filter-and-lists.md#daygroupedlist), `groupByDay` | A list split by day — Today, Yesterday, This week, Earlier — under headings that stick while their items scroll. | — (later) |
|