@cloud-ru/ds-table 2.2.12 → 2.2.13-preview-15dc0d59.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/README.md +27 -334
- 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 +9 -3
- package/dist/cjs/components/Table/hooks/useTableInstance.d.ts +2 -1
- package/dist/cjs/components/Table/hooks/useTableInstance.js +2 -1
- package/dist/cjs/components/Table/styles.module.css +1 -0
- package/dist/cjs/components/types.d.ts +6 -3
- package/dist/cjs/helperComponents/Cells/RowActionsCell/components/RowActionsButton.js +1 -4
- package/dist/cjs/helperComponents/Cells/RowActionsCell/styles.module.css +2 -0
- package/dist/cjs/helperComponents/Cells/TreeCell/TreeLine/styles.module.css +1 -0
- package/dist/cjs/helperComponents/TableEmptyState/hooks.d.ts +2 -1
- package/dist/cjs/helperComponents/TableEmptyState/hooks.js +5 -2
- package/dist/cjs/helperComponents/TablePagination/TablePagination.js +31 -7
- package/dist/cjs/helperComponents/TablePagination/styles.module.css +8 -0
- package/dist/cjs/hooks/useCellSizes.js +4 -2
- package/dist/cjs/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.js +1 -0
- package/dist/cjs/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.js +1 -1
- package/dist/cjs/locale/index.d.ts +28 -8
- package/dist/cjs/locale/index.js +14 -4
- package/dist/cjs/presets/index.d.ts +0 -3
- package/dist/cjs/presets/index.js +0 -3
- 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 +5 -6
- package/dist/cjs/presets/simpleTable/toSimpleTableProps.js +6 -6
- package/dist/cjs/presets/simpleTable/useSimpleTableProps.js +1 -4
- package/dist/cjs/presets/treeTable/toTreeTableProps.d.ts +7 -7
- package/dist/cjs/presets/treeTable/toTreeTableProps.js +2 -3
- package/dist/cjs/style.css +12 -0
- 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 +9 -3
- package/dist/esm/components/Table/hooks/useTableInstance.d.ts +2 -1
- package/dist/esm/components/Table/hooks/useTableInstance.js +2 -1
- package/dist/esm/components/Table/styles.module.css +1 -0
- package/dist/esm/components/types.d.ts +6 -3
- package/dist/esm/helperComponents/Cells/RowActionsCell/components/RowActionsButton.js +1 -4
- package/dist/esm/helperComponents/Cells/RowActionsCell/styles.module.css +2 -0
- package/dist/esm/helperComponents/Cells/TreeCell/TreeLine/styles.module.css +1 -0
- package/dist/esm/helperComponents/TableEmptyState/hooks.d.ts +2 -1
- package/dist/esm/helperComponents/TableEmptyState/hooks.js +5 -2
- package/dist/esm/helperComponents/TablePagination/TablePagination.js +31 -7
- package/dist/esm/helperComponents/TablePagination/styles.module.css +8 -0
- package/dist/esm/hooks/useCellSizes.js +5 -3
- package/dist/esm/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.js +1 -0
- package/dist/esm/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.js +1 -1
- package/dist/esm/locale/index.d.ts +28 -8
- package/dist/esm/locale/index.js +14 -4
- package/dist/esm/presets/index.d.ts +0 -3
- package/dist/esm/presets/index.js +0 -3
- 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 +5 -6
- package/dist/esm/presets/simpleTable/toSimpleTableProps.js +7 -7
- package/dist/esm/presets/simpleTable/useSimpleTableProps.js +1 -4
- package/dist/esm/presets/treeTable/toTreeTableProps.d.ts +7 -7
- package/dist/esm/presets/treeTable/toTreeTableProps.js +3 -4
- package/dist/esm/style.css +12 -0
- 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 +1 -0
- package/src/components/Table/STRUCTURE.md +12 -6
- package/src/components/Table/Table.tsx +9 -2
- package/src/components/Table/hooks/useTableInstance.tsx +3 -0
- package/src/components/Table/styles.module.scss +2 -3
- package/src/components/types.ts +6 -3
- package/src/helperComponents/Cells/RowActionsCell/components/RowActionsButton.tsx +1 -3
- package/src/helperComponents/Cells/RowActionsCell/styles.module.scss +2 -0
- package/src/helperComponents/Cells/TreeCell/TreeLine/styles.module.scss +3 -0
- package/src/helperComponents/TableEmptyState/{hooks.ts → hooks.tsx} +7 -1
- package/src/helperComponents/TablePagination/TablePagination.tsx +80 -10
- package/src/helperComponents/TablePagination/styles.module.scss +9 -0
- package/src/hooks/useCellSizes.ts +5 -3
- package/src/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.tsx +1 -0
- package/src/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.tsx +2 -0
- package/src/locale/index.ts +14 -4
- package/src/presets/index.ts +0 -3
- package/src/presets/simpleTable/SimpleTable.tsx +1 -1
- package/src/presets/simpleTable/toSimpleTableProps.ts +35 -30
- package/src/presets/simpleTable/useSimpleTableProps.ts +1 -5
- package/src/presets/treeTable/toTreeTableProps.ts +24 -23
- package/dist/cjs/presets/adminTable/AdminTable.d.ts +0 -4
- package/dist/cjs/presets/adminTable/AdminTable.js +0 -11
- package/dist/cjs/presets/adminTable/index.d.ts +0 -4
- package/dist/cjs/presets/adminTable/index.js +0 -9
- package/dist/cjs/presets/adminTable/toAdminTableProps.d.ts +0 -31
- package/dist/cjs/presets/adminTable/toAdminTableProps.js +0 -57
- package/dist/cjs/presets/adminTable/useAdminTableProps.d.ts +0 -5
- package/dist/cjs/presets/adminTable/useAdminTableProps.js +0 -25
- package/dist/cjs/presets/serverAdminTable/ServerAdminTable.d.ts +0 -4
- package/dist/cjs/presets/serverAdminTable/ServerAdminTable.js +0 -11
- package/dist/cjs/presets/serverAdminTable/index.d.ts +0 -4
- package/dist/cjs/presets/serverAdminTable/index.js +0 -9
- package/dist/cjs/presets/serverAdminTable/toServerAdminTableProps.d.ts +0 -13
- package/dist/cjs/presets/serverAdminTable/toServerAdminTableProps.js +0 -25
- package/dist/cjs/presets/serverAdminTable/useServerAdminTableProps.d.ts +0 -5
- package/dist/cjs/presets/serverAdminTable/useServerAdminTableProps.js +0 -25
- package/dist/cjs/presets/serverSimpleTable/ServerSimpleTable.d.ts +0 -3
- package/dist/cjs/presets/serverSimpleTable/ServerSimpleTable.js +0 -11
- package/dist/cjs/presets/serverSimpleTable/index.d.ts +0 -4
- package/dist/cjs/presets/serverSimpleTable/index.js +0 -9
- package/dist/cjs/presets/serverSimpleTable/toServerSimpleTableProps.d.ts +0 -13
- package/dist/cjs/presets/serverSimpleTable/toServerSimpleTableProps.js +0 -25
- package/dist/cjs/presets/serverSimpleTable/useServerSimpleTableProps.d.ts +0 -4
- package/dist/cjs/presets/serverSimpleTable/useServerSimpleTableProps.js +0 -21
- package/dist/esm/presets/adminTable/AdminTable.d.ts +0 -4
- package/dist/esm/presets/adminTable/AdminTable.js +0 -8
- package/dist/esm/presets/adminTable/index.d.ts +0 -4
- package/dist/esm/presets/adminTable/index.js +0 -3
- package/dist/esm/presets/adminTable/toAdminTableProps.d.ts +0 -31
- package/dist/esm/presets/adminTable/toAdminTableProps.js +0 -54
- package/dist/esm/presets/adminTable/useAdminTableProps.d.ts +0 -5
- package/dist/esm/presets/adminTable/useAdminTableProps.js +0 -22
- package/dist/esm/presets/serverAdminTable/ServerAdminTable.d.ts +0 -4
- package/dist/esm/presets/serverAdminTable/ServerAdminTable.js +0 -8
- package/dist/esm/presets/serverAdminTable/index.d.ts +0 -4
- package/dist/esm/presets/serverAdminTable/index.js +0 -3
- package/dist/esm/presets/serverAdminTable/toServerAdminTableProps.d.ts +0 -13
- package/dist/esm/presets/serverAdminTable/toServerAdminTableProps.js +0 -22
- package/dist/esm/presets/serverAdminTable/useServerAdminTableProps.d.ts +0 -5
- package/dist/esm/presets/serverAdminTable/useServerAdminTableProps.js +0 -22
- package/dist/esm/presets/serverSimpleTable/ServerSimpleTable.d.ts +0 -3
- package/dist/esm/presets/serverSimpleTable/ServerSimpleTable.js +0 -8
- package/dist/esm/presets/serverSimpleTable/index.d.ts +0 -4
- package/dist/esm/presets/serverSimpleTable/index.js +0 -3
- package/dist/esm/presets/serverSimpleTable/toServerSimpleTableProps.d.ts +0 -13
- package/dist/esm/presets/serverSimpleTable/toServerSimpleTableProps.js +0 -22
- package/dist/esm/presets/serverSimpleTable/useServerSimpleTableProps.d.ts +0 -4
- package/dist/esm/presets/serverSimpleTable/useServerSimpleTableProps.js +0 -18
- package/src/presets/adminTable/AdminTable.tsx +0 -14
- package/src/presets/adminTable/index.ts +0 -4
- package/src/presets/adminTable/toAdminTableProps.ts +0 -140
- package/src/presets/adminTable/useAdminTableProps.ts +0 -35
- package/src/presets/serverAdminTable/ServerAdminTable.tsx +0 -14
- package/src/presets/serverAdminTable/index.ts +0 -4
- package/src/presets/serverAdminTable/toServerAdminTableProps.ts +0 -44
- package/src/presets/serverAdminTable/useServerAdminTableProps.ts +0 -35
- package/src/presets/serverSimpleTable/ServerSimpleTable.tsx +0 -10
- package/src/presets/serverSimpleTable/index.ts +0 -4
- package/src/presets/serverSimpleTable/toServerSimpleTableProps.ts +0 -56
- package/src/presets/serverSimpleTable/useServerSimpleTableProps.ts +0 -27
package/README.md
CHANGED
|
@@ -32,7 +32,6 @@ flowchart TB
|
|
|
32
32
|
|
|
33
33
|
subgraph hooks [Хуки]
|
|
34
34
|
useSimple[useSimpleTableProps]
|
|
35
|
-
useAdmin[useAdminTableProps]
|
|
36
35
|
useTree[useTreeTableProps]
|
|
37
36
|
useInfinite[useInfiniteTableProps]
|
|
38
37
|
useEntities[useEntitiesTableProps]
|
|
@@ -40,9 +39,6 @@ flowchart TB
|
|
|
40
39
|
|
|
41
40
|
subgraph presets [Preset-компоненты]
|
|
42
41
|
SimpleTable
|
|
43
|
-
ServerSimpleTable
|
|
44
|
-
AdminTable
|
|
45
|
-
ServerAdminTable
|
|
46
42
|
EntitiesTable
|
|
47
43
|
TreeTable
|
|
48
44
|
InfiniteTable
|
|
@@ -56,21 +52,17 @@ flowchart TB
|
|
|
56
52
|
|
|
57
53
|
public -.->|columnDefinitions| Table
|
|
58
54
|
useSimple --> SimpleTable
|
|
59
|
-
useAdmin --> AdminTable
|
|
60
55
|
useTree --> TreeTable
|
|
61
56
|
useInfinite --> InfiniteTable
|
|
62
57
|
useEntities --> EntitiesTable
|
|
63
58
|
SimpleTable --> Table
|
|
64
|
-
ServerSimpleTable --> ServerTable
|
|
65
|
-
AdminTable --> Table
|
|
66
|
-
ServerAdminTable --> ServerTable
|
|
67
59
|
EntitiesTable --> ServerTable
|
|
68
60
|
TreeTable --> Table
|
|
69
61
|
InfiniteTable --> Table
|
|
70
62
|
ServerTable --> Table
|
|
71
63
|
```
|
|
72
64
|
|
|
73
|
-
`defineColumns`, `statusColumn` и `actionsColumn` — публичные утилиты: ими собирают `columnDefinitions` для **`Table`** напрямую. Preset-ы дают тот же результат через упрощённые
|
|
65
|
+
`defineColumns`, `statusColumn` и `actionsColumn` — публичные утилиты: ими собирают `columnDefinitions` для **`Table`** напрямую. Preset-ы дают тот же результат через упрощённые пропсы.
|
|
74
66
|
|
|
75
67
|
`ServerTable` — обёртка над `Table` для серверной пагинации, сортировки и фильтрации.
|
|
76
68
|
|
|
@@ -112,8 +104,6 @@ flowchart TB
|
|
|
112
104
|
- используйте **`ServerTable`**.
|
|
113
105
|
- Простой справочник без поиска и фильтров:
|
|
114
106
|
- **`SimpleTable`** вместо ручной сборки `columnDefinitions`.
|
|
115
|
-
- Типичный админ-экран (поиск, статус, выбор, действия):
|
|
116
|
-
- **`AdminTable`** вместо полного `Table`.
|
|
117
107
|
- Простой список без колонок и сортировки:
|
|
118
108
|
- используйте список или карточки.
|
|
119
109
|
|
|
@@ -953,7 +943,7 @@ export function FullWidth() {
|
|
|
953
943
|
| `infiniteLoading` | `boolean` | `false` | Режим работы "бесконечной" загрузки |
|
|
954
944
|
| `keepPinnedRows` | `boolean` | `false` | Параметр отвечает за отображение закрепленных строк на всех страницах таблицы |
|
|
955
945
|
| `layoutPresets` | `LayoutPresets` \| `TableLayoutDefaults` | — | Override дефолтов адаптива для этого инстанса (`mergePresets` поверх `TABLE_LAYOUT_PRESETS`). <br/> `stickyControls` в пресете tier'а заменяет DS-объект целиком — указывайте все нужные поля. <br/> Escape-hatch: обычно не нужен — DS-пресет применяется автоматически по `AdaptiveProvider`. |
|
|
956
|
-
| `loadMoreTrigger` | `"button"` \| `"scroll"` | `scroll` | Механизм подгрузки следующей порции данных. <br/> - `'scroll'` (по умолчанию) — IntersectionObserver на scroll-stub в конце списка. <br/> - `'button'` — кнопка
|
|
946
|
+
| `loadMoreTrigger` | `"button"` \| `"scroll"` | `scroll` | Механизм подгрузки следующей порции данных. <br/> - `'scroll'` (по умолчанию) — IntersectionObserver на scroll-stub в конце списка. <br/> - `'button'` — кнопка «Показать ещё» под таблицей. |
|
|
957
947
|
| `loading` | `boolean` | `false` | Состояние загрузки |
|
|
958
948
|
| `manualFiltering` | `boolean` | `false` | |
|
|
959
949
|
| `manualPagination` | `boolean` | `false` | |
|
|
@@ -962,7 +952,7 @@ export function FullWidth() {
|
|
|
962
952
|
| `noDataState` | `EmptyStateProps` | — | Экран при отсутствии данных |
|
|
963
953
|
| `noResultsState` | `EmptyStateProps` | — | Экран при отсутствии результатов поиска или фильтров |
|
|
964
954
|
| `onExport` | `(() => void)` | — | Колбэк экспорта данных. Рендерит иконку в тулбаре перед настройками колонок. |
|
|
965
|
-
| `onLoadMore` | `(() => void)` | — | Колбэк дозагрузки следующей порции данных. <br/> В режиме `loadMoreTrigger='scroll'` вызывается автоматически при достижении конца списка; <br/> в режиме `loadMoreTrigger='button'` — по нажатию кнопки
|
|
955
|
+
| `onLoadMore` | `(() => void)` | — | Колбэк дозагрузки следующей порции данных. <br/> В режиме `loadMoreTrigger='scroll'` вызывается автоматически при достижении конца списка; <br/> в режиме `loadMoreTrigger='button'` — по нажатию кнопки «Показать ещё». |
|
|
966
956
|
| `onRefresh` | `(() => void)` | — | Колбэк обновления данных |
|
|
967
957
|
| `onRowClick` | `RowClickHandler` | — | Колбэк клика по строке |
|
|
968
958
|
| `onViewChange` | `((view: View) => void)` | — | Колбэк на смену режима отображения |
|
|
@@ -972,6 +962,7 @@ export function FullWidth() {
|
|
|
972
962
|
| `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`. |
|
|
973
963
|
| `renderCard` | `((context: RenderCardContext<TData>) => ReactNode)` | — | Кастомный рендер карточки в `view='cards'`. Получает контекст с tanstack <br/> `row` / `table` и `defaultRender` (готовый элемент дефолтной карточки — <br/> можно обернуть). Возврат заменяет дефолтную карточку. |
|
|
974
964
|
| `rowAutoHeight` | `boolean` | — | |
|
|
965
|
+
| `rowCount` | `number` | — | Общее количество строк при внешнем управлении пагинацией. |
|
|
975
966
|
| `rowPinning` | `Pick<RowPinningState, "top">` | `{ top: [], }` | Определение, какие строки должны быть закреплены в таблице |
|
|
976
967
|
| `rowSelection` | `RowAppearance` | — | Параметры выбора строк: `initialState`, `state`, `enable`, `appearance`, `multiRow`, `onChange`. |
|
|
977
968
|
| `rowVirtualizerInstanceRef` | `RowVirtualizer` | — | Ref на инстанс row-virtualizer'а для управления прокруткой снаружи |
|
|
@@ -1056,7 +1047,6 @@ export function FullWidth() {
|
|
|
1056
1047
|
- **Обзор пакета** — архитектура, выбор компонента, preset-ы.
|
|
1057
1048
|
- **`defineColumns`** — декларативные колонки для preset-ов и escape hatch.
|
|
1058
1049
|
- **SimpleTable** — минимальный клиентский preset.
|
|
1059
|
-
- **AdminTable** — админ-экран на клиенте.
|
|
1060
1050
|
- **TreeTable** — иерархические данные.
|
|
1061
1051
|
- **InfiniteTable** — бесконечная прокрутка.
|
|
1062
1052
|
- **ServerTable** — постраничные данные с бэкенда.
|
|
@@ -1175,7 +1165,7 @@ localStorage и sessionStorage используют ключ `${id}_filter` и J
|
|
|
1175
1165
|
|
|
1176
1166
|
`ServerTable` — обёртка над **`Table`** для постраничных данных с бэкенда. Страница данных приходит снаружи (`items` / `total` / `limit` / `offset`), смена страницы, поиск и сортировка делегируются серверу: компонент вызывает `onChangePage`, `search.onChange` и `sorting.onChange`, а отрисовывает то, что передано в пропсах.
|
|
1177
1167
|
|
|
1178
|
-
|
|
1168
|
+
Декларативное описание колонок можно преобразовать через `defineColumns` и передать в `columnDefinitions`.
|
|
1179
1169
|
|
|
1180
1170
|
### Когда использовать
|
|
1181
1171
|
|
|
@@ -1186,12 +1176,11 @@ localStorage и sessionStorage используют ключ `${id}_filter` и J
|
|
|
1186
1176
|
Когда **не** нужен:
|
|
1187
1177
|
|
|
1188
1178
|
- Данные загружены на клиент целиком:
|
|
1189
|
-
- используйте **`Table`** или **`SimpleTable`**
|
|
1179
|
+
- используйте **`Table`** для локальной пагинации или **`SimpleTable`** для отображения всех строк.
|
|
1190
1180
|
|
|
1191
1181
|
Рекомендации по выбору API:
|
|
1192
1182
|
|
|
1193
|
-
-
|
|
1194
|
-
- Админ-экран с поиском, статусом, выбором и действиями — `ServerAdminTable`.
|
|
1183
|
+
- Админ-экран с поиском, статусом, выбором и действиями — `ServerTable`.
|
|
1195
1184
|
- Нестандартные колонки, фильтры или поведение тулбара — `ServerTable` напрямую.
|
|
1196
1185
|
|
|
1197
1186
|
### Анатомия
|
|
@@ -1517,16 +1506,15 @@ export function ServerDriven() {
|
|
|
1517
1506
|
|
|
1518
1507
|
### Смотри также
|
|
1519
1508
|
|
|
1520
|
-
- **Обзор пакета** —
|
|
1509
|
+
- **Обзор пакета** — выбор компонента.
|
|
1521
1510
|
- **Table** — клиентская таблица для данных, загруженных целиком.
|
|
1522
|
-
- **SimpleTable** —
|
|
1523
|
-
- **AdminTable** — клиентский аналог `ServerAdminTable`.
|
|
1511
|
+
- **SimpleTable** — таблица для отображения готового массива данных.
|
|
1524
1512
|
|
|
1525
1513
|
## SimpleTable
|
|
1526
1514
|
|
|
1527
|
-
Минимальная клиентская таблица:
|
|
1515
|
+
Минимальная клиентская таблица: данные и декларативные колонки.
|
|
1528
1516
|
|
|
1529
|
-
`SimpleTable` — preset-обёртка над **`Table`** для простых списков: декларативные колонки через `defineColumns`,
|
|
1517
|
+
`SimpleTable` — preset-обёртка над **`Table`** для простых списков: декларативные колонки через `defineColumns`, `outline` включён по умолчанию. Таблица отображает все строки без панели инструментов и пагинации.
|
|
1530
1518
|
|
|
1531
1519
|
### Когда использовать
|
|
1532
1520
|
|
|
@@ -1536,8 +1524,8 @@ export function ServerDriven() {
|
|
|
1536
1524
|
|
|
1537
1525
|
Когда **не** нужен:
|
|
1538
1526
|
|
|
1539
|
-
- Поиск, фильтры, выбор строк — используйте `
|
|
1540
|
-
- Данные с бэкенда постранично — `
|
|
1527
|
+
- Поиск, фильтры, выбор строк — используйте `Table`.
|
|
1528
|
+
- Данные с бэкенда постранично — `ServerTable`.
|
|
1541
1529
|
|
|
1542
1530
|
### Примеры использования
|
|
1543
1531
|
|
|
@@ -1572,7 +1560,7 @@ const columns: SimpleColumnDef<User>[] = [
|
|
|
1572
1560
|
];
|
|
1573
1561
|
|
|
1574
1562
|
export function SimpleTableBasic() {
|
|
1575
|
-
return <SimpleTable data={USERS} columns={columns}
|
|
1563
|
+
return <SimpleTable data={USERS} columns={columns} getRowId={user => user.id} outline />;
|
|
1576
1564
|
}
|
|
1577
1565
|
```
|
|
1578
1566
|
|
|
@@ -1605,7 +1593,6 @@ export function SimpleTableWithHook() {
|
|
|
1605
1593
|
const tableProps = useSimpleTableProps({
|
|
1606
1594
|
data: USERS,
|
|
1607
1595
|
columns,
|
|
1608
|
-
pageSize: 5,
|
|
1609
1596
|
getRowId: user => user.id,
|
|
1610
1597
|
outline: true,
|
|
1611
1598
|
});
|
|
@@ -1614,278 +1601,21 @@ export function SimpleTableWithHook() {
|
|
|
1614
1601
|
}
|
|
1615
1602
|
```
|
|
1616
1603
|
|
|
1617
|
-
|
|
1604
|
+
### Возможности и API
|
|
1618
1605
|
|
|
1619
|
-
|
|
1620
|
-
|
|
1621
|
-
|
|
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
|
-
```
|
|
1606
|
+
`SimpleTable` принимает данные через `data`, а описание колонок — через `columns`.
|
|
1607
|
+
Форматирование значений задаётся через `format`; для полной настройки колонки используется `column`.
|
|
1608
|
+
Все строки отображаются сразу в табличном виде. Поддерживаются сортировка колонок,
|
|
1609
|
+
обработка нажатия на строку, состояния загрузки, ошибки и отсутствия данных.
|
|
1838
1610
|
|
|
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
|
-
```
|
|
1611
|
+
Для панели инструментов, пагинации, выбора строк, поиска, фильтров и карточного режима
|
|
1612
|
+
используется `Table`. Для серверной обработки данных — `ServerTable`.
|
|
1883
1613
|
|
|
1884
1614
|
## TreeTable
|
|
1885
1615
|
|
|
1886
|
-
Иерархическая таблица:
|
|
1616
|
+
Иерархическая таблица: раскрытие строк, постраничная навигация и выбор строк.
|
|
1887
1617
|
|
|
1888
|
-
`TreeTable` — preset для иерархических данных: `getChildren`, tree-колонка через `primaryColumn`,
|
|
1618
|
+
`TreeTable` — preset для иерархических данных: `getChildren`, tree-колонка через `primaryColumn`, с пагинацией корневых строк. Дочерние строки отображаются вместе с родителем и не уменьшают число корневых строк на странице. Представление — только таблица, включая мобильный режим.
|
|
1889
1619
|
|
|
1890
1620
|
### Когда использовать
|
|
1891
1621
|
|
|
@@ -1894,7 +1624,7 @@ export function AdminTableCardView() {
|
|
|
1894
1624
|
|
|
1895
1625
|
Когда **не** нужен:
|
|
1896
1626
|
|
|
1897
|
-
- Плоский список — `SimpleTable
|
|
1627
|
+
- Плоский список — `SimpleTable`.
|
|
1898
1628
|
- Закрепление строк (`rowPinning`) — только на полном `Table`.
|
|
1899
1629
|
|
|
1900
1630
|
### Примеры использования
|
|
@@ -2191,44 +1921,8 @@ Server-driven список сущностей: state пагинации/поис
|
|
|
2191
1921
|
|
|
2192
1922
|
Когда **не** нужен:
|
|
2193
1923
|
|
|
2194
|
-
-
|
|
2195
|
-
- Клиентские данные в памяти — **`
|
|
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
|
-
```
|
|
1924
|
+
- Ручная загрузка страниц — **`ServerTable`**.
|
|
1925
|
+
- Клиентские данные в памяти — **`Table`** или **`SimpleTable`**.
|
|
2232
1926
|
|
|
2233
1927
|
### Примеры использования
|
|
2234
1928
|
|
|
@@ -2569,5 +2263,4 @@ export function EntitiesTableWithFilters() {
|
|
|
2569
2263
|
|
|
2570
2264
|
### Смотри также
|
|
2571
2265
|
|
|
2572
|
-
- **`
|
|
2573
|
-
- **`ServerTable`** — escape hatch без product-дефолтов.
|
|
2266
|
+
- **`ServerTable`** — таблица с ручной загрузкой страниц.
|
|
@@ -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, pagination: {
|
|
39
|
+
}, columnFilters: columnFilters, pageCount: pageCount, rowCount: total, 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, 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;
|
|
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, rowCount, 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, 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 }) {
|
|
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, rowCount, 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,6 +138,7 @@ function Table({ data, rowPinning = {
|
|
|
138
138
|
pagination,
|
|
139
139
|
onPaginationChange,
|
|
140
140
|
pageCount,
|
|
141
|
+
rowCount,
|
|
141
142
|
pageSize,
|
|
142
143
|
manualSorting,
|
|
143
144
|
manualPagination,
|
|
@@ -177,7 +178,12 @@ function Table({ data, rowPinning = {
|
|
|
177
178
|
isLoadingState,
|
|
178
179
|
savedState,
|
|
179
180
|
});
|
|
180
|
-
const emptyStates = (0, helperComponents_1.useEmptyState)({
|
|
181
|
+
const emptyStates = (0, helperComponents_1.useEmptyState)({
|
|
182
|
+
noDataState,
|
|
183
|
+
noResultsState,
|
|
184
|
+
errorDataState,
|
|
185
|
+
onRefresh: onRefresh ? handleOnRefresh : undefined,
|
|
186
|
+
});
|
|
181
187
|
(0, hooks_1.usePageReset)({
|
|
182
188
|
manualPagination,
|
|
183
189
|
maximumAvailablePage: pageCount || tableFilteredRows.length / pagination.pageSize,
|
|
@@ -342,7 +348,7 @@ function Table({ data, rowPinning = {
|
|
|
342
348
|
paginationChrome =
|
|
343
349
|
isStickyControls && controlsAcrylic ? ((0, jsx_runtime_1.jsx)(TableChrome_1.TableChrome, { variant: 'footer', acrylic: controlsAcrylic, children: pagination })) : (pagination);
|
|
344
350
|
}
|
|
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.
|
|
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.jsxs)(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] })] }) }));
|
|
346
352
|
}
|
|
347
353
|
Table.getStatusColumnDef = helperComponents_1.getStatusColumnDef;
|
|
348
354
|
Table.statusAppearances = helperComponents_1.STATUS_APPEARANCE;
|
|
@@ -20,6 +20,7 @@ type UseTableInstanceParams<TData extends object> = {
|
|
|
20
20
|
pagination: PaginationState;
|
|
21
21
|
onPaginationChange: OnChangeFn<PaginationState>;
|
|
22
22
|
pageCount?: number;
|
|
23
|
+
rowCount?: number;
|
|
23
24
|
pageSize: number;
|
|
24
25
|
manualSorting: boolean;
|
|
25
26
|
manualPagination: boolean;
|
|
@@ -41,7 +42,7 @@ type UseTableInstanceParams<TData extends object> = {
|
|
|
41
42
|
onRefresh?: () => void;
|
|
42
43
|
bulkActionsProp?: TableProps<TData>['bulkActions'];
|
|
43
44
|
};
|
|
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>): {
|
|
45
|
+
export declare function useTableInstance<TData extends object>({ data, rowPinning, keepPinnedRows, enableSelectPinned, rowSelectionProp, globalFilter, onGlobalFilterChange, rowSelection, onRowSelectionChange, sorting, onSortingChange, expanded, onExpandedChange, pagination, onPaginationChange, pageCount, rowCount, pageSize, manualSorting, manualPagination, manualFiltering, autoResetPageIndex, getRowId, enableFuzzySearch, expanding, rowAutoHeight, enabledTableColumns, enabledColumnsDefinitions, columnPinning, columnOrder, enableColumnsOrderSortByDrag, setColumnOrder, masterSelection, infiniteLoading, loading, onRefresh, bulkActionsProp, }: UseTableInstanceParams<TData>): {
|
|
45
46
|
table: import("@tanstack/react-table").Table<TData>;
|
|
46
47
|
loadingTable: import("@tanstack/react-table").Table<TData>;
|
|
47
48
|
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, pageSize, manualSorting, manualPagination, manualFiltering, autoResetPageIndex, getRowId, enableFuzzySearch, expanding, rowAutoHeight, enabledTableColumns, enabledColumnsDefinitions, columnPinning, columnOrder, enableColumnsOrderSortByDrag, setColumnOrder, masterSelection, infiniteLoading, loading, onRefresh, bulkActionsProp, }) {
|
|
15
|
+
function useTableInstance({ data, rowPinning, keepPinnedRows, enableSelectPinned, rowSelectionProp, globalFilter, onGlobalFilterChange, rowSelection, onRowSelectionChange, sorting, onSortingChange, expanded, onExpandedChange, pagination, onPaginationChange, pageCount, rowCount, 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,6 +38,7 @@ function useTableInstance({ data, rowPinning, keepPinnedRows, enableSelectPinned
|
|
|
38
38
|
expanded,
|
|
39
39
|
},
|
|
40
40
|
pageCount,
|
|
41
|
+
rowCount,
|
|
41
42
|
defaultColumn: {
|
|
42
43
|
enableSorting: false,
|
|
43
44
|
enableResizing: false,
|