@cloud-ru/ds-table 2.2.12-preview-2991dba0.0 → 2.2.12
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 +4 -0
- package/README.md +334 -27
- package/dist/cjs/components/ServerTable/ServerTable.js +1 -1
- package/dist/cjs/components/Table/Table.d.ts +1 -1
- package/dist/cjs/components/Table/Table.js +3 -9
- package/dist/cjs/components/Table/hooks/useTableInstance.d.ts +1 -2
- package/dist/cjs/components/Table/hooks/useTableInstance.js +1 -2
- package/dist/cjs/components/Table/styles.module.css +0 -1
- package/dist/cjs/components/types.d.ts +3 -6
- package/dist/cjs/helperComponents/Cells/RowActionsCell/components/RowActionsButton.js +4 -1
- package/dist/cjs/helperComponents/Cells/RowActionsCell/styles.module.css +0 -2
- package/dist/cjs/helperComponents/Cells/TreeCell/TreeLine/styles.module.css +0 -1
- package/dist/cjs/helperComponents/TableEmptyState/hooks.d.ts +1 -2
- package/dist/cjs/helperComponents/TableEmptyState/hooks.js +2 -5
- package/dist/cjs/helperComponents/TablePagination/TablePagination.js +7 -31
- package/dist/cjs/helperComponents/TablePagination/styles.module.css +0 -8
- package/dist/cjs/hooks/useCellSizes.js +2 -4
- package/dist/cjs/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.js +0 -1
- package/dist/cjs/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.js +1 -1
- package/dist/cjs/locale/index.d.ts +8 -28
- package/dist/cjs/locale/index.js +4 -14
- package/dist/cjs/presets/adminTable/AdminTable.d.ts +4 -0
- package/dist/cjs/presets/adminTable/AdminTable.js +11 -0
- package/dist/cjs/presets/adminTable/index.d.ts +4 -0
- package/dist/cjs/presets/adminTable/index.js +9 -0
- package/dist/cjs/presets/adminTable/toAdminTableProps.d.ts +31 -0
- package/dist/cjs/presets/adminTable/toAdminTableProps.js +57 -0
- package/dist/cjs/presets/adminTable/useAdminTableProps.d.ts +5 -0
- package/dist/cjs/presets/adminTable/useAdminTableProps.js +25 -0
- package/dist/cjs/presets/index.d.ts +3 -0
- package/dist/cjs/presets/index.js +3 -0
- package/dist/cjs/presets/serverAdminTable/ServerAdminTable.d.ts +4 -0
- package/dist/cjs/presets/serverAdminTable/ServerAdminTable.js +11 -0
- package/dist/cjs/presets/serverAdminTable/index.d.ts +4 -0
- package/dist/cjs/presets/serverAdminTable/index.js +9 -0
- package/dist/cjs/presets/serverAdminTable/toServerAdminTableProps.d.ts +13 -0
- package/dist/cjs/presets/serverAdminTable/toServerAdminTableProps.js +25 -0
- package/dist/cjs/presets/serverAdminTable/useServerAdminTableProps.d.ts +5 -0
- package/dist/cjs/presets/serverAdminTable/useServerAdminTableProps.js +25 -0
- package/dist/cjs/presets/serverSimpleTable/ServerSimpleTable.d.ts +3 -0
- package/dist/cjs/presets/serverSimpleTable/ServerSimpleTable.js +11 -0
- package/dist/cjs/presets/serverSimpleTable/index.d.ts +4 -0
- package/dist/cjs/presets/serverSimpleTable/index.js +9 -0
- package/dist/cjs/presets/serverSimpleTable/toServerSimpleTableProps.d.ts +13 -0
- package/dist/cjs/presets/serverSimpleTable/toServerSimpleTableProps.js +25 -0
- package/dist/cjs/presets/serverSimpleTable/useServerSimpleTableProps.d.ts +4 -0
- package/dist/cjs/presets/serverSimpleTable/useServerSimpleTableProps.js +21 -0
- package/dist/cjs/presets/simpleTable/SimpleTable.d.ts +1 -1
- package/dist/cjs/presets/simpleTable/SimpleTable.js +1 -1
- package/dist/cjs/presets/simpleTable/toSimpleTableProps.d.ts +6 -5
- package/dist/cjs/presets/simpleTable/toSimpleTableProps.js +6 -6
- package/dist/cjs/presets/simpleTable/useSimpleTableProps.js +4 -1
- package/dist/cjs/presets/treeTable/toTreeTableProps.d.ts +7 -7
- package/dist/cjs/presets/treeTable/toTreeTableProps.js +3 -2
- package/dist/cjs/style.css +0 -12
- package/dist/esm/components/ServerTable/ServerTable.js +1 -1
- package/dist/esm/components/Table/Table.d.ts +1 -1
- package/dist/esm/components/Table/Table.js +3 -9
- package/dist/esm/components/Table/hooks/useTableInstance.d.ts +1 -2
- package/dist/esm/components/Table/hooks/useTableInstance.js +1 -2
- package/dist/esm/components/Table/styles.module.css +0 -1
- package/dist/esm/components/types.d.ts +3 -6
- package/dist/esm/helperComponents/Cells/RowActionsCell/components/RowActionsButton.js +4 -1
- package/dist/esm/helperComponents/Cells/RowActionsCell/styles.module.css +0 -2
- package/dist/esm/helperComponents/Cells/TreeCell/TreeLine/styles.module.css +0 -1
- package/dist/esm/helperComponents/TableEmptyState/hooks.d.ts +1 -2
- package/dist/esm/helperComponents/TableEmptyState/hooks.js +2 -5
- package/dist/esm/helperComponents/TablePagination/TablePagination.js +7 -31
- package/dist/esm/helperComponents/TablePagination/styles.module.css +0 -8
- package/dist/esm/hooks/useCellSizes.js +3 -5
- package/dist/esm/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.js +0 -1
- package/dist/esm/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.js +1 -1
- package/dist/esm/locale/index.d.ts +8 -28
- package/dist/esm/locale/index.js +4 -14
- package/dist/esm/presets/adminTable/AdminTable.d.ts +4 -0
- package/dist/esm/presets/adminTable/AdminTable.js +8 -0
- package/dist/esm/presets/adminTable/index.d.ts +4 -0
- package/dist/esm/presets/adminTable/index.js +3 -0
- package/dist/esm/presets/adminTable/toAdminTableProps.d.ts +31 -0
- package/dist/esm/presets/adminTable/toAdminTableProps.js +54 -0
- package/dist/esm/presets/adminTable/useAdminTableProps.d.ts +5 -0
- package/dist/esm/presets/adminTable/useAdminTableProps.js +22 -0
- package/dist/esm/presets/index.d.ts +3 -0
- package/dist/esm/presets/index.js +3 -0
- package/dist/esm/presets/serverAdminTable/ServerAdminTable.d.ts +4 -0
- package/dist/esm/presets/serverAdminTable/ServerAdminTable.js +8 -0
- package/dist/esm/presets/serverAdminTable/index.d.ts +4 -0
- package/dist/esm/presets/serverAdminTable/index.js +3 -0
- package/dist/esm/presets/serverAdminTable/toServerAdminTableProps.d.ts +13 -0
- package/dist/esm/presets/serverAdminTable/toServerAdminTableProps.js +22 -0
- package/dist/esm/presets/serverAdminTable/useServerAdminTableProps.d.ts +5 -0
- package/dist/esm/presets/serverAdminTable/useServerAdminTableProps.js +22 -0
- package/dist/esm/presets/serverSimpleTable/ServerSimpleTable.d.ts +3 -0
- package/dist/esm/presets/serverSimpleTable/ServerSimpleTable.js +8 -0
- package/dist/esm/presets/serverSimpleTable/index.d.ts +4 -0
- package/dist/esm/presets/serverSimpleTable/index.js +3 -0
- package/dist/esm/presets/serverSimpleTable/toServerSimpleTableProps.d.ts +13 -0
- package/dist/esm/presets/serverSimpleTable/toServerSimpleTableProps.js +22 -0
- package/dist/esm/presets/serverSimpleTable/useServerSimpleTableProps.d.ts +4 -0
- package/dist/esm/presets/serverSimpleTable/useServerSimpleTableProps.js +18 -0
- package/dist/esm/presets/simpleTable/SimpleTable.d.ts +1 -1
- package/dist/esm/presets/simpleTable/SimpleTable.js +1 -1
- package/dist/esm/presets/simpleTable/toSimpleTableProps.d.ts +6 -5
- package/dist/esm/presets/simpleTable/toSimpleTableProps.js +7 -7
- package/dist/esm/presets/simpleTable/useSimpleTableProps.js +4 -1
- package/dist/esm/presets/treeTable/toTreeTableProps.d.ts +7 -7
- package/dist/esm/presets/treeTable/toTreeTableProps.js +4 -3
- package/dist/esm/style.css +0 -12
- package/dist/tsconfig.cjs.tsbuildinfo +1 -1
- package/dist/tsconfig.esm.tsbuildinfo +1 -1
- package/package.json +20 -20
- package/src/components/ServerTable/ServerTable.tsx +0 -1
- package/src/components/Table/STRUCTURE.md +6 -12
- package/src/components/Table/Table.tsx +2 -9
- package/src/components/Table/hooks/useTableInstance.tsx +0 -3
- package/src/components/Table/styles.module.scss +3 -2
- package/src/components/types.ts +3 -6
- package/src/helperComponents/Cells/RowActionsCell/components/RowActionsButton.tsx +3 -1
- package/src/helperComponents/Cells/RowActionsCell/styles.module.scss +0 -2
- package/src/helperComponents/Cells/TreeCell/TreeLine/styles.module.scss +0 -3
- package/src/helperComponents/TableEmptyState/{hooks.tsx → hooks.ts} +1 -7
- package/src/helperComponents/TablePagination/TablePagination.tsx +10 -80
- package/src/helperComponents/TablePagination/styles.module.scss +0 -9
- package/src/hooks/useCellSizes.ts +3 -5
- package/src/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.tsx +0 -1
- package/src/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.tsx +0 -2
- package/src/locale/index.ts +4 -14
- package/src/presets/adminTable/AdminTable.tsx +14 -0
- package/src/presets/adminTable/index.ts +4 -0
- package/src/presets/adminTable/toAdminTableProps.ts +140 -0
- package/src/presets/adminTable/useAdminTableProps.ts +35 -0
- package/src/presets/index.ts +3 -0
- package/src/presets/serverAdminTable/ServerAdminTable.tsx +14 -0
- package/src/presets/serverAdminTable/index.ts +4 -0
- package/src/presets/serverAdminTable/toServerAdminTableProps.ts +44 -0
- package/src/presets/serverAdminTable/useServerAdminTableProps.ts +35 -0
- package/src/presets/serverSimpleTable/ServerSimpleTable.tsx +10 -0
- package/src/presets/serverSimpleTable/index.ts +4 -0
- package/src/presets/serverSimpleTable/toServerSimpleTableProps.ts +56 -0
- package/src/presets/serverSimpleTable/useServerSimpleTableProps.ts +27 -0
- package/src/presets/simpleTable/SimpleTable.tsx +1 -1
- package/src/presets/simpleTable/toSimpleTableProps.ts +30 -35
- package/src/presets/simpleTable/useSimpleTableProps.ts +5 -1
- package/src/presets/treeTable/toTreeTableProps.ts +23 -24
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,10 @@
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
|
|
5
5
|
|
|
6
|
+
## 2.2.12 (2026-11-18)
|
|
7
|
+
|
|
8
|
+
**Note:** Version bump only for package @ds/table
|
|
9
|
+
|
|
6
10
|
## 2.2.11 (2026-11-17)
|
|
7
11
|
|
|
8
12
|
**Note:** Version bump only for package @ds/table
|
package/README.md
CHANGED
|
@@ -32,6 +32,7 @@ flowchart TB
|
|
|
32
32
|
|
|
33
33
|
subgraph hooks [Хуки]
|
|
34
34
|
useSimple[useSimpleTableProps]
|
|
35
|
+
useAdmin[useAdminTableProps]
|
|
35
36
|
useTree[useTreeTableProps]
|
|
36
37
|
useInfinite[useInfiniteTableProps]
|
|
37
38
|
useEntities[useEntitiesTableProps]
|
|
@@ -39,6 +40,9 @@ flowchart TB
|
|
|
39
40
|
|
|
40
41
|
subgraph presets [Preset-компоненты]
|
|
41
42
|
SimpleTable
|
|
43
|
+
ServerSimpleTable
|
|
44
|
+
AdminTable
|
|
45
|
+
ServerAdminTable
|
|
42
46
|
EntitiesTable
|
|
43
47
|
TreeTable
|
|
44
48
|
InfiniteTable
|
|
@@ -52,17 +56,21 @@ flowchart TB
|
|
|
52
56
|
|
|
53
57
|
public -.->|columnDefinitions| Table
|
|
54
58
|
useSimple --> SimpleTable
|
|
59
|
+
useAdmin --> AdminTable
|
|
55
60
|
useTree --> TreeTable
|
|
56
61
|
useInfinite --> InfiniteTable
|
|
57
62
|
useEntities --> EntitiesTable
|
|
58
63
|
SimpleTable --> Table
|
|
64
|
+
ServerSimpleTable --> ServerTable
|
|
65
|
+
AdminTable --> Table
|
|
66
|
+
ServerAdminTable --> ServerTable
|
|
59
67
|
EntitiesTable --> ServerTable
|
|
60
68
|
TreeTable --> Table
|
|
61
69
|
InfiniteTable --> Table
|
|
62
70
|
ServerTable --> Table
|
|
63
71
|
```
|
|
64
72
|
|
|
65
|
-
`defineColumns`, `statusColumn` и `actionsColumn` — публичные утилиты: ими собирают `columnDefinitions` для **`Table`** напрямую. Preset-ы дают тот же результат через упрощённые
|
|
73
|
+
`defineColumns`, `statusColumn` и `actionsColumn` — публичные утилиты: ими собирают `columnDefinitions` для **`Table`** напрямую. Preset-ы дают тот же результат через упрощённые пропсы (`columns`, `statusColumn`, `rowActions` в `AdminTable`).
|
|
66
74
|
|
|
67
75
|
`ServerTable` — обёртка над `Table` для серверной пагинации, сортировки и фильтрации.
|
|
68
76
|
|
|
@@ -104,6 +112,8 @@ flowchart TB
|
|
|
104
112
|
- используйте **`ServerTable`**.
|
|
105
113
|
- Простой справочник без поиска и фильтров:
|
|
106
114
|
- **`SimpleTable`** вместо ручной сборки `columnDefinitions`.
|
|
115
|
+
- Типичный админ-экран (поиск, статус, выбор, действия):
|
|
116
|
+
- **`AdminTable`** вместо полного `Table`.
|
|
107
117
|
- Простой список без колонок и сортировки:
|
|
108
118
|
- используйте список или карточки.
|
|
109
119
|
|
|
@@ -943,7 +953,7 @@ export function FullWidth() {
|
|
|
943
953
|
| `infiniteLoading` | `boolean` | `false` | Режим работы "бесконечной" загрузки |
|
|
944
954
|
| `keepPinnedRows` | `boolean` | `false` | Параметр отвечает за отображение закрепленных строк на всех страницах таблицы |
|
|
945
955
|
| `layoutPresets` | `LayoutPresets` \| `TableLayoutDefaults` | — | Override дефолтов адаптива для этого инстанса (`mergePresets` поверх `TABLE_LAYOUT_PRESETS`). <br/> `stickyControls` в пресете tier'а заменяет DS-объект целиком — указывайте все нужные поля. <br/> Escape-hatch: обычно не нужен — DS-пресет применяется автоматически по `AdaptiveProvider`. |
|
|
946
|
-
| `loadMoreTrigger` | `"button"` \| `"scroll"` | `scroll` | Механизм подгрузки следующей порции данных. <br/> - `'scroll'` (по умолчанию) — IntersectionObserver на scroll-stub в конце списка. <br/> - `'button'` — кнопка
|
|
956
|
+
| `loadMoreTrigger` | `"button"` \| `"scroll"` | `scroll` | Механизм подгрузки следующей порции данных. <br/> - `'scroll'` (по умолчанию) — IntersectionObserver на scroll-stub в конце списка. <br/> - `'button'` — кнопка «Загрузить ещё» под таблицей. |
|
|
947
957
|
| `loading` | `boolean` | `false` | Состояние загрузки |
|
|
948
958
|
| `manualFiltering` | `boolean` | `false` | |
|
|
949
959
|
| `manualPagination` | `boolean` | `false` | |
|
|
@@ -952,7 +962,7 @@ export function FullWidth() {
|
|
|
952
962
|
| `noDataState` | `EmptyStateProps` | — | Экран при отсутствии данных |
|
|
953
963
|
| `noResultsState` | `EmptyStateProps` | — | Экран при отсутствии результатов поиска или фильтров |
|
|
954
964
|
| `onExport` | `(() => void)` | — | Колбэк экспорта данных. Рендерит иконку в тулбаре перед настройками колонок. |
|
|
955
|
-
| `onLoadMore` | `(() => void)` | — | Колбэк дозагрузки следующей порции данных. <br/> В режиме `loadMoreTrigger='scroll'` вызывается автоматически при достижении конца списка; <br/> в режиме `loadMoreTrigger='button'` — по нажатию кнопки
|
|
965
|
+
| `onLoadMore` | `(() => void)` | — | Колбэк дозагрузки следующей порции данных. <br/> В режиме `loadMoreTrigger='scroll'` вызывается автоматически при достижении конца списка; <br/> в режиме `loadMoreTrigger='button'` — по нажатию кнопки «Загрузить ещё». |
|
|
956
966
|
| `onRefresh` | `(() => void)` | — | Колбэк обновления данных |
|
|
957
967
|
| `onRowClick` | `RowClickHandler` | — | Колбэк клика по строке |
|
|
958
968
|
| `onViewChange` | `((view: View) => void)` | — | Колбэк на смену режима отображения |
|
|
@@ -962,7 +972,6 @@ export function FullWidth() {
|
|
|
962
972
|
| `pagination` | `{ state?: PaginationState; options?: number[]; optionsLabel?: string \| undefined; onChange?(state: PaginationState): void; optionsRender?(value: string \| number, idx: number): string \| number; } \| undefined` | — | Параметры пагинации: `state`, `options`, `optionsLabel`, `onChange`, `optionsRender`. |
|
|
963
973
|
| `renderCard` | `((context: RenderCardContext<TData>) => ReactNode)` | — | Кастомный рендер карточки в `view='cards'`. Получает контекст с tanstack <br/> `row` / `table` и `defaultRender` (готовый элемент дефолтной карточки — <br/> можно обернуть). Возврат заменяет дефолтную карточку. |
|
|
964
974
|
| `rowAutoHeight` | `boolean` | — | |
|
|
965
|
-
| `rowCount` | `number` | — | Общее количество строк при внешнем управлении пагинацией. |
|
|
966
975
|
| `rowPinning` | `Pick<RowPinningState, "top">` | `{ top: [], }` | Определение, какие строки должны быть закреплены в таблице |
|
|
967
976
|
| `rowSelection` | `RowAppearance` | — | Параметры выбора строк: `initialState`, `state`, `enable`, `appearance`, `multiRow`, `onChange`. |
|
|
968
977
|
| `rowVirtualizerInstanceRef` | `RowVirtualizer` | — | Ref на инстанс row-virtualizer'а для управления прокруткой снаружи |
|
|
@@ -1047,6 +1056,7 @@ export function FullWidth() {
|
|
|
1047
1056
|
- **Обзор пакета** — архитектура, выбор компонента, preset-ы.
|
|
1048
1057
|
- **`defineColumns`** — декларативные колонки для preset-ов и escape hatch.
|
|
1049
1058
|
- **SimpleTable** — минимальный клиентский preset.
|
|
1059
|
+
- **AdminTable** — админ-экран на клиенте.
|
|
1050
1060
|
- **TreeTable** — иерархические данные.
|
|
1051
1061
|
- **InfiniteTable** — бесконечная прокрутка.
|
|
1052
1062
|
- **ServerTable** — постраничные данные с бэкенда.
|
|
@@ -1165,7 +1175,7 @@ localStorage и sessionStorage используют ключ `${id}_filter` и J
|
|
|
1165
1175
|
|
|
1166
1176
|
`ServerTable` — обёртка над **`Table`** для постраничных данных с бэкенда. Страница данных приходит снаружи (`items` / `total` / `limit` / `offset`), смена страницы, поиск и сортировка делегируются серверу: компонент вызывает `onChangePage`, `search.onChange` и `sorting.onChange`, а отрисовывает то, что передано в пропсах.
|
|
1167
1177
|
|
|
1168
|
-
|
|
1178
|
+
Для типовых серверных сценариев есть preset-ы `ServerSimpleTable` и `ServerAdminTable` (см. **обзор пакета**) — они маппят упрощённый API в `ServerTable`, как `SimpleTable` / `AdminTable` маппят в `Table`.
|
|
1169
1179
|
|
|
1170
1180
|
### Когда использовать
|
|
1171
1181
|
|
|
@@ -1176,11 +1186,12 @@ localStorage и sessionStorage используют ключ `${id}_filter` и J
|
|
|
1176
1186
|
Когда **не** нужен:
|
|
1177
1187
|
|
|
1178
1188
|
- Данные загружены на клиент целиком:
|
|
1179
|
-
- используйте **`Table`**
|
|
1189
|
+
- используйте **`Table`** или **`SimpleTable`** — пагинация, поиск и сортировка работают локально.
|
|
1180
1190
|
|
|
1181
1191
|
Рекомендации по выбору API:
|
|
1182
1192
|
|
|
1183
|
-
-
|
|
1193
|
+
- Простой серверный список (колонки + пагинация) — `ServerSimpleTable`.
|
|
1194
|
+
- Админ-экран с поиском, статусом, выбором и действиями — `ServerAdminTable`.
|
|
1184
1195
|
- Нестандартные колонки, фильтры или поведение тулбара — `ServerTable` напрямую.
|
|
1185
1196
|
|
|
1186
1197
|
### Анатомия
|
|
@@ -1506,15 +1517,16 @@ export function ServerDriven() {
|
|
|
1506
1517
|
|
|
1507
1518
|
### Смотри также
|
|
1508
1519
|
|
|
1509
|
-
- **Обзор пакета** — выбор компонента.
|
|
1520
|
+
- **Обзор пакета** — `ServerSimpleTable`, `ServerAdminTable` и выбор компонента.
|
|
1510
1521
|
- **Table** — клиентская таблица для данных, загруженных целиком.
|
|
1511
|
-
- **SimpleTable** —
|
|
1522
|
+
- **SimpleTable** — клиентский аналог `ServerSimpleTable`.
|
|
1523
|
+
- **AdminTable** — клиентский аналог `ServerAdminTable`.
|
|
1512
1524
|
|
|
1513
1525
|
## SimpleTable
|
|
1514
1526
|
|
|
1515
|
-
Минимальная клиентская таблица:
|
|
1527
|
+
Минимальная клиентская таблица: данные, колонки и пагинация с предустановленными дефолтами.
|
|
1516
1528
|
|
|
1517
|
-
`SimpleTable` — preset-обёртка над **`Table`** для простых списков: декларативные колонки через `defineColumns`, `outline`
|
|
1529
|
+
`SimpleTable` — preset-обёртка над **`Table`** для простых списков: декларативные колонки через `defineColumns`, пагинация и `outline` включены по умолчанию.
|
|
1518
1530
|
|
|
1519
1531
|
### Когда использовать
|
|
1520
1532
|
|
|
@@ -1524,8 +1536,8 @@ export function ServerDriven() {
|
|
|
1524
1536
|
|
|
1525
1537
|
Когда **не** нужен:
|
|
1526
1538
|
|
|
1527
|
-
- Поиск, фильтры, выбор строк — используйте `
|
|
1528
|
-
- Данные с бэкенда постранично — `ServerTable`.
|
|
1539
|
+
- Поиск, фильтры, выбор строк — используйте `AdminTable`.
|
|
1540
|
+
- Данные с бэкенда постранично — `ServerSimpleTable` или `ServerTable`.
|
|
1529
1541
|
|
|
1530
1542
|
### Примеры использования
|
|
1531
1543
|
|
|
@@ -1560,7 +1572,7 @@ const columns: SimpleColumnDef<User>[] = [
|
|
|
1560
1572
|
];
|
|
1561
1573
|
|
|
1562
1574
|
export function SimpleTableBasic() {
|
|
1563
|
-
return <SimpleTable data={USERS} columns={columns} getRowId={user => user.id} outline />;
|
|
1575
|
+
return <SimpleTable data={USERS} columns={columns} pageSize={5} getRowId={user => user.id} outline />;
|
|
1564
1576
|
}
|
|
1565
1577
|
```
|
|
1566
1578
|
|
|
@@ -1593,6 +1605,7 @@ export function SimpleTableWithHook() {
|
|
|
1593
1605
|
const tableProps = useSimpleTableProps({
|
|
1594
1606
|
data: USERS,
|
|
1595
1607
|
columns,
|
|
1608
|
+
pageSize: 5,
|
|
1596
1609
|
getRowId: user => user.id,
|
|
1597
1610
|
outline: true,
|
|
1598
1611
|
});
|
|
@@ -1601,21 +1614,278 @@ export function SimpleTableWithHook() {
|
|
|
1601
1614
|
}
|
|
1602
1615
|
```
|
|
1603
1616
|
|
|
1604
|
-
|
|
1617
|
+
#### Карточный режим
|
|
1605
1618
|
|
|
1606
|
-
|
|
1607
|
-
|
|
1608
|
-
|
|
1609
|
-
|
|
1619
|
+
```tsx
|
|
1620
|
+
import { SimpleColumnDef, SimpleTable, VIEW } from '@cloud-ru/ds-table';
|
|
1621
|
+
import { useState } from 'react';
|
|
1622
|
+
|
|
1623
|
+
type User = {
|
|
1624
|
+
id: string;
|
|
1625
|
+
name: string;
|
|
1626
|
+
email: string;
|
|
1627
|
+
role: string;
|
|
1628
|
+
};
|
|
1629
|
+
|
|
1630
|
+
const USERS: User[] = [
|
|
1631
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner' },
|
|
1632
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin' },
|
|
1633
|
+
{ id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor' },
|
|
1634
|
+
];
|
|
1635
|
+
|
|
1636
|
+
const columns: SimpleColumnDef<User>[] = [
|
|
1637
|
+
{ key: 'name', header: 'Имя', sortable: true, width: 200 },
|
|
1638
|
+
{ key: 'email', header: 'Email', width: 240 },
|
|
1639
|
+
{ key: 'role', header: 'Роль', width: 140 },
|
|
1640
|
+
];
|
|
1641
|
+
|
|
1642
|
+
export function SimpleTableCardView() {
|
|
1643
|
+
const [view, setView] = useState<typeof VIEW.Table | typeof VIEW.Cards>(VIEW.Cards);
|
|
1644
|
+
|
|
1645
|
+
return (
|
|
1646
|
+
<SimpleTable
|
|
1647
|
+
data={USERS}
|
|
1648
|
+
columns={columns}
|
|
1649
|
+
pageSize={5}
|
|
1650
|
+
getRowId={user => user.id}
|
|
1651
|
+
headlineKey='name'
|
|
1652
|
+
view={view}
|
|
1653
|
+
onViewChange={setView}
|
|
1654
|
+
outline
|
|
1655
|
+
/>
|
|
1656
|
+
);
|
|
1657
|
+
}
|
|
1658
|
+
```
|
|
1659
|
+
|
|
1660
|
+
## AdminTable
|
|
1661
|
+
|
|
1662
|
+
Админ-таблица: поиск, статус, выбор строк и действия с предустановленными дефолтами.
|
|
1663
|
+
|
|
1664
|
+
`AdminTable` — preset над **`Table`** для типичных админ-экранов: поиск, колонка статуса, настройки колонок, опционально фильтры, выбор строк и действия.
|
|
1665
|
+
|
|
1666
|
+
### Когда использовать
|
|
1667
|
+
|
|
1668
|
+
- Списки сущностей с поиском и статусом на клиенте.
|
|
1669
|
+
- Нужен упрощённый API вместо сборки `columnDefinitions` + toolbar-пропсов вручную.
|
|
1670
|
+
|
|
1671
|
+
Когда **не** нужен:
|
|
1672
|
+
|
|
1673
|
+
- Данные с бэкенда постранично — `ServerAdminTable`.
|
|
1674
|
+
- Простой справочник без поиска — `SimpleTable`.
|
|
1675
|
+
|
|
1676
|
+
### Примеры использования
|
|
1677
|
+
|
|
1678
|
+
#### Базовое использование
|
|
1679
|
+
|
|
1680
|
+
```tsx
|
|
1681
|
+
import { AdminTable, SimpleColumnDef, STATUS_APPEARANCE } from '@cloud-ru/ds-table';
|
|
1682
|
+
|
|
1683
|
+
type User = {
|
|
1684
|
+
id: string;
|
|
1685
|
+
name: string;
|
|
1686
|
+
email: string;
|
|
1687
|
+
role: string;
|
|
1688
|
+
status: string;
|
|
1689
|
+
amount: number;
|
|
1690
|
+
};
|
|
1691
|
+
|
|
1692
|
+
const USERS: User[] = [
|
|
1693
|
+
{
|
|
1694
|
+
id: 'u-1',
|
|
1695
|
+
name: 'Анна Иванова',
|
|
1696
|
+
email: 'anna.ivanova@example.com',
|
|
1697
|
+
role: 'Owner',
|
|
1698
|
+
status: 'active',
|
|
1699
|
+
amount: 12990,
|
|
1700
|
+
},
|
|
1701
|
+
{
|
|
1702
|
+
id: 'u-2',
|
|
1703
|
+
name: 'Борис Петров',
|
|
1704
|
+
email: 'boris.petrov@example.com',
|
|
1705
|
+
role: 'Admin',
|
|
1706
|
+
status: 'pending',
|
|
1707
|
+
amount: 8450,
|
|
1708
|
+
},
|
|
1709
|
+
{
|
|
1710
|
+
id: 'u-3',
|
|
1711
|
+
name: 'Вера Сидорова',
|
|
1712
|
+
email: 'vera.sidorova@example.com',
|
|
1713
|
+
role: 'Editor',
|
|
1714
|
+
status: 'blocked',
|
|
1715
|
+
amount: 4300,
|
|
1716
|
+
},
|
|
1717
|
+
{
|
|
1718
|
+
id: 'u-4',
|
|
1719
|
+
name: 'Глеб Кузнецов',
|
|
1720
|
+
email: 'gleb.kuznetsov@example.com',
|
|
1721
|
+
role: 'Viewer',
|
|
1722
|
+
status: 'invited',
|
|
1723
|
+
amount: 0,
|
|
1724
|
+
},
|
|
1725
|
+
{ id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', status: 'active', amount: 990 },
|
|
1726
|
+
];
|
|
1727
|
+
|
|
1728
|
+
const columns: SimpleColumnDef<User>[] = [
|
|
1729
|
+
{ key: 'name', header: 'Имя', sortable: true, width: 200 },
|
|
1730
|
+
{ key: 'email', header: 'Email', width: 240 },
|
|
1731
|
+
{ key: 'role', header: 'Роль', sortable: true, width: 140 },
|
|
1732
|
+
{ key: 'amount', header: 'Сумма', sortable: true, align: 'right', width: 140, format: 'currency' },
|
|
1733
|
+
];
|
|
1734
|
+
|
|
1735
|
+
const statusLabels: Record<string, string> = {
|
|
1736
|
+
active: 'Активен',
|
|
1737
|
+
pending: 'Ожидание',
|
|
1738
|
+
blocked: 'Заблокирован',
|
|
1739
|
+
invited: 'Приглашён',
|
|
1740
|
+
};
|
|
1741
|
+
|
|
1742
|
+
export function AdminTableBasic() {
|
|
1743
|
+
return (
|
|
1744
|
+
<AdminTable
|
|
1745
|
+
data={USERS}
|
|
1746
|
+
columns={columns}
|
|
1747
|
+
statusColumn={{
|
|
1748
|
+
key: 'status',
|
|
1749
|
+
mapStatusToAppearance: value => {
|
|
1750
|
+
switch (value) {
|
|
1751
|
+
case 'active':
|
|
1752
|
+
return STATUS_APPEARANCE.Green;
|
|
1753
|
+
case 'pending':
|
|
1754
|
+
return STATUS_APPEARANCE.Yellow;
|
|
1755
|
+
case 'blocked':
|
|
1756
|
+
return STATUS_APPEARANCE.Red;
|
|
1757
|
+
case 'invited':
|
|
1758
|
+
return STATUS_APPEARANCE.Blue;
|
|
1759
|
+
default:
|
|
1760
|
+
return STATUS_APPEARANCE.Neutral;
|
|
1761
|
+
}
|
|
1762
|
+
},
|
|
1763
|
+
renderDescription: status => statusLabels[status] ?? status,
|
|
1764
|
+
}}
|
|
1765
|
+
pageSize={5}
|
|
1766
|
+
getRowId={user => user.id}
|
|
1767
|
+
search
|
|
1768
|
+
outline
|
|
1769
|
+
/>
|
|
1770
|
+
);
|
|
1771
|
+
}
|
|
1772
|
+
```
|
|
1773
|
+
|
|
1774
|
+
#### Через хук useAdminTableProps
|
|
1775
|
+
|
|
1776
|
+
```tsx
|
|
1777
|
+
import { SimpleColumnDef, STATUS_APPEARANCE, Table, useAdminTableProps } from '@cloud-ru/ds-table';
|
|
1778
|
+
|
|
1779
|
+
type User = {
|
|
1780
|
+
id: string;
|
|
1781
|
+
name: string;
|
|
1782
|
+
email: string;
|
|
1783
|
+
role: string;
|
|
1784
|
+
status: string;
|
|
1785
|
+
amount: number;
|
|
1786
|
+
};
|
|
1787
|
+
|
|
1788
|
+
const USERS: User[] = [
|
|
1789
|
+
{
|
|
1790
|
+
id: 'u-1',
|
|
1791
|
+
name: 'Анна Иванова',
|
|
1792
|
+
email: 'anna.ivanova@example.com',
|
|
1793
|
+
role: 'Owner',
|
|
1794
|
+
status: 'active',
|
|
1795
|
+
amount: 12990,
|
|
1796
|
+
},
|
|
1797
|
+
{
|
|
1798
|
+
id: 'u-2',
|
|
1799
|
+
name: 'Борис Петров',
|
|
1800
|
+
email: 'boris.petrov@example.com',
|
|
1801
|
+
role: 'Admin',
|
|
1802
|
+
status: 'pending',
|
|
1803
|
+
amount: 8450,
|
|
1804
|
+
},
|
|
1805
|
+
{
|
|
1806
|
+
id: 'u-3',
|
|
1807
|
+
name: 'Вера Сидорова',
|
|
1808
|
+
email: 'vera.sidorova@example.com',
|
|
1809
|
+
role: 'Editor',
|
|
1810
|
+
status: 'blocked',
|
|
1811
|
+
amount: 4300,
|
|
1812
|
+
},
|
|
1813
|
+
];
|
|
1814
|
+
|
|
1815
|
+
const columns: SimpleColumnDef<User>[] = [
|
|
1816
|
+
{ key: 'name', header: 'Имя', sortable: true, width: 200 },
|
|
1817
|
+
{ key: 'email', header: 'Email', width: 240 },
|
|
1818
|
+
{ key: 'role', header: 'Роль', sortable: true, width: 140 },
|
|
1819
|
+
];
|
|
1820
|
+
|
|
1821
|
+
export function AdminTableWithHook() {
|
|
1822
|
+
const tableProps = useAdminTableProps({
|
|
1823
|
+
data: USERS,
|
|
1824
|
+
columns,
|
|
1825
|
+
statusColumn: {
|
|
1826
|
+
key: 'status',
|
|
1827
|
+
mapStatusToAppearance: value => (value === 'active' ? STATUS_APPEARANCE.Green : STATUS_APPEARANCE.Yellow),
|
|
1828
|
+
renderDescription: status => (status === 'active' ? 'Активен' : 'Ожидание'),
|
|
1829
|
+
},
|
|
1830
|
+
pageSize: 5,
|
|
1831
|
+
getRowId: user => user.id,
|
|
1832
|
+
search: true,
|
|
1833
|
+
});
|
|
1834
|
+
|
|
1835
|
+
return <Table {...tableProps} outline />;
|
|
1836
|
+
}
|
|
1837
|
+
```
|
|
1610
1838
|
|
|
1611
|
-
|
|
1612
|
-
|
|
1839
|
+
#### Карточный режим
|
|
1840
|
+
|
|
1841
|
+
```tsx
|
|
1842
|
+
import { AdminTable, SimpleColumnDef, VIEW } from '@cloud-ru/ds-table';
|
|
1843
|
+
import { useState } from 'react';
|
|
1844
|
+
|
|
1845
|
+
type User = {
|
|
1846
|
+
id: string;
|
|
1847
|
+
name: string;
|
|
1848
|
+
email: string;
|
|
1849
|
+
role: string;
|
|
1850
|
+
amount: number;
|
|
1851
|
+
};
|
|
1852
|
+
|
|
1853
|
+
const USERS: User[] = [
|
|
1854
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', amount: 12990 },
|
|
1855
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', amount: 8450 },
|
|
1856
|
+
{ id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', amount: 4300 },
|
|
1857
|
+
];
|
|
1858
|
+
|
|
1859
|
+
const columns: SimpleColumnDef<User>[] = [
|
|
1860
|
+
{ key: 'name', header: 'Имя', sortable: true, width: 200 },
|
|
1861
|
+
{ key: 'email', header: 'Email', width: 240 },
|
|
1862
|
+
{ key: 'role', header: 'Роль', sortable: true, width: 140 },
|
|
1863
|
+
];
|
|
1864
|
+
|
|
1865
|
+
export function AdminTableCardView() {
|
|
1866
|
+
const [view, setView] = useState<typeof VIEW.Table | typeof VIEW.Cards>(VIEW.Cards);
|
|
1867
|
+
|
|
1868
|
+
return (
|
|
1869
|
+
<AdminTable
|
|
1870
|
+
data={USERS}
|
|
1871
|
+
columns={columns}
|
|
1872
|
+
pageSize={5}
|
|
1873
|
+
getRowId={user => user.id}
|
|
1874
|
+
search
|
|
1875
|
+
headlineKey='name'
|
|
1876
|
+
view={view}
|
|
1877
|
+
onViewChange={setView}
|
|
1878
|
+
outline
|
|
1879
|
+
/>
|
|
1880
|
+
);
|
|
1881
|
+
}
|
|
1882
|
+
```
|
|
1613
1883
|
|
|
1614
1884
|
## TreeTable
|
|
1615
1885
|
|
|
1616
|
-
Иерархическая таблица:
|
|
1886
|
+
Иерархическая таблица: expanding, без пагинации, с опциональным выбором строк.
|
|
1617
1887
|
|
|
1618
|
-
`TreeTable` — preset для иерархических данных: `getChildren`, tree-колонка через `primaryColumn`,
|
|
1888
|
+
`TreeTable` — preset для иерархических данных: `getChildren`, tree-колонка через `primaryColumn`, без пагинации.
|
|
1619
1889
|
|
|
1620
1890
|
### Когда использовать
|
|
1621
1891
|
|
|
@@ -1624,7 +1894,7 @@ export function SimpleTableWithHook() {
|
|
|
1624
1894
|
|
|
1625
1895
|
Когда **не** нужен:
|
|
1626
1896
|
|
|
1627
|
-
- Плоский список — `SimpleTable`.
|
|
1897
|
+
- Плоский список — `SimpleTable` / `AdminTable`.
|
|
1628
1898
|
- Закрепление строк (`rowPinning`) — только на полном `Table`.
|
|
1629
1899
|
|
|
1630
1900
|
### Примеры использования
|
|
@@ -1921,8 +2191,44 @@ Server-driven список сущностей: state пагинации/поис
|
|
|
1921
2191
|
|
|
1922
2192
|
Когда **не** нужен:
|
|
1923
2193
|
|
|
1924
|
-
-
|
|
1925
|
-
- Клиентские данные в памяти — **`
|
|
2194
|
+
- Ручной fetch и упрощённый API (`columns`, `statusColumn`) — **`ServerAdminTable`**.
|
|
2195
|
+
- Клиентские данные в памяти — **`AdminTable`** или **`SimpleTable`**.
|
|
2196
|
+
|
|
2197
|
+
#### EntitiesTable vs ServerAdminTable
|
|
2198
|
+
|
|
2199
|
+
| | `EntitiesTable` | `ServerAdminTable` |
|
|
2200
|
+
| --- | --- | --- |
|
|
2201
|
+
| Вход колонок | `columnDefinitions` | `columns` + `statusColumn` / `rowActions` |
|
|
2202
|
+
| Данные | `queryFn` (custom hook на render) | `items` / `total` / `loading` вручную |
|
|
2203
|
+
| State пагинации | внутри (`useEntitiesTableState`) | снаружи |
|
|
2204
|
+
| `savedState` | из обязательного `id` | не задаётся preset-ом |
|
|
2205
|
+
| Drag колонок | включён по умолчанию | только меню настроек |
|
|
2206
|
+
|
|
2207
|
+
Оба preset-а валидны; выбор — по входному API и способу загрузки данных.
|
|
2208
|
+
|
|
2209
|
+
#### Переход на ServerAdminTable
|
|
2210
|
+
|
|
2211
|
+
Если экран укладывается в `columns` + `statusColumn` и вы сами управляете fetch — уберите `queryFn`, state страницы вынесите наружу, колонки упростите. `savedState` из `id` не переносится; drag — через `columnsSettings`.
|
|
2212
|
+
|
|
2213
|
+
```tsx
|
|
2214
|
+
// Было
|
|
2215
|
+
<EntitiesTable id="entities" queryFn={useEntitiesQuery} columnDefinitions={columnDefinitions} getRowId={row => row.id} />
|
|
2216
|
+
|
|
2217
|
+
// Стало: items/total/loading + offset/limit/search снаружи
|
|
2218
|
+
<ServerAdminTable
|
|
2219
|
+
items={items}
|
|
2220
|
+
total={total}
|
|
2221
|
+
offset={offset}
|
|
2222
|
+
limit={limit}
|
|
2223
|
+
loading={loading}
|
|
2224
|
+
columns={columns}
|
|
2225
|
+
statusColumn={statusColumn}
|
|
2226
|
+
getRowId={row => row.id}
|
|
2227
|
+
onChangePage={(nextOffset, nextLimit) => { setOffset(nextOffset); setLimit(nextLimit); }}
|
|
2228
|
+
search={{ state: search, onChange: value => { setOffset(0); setSearch(value); } }}
|
|
2229
|
+
columnsSettings={{ enableDrag: true, enableSettingsMenu: true }}
|
|
2230
|
+
/>
|
|
2231
|
+
```
|
|
1926
2232
|
|
|
1927
2233
|
### Примеры использования
|
|
1928
2234
|
|
|
@@ -2263,4 +2569,5 @@ export function EntitiesTableWithFilters() {
|
|
|
2263
2569
|
|
|
2264
2570
|
### Смотри также
|
|
2265
2571
|
|
|
2266
|
-
- **`
|
|
2572
|
+
- **`ServerAdminTable`** — ручной fetch и упрощённый API колонок.
|
|
2573
|
+
- **`ServerTable`** — escape hatch без product-дефолтов.
|
|
@@ -36,7 +36,7 @@ function ServerTable({ items, total = constants_1.DEFAULT_PAGINATION_LIMIT, limi
|
|
|
36
36
|
onChange: handleSearch,
|
|
37
37
|
loading: searchProp?.loading,
|
|
38
38
|
placeholder: searchProp?.placeholder,
|
|
39
|
-
}, columnFilters: columnFilters, pageCount: pageCount,
|
|
39
|
+
}, columnFilters: columnFilters, pageCount: pageCount, pagination: {
|
|
40
40
|
...pagination,
|
|
41
41
|
state: {
|
|
42
42
|
pageIndex,
|
|
@@ -4,7 +4,7 @@ import { TableLayoutDefaults, TableProps } from '../types';
|
|
|
4
4
|
/** DS-пресет адаптива `Table`: mobile-дефолты sticky-хрома, `fullWidth` и стартовый вид `cards`. Desktop — `BASE_TABLE_LAYOUT_DEFAULTS`. */
|
|
5
5
|
export declare const TABLE_LAYOUT_PRESETS: LayoutPresets<TableLayoutDefaults>;
|
|
6
6
|
/** Компонент таблицы */
|
|
7
|
-
export declare function Table<TData extends object, TFilters extends FiltersState = Record<string, unknown>>({ data, rowPinning, columnDefinitions, keepPinnedRows, copyPinnedRows, enableSelectPinned, rowSelection: rowSelectionProp, search, sorting: sortingProp, columnFilters, pagination: paginationProp, className, onRowClick, onRefresh, pageSize, pageCount,
|
|
7
|
+
export declare function Table<TData extends object, TFilters extends FiltersState = Record<string, unknown>>({ data, rowPinning, columnDefinitions, keepPinnedRows, copyPinnedRows, enableSelectPinned, rowSelection: rowSelectionProp, search, sorting: sortingProp, columnFilters, pagination: paginationProp, className, onRowClick, onRefresh, pageSize, pageCount, loading, infiniteLoading, onLoadMore, hasMore, loadMoreTrigger, outline, fullWidth, moreActions, onExport, dataFiltered, dataError, noDataState, noResultsState, errorDataState, suppressToolbar, suppressHeader, suppressSearch, toolbarAfter, suppressPagination, manualSorting, manualPagination: manualPaginationProp, manualFiltering, autoResetPageIndex, scrollRef, scrollContainerRef, stickyControls: stickyControlsProp, layoutPresets, getRowId, enableFuzzySearch, savedState, expanding: expandingProp, bulkActions: bulkActionsProp, rowAutoHeight, columnsSettings: columnsSettingsProp, getRowBackgroundColor, headerRowBackgroundColor, toolbarCheckBoxMode, view: viewProp, defaultView: defaultViewProp, onViewChange, showDataView, headlineId, cardColumns, cardMinWidth, renderCard, enableRowVirtualization, rowVirtualizerOptions, rowVirtualizerInstanceRef, enableColumnVirtualization, columnVirtualizerOptions, columnVirtualizerInstanceRef, ...rest }: TableProps<TData, TFilters>): import("react/jsx-runtime").JSX.Element;
|
|
8
8
|
export declare namespace Table {
|
|
9
9
|
var getStatusColumnDef: typeof import("../../helperComponents").getStatusColumnDef;
|
|
10
10
|
var statusAppearances: {
|
|
@@ -54,7 +54,7 @@ exports.TABLE_LAYOUT_PRESETS = {
|
|
|
54
54
|
/** Компонент таблицы */
|
|
55
55
|
function Table({ data, rowPinning = {
|
|
56
56
|
top: [],
|
|
57
|
-
}, columnDefinitions, keepPinnedRows = false, copyPinnedRows = false, enableSelectPinned = false, rowSelection: rowSelectionProp, search, sorting: sortingProp, columnFilters, pagination: paginationProp, className, onRowClick, onRefresh, pageSize = constants_1.DEFAULT_PAGE_SIZE, pageCount,
|
|
57
|
+
}, columnDefinitions, keepPinnedRows = false, copyPinnedRows = false, enableSelectPinned = false, rowSelection: rowSelectionProp, search, sorting: sortingProp, columnFilters, pagination: paginationProp, className, onRowClick, onRefresh, pageSize = constants_1.DEFAULT_PAGE_SIZE, pageCount, loading = false, infiniteLoading = false, onLoadMore, hasMore, loadMoreTrigger = 'scroll', outline = false, fullWidth, moreActions, onExport, dataFiltered, dataError, noDataState, noResultsState, errorDataState, suppressToolbar = false, suppressHeader = false, suppressSearch = false, toolbarAfter, suppressPagination = false, manualSorting = false, manualPagination: manualPaginationProp = false, manualFiltering = false, autoResetPageIndex = false, scrollRef, scrollContainerRef, stickyControls: stickyControlsProp, layoutPresets, getRowId, enableFuzzySearch, savedState, expanding: expandingProp, bulkActions: bulkActionsProp, rowAutoHeight, columnsSettings: columnsSettingsProp, getRowBackgroundColor, headerRowBackgroundColor, toolbarCheckBoxMode, view: viewProp, defaultView: defaultViewProp, onViewChange, showDataView = false, headlineId, cardColumns, cardMinWidth, renderCard, enableRowVirtualization = false, rowVirtualizerOptions, rowVirtualizerInstanceRef, enableColumnVirtualization = false, columnVirtualizerOptions, columnVirtualizerInstanceRef, ...rest }) {
|
|
58
58
|
const { layoutType } = (0, adaptive_1.useAdaptiveLayout)();
|
|
59
59
|
const isMobile = (0, adaptive_1.isMobileLayout)(layoutType);
|
|
60
60
|
const expanding = (0, react_1.useMemo)(() => expandingProp && {
|
|
@@ -138,7 +138,6 @@ function Table({ data, rowPinning = {
|
|
|
138
138
|
pagination,
|
|
139
139
|
onPaginationChange,
|
|
140
140
|
pageCount,
|
|
141
|
-
rowCount,
|
|
142
141
|
pageSize,
|
|
143
142
|
manualSorting,
|
|
144
143
|
manualPagination,
|
|
@@ -178,12 +177,7 @@ function Table({ data, rowPinning = {
|
|
|
178
177
|
isLoadingState,
|
|
179
178
|
savedState,
|
|
180
179
|
});
|
|
181
|
-
const emptyStates = (0, helperComponents_1.useEmptyState)({
|
|
182
|
-
noDataState,
|
|
183
|
-
noResultsState,
|
|
184
|
-
errorDataState,
|
|
185
|
-
onRefresh: onRefresh ? handleOnRefresh : undefined,
|
|
186
|
-
});
|
|
180
|
+
const emptyStates = (0, helperComponents_1.useEmptyState)({ noDataState, noResultsState, errorDataState });
|
|
187
181
|
(0, hooks_1.usePageReset)({
|
|
188
182
|
manualPagination,
|
|
189
183
|
maximumAvailablePage: pageCount || tableFilteredRows.length / pagination.pageSize,
|
|
@@ -348,7 +342,7 @@ function Table({ data, rowPinning = {
|
|
|
348
342
|
paginationChrome =
|
|
349
343
|
isStickyControls && controlsAcrylic ? ((0, jsx_runtime_1.jsx)(TableChrome_1.TableChrome, { variant: 'footer', acrylic: controlsAcrylic, children: pagination })) : (pagination);
|
|
350
344
|
}
|
|
351
|
-
return ((0, jsx_runtime_1.jsx)("div", { ref: wrapperRef, className: (0, classnames_1.default)(styles_module_scss_1.default.wrapper, className), "data-view": view, "data-layout-type": layoutType, "data-sticky-controls": isStickyControls || undefined, "data-with-toolbar": showToolbar || undefined, "data-empty-body": isEmptyBody || undefined, "data-fit-content": !resolvedFullWidth || undefined, ...(0, utils_1.extractSupportProps)(rest), children: (0, jsx_runtime_1.jsxs)(contexts_1.TableContext.Provider, { value: tableContextValue, children: [toolbarChrome, (0, jsx_runtime_1.jsxs)("div", { className: styles_module_scss_1.default.tableView, children: [(0, jsx_runtime_1.jsxs)("div", { className: styles_module_scss_1.default.content, "data-outline": !isCardsView && outline ? true : undefined, "data-page-sticky-header": !isCardsView && usePageStickyHeader ? true : undefined, ...(!isCardsView ? TABLE_CONTENT_ACRYLIC : {}), children: [!isCardsView ? (0, jsx_runtime_1.jsx)("span", { className: styles_module_scss_1.default.contentAcrylic, "data-acrylic-background": true, "aria-hidden": true }) : null, hasMobileToolbarMounts ? ((0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.mobileToolbarMounts, children: columnsSettingsToolbarSlot.mobileMount })) : null, (0, jsx_runtime_1.jsxs)(core_1.DndContext, { ...dndContextProps, children: [draggingColumnPreview, (0, jsx_runtime_1.
|
|
345
|
+
return ((0, jsx_runtime_1.jsx)("div", { ref: wrapperRef, className: (0, classnames_1.default)(styles_module_scss_1.default.wrapper, className), "data-view": view, "data-layout-type": layoutType, "data-sticky-controls": isStickyControls || undefined, "data-with-toolbar": showToolbar || undefined, "data-empty-body": isEmptyBody || undefined, "data-fit-content": !resolvedFullWidth || undefined, ...(0, utils_1.extractSupportProps)(rest), children: (0, jsx_runtime_1.jsxs)(contexts_1.TableContext.Provider, { value: tableContextValue, children: [toolbarChrome, (0, jsx_runtime_1.jsxs)("div", { className: styles_module_scss_1.default.tableView, children: [(0, jsx_runtime_1.jsxs)("div", { className: styles_module_scss_1.default.content, "data-outline": !isCardsView && outline ? true : undefined, "data-page-sticky-header": !isCardsView && usePageStickyHeader ? true : undefined, ...(!isCardsView ? TABLE_CONTENT_ACRYLIC : {}), children: [!isCardsView ? (0, jsx_runtime_1.jsx)("span", { className: styles_module_scss_1.default.contentAcrylic, "data-acrylic-background": true, "aria-hidden": true }) : null, hasMobileToolbarMounts ? ((0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.mobileToolbarMounts, children: columnsSettingsToolbarSlot.mobileMount })) : null, (0, jsx_runtime_1.jsxs)(core_1.DndContext, { ...dndContextProps, children: [draggingColumnPreview, (0, jsx_runtime_1.jsx)(TableScrollHost_1.TableScrollHost, { view: view, isMobile: isMobile, isCardsView: isCardsView, usePageStickyHeader: usePageStickyHeader, scrollOverflow: scrollOverflow, scrollPaddingAbsolute: scrollPaddingAbsolute, internalScrollRef: internalScrollRef, scrollRef: scrollRef, scrollContainerRef: scrollContainerRef, handleScrollInitialized: handleScrollInitialized, syncHeaderHorizontalScroll: syncHeaderHorizontalScroll, tableHeaderElement: tableHeaderElement, columnSizeVars: columnSizes.vars, children: scrollContent })] }), loadMoreButtonNode, !isCardsView && outline ? (0, jsx_runtime_1.jsx)("span", { className: styles_module_scss_1.default.contentBorder, "aria-hidden": true }) : null] }), paginationChrome] })] }) }));
|
|
352
346
|
}
|
|
353
347
|
Table.getStatusColumnDef = helperComponents_1.getStatusColumnDef;
|
|
354
348
|
Table.statusAppearances = helperComponents_1.STATUS_APPEARANCE;
|
|
@@ -20,7 +20,6 @@ type UseTableInstanceParams<TData extends object> = {
|
|
|
20
20
|
pagination: PaginationState;
|
|
21
21
|
onPaginationChange: OnChangeFn<PaginationState>;
|
|
22
22
|
pageCount?: number;
|
|
23
|
-
rowCount?: number;
|
|
24
23
|
pageSize: number;
|
|
25
24
|
manualSorting: boolean;
|
|
26
25
|
manualPagination: boolean;
|
|
@@ -42,7 +41,7 @@ type UseTableInstanceParams<TData extends object> = {
|
|
|
42
41
|
onRefresh?: () => void;
|
|
43
42
|
bulkActionsProp?: TableProps<TData>['bulkActions'];
|
|
44
43
|
};
|
|
45
|
-
export declare function useTableInstance<TData extends object>({ data, rowPinning, keepPinnedRows, enableSelectPinned, rowSelectionProp, globalFilter, onGlobalFilterChange, rowSelection, onRowSelectionChange, sorting, onSortingChange, expanded, onExpandedChange, pagination, onPaginationChange, pageCount,
|
|
44
|
+
export declare function useTableInstance<TData extends object>({ data, rowPinning, keepPinnedRows, enableSelectPinned, rowSelectionProp, globalFilter, onGlobalFilterChange, rowSelection, onRowSelectionChange, sorting, onSortingChange, expanded, onExpandedChange, pagination, onPaginationChange, pageCount, pageSize, manualSorting, manualPagination, manualFiltering, autoResetPageIndex, getRowId, enableFuzzySearch, expanding, rowAutoHeight, enabledTableColumns, enabledColumnsDefinitions, columnPinning, columnOrder, enableColumnsOrderSortByDrag, setColumnOrder, masterSelection, infiniteLoading, loading, onRefresh, bulkActionsProp, }: UseTableInstanceParams<TData>): {
|
|
46
45
|
table: import("@tanstack/react-table").Table<TData>;
|
|
47
46
|
loadingTable: import("@tanstack/react-table").Table<TData>;
|
|
48
47
|
enableSelection: boolean;
|
|
@@ -12,7 +12,7 @@ const helpers_1 = require("../../../helpers");
|
|
|
12
12
|
const utils_1 = require("../../../utils");
|
|
13
13
|
const utils_2 = require("../utils");
|
|
14
14
|
const useLoadingTable_1 = require("./useLoadingTable");
|
|
15
|
-
function useTableInstance({ data, rowPinning, keepPinnedRows, enableSelectPinned, rowSelectionProp, globalFilter, onGlobalFilterChange, rowSelection, onRowSelectionChange, sorting, onSortingChange, expanded, onExpandedChange, pagination, onPaginationChange, pageCount,
|
|
15
|
+
function useTableInstance({ data, rowPinning, keepPinnedRows, enableSelectPinned, rowSelectionProp, globalFilter, onGlobalFilterChange, rowSelection, onRowSelectionChange, sorting, onSortingChange, expanded, onExpandedChange, pagination, onPaginationChange, pageCount, pageSize, manualSorting, manualPagination, manualFiltering, autoResetPageIndex, getRowId, enableFuzzySearch, expanding, rowAutoHeight, enabledTableColumns, enabledColumnsDefinitions, columnPinning, columnOrder, enableColumnsOrderSortByDrag, setColumnOrder, masterSelection, infiniteLoading, loading, onRefresh, bulkActionsProp, }) {
|
|
16
16
|
const enableSelection = Boolean(rowSelectionProp?.enable);
|
|
17
17
|
const enableRowSelection = (0, react_1.useCallback)((row) => {
|
|
18
18
|
const parent = row.getParentRow();
|
|
@@ -38,7 +38,6 @@ function useTableInstance({ data, rowPinning, keepPinnedRows, enableSelectPinned
|
|
|
38
38
|
expanded,
|
|
39
39
|
},
|
|
40
40
|
pageCount,
|
|
41
|
-
rowCount,
|
|
42
41
|
defaultColumn: {
|
|
43
42
|
enableSorting: false,
|
|
44
43
|
enableResizing: false,
|