@cloud-ru/ds-table 2.2.11-preview-2f5fa273.0 → 2.2.11-preview-8ecff793.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 +286 -14
- 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 +2 -3
- 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/types.d.ts +1 -4
- package/dist/cjs/helperComponents/TablePagination/TablePagination.js +2 -24
- package/dist/cjs/helperComponents/TablePagination/styles.module.css +0 -7
- package/dist/cjs/locale/index.d.ts +0 -16
- package/dist/cjs/locale/index.js +0 -8
- 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 +2 -0
- package/dist/cjs/presets/index.js +2 -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/simpleTable/toSimpleTableProps.d.ts +3 -1
- package/dist/cjs/presets/simpleTable/toSimpleTableProps.js +5 -5
- package/dist/cjs/presets/simpleTable/useSimpleTableProps.js +4 -1
- package/dist/cjs/style.css +0 -7
- 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 +2 -3
- 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/types.d.ts +1 -4
- package/dist/esm/helperComponents/TablePagination/TablePagination.js +2 -24
- package/dist/esm/helperComponents/TablePagination/styles.module.css +0 -7
- package/dist/esm/locale/index.d.ts +0 -16
- package/dist/esm/locale/index.js +0 -8
- 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 +2 -0
- package/dist/esm/presets/index.js +2 -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/simpleTable/toSimpleTableProps.d.ts +3 -1
- package/dist/esm/presets/simpleTable/toSimpleTableProps.js +5 -5
- package/dist/esm/presets/simpleTable/useSimpleTableProps.js +4 -1
- package/dist/esm/style.css +0 -7
- package/dist/tsconfig.cjs.tsbuildinfo +1 -1
- package/dist/tsconfig.esm.tsbuildinfo +1 -1
- package/package.json +19 -19
- package/src/components/ServerTable/ServerTable.tsx +0 -1
- package/src/components/Table/STRUCTURE.md +6 -12
- package/src/components/Table/Table.tsx +1 -3
- package/src/components/Table/hooks/useTableInstance.tsx +0 -3
- package/src/components/types.ts +1 -4
- package/src/helperComponents/TablePagination/TablePagination.tsx +5 -64
- package/src/helperComponents/TablePagination/styles.module.scss +0 -7
- package/src/locale/index.ts +0 -8
- 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 +2 -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/simpleTable/toSimpleTableProps.ts +21 -6
- package/src/presets/simpleTable/useSimpleTableProps.ts +5 -1
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]
|
|
@@ -40,6 +41,8 @@ flowchart TB
|
|
|
40
41
|
subgraph presets [Preset-компоненты]
|
|
41
42
|
SimpleTable
|
|
42
43
|
ServerSimpleTable
|
|
44
|
+
AdminTable
|
|
45
|
+
ServerAdminTable
|
|
43
46
|
EntitiesTable
|
|
44
47
|
TreeTable
|
|
45
48
|
InfiniteTable
|
|
@@ -53,18 +56,21 @@ flowchart TB
|
|
|
53
56
|
|
|
54
57
|
public -.->|columnDefinitions| Table
|
|
55
58
|
useSimple --> SimpleTable
|
|
59
|
+
useAdmin --> AdminTable
|
|
56
60
|
useTree --> TreeTable
|
|
57
61
|
useInfinite --> InfiniteTable
|
|
58
62
|
useEntities --> EntitiesTable
|
|
59
63
|
SimpleTable --> Table
|
|
60
64
|
ServerSimpleTable --> ServerTable
|
|
65
|
+
AdminTable --> Table
|
|
66
|
+
ServerAdminTable --> ServerTable
|
|
61
67
|
EntitiesTable --> ServerTable
|
|
62
68
|
TreeTable --> Table
|
|
63
69
|
InfiniteTable --> Table
|
|
64
70
|
ServerTable --> Table
|
|
65
71
|
```
|
|
66
72
|
|
|
67
|
-
`defineColumns`, `statusColumn` и `actionsColumn` — публичные утилиты: ими собирают `columnDefinitions` для **`Table`** напрямую. Preset-ы дают тот же результат через упрощённые
|
|
73
|
+
`defineColumns`, `statusColumn` и `actionsColumn` — публичные утилиты: ими собирают `columnDefinitions` для **`Table`** напрямую. Preset-ы дают тот же результат через упрощённые пропсы (`columns`, `statusColumn`, `rowActions` в `AdminTable`).
|
|
68
74
|
|
|
69
75
|
`ServerTable` — обёртка над `Table` для серверной пагинации, сортировки и фильтрации.
|
|
70
76
|
|
|
@@ -106,6 +112,8 @@ flowchart TB
|
|
|
106
112
|
- используйте **`ServerTable`**.
|
|
107
113
|
- Простой справочник без поиска и фильтров:
|
|
108
114
|
- **`SimpleTable`** вместо ручной сборки `columnDefinitions`.
|
|
115
|
+
- Типичный админ-экран (поиск, статус, выбор, действия):
|
|
116
|
+
- **`AdminTable`** вместо полного `Table`.
|
|
109
117
|
- Простой список без колонок и сортировки:
|
|
110
118
|
- используйте список или карточки.
|
|
111
119
|
|
|
@@ -964,7 +972,6 @@ export function FullWidth() {
|
|
|
964
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`. |
|
|
965
973
|
| `renderCard` | `((context: RenderCardContext<TData>) => ReactNode)` | — | Кастомный рендер карточки в `view='cards'`. Получает контекст с tanstack <br/> `row` / `table` и `defaultRender` (готовый элемент дефолтной карточки — <br/> можно обернуть). Возврат заменяет дефолтную карточку. |
|
|
966
974
|
| `rowAutoHeight` | `boolean` | — | |
|
|
967
|
-
| `rowCount` | `number` | — | Общее количество строк при внешнем управлении пагинацией. |
|
|
968
975
|
| `rowPinning` | `Pick<RowPinningState, "top">` | `{ top: [], }` | Определение, какие строки должны быть закреплены в таблице |
|
|
969
976
|
| `rowSelection` | `RowAppearance` | — | Параметры выбора строк: `initialState`, `state`, `enable`, `appearance`, `multiRow`, `onChange`. |
|
|
970
977
|
| `rowVirtualizerInstanceRef` | `RowVirtualizer` | — | Ref на инстанс row-virtualizer'а для управления прокруткой снаружи |
|
|
@@ -1049,6 +1056,7 @@ export function FullWidth() {
|
|
|
1049
1056
|
- **Обзор пакета** — архитектура, выбор компонента, preset-ы.
|
|
1050
1057
|
- **`defineColumns`** — декларативные колонки для preset-ов и escape hatch.
|
|
1051
1058
|
- **SimpleTable** — минимальный клиентский preset.
|
|
1059
|
+
- **AdminTable** — админ-экран на клиенте.
|
|
1052
1060
|
- **TreeTable** — иерархические данные.
|
|
1053
1061
|
- **InfiniteTable** — бесконечная прокрутка.
|
|
1054
1062
|
- **ServerTable** — постраничные данные с бэкенда.
|
|
@@ -1167,7 +1175,7 @@ localStorage и sessionStorage используют ключ `${id}_filter` и J
|
|
|
1167
1175
|
|
|
1168
1176
|
`ServerTable` — обёртка над **`Table`** для постраничных данных с бэкенда. Страница данных приходит снаружи (`items` / `total` / `limit` / `offset`), смена страницы, поиск и сортировка делегируются серверу: компонент вызывает `onChangePage`, `search.onChange` и `sorting.onChange`, а отрисовывает то, что передано в пропсах.
|
|
1169
1177
|
|
|
1170
|
-
Для типовых серверных сценариев `ServerSimpleTable`
|
|
1178
|
+
Для типовых серверных сценариев есть preset-ы `ServerSimpleTable` и `ServerAdminTable` (см. **обзор пакета**) — они маппят упрощённый API в `ServerTable`, как `SimpleTable` / `AdminTable` маппят в `Table`.
|
|
1171
1179
|
|
|
1172
1180
|
### Когда использовать
|
|
1173
1181
|
|
|
@@ -1178,12 +1186,12 @@ localStorage и sessionStorage используют ключ `${id}_filter` и J
|
|
|
1178
1186
|
Когда **не** нужен:
|
|
1179
1187
|
|
|
1180
1188
|
- Данные загружены на клиент целиком:
|
|
1181
|
-
- используйте **`Table`**
|
|
1189
|
+
- используйте **`Table`** или **`SimpleTable`** — пагинация, поиск и сортировка работают локально.
|
|
1182
1190
|
|
|
1183
1191
|
Рекомендации по выбору API:
|
|
1184
1192
|
|
|
1185
1193
|
- Простой серверный список (колонки + пагинация) — `ServerSimpleTable`.
|
|
1186
|
-
- Админ-экран с поиском, статусом, выбором и действиями — `
|
|
1194
|
+
- Админ-экран с поиском, статусом, выбором и действиями — `ServerAdminTable`.
|
|
1187
1195
|
- Нестандартные колонки, фильтры или поведение тулбара — `ServerTable` напрямую.
|
|
1188
1196
|
|
|
1189
1197
|
### Анатомия
|
|
@@ -1509,15 +1517,16 @@ export function ServerDriven() {
|
|
|
1509
1517
|
|
|
1510
1518
|
### Смотри также
|
|
1511
1519
|
|
|
1512
|
-
- **Обзор пакета** — `ServerSimpleTable` и выбор компонента.
|
|
1520
|
+
- **Обзор пакета** — `ServerSimpleTable`, `ServerAdminTable` и выбор компонента.
|
|
1513
1521
|
- **Table** — клиентская таблица для данных, загруженных целиком.
|
|
1514
1522
|
- **SimpleTable** — клиентский аналог `ServerSimpleTable`.
|
|
1523
|
+
- **AdminTable** — клиентский аналог `ServerAdminTable`.
|
|
1515
1524
|
|
|
1516
1525
|
## SimpleTable
|
|
1517
1526
|
|
|
1518
|
-
Минимальная клиентская таблица:
|
|
1527
|
+
Минимальная клиентская таблица: данные, колонки и пагинация с предустановленными дефолтами.
|
|
1519
1528
|
|
|
1520
|
-
`SimpleTable` — preset-обёртка над **`Table`** для простых списков: декларативные колонки через `defineColumns`, `outline`
|
|
1529
|
+
`SimpleTable` — preset-обёртка над **`Table`** для простых списков: декларативные колонки через `defineColumns`, пагинация и `outline` включены по умолчанию.
|
|
1521
1530
|
|
|
1522
1531
|
### Когда использовать
|
|
1523
1532
|
|
|
@@ -1527,7 +1536,7 @@ export function ServerDriven() {
|
|
|
1527
1536
|
|
|
1528
1537
|
Когда **не** нужен:
|
|
1529
1538
|
|
|
1530
|
-
- Поиск, фильтры, выбор строк — используйте `
|
|
1539
|
+
- Поиск, фильтры, выбор строк — используйте `AdminTable`.
|
|
1531
1540
|
- Данные с бэкенда постранично — `ServerSimpleTable` или `ServerTable`.
|
|
1532
1541
|
|
|
1533
1542
|
### Примеры использования
|
|
@@ -1563,7 +1572,7 @@ const columns: SimpleColumnDef<User>[] = [
|
|
|
1563
1572
|
];
|
|
1564
1573
|
|
|
1565
1574
|
export function SimpleTableBasic() {
|
|
1566
|
-
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 />;
|
|
1567
1576
|
}
|
|
1568
1577
|
```
|
|
1569
1578
|
|
|
@@ -1596,6 +1605,7 @@ export function SimpleTableWithHook() {
|
|
|
1596
1605
|
const tableProps = useSimpleTableProps({
|
|
1597
1606
|
data: USERS,
|
|
1598
1607
|
columns,
|
|
1608
|
+
pageSize: 5,
|
|
1599
1609
|
getRowId: user => user.id,
|
|
1600
1610
|
outline: true,
|
|
1601
1611
|
});
|
|
@@ -1636,6 +1646,7 @@ export function SimpleTableCardView() {
|
|
|
1636
1646
|
<SimpleTable
|
|
1637
1647
|
data={USERS}
|
|
1638
1648
|
columns={columns}
|
|
1649
|
+
pageSize={5}
|
|
1639
1650
|
getRowId={user => user.id}
|
|
1640
1651
|
headlineKey='name'
|
|
1641
1652
|
view={view}
|
|
@@ -1646,6 +1657,230 @@ export function SimpleTableCardView() {
|
|
|
1646
1657
|
}
|
|
1647
1658
|
```
|
|
1648
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
|
+
```
|
|
1838
|
+
|
|
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
|
+
```
|
|
1883
|
+
|
|
1649
1884
|
## TreeTable
|
|
1650
1885
|
|
|
1651
1886
|
Иерархическая таблица: expanding, без пагинации, с опциональным выбором строк.
|
|
@@ -1659,7 +1894,7 @@ export function SimpleTableCardView() {
|
|
|
1659
1894
|
|
|
1660
1895
|
Когда **не** нужен:
|
|
1661
1896
|
|
|
1662
|
-
- Плоский список — `SimpleTable`.
|
|
1897
|
+
- Плоский список — `SimpleTable` / `AdminTable`.
|
|
1663
1898
|
- Закрепление строк (`rowPinning`) — только на полном `Table`.
|
|
1664
1899
|
|
|
1665
1900
|
### Примеры использования
|
|
@@ -1956,8 +2191,44 @@ Server-driven список сущностей: state пагинации/поис
|
|
|
1956
2191
|
|
|
1957
2192
|
Когда **не** нужен:
|
|
1958
2193
|
|
|
1959
|
-
-
|
|
1960
|
-
- Клиентские данные в памяти — **`
|
|
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
|
+
```
|
|
1961
2232
|
|
|
1962
2233
|
### Примеры использования
|
|
1963
2234
|
|
|
@@ -2298,4 +2569,5 @@ export function EntitiesTableWithFilters() {
|
|
|
2298
2569
|
|
|
2299
2570
|
### Смотри также
|
|
2300
2571
|
|
|
2301
|
-
- **`
|
|
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,
|
|
@@ -343,7 +342,7 @@ function Table({ data, rowPinning = {
|
|
|
343
342
|
paginationChrome =
|
|
344
343
|
isStickyControls && controlsAcrylic ? ((0, jsx_runtime_1.jsx)(TableChrome_1.TableChrome, { variant: 'footer', acrylic: controlsAcrylic, children: pagination })) : (pagination);
|
|
345
344
|
}
|
|
346
|
-
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] })] }) }));
|
|
347
346
|
}
|
|
348
347
|
Table.getStatusColumnDef = helperComponents_1.getStatusColumnDef;
|
|
349
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,
|
|
@@ -328,7 +328,6 @@ export type InfiniteTableProps<TData extends object, TFilters extends FiltersSta
|
|
|
328
328
|
pagination?: never;
|
|
329
329
|
autoResetPageIndex?: never;
|
|
330
330
|
pageCount?: never;
|
|
331
|
-
rowCount?: never;
|
|
332
331
|
/** Режим работы "бесконечной" загрузки */
|
|
333
332
|
infiniteLoading?: boolean;
|
|
334
333
|
suppressPagination?: never;
|
|
@@ -364,8 +363,6 @@ export type ClientTableProps<TData extends object, TFilters extends FiltersState
|
|
|
364
363
|
autoResetPageIndex?: boolean;
|
|
365
364
|
/** Кол-во страниц (для внешнего управления) */
|
|
366
365
|
pageCount?: number;
|
|
367
|
-
/** Общее количество строк при внешнем управлении пагинацией. */
|
|
368
|
-
rowCount?: number;
|
|
369
366
|
/** Отключение пагинации */
|
|
370
367
|
suppressPagination?: boolean;
|
|
371
368
|
manualPagination?: boolean;
|
|
@@ -377,7 +374,7 @@ export type ClientTableProps<TData extends object, TFilters extends FiltersState
|
|
|
377
374
|
toolbarCheckBoxMode?: ToolbarCheckBoxMode;
|
|
378
375
|
};
|
|
379
376
|
export type TableProps<TData extends object, TFilters extends FiltersState = Record<string, unknown>> = InfiniteTableProps<TData, TFilters> | ClientTableProps<TData, TFilters>;
|
|
380
|
-
export type ServerTableProps<TData extends object, TFilters extends FiltersState = Record<string, unknown>> = Omit<ClientTableProps<TData, TFilters>, 'pageSize' | 'pageCount' | '
|
|
377
|
+
export type ServerTableProps<TData extends object, TFilters extends FiltersState = Record<string, unknown>> = Omit<ClientTableProps<TData, TFilters>, 'pageSize' | 'pageCount' | 'pagination' | 'search' | 'data' | 'toolbarCheckBoxMode'> & {
|
|
381
378
|
/** Данные для отрисовки */
|
|
382
379
|
items?: TData[];
|
|
383
380
|
/** Общее кол-во строк @default 10 */
|
|
@@ -5,18 +5,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
|
5
5
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
6
|
exports.TablePagination = TablePagination;
|
|
7
7
|
const jsx_runtime_1 = require("react/jsx-runtime");
|
|
8
|
-
const adaptive_1 = require("@cloud-ru/ds-adaptive");
|
|
9
|
-
const button_1 = require("@cloud-ru/ds-button");
|
|
10
8
|
const chips_1 = require("@cloud-ru/ds-chips");
|
|
11
|
-
const system_1 = require("@cloud-ru/ds-icons/interface/system");
|
|
12
9
|
const pagination_1 = require("@cloud-ru/ds-pagination");
|
|
13
10
|
const react_1 = require("react");
|
|
14
11
|
const locale_1 = require("../../locale");
|
|
15
12
|
const styles_module_scss_1 = __importDefault(require('./styles.module.css'));
|
|
16
|
-
const MAX_PAGE_OPTIONS = 1000;
|
|
17
13
|
function TablePagination({ table, options: optionsProp, optionsLabel: optionsLabelProp, optionsRender, view, }) {
|
|
18
|
-
const { layoutType } = (0, adaptive_1.useAdaptiveLayout)();
|
|
19
|
-
const mobile = (0, adaptive_1.isMobileLayout)(layoutType);
|
|
20
14
|
const { t } = locale_1.tableLocale.useTranslations();
|
|
21
15
|
const optionsLabel = optionsLabelProp ?? t('rowsOptionsLabel');
|
|
22
16
|
const handlePaginationOnChange = (0, react_1.useCallback)((pageIndex) => {
|
|
@@ -33,24 +27,8 @@ function TablePagination({ table, options: optionsProp, optionsLabel: optionsLab
|
|
|
33
27
|
value: String(value),
|
|
34
28
|
})), [optionsProp, optionsRender]);
|
|
35
29
|
const tablePaginationState = table.getState().pagination;
|
|
36
|
-
|
|
37
|
-
const currentPage = tablePaginationState.pageIndex + 1;
|
|
38
|
-
const hasKnownPageCount = Number.isSafeInteger(pageCount) && pageCount >= 0;
|
|
39
|
-
const showPagination = !hasKnownPageCount || pageCount > 1;
|
|
40
|
-
const showPagePicker = mobile && hasKnownPageCount && pageCount > 1 && pageCount <= MAX_PAGE_OPTIONS;
|
|
41
|
-
const useCompactPagination = mobile || !hasKnownPageCount;
|
|
42
|
-
const pageOptions = (0, react_1.useMemo)(() => showPagePicker
|
|
43
|
-
? Array.from({ length: pageCount }, (_, index) => {
|
|
44
|
-
const page = String(index + 1);
|
|
45
|
-
return { label: page, value: page };
|
|
46
|
-
})
|
|
47
|
-
: [], [showPagePicker, pageCount]);
|
|
48
|
-
if (!showPagination && !options?.length) {
|
|
30
|
+
if (table.getPageCount() <= 1 && !options) {
|
|
49
31
|
return null;
|
|
50
32
|
}
|
|
51
|
-
return ((0, jsx_runtime_1.jsxs)("div", { className: styles_module_scss_1.default.footer, "data-view": view, children: [
|
|
52
|
-
if (value !== undefined) {
|
|
53
|
-
handlePaginationOnChange(Number(value));
|
|
54
|
-
}
|
|
55
|
-
}, size: 's' })), (0, jsx_runtime_1.jsx)(button_1.Button, { size: 's', view: 'function', appearance: 'neutral', icon: (0, jsx_runtime_1.jsx)(system_1.ChevronRightSVG, {}), "aria-label": t('nextPage'), disabled: !table.getCanNextPage(), onClick: () => table.nextPage() })] })), showPagination && !useCompactPagination && ((0, jsx_runtime_1.jsx)(pagination_1.Pagination, { total: pageCount, page: currentPage, onChange: handlePaginationOnChange, size: 's', className: styles_module_scss_1.default.pagination })), options && options.length > 0 && (mobile || table.getRowCount() >= Number(options[0].value)) && ((0, jsx_runtime_1.jsx)(chips_1.ChipChoice.Single, { value: String(tablePaginationState.pageSize), onChange: value => handleRowsVolumeOnChange(String(value)), placement: 'top-end', options: options, label: optionsLabel, widthStrategy: 'eq', size: 's' }))] }));
|
|
33
|
+
return ((0, jsx_runtime_1.jsxs)("div", { className: styles_module_scss_1.default.footer, "data-view": view, children: [table.getPageCount() > 1 && ((0, jsx_runtime_1.jsx)(pagination_1.Pagination, { total: table.getPageCount(), page: tablePaginationState.pageIndex + 1, onChange: handlePaginationOnChange, size: 's', className: styles_module_scss_1.default.pagination })), options && table.getRowModel().rows.length >= Number(options[0].value) && ((0, jsx_runtime_1.jsx)(chips_1.ChipChoice.Single, { value: String(tablePaginationState.pageSize), onChange: value => handleRowsVolumeOnChange(String(value)), placement: 'top-end', options: options, label: optionsLabel, widthStrategy: 'eq', size: 's' }))] }));
|
|
56
34
|
}
|