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