@cloud-ru/ds-table 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/LICENSE +201 -0
- package/README.md +2471 -0
- package/dist/cjs/columnUtils/actionsColumn.d.ts +10 -0
- package/dist/cjs/columnUtils/actionsColumn.js +8 -0
- package/dist/cjs/columnUtils/defineColumns.d.ts +27 -0
- package/dist/cjs/columnUtils/defineColumns.js +53 -0
- package/dist/cjs/columnUtils/index.d.ts +8 -0
- package/dist/cjs/columnUtils/index.js +11 -0
- package/dist/cjs/columnUtils/mapCardViewProps.d.ts +25 -0
- package/dist/cjs/columnUtils/mapCardViewProps.js +21 -0
- package/dist/cjs/columnUtils/statusColumn.d.ts +18 -0
- package/dist/cjs/columnUtils/statusColumn.js +25 -0
- package/dist/cjs/components/ServerTable/ServerTable.d.ts +19 -0
- package/dist/cjs/components/ServerTable/ServerTable.js +50 -0
- package/dist/cjs/components/ServerTable/constants.d.ts +2 -0
- package/dist/cjs/components/ServerTable/constants.js +5 -0
- package/dist/cjs/components/ServerTable/index.d.ts +1 -0
- package/dist/cjs/components/ServerTable/index.js +17 -0
- package/dist/cjs/components/Table/Table.d.ts +23 -0
- package/dist/cjs/components/Table/Table.js +336 -0
- package/dist/cjs/components/Table/components/TableCardsBody/TableCardsBody.d.ts +39 -0
- package/dist/cjs/components/Table/components/TableCardsBody/TableCardsBody.js +36 -0
- package/dist/cjs/components/Table/components/TableCardsBody/index.d.ts +1 -0
- package/dist/cjs/components/Table/components/TableCardsBody/index.js +17 -0
- package/dist/cjs/components/Table/components/TableChrome/TableChrome.d.ts +10 -0
- package/dist/cjs/components/Table/components/TableChrome/TableChrome.js +18 -0
- package/dist/cjs/components/Table/components/TableChrome/index.d.ts +1 -0
- package/dist/cjs/components/Table/components/TableChrome/index.js +17 -0
- package/dist/cjs/components/Table/components/TableRowsBody/TableRowsBody.d.ts +21 -0
- package/dist/cjs/components/Table/components/TableRowsBody/TableRowsBody.js +21 -0
- package/dist/cjs/components/Table/components/TableRowsBody/index.d.ts +1 -0
- package/dist/cjs/components/Table/components/TableRowsBody/index.js +17 -0
- package/dist/cjs/components/Table/components/TableScrollHost/TableScrollHost.d.ts +21 -0
- package/dist/cjs/components/Table/components/TableScrollHost/TableScrollHost.js +19 -0
- package/dist/cjs/components/Table/components/TableScrollHost/index.d.ts +1 -0
- package/dist/cjs/components/Table/components/TableScrollHost/index.js +17 -0
- package/dist/cjs/components/Table/components/TableSkeletonBody/TableSkeletonBody.d.ts +23 -0
- package/dist/cjs/components/Table/components/TableSkeletonBody/TableSkeletonBody.js +16 -0
- package/dist/cjs/components/Table/components/TableSkeletonBody/index.d.ts +1 -0
- package/dist/cjs/components/Table/components/TableSkeletonBody/index.js +17 -0
- package/dist/cjs/components/Table/components/TableToolbar/TableToolbar.d.ts +26 -0
- package/dist/cjs/components/Table/components/TableToolbar/TableToolbar.js +13 -0
- package/dist/cjs/components/Table/components/TableToolbar/index.d.ts +1 -0
- package/dist/cjs/components/Table/components/TableToolbar/index.js +17 -0
- package/dist/cjs/components/Table/hooks/index.d.ts +13 -0
- package/dist/cjs/components/Table/hooks/index.js +29 -0
- package/dist/cjs/components/Table/hooks/loadingTableCells.d.ts +2 -0
- package/dist/cjs/components/Table/hooks/loadingTableCells.js +59 -0
- package/dist/cjs/components/Table/hooks/useColumnOrderByDrag/index.d.ts +1 -0
- package/dist/cjs/components/Table/hooks/useColumnOrderByDrag/index.js +17 -0
- package/dist/cjs/components/Table/hooks/useColumnOrderByDrag/useColumnOrderByDrag.d.ts +16 -0
- package/dist/cjs/components/Table/hooks/useColumnOrderByDrag/useColumnOrderByDrag.js +82 -0
- package/dist/cjs/components/Table/hooks/useColumnOrderByDrag/utils/prepareInitialState.d.ts +4 -0
- package/dist/cjs/components/Table/hooks/useColumnOrderByDrag/utils/prepareInitialState.js +23 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/index.d.ts +1 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/index.js +17 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/useColumnSettings.d.ts +28 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/useColumnSettings.js +95 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/collectReorderLeafIds.d.ts +8 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/collectReorderLeafIds.js +13 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/createColumnsSettingsOption.d.ts +14 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/createColumnsSettingsOption.js +59 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/getEnabledColumnsInitialState.d.ts +3 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/getEnabledColumnsInitialState.js +26 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/index.d.ts +9 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/index.js +25 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/isColumnEnabledInitially.d.ts +6 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/isColumnEnabledInitially.js +13 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/isColumnVisibilityConfigurable.d.ts +6 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/isColumnVisibilityConfigurable.js +24 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/isFilterableColumn.d.ts +6 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/isFilterableColumn.js +12 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/mergeColumnOrderFromSettings.d.ts +5 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/mergeColumnOrderFromSettings.js +19 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/prepareColumnsSettings.d.ts +15 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/prepareColumnsSettings.js +37 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/prepareReorderableColumnsSettings.d.ts +21 -0
- package/dist/cjs/components/Table/hooks/useColumnSettings/utils/prepareReorderableColumnsSettings.js +16 -0
- package/dist/cjs/components/Table/hooks/useColumnSizes.d.ts +21 -0
- package/dist/cjs/components/Table/hooks/useColumnSizes.js +138 -0
- package/dist/cjs/components/Table/hooks/useColumnVirtualizer.d.ts +30 -0
- package/dist/cjs/components/Table/hooks/useColumnVirtualizer.js +33 -0
- package/dist/cjs/components/Table/hooks/useFilters/index.d.ts +1 -0
- package/dist/cjs/components/Table/hooks/useFilters/index.js +17 -0
- package/dist/cjs/components/Table/hooks/useFilters/useFilters.d.ts +11 -0
- package/dist/cjs/components/Table/hooks/useFilters/useFilters.js +40 -0
- package/dist/cjs/components/Table/hooks/useFilters/utils/getInitialColumnsFiltersOpenValue.d.ts +2 -0
- package/dist/cjs/components/Table/hooks/useFilters/utils/getInitialColumnsFiltersOpenValue.js +11 -0
- package/dist/cjs/components/Table/hooks/useFilters/utils/index.d.ts +1 -0
- package/dist/cjs/components/Table/hooks/useFilters/utils/index.js +17 -0
- package/dist/cjs/components/Table/hooks/useLoadingTable.d.ts +16 -0
- package/dist/cjs/components/Table/hooks/useLoadingTable.js +60 -0
- package/dist/cjs/components/Table/hooks/usePageReset.d.ts +10 -0
- package/dist/cjs/components/Table/hooks/usePageReset.js +15 -0
- package/dist/cjs/components/Table/hooks/useRowVirtualizer.d.ts +17 -0
- package/dist/cjs/components/Table/hooks/useRowVirtualizer.js +25 -0
- package/dist/cjs/components/Table/hooks/useStateControl.d.ts +8 -0
- package/dist/cjs/components/Table/hooks/useStateControl.js +16 -0
- package/dist/cjs/components/Table/hooks/useTableInstance.d.ts +126 -0
- package/dist/cjs/components/Table/hooks/useTableInstance.js +143 -0
- package/dist/cjs/components/Table/hooks/useTableScroll.d.ts +28 -0
- package/dist/cjs/components/Table/hooks/useTableScroll.js +114 -0
- package/dist/cjs/components/Table/hooks/useTableToolbar.d.ts +78 -0
- package/dist/cjs/components/Table/hooks/useTableToolbar.js +119 -0
- package/dist/cjs/components/Table/hooks/useTableView.d.ts +24 -0
- package/dist/cjs/components/Table/hooks/useTableView.js +23 -0
- package/dist/cjs/components/Table/index.d.ts +2 -0
- package/dist/cjs/components/Table/index.js +20 -0
- package/dist/cjs/components/Table/styles.module.css +578 -0
- package/dist/cjs/components/Table/utils/columnSize.d.ts +12 -0
- package/dist/cjs/components/Table/utils/columnSize.js +24 -0
- package/dist/cjs/components/Table/utils/getColumnIdentifier.d.ts +2 -0
- package/dist/cjs/components/Table/utils/getColumnIdentifier.js +9 -0
- package/dist/cjs/components/Table/utils/getColumnStyleVars.d.ts +4 -0
- package/dist/cjs/components/Table/utils/getColumnStyleVars.js +10 -0
- package/dist/cjs/components/Table/utils/getCurrentlyConfiguredHeaderWidth.d.ts +1 -0
- package/dist/cjs/components/Table/utils/getCurrentlyConfiguredHeaderWidth.js +20 -0
- package/dist/cjs/components/Table/utils/getPinnedGroups.d.ts +11 -0
- package/dist/cjs/components/Table/utils/getPinnedGroups.js +26 -0
- package/dist/cjs/components/Table/utils/getTableColumnsDefinitions.d.ts +18 -0
- package/dist/cjs/components/Table/utils/getTableColumnsDefinitions.js +27 -0
- package/dist/cjs/components/Table/utils/index.d.ts +8 -0
- package/dist/cjs/components/Table/utils/index.js +24 -0
- package/dist/cjs/components/Table/utils/isEveryArrayItemString.d.ts +1 -0
- package/dist/cjs/components/Table/utils/isEveryArrayItemString.js +5 -0
- package/dist/cjs/components/Table/utils/saveTableState/mappers.d.ts +18 -0
- package/dist/cjs/components/Table/utils/saveTableState/mappers.js +45 -0
- package/dist/cjs/components/Table/utils/saveTableState/validators.d.ts +5 -0
- package/dist/cjs/components/Table/utils/saveTableState/validators.js +24 -0
- package/dist/cjs/components/Table/utils/sortColumnDefinitions.d.ts +2 -0
- package/dist/cjs/components/Table/utils/sortColumnDefinitions.js +11 -0
- package/dist/cjs/components/index.d.ts +3 -0
- package/dist/cjs/components/index.js +19 -0
- package/dist/cjs/components/types.d.ts +395 -0
- package/dist/cjs/components/types.js +28 -0
- package/dist/cjs/constants.d.ts +113 -0
- package/dist/cjs/constants.js +117 -0
- package/dist/cjs/contexts/CellAutoResizeContext/CellAutoResizeContext.d.ts +2 -0
- package/dist/cjs/contexts/CellAutoResizeContext/CellAutoResizeContext.js +8 -0
- package/dist/cjs/contexts/CellAutoResizeContext/hooks/index.d.ts +2 -0
- package/dist/cjs/contexts/CellAutoResizeContext/hooks/index.js +18 -0
- package/dist/cjs/contexts/CellAutoResizeContext/hooks/useCellAutoResizeController.d.ts +6 -0
- package/dist/cjs/contexts/CellAutoResizeContext/hooks/useCellAutoResizeController.js +41 -0
- package/dist/cjs/contexts/CellAutoResizeContext/hooks/useCellResize.d.ts +4 -0
- package/dist/cjs/contexts/CellAutoResizeContext/hooks/useCellResize.js +23 -0
- package/dist/cjs/contexts/CellAutoResizeContext/index.d.ts +2 -0
- package/dist/cjs/contexts/CellAutoResizeContext/index.js +18 -0
- package/dist/cjs/contexts/CellAutoResizeContext/types.d.ts +15 -0
- package/dist/cjs/contexts/CellAutoResizeContext/types.js +2 -0
- package/dist/cjs/contexts/RowContext/RowContext.d.ts +10 -0
- package/dist/cjs/contexts/RowContext/RowContext.js +12 -0
- package/dist/cjs/contexts/RowContext/index.d.ts +1 -0
- package/dist/cjs/contexts/RowContext/index.js +17 -0
- package/dist/cjs/contexts/TableContext/TableContext.d.ts +28 -0
- package/dist/cjs/contexts/TableContext/TableContext.js +17 -0
- package/dist/cjs/contexts/TableContext/index.d.ts +1 -0
- package/dist/cjs/contexts/TableContext/index.js +17 -0
- package/dist/cjs/contexts/index.d.ts +4 -0
- package/dist/cjs/contexts/index.js +22 -0
- package/dist/cjs/helperComponents/Cells/BodyCell/BodyCell.d.ts +9 -0
- package/dist/cjs/helperComponents/Cells/BodyCell/BodyCell.js +33 -0
- package/dist/cjs/helperComponents/Cells/BodyCell/index.d.ts +1 -0
- package/dist/cjs/helperComponents/Cells/BodyCell/index.js +17 -0
- package/dist/cjs/helperComponents/Cells/BodyCell/styles.module.css +15 -0
- package/dist/cjs/helperComponents/Cells/Cell.d.ts +18 -0
- package/dist/cjs/helperComponents/Cells/Cell.js +11 -0
- package/dist/cjs/helperComponents/Cells/CopyCell/CopyCell.d.ts +4 -0
- package/dist/cjs/helperComponents/Cells/CopyCell/CopyCell.js +32 -0
- package/dist/cjs/helperComponents/Cells/CopyCell/index.d.ts +1 -0
- package/dist/cjs/helperComponents/Cells/CopyCell/index.js +17 -0
- package/dist/cjs/helperComponents/Cells/CopyCell/styles.module.css +39 -0
- package/dist/cjs/helperComponents/Cells/HeaderCell/HeaderCell.d.ts +11 -0
- package/dist/cjs/helperComponents/Cells/HeaderCell/HeaderCell.js +49 -0
- package/dist/cjs/helperComponents/Cells/HeaderCell/ResizeHandle.d.ts +8 -0
- package/dist/cjs/helperComponents/Cells/HeaderCell/ResizeHandle.js +41 -0
- package/dist/cjs/helperComponents/Cells/HeaderCell/helpers.d.ts +4 -0
- package/dist/cjs/helperComponents/Cells/HeaderCell/helpers.js +20 -0
- package/dist/cjs/helperComponents/Cells/HeaderCell/index.d.ts +1 -0
- package/dist/cjs/helperComponents/Cells/HeaderCell/index.js +17 -0
- package/dist/cjs/helperComponents/Cells/HeaderCell/styles.module.css +149 -0
- package/dist/cjs/helperComponents/Cells/RowActionsCell/RowActionsCell.d.ts +12 -0
- package/dist/cjs/helperComponents/Cells/RowActionsCell/RowActionsCell.js +63 -0
- package/dist/cjs/helperComponents/Cells/RowActionsCell/components/RowActionsButton.d.ts +8 -0
- package/dist/cjs/helperComponents/Cells/RowActionsCell/components/RowActionsButton.js +20 -0
- package/dist/cjs/helperComponents/Cells/RowActionsCell/components/index.d.ts +1 -0
- package/dist/cjs/helperComponents/Cells/RowActionsCell/components/index.js +17 -0
- package/dist/cjs/helperComponents/Cells/RowActionsCell/index.d.ts +1 -0
- package/dist/cjs/helperComponents/Cells/RowActionsCell/index.js +17 -0
- package/dist/cjs/helperComponents/Cells/RowActionsCell/styles.module.css +23 -0
- package/dist/cjs/helperComponents/Cells/SelectionCell/SelectionCell.d.ts +3 -0
- package/dist/cjs/helperComponents/Cells/SelectionCell/SelectionCell.js +92 -0
- package/dist/cjs/helperComponents/Cells/SelectionCell/index.d.ts +1 -0
- package/dist/cjs/helperComponents/Cells/SelectionCell/index.js +17 -0
- package/dist/cjs/helperComponents/Cells/SelectionCell/styles.module.css +15 -0
- package/dist/cjs/helperComponents/Cells/StatusCell/StatusCell.d.ts +39 -0
- package/dist/cjs/helperComponents/Cells/StatusCell/StatusCell.js +73 -0
- package/dist/cjs/helperComponents/Cells/StatusCell/constants.d.ts +13 -0
- package/dist/cjs/helperComponents/Cells/StatusCell/constants.js +18 -0
- package/dist/cjs/helperComponents/Cells/StatusCell/index.d.ts +1 -0
- package/dist/cjs/helperComponents/Cells/StatusCell/index.js +17 -0
- package/dist/cjs/helperComponents/Cells/StatusCell/styles.module.css +24 -0
- package/dist/cjs/helperComponents/Cells/StatusCell/types.d.ts +3 -0
- package/dist/cjs/helperComponents/Cells/StatusCell/types.js +2 -0
- package/dist/cjs/helperComponents/Cells/TreeCell/TreeCell.d.ts +40 -0
- package/dist/cjs/helperComponents/Cells/TreeCell/TreeCell.js +170 -0
- package/dist/cjs/helperComponents/Cells/TreeCell/TreeLine/TreeLine.d.ts +9 -0
- package/dist/cjs/helperComponents/Cells/TreeCell/TreeLine/TreeLine.js +12 -0
- package/dist/cjs/helperComponents/Cells/TreeCell/TreeLine/index.d.ts +1 -0
- package/dist/cjs/helperComponents/Cells/TreeCell/TreeLine/index.js +17 -0
- package/dist/cjs/helperComponents/Cells/TreeCell/TreeLine/styles.module.css +39 -0
- package/dist/cjs/helperComponents/Cells/TreeCell/constants.d.ts +1 -0
- package/dist/cjs/helperComponents/Cells/TreeCell/constants.js +4 -0
- package/dist/cjs/helperComponents/Cells/TreeCell/index.d.ts +1 -0
- package/dist/cjs/helperComponents/Cells/TreeCell/index.js +17 -0
- package/dist/cjs/helperComponents/Cells/TreeCell/rowHierarchicalSelection.d.ts +7 -0
- package/dist/cjs/helperComponents/Cells/TreeCell/rowHierarchicalSelection.js +41 -0
- package/dist/cjs/helperComponents/Cells/TreeCell/styles.module.css +112 -0
- package/dist/cjs/helperComponents/Cells/index.d.ts +8 -0
- package/dist/cjs/helperComponents/Cells/index.js +24 -0
- package/dist/cjs/helperComponents/Cells/styles.module.css +13 -0
- package/dist/cjs/helperComponents/ControlsChrome/ControlsChrome.d.ts +17 -0
- package/dist/cjs/helperComponents/ControlsChrome/ControlsChrome.js +31 -0
- package/dist/cjs/helperComponents/ControlsChrome/index.d.ts +1 -0
- package/dist/cjs/helperComponents/ControlsChrome/index.js +17 -0
- package/dist/cjs/helperComponents/ControlsChrome/styles.module.css +221 -0
- package/dist/cjs/helperComponents/LoadMoreButton/LoadMoreButton.d.ts +6 -0
- package/dist/cjs/helperComponents/LoadMoreButton/LoadMoreButton.js +18 -0
- package/dist/cjs/helperComponents/LoadMoreButton/index.d.ts +2 -0
- package/dist/cjs/helperComponents/LoadMoreButton/index.js +5 -0
- package/dist/cjs/helperComponents/LoadMoreButton/styles.module.css +6 -0
- package/dist/cjs/helperComponents/Rows/BodyRow.d.ts +20 -0
- package/dist/cjs/helperComponents/Rows/BodyRow.js +37 -0
- package/dist/cjs/helperComponents/Rows/HeaderRow.d.ts +10 -0
- package/dist/cjs/helperComponents/Rows/HeaderRow.js +27 -0
- package/dist/cjs/helperComponents/Rows/PinnedCells.d.ts +9 -0
- package/dist/cjs/helperComponents/Rows/PinnedCells.js +12 -0
- package/dist/cjs/helperComponents/Rows/Row.d.ts +12 -0
- package/dist/cjs/helperComponents/Rows/Row.js +23 -0
- package/dist/cjs/helperComponents/Rows/index.d.ts +2 -0
- package/dist/cjs/helperComponents/Rows/index.js +18 -0
- package/dist/cjs/helperComponents/Rows/styles.module.css +229 -0
- package/dist/cjs/helperComponents/TableCard/TableCard.d.ts +28 -0
- package/dist/cjs/helperComponents/TableCard/TableCard.js +80 -0
- package/dist/cjs/helperComponents/TableCard/index.d.ts +1 -0
- package/dist/cjs/helperComponents/TableCard/index.js +17 -0
- package/dist/cjs/helperComponents/TableCard/styles.module.css +63 -0
- package/dist/cjs/helperComponents/TableEmptyState/TableEmptyState.d.ts +13 -0
- package/dist/cjs/helperComponents/TableEmptyState/TableEmptyState.js +15 -0
- package/dist/cjs/helperComponents/TableEmptyState/hooks.d.ts +10 -0
- package/dist/cjs/helperComponents/TableEmptyState/hooks.js +34 -0
- package/dist/cjs/helperComponents/TableEmptyState/index.d.ts +2 -0
- package/dist/cjs/helperComponents/TableEmptyState/index.js +18 -0
- package/dist/cjs/helperComponents/TableEmptyState/styles.module.css +11 -0
- package/dist/cjs/helperComponents/TablePagination/TablePagination.d.ts +9 -0
- package/dist/cjs/helperComponents/TablePagination/TablePagination.js +34 -0
- package/dist/cjs/helperComponents/TablePagination/index.d.ts +1 -0
- package/dist/cjs/helperComponents/TablePagination/index.js +17 -0
- package/dist/cjs/helperComponents/TablePagination/styles.module.css +14 -0
- package/dist/cjs/helperComponents/index.d.ts +8 -0
- package/dist/cjs/helperComponents/index.js +24 -0
- package/dist/cjs/helperComponents/types.d.ts +7 -0
- package/dist/cjs/helperComponents/types.js +2 -0
- package/dist/cjs/helpers/getColumnId.d.ts +2 -0
- package/dist/cjs/helpers/getColumnId.js +12 -0
- package/dist/cjs/helpers/index.d.ts +9 -0
- package/dist/cjs/helpers/index.js +25 -0
- package/dist/cjs/helpers/masterSelection.d.ts +15 -0
- package/dist/cjs/helpers/masterSelection.js +31 -0
- package/dist/cjs/helpers/renderColumnsSettingsOverflowButton.d.ts +7 -0
- package/dist/cjs/helpers/renderColumnsSettingsOverflowButton.js +15 -0
- package/dist/cjs/helpers/renderExportToolbarButton.d.ts +8 -0
- package/dist/cjs/helpers/renderExportToolbarButton.js +24 -0
- package/dist/cjs/helpers/renderMasterSelectionToggle.d.ts +10 -0
- package/dist/cjs/helpers/renderMasterSelectionToggle.js +20 -0
- package/dist/cjs/helpers/renderTableSortingOverflowButton.d.ts +9 -0
- package/dist/cjs/helpers/renderTableSortingOverflowButton.js +20 -0
- package/dist/cjs/helpers/renderToolbarAfterOverflowButton.d.ts +9 -0
- package/dist/cjs/helpers/renderToolbarAfterOverflowButton.js +9 -0
- package/dist/cjs/helpers/rowSelectionState.d.ts +3 -0
- package/dist/cjs/helpers/rowSelectionState.js +13 -0
- package/dist/cjs/helpers/toolbarTooltipTrigger.module.css +5 -0
- package/dist/cjs/helpers/tryParseLocalStorage.d.ts +2 -0
- package/dist/cjs/helpers/tryParseLocalStorage.js +16 -0
- package/dist/cjs/hooks/index.d.ts +7 -0
- package/dist/cjs/hooks/index.js +23 -0
- package/dist/cjs/hooks/useCellSizes.d.ts +10 -0
- package/dist/cjs/hooks/useCellSizes.js +34 -0
- package/dist/cjs/hooks/useColumnsSettingsToolbarSlot/index.d.ts +1 -0
- package/dist/cjs/hooks/useColumnsSettingsToolbarSlot/index.js +17 -0
- package/dist/cjs/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.d.ts +17 -0
- package/dist/cjs/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.js +90 -0
- package/dist/cjs/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.module.css +13 -0
- package/dist/cjs/hooks/useExportToolbarSlot/index.d.ts +1 -0
- package/dist/cjs/hooks/useExportToolbarSlot/index.js +17 -0
- package/dist/cjs/hooks/useExportToolbarSlot/useExportToolbarSlot.d.ts +10 -0
- package/dist/cjs/hooks/useExportToolbarSlot/useExportToolbarSlot.js +22 -0
- package/dist/cjs/hooks/useHeaderGroups.d.ts +10 -0
- package/dist/cjs/hooks/useHeaderGroups.js +40 -0
- package/dist/cjs/hooks/useRowCells.d.ts +10 -0
- package/dist/cjs/hooks/useRowCells.js +31 -0
- package/dist/cjs/hooks/useTableSorting/index.d.ts +1 -0
- package/dist/cjs/hooks/useTableSorting/index.js +17 -0
- package/dist/cjs/hooks/useTableSorting/useTableSorting.d.ts +25 -0
- package/dist/cjs/hooks/useTableSorting/useTableSorting.js +197 -0
- package/dist/cjs/hooks/useTableSorting/useTableSorting.module.css +3 -0
- package/dist/cjs/hooks/useTableSorting/utils.d.ts +16 -0
- package/dist/cjs/hooks/useTableSorting/utils.js +82 -0
- package/dist/cjs/hooks/useTableSortingToolbarSlot/index.d.ts +1 -0
- package/dist/cjs/hooks/useTableSortingToolbarSlot/index.js +17 -0
- package/dist/cjs/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.d.ts +24 -0
- package/dist/cjs/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.js +57 -0
- package/dist/cjs/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.module.css +8 -0
- package/dist/cjs/index.d.ts +20 -0
- package/dist/cjs/index.js +51 -0
- package/dist/cjs/locale/index.d.ts +107 -0
- package/dist/cjs/locale/index.js +58 -0
- package/dist/cjs/package.json +3 -0
- 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/constants.d.ts +3 -0
- package/dist/cjs/presets/constants.js +6 -0
- package/dist/cjs/presets/entitiesTable/EntitiesTable.d.ts +9 -0
- package/dist/cjs/presets/entitiesTable/EntitiesTable.js +78 -0
- package/dist/cjs/presets/entitiesTable/constants.d.ts +1 -0
- package/dist/cjs/presets/entitiesTable/constants.js +4 -0
- package/dist/cjs/presets/entitiesTable/index.d.ts +7 -0
- package/dist/cjs/presets/entitiesTable/index.js +17 -0
- package/dist/cjs/presets/entitiesTable/toEntitiesTableProps.d.ts +13 -0
- package/dist/cjs/presets/entitiesTable/toEntitiesTableProps.js +58 -0
- package/dist/cjs/presets/entitiesTable/types.d.ts +55 -0
- package/dist/cjs/presets/entitiesTable/types.js +2 -0
- package/dist/cjs/presets/entitiesTable/useEntitiesTableProps.d.ts +13 -0
- package/dist/cjs/presets/entitiesTable/useEntitiesTableProps.js +9 -0
- package/dist/cjs/presets/entitiesTable/useEntitiesTableState.d.ts +3 -0
- package/dist/cjs/presets/entitiesTable/useEntitiesTableState.js +42 -0
- package/dist/cjs/presets/entitiesTable/utils.d.ts +9 -0
- package/dist/cjs/presets/entitiesTable/utils.js +24 -0
- package/dist/cjs/presets/index.d.ts +7 -0
- package/dist/cjs/presets/index.js +23 -0
- package/dist/cjs/presets/infiniteTable/InfiniteTable.d.ts +3 -0
- package/dist/cjs/presets/infiniteTable/InfiniteTable.js +11 -0
- package/dist/cjs/presets/infiniteTable/index.d.ts +5 -0
- package/dist/cjs/presets/infiniteTable/index.js +11 -0
- package/dist/cjs/presets/infiniteTable/toInfiniteTableProps.d.ts +11 -0
- package/dist/cjs/presets/infiniteTable/toInfiniteTableProps.js +20 -0
- package/dist/cjs/presets/infiniteTable/useInfiniteScrollRef.d.ts +17 -0
- package/dist/cjs/presets/infiniteTable/useInfiniteScrollRef.js +29 -0
- package/dist/cjs/presets/infiniteTable/useInfiniteTableProps.d.ts +4 -0
- package/dist/cjs/presets/infiniteTable/useInfiniteTableProps.js +26 -0
- package/dist/cjs/presets/serverAdminTable/ServerAdminTable.d.ts +4 -0
- package/dist/cjs/presets/serverAdminTable/ServerAdminTable.js +11 -0
- package/dist/cjs/presets/serverAdminTable/index.d.ts +4 -0
- package/dist/cjs/presets/serverAdminTable/index.js +9 -0
- package/dist/cjs/presets/serverAdminTable/toServerAdminTableProps.d.ts +13 -0
- package/dist/cjs/presets/serverAdminTable/toServerAdminTableProps.js +25 -0
- package/dist/cjs/presets/serverAdminTable/useServerAdminTableProps.d.ts +5 -0
- package/dist/cjs/presets/serverAdminTable/useServerAdminTableProps.js +25 -0
- package/dist/cjs/presets/serverSimpleTable/ServerSimpleTable.d.ts +3 -0
- package/dist/cjs/presets/serverSimpleTable/ServerSimpleTable.js +11 -0
- package/dist/cjs/presets/serverSimpleTable/index.d.ts +4 -0
- package/dist/cjs/presets/serverSimpleTable/index.js +9 -0
- package/dist/cjs/presets/serverSimpleTable/toServerSimpleTableProps.d.ts +13 -0
- package/dist/cjs/presets/serverSimpleTable/toServerSimpleTableProps.js +25 -0
- package/dist/cjs/presets/serverSimpleTable/useServerSimpleTableProps.d.ts +4 -0
- package/dist/cjs/presets/serverSimpleTable/useServerSimpleTableProps.js +21 -0
- package/dist/cjs/presets/simpleTable/SimpleTable.d.ts +3 -0
- package/dist/cjs/presets/simpleTable/SimpleTable.js +11 -0
- package/dist/cjs/presets/simpleTable/index.d.ts +4 -0
- package/dist/cjs/presets/simpleTable/index.js +9 -0
- package/dist/cjs/presets/simpleTable/toSimpleTableProps.d.ts +15 -0
- package/dist/cjs/presets/simpleTable/toSimpleTableProps.js +21 -0
- package/dist/cjs/presets/simpleTable/useSimpleTableProps.d.ts +4 -0
- package/dist/cjs/presets/simpleTable/useSimpleTableProps.js +21 -0
- package/dist/cjs/presets/treeTable/TreeTable.d.ts +3 -0
- package/dist/cjs/presets/treeTable/TreeTable.js +11 -0
- package/dist/cjs/presets/treeTable/index.d.ts +4 -0
- package/dist/cjs/presets/treeTable/index.js +9 -0
- package/dist/cjs/presets/treeTable/toTreeTableProps.d.ts +34 -0
- package/dist/cjs/presets/treeTable/toTreeTableProps.js +57 -0
- package/dist/cjs/presets/treeTable/useTreeTableProps.d.ts +4 -0
- package/dist/cjs/presets/treeTable/useTreeTableProps.js +18 -0
- package/dist/cjs/presets/wrapGetRowId.d.ts +2 -0
- package/dist/cjs/presets/wrapGetRowId.js +10 -0
- package/dist/cjs/style.css +1580 -0
- package/dist/cjs/types.d.ts +59 -0
- package/dist/cjs/types.js +2 -0
- package/dist/cjs/utils.d.ts +2 -0
- package/dist/cjs/utils.js +13 -0
- package/dist/esm/columnUtils/actionsColumn.d.ts +10 -0
- package/dist/esm/columnUtils/actionsColumn.js +5 -0
- package/dist/esm/columnUtils/defineColumns.d.ts +27 -0
- package/dist/esm/columnUtils/defineColumns.js +50 -0
- package/dist/esm/columnUtils/index.d.ts +8 -0
- package/dist/esm/columnUtils/index.js +4 -0
- package/dist/esm/columnUtils/mapCardViewProps.d.ts +25 -0
- package/dist/esm/columnUtils/mapCardViewProps.js +18 -0
- package/dist/esm/columnUtils/statusColumn.d.ts +18 -0
- package/dist/esm/columnUtils/statusColumn.js +22 -0
- package/dist/esm/components/ServerTable/ServerTable.d.ts +19 -0
- package/dist/esm/components/ServerTable/ServerTable.js +47 -0
- package/dist/esm/components/ServerTable/constants.d.ts +2 -0
- package/dist/esm/components/ServerTable/constants.js +2 -0
- package/dist/esm/components/ServerTable/index.d.ts +1 -0
- package/dist/esm/components/ServerTable/index.js +1 -0
- package/dist/esm/components/Table/Table.d.ts +23 -0
- package/dist/esm/components/Table/Table.js +329 -0
- package/dist/esm/components/Table/components/TableCardsBody/TableCardsBody.d.ts +39 -0
- package/dist/esm/components/Table/components/TableCardsBody/TableCardsBody.js +28 -0
- package/dist/esm/components/Table/components/TableCardsBody/index.d.ts +1 -0
- package/dist/esm/components/Table/components/TableCardsBody/index.js +1 -0
- package/dist/esm/components/Table/components/TableChrome/TableChrome.d.ts +10 -0
- package/dist/esm/components/Table/components/TableChrome/TableChrome.js +12 -0
- package/dist/esm/components/Table/components/TableChrome/index.d.ts +1 -0
- package/dist/esm/components/Table/components/TableChrome/index.js +1 -0
- package/dist/esm/components/Table/components/TableRowsBody/TableRowsBody.d.ts +21 -0
- package/dist/esm/components/Table/components/TableRowsBody/TableRowsBody.js +15 -0
- package/dist/esm/components/Table/components/TableRowsBody/index.d.ts +1 -0
- package/dist/esm/components/Table/components/TableRowsBody/index.js +1 -0
- package/dist/esm/components/Table/components/TableScrollHost/TableScrollHost.d.ts +21 -0
- package/dist/esm/components/Table/components/TableScrollHost/TableScrollHost.js +13 -0
- package/dist/esm/components/Table/components/TableScrollHost/index.d.ts +1 -0
- package/dist/esm/components/Table/components/TableScrollHost/index.js +1 -0
- package/dist/esm/components/Table/components/TableSkeletonBody/TableSkeletonBody.d.ts +23 -0
- package/dist/esm/components/Table/components/TableSkeletonBody/TableSkeletonBody.js +13 -0
- package/dist/esm/components/Table/components/TableSkeletonBody/index.d.ts +1 -0
- package/dist/esm/components/Table/components/TableSkeletonBody/index.js +1 -0
- package/dist/esm/components/Table/components/TableToolbar/TableToolbar.d.ts +26 -0
- package/dist/esm/components/Table/components/TableToolbar/TableToolbar.js +7 -0
- package/dist/esm/components/Table/components/TableToolbar/index.d.ts +1 -0
- package/dist/esm/components/Table/components/TableToolbar/index.js +1 -0
- package/dist/esm/components/Table/hooks/index.d.ts +13 -0
- package/dist/esm/components/Table/hooks/index.js +13 -0
- package/dist/esm/components/Table/hooks/loadingTableCells.d.ts +2 -0
- package/dist/esm/components/Table/hooks/loadingTableCells.js +53 -0
- package/dist/esm/components/Table/hooks/useColumnOrderByDrag/index.d.ts +1 -0
- package/dist/esm/components/Table/hooks/useColumnOrderByDrag/index.js +1 -0
- package/dist/esm/components/Table/hooks/useColumnOrderByDrag/useColumnOrderByDrag.d.ts +16 -0
- package/dist/esm/components/Table/hooks/useColumnOrderByDrag/useColumnOrderByDrag.js +79 -0
- package/dist/esm/components/Table/hooks/useColumnOrderByDrag/utils/prepareInitialState.d.ts +4 -0
- package/dist/esm/components/Table/hooks/useColumnOrderByDrag/utils/prepareInitialState.js +18 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/index.d.ts +1 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/index.js +1 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/useColumnSettings.d.ts +28 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/useColumnSettings.js +92 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/collectReorderLeafIds.d.ts +8 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/collectReorderLeafIds.js +10 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/createColumnsSettingsOption.d.ts +14 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/createColumnsSettingsOption.js +54 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/getEnabledColumnsInitialState.d.ts +3 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/getEnabledColumnsInitialState.js +23 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/index.d.ts +9 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/index.js +9 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/isColumnEnabledInitially.d.ts +6 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/isColumnEnabledInitially.js +10 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/isColumnVisibilityConfigurable.d.ts +6 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/isColumnVisibilityConfigurable.js +21 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/isFilterableColumn.d.ts +6 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/isFilterableColumn.js +9 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/mergeColumnOrderFromSettings.d.ts +5 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/mergeColumnOrderFromSettings.js +16 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/prepareColumnsSettings.d.ts +15 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/prepareColumnsSettings.js +34 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/prepareReorderableColumnsSettings.d.ts +21 -0
- package/dist/esm/components/Table/hooks/useColumnSettings/utils/prepareReorderableColumnsSettings.js +13 -0
- package/dist/esm/components/Table/hooks/useColumnSizes.d.ts +21 -0
- package/dist/esm/components/Table/hooks/useColumnSizes.js +135 -0
- package/dist/esm/components/Table/hooks/useColumnVirtualizer.d.ts +30 -0
- package/dist/esm/components/Table/hooks/useColumnVirtualizer.js +30 -0
- package/dist/esm/components/Table/hooks/useFilters/index.d.ts +1 -0
- package/dist/esm/components/Table/hooks/useFilters/index.js +1 -0
- package/dist/esm/components/Table/hooks/useFilters/useFilters.d.ts +11 -0
- package/dist/esm/components/Table/hooks/useFilters/useFilters.js +37 -0
- package/dist/esm/components/Table/hooks/useFilters/utils/getInitialColumnsFiltersOpenValue.d.ts +2 -0
- package/dist/esm/components/Table/hooks/useFilters/utils/getInitialColumnsFiltersOpenValue.js +8 -0
- package/dist/esm/components/Table/hooks/useFilters/utils/index.d.ts +1 -0
- package/dist/esm/components/Table/hooks/useFilters/utils/index.js +1 -0
- package/dist/esm/components/Table/hooks/useLoadingTable.d.ts +16 -0
- package/dist/esm/components/Table/hooks/useLoadingTable.js +57 -0
- package/dist/esm/components/Table/hooks/usePageReset.d.ts +10 -0
- package/dist/esm/components/Table/hooks/usePageReset.js +12 -0
- package/dist/esm/components/Table/hooks/useRowVirtualizer.d.ts +17 -0
- package/dist/esm/components/Table/hooks/useRowVirtualizer.js +22 -0
- package/dist/esm/components/Table/hooks/useStateControl.d.ts +8 -0
- package/dist/esm/components/Table/hooks/useStateControl.js +13 -0
- package/dist/esm/components/Table/hooks/useTableInstance.d.ts +126 -0
- package/dist/esm/components/Table/hooks/useTableInstance.js +138 -0
- package/dist/esm/components/Table/hooks/useTableScroll.d.ts +28 -0
- package/dist/esm/components/Table/hooks/useTableScroll.js +111 -0
- package/dist/esm/components/Table/hooks/useTableToolbar.d.ts +78 -0
- package/dist/esm/components/Table/hooks/useTableToolbar.js +116 -0
- package/dist/esm/components/Table/hooks/useTableView.d.ts +24 -0
- package/dist/esm/components/Table/hooks/useTableView.js +20 -0
- package/dist/esm/components/Table/index.d.ts +2 -0
- package/dist/esm/components/Table/index.js +2 -0
- package/dist/esm/components/Table/styles.module.css +578 -0
- package/dist/esm/components/Table/utils/columnSize.d.ts +12 -0
- package/dist/esm/components/Table/utils/columnSize.js +20 -0
- package/dist/esm/components/Table/utils/getColumnIdentifier.d.ts +2 -0
- package/dist/esm/components/Table/utils/getColumnIdentifier.js +6 -0
- package/dist/esm/components/Table/utils/getColumnStyleVars.d.ts +4 -0
- package/dist/esm/components/Table/utils/getColumnStyleVars.js +7 -0
- package/dist/esm/components/Table/utils/getCurrentlyConfiguredHeaderWidth.d.ts +1 -0
- package/dist/esm/components/Table/utils/getCurrentlyConfiguredHeaderWidth.js +17 -0
- package/dist/esm/components/Table/utils/getPinnedGroups.d.ts +11 -0
- package/dist/esm/components/Table/utils/getPinnedGroups.js +23 -0
- package/dist/esm/components/Table/utils/getTableColumnsDefinitions.d.ts +18 -0
- package/dist/esm/components/Table/utils/getTableColumnsDefinitions.js +24 -0
- package/dist/esm/components/Table/utils/index.d.ts +8 -0
- package/dist/esm/components/Table/utils/index.js +8 -0
- package/dist/esm/components/Table/utils/isEveryArrayItemString.d.ts +1 -0
- package/dist/esm/components/Table/utils/isEveryArrayItemString.js +1 -0
- package/dist/esm/components/Table/utils/saveTableState/mappers.d.ts +18 -0
- package/dist/esm/components/Table/utils/saveTableState/mappers.js +37 -0
- package/dist/esm/components/Table/utils/saveTableState/validators.d.ts +5 -0
- package/dist/esm/components/Table/utils/saveTableState/validators.js +18 -0
- package/dist/esm/components/Table/utils/sortColumnDefinitions.d.ts +2 -0
- package/dist/esm/components/Table/utils/sortColumnDefinitions.js +8 -0
- package/dist/esm/components/index.d.ts +3 -0
- package/dist/esm/components/index.js +3 -0
- package/dist/esm/components/types.d.ts +395 -0
- package/dist/esm/components/types.js +25 -0
- package/dist/esm/constants.d.ts +113 -0
- package/dist/esm/constants.js +114 -0
- package/dist/esm/contexts/CellAutoResizeContext/CellAutoResizeContext.d.ts +2 -0
- package/dist/esm/contexts/CellAutoResizeContext/CellAutoResizeContext.js +5 -0
- package/dist/esm/contexts/CellAutoResizeContext/hooks/index.d.ts +2 -0
- package/dist/esm/contexts/CellAutoResizeContext/hooks/index.js +2 -0
- package/dist/esm/contexts/CellAutoResizeContext/hooks/useCellAutoResizeController.d.ts +6 -0
- package/dist/esm/contexts/CellAutoResizeContext/hooks/useCellAutoResizeController.js +37 -0
- package/dist/esm/contexts/CellAutoResizeContext/hooks/useCellResize.d.ts +4 -0
- package/dist/esm/contexts/CellAutoResizeContext/hooks/useCellResize.js +19 -0
- package/dist/esm/contexts/CellAutoResizeContext/index.d.ts +2 -0
- package/dist/esm/contexts/CellAutoResizeContext/index.js +2 -0
- package/dist/esm/contexts/CellAutoResizeContext/types.d.ts +15 -0
- package/dist/esm/contexts/CellAutoResizeContext/types.js +1 -0
- package/dist/esm/contexts/RowContext/RowContext.d.ts +10 -0
- package/dist/esm/contexts/RowContext/RowContext.js +8 -0
- package/dist/esm/contexts/RowContext/index.d.ts +1 -0
- package/dist/esm/contexts/RowContext/index.js +1 -0
- package/dist/esm/contexts/TableContext/TableContext.d.ts +28 -0
- package/dist/esm/contexts/TableContext/TableContext.js +13 -0
- package/dist/esm/contexts/TableContext/index.d.ts +1 -0
- package/dist/esm/contexts/TableContext/index.js +1 -0
- package/dist/esm/contexts/index.d.ts +4 -0
- package/dist/esm/contexts/index.js +4 -0
- package/dist/esm/helperComponents/Cells/BodyCell/BodyCell.d.ts +9 -0
- package/dist/esm/helperComponents/Cells/BodyCell/BodyCell.js +27 -0
- package/dist/esm/helperComponents/Cells/BodyCell/index.d.ts +1 -0
- package/dist/esm/helperComponents/Cells/BodyCell/index.js +1 -0
- package/dist/esm/helperComponents/Cells/BodyCell/styles.module.css +15 -0
- package/dist/esm/helperComponents/Cells/Cell.d.ts +18 -0
- package/dist/esm/helperComponents/Cells/Cell.js +5 -0
- package/dist/esm/helperComponents/Cells/CopyCell/CopyCell.d.ts +4 -0
- package/dist/esm/helperComponents/Cells/CopyCell/CopyCell.js +26 -0
- package/dist/esm/helperComponents/Cells/CopyCell/index.d.ts +1 -0
- package/dist/esm/helperComponents/Cells/CopyCell/index.js +1 -0
- package/dist/esm/helperComponents/Cells/CopyCell/styles.module.css +39 -0
- package/dist/esm/helperComponents/Cells/HeaderCell/HeaderCell.d.ts +11 -0
- package/dist/esm/helperComponents/Cells/HeaderCell/HeaderCell.js +43 -0
- package/dist/esm/helperComponents/Cells/HeaderCell/ResizeHandle.d.ts +8 -0
- package/dist/esm/helperComponents/Cells/HeaderCell/ResizeHandle.js +35 -0
- package/dist/esm/helperComponents/Cells/HeaderCell/helpers.d.ts +4 -0
- package/dist/esm/helperComponents/Cells/HeaderCell/helpers.js +15 -0
- package/dist/esm/helperComponents/Cells/HeaderCell/index.d.ts +1 -0
- package/dist/esm/helperComponents/Cells/HeaderCell/index.js +1 -0
- package/dist/esm/helperComponents/Cells/HeaderCell/styles.module.css +149 -0
- package/dist/esm/helperComponents/Cells/RowActionsCell/RowActionsCell.d.ts +12 -0
- package/dist/esm/helperComponents/Cells/RowActionsCell/RowActionsCell.js +57 -0
- package/dist/esm/helperComponents/Cells/RowActionsCell/components/RowActionsButton.d.ts +8 -0
- package/dist/esm/helperComponents/Cells/RowActionsCell/components/RowActionsButton.js +17 -0
- package/dist/esm/helperComponents/Cells/RowActionsCell/components/index.d.ts +1 -0
- package/dist/esm/helperComponents/Cells/RowActionsCell/components/index.js +1 -0
- package/dist/esm/helperComponents/Cells/RowActionsCell/index.d.ts +1 -0
- package/dist/esm/helperComponents/Cells/RowActionsCell/index.js +1 -0
- package/dist/esm/helperComponents/Cells/RowActionsCell/styles.module.css +23 -0
- package/dist/esm/helperComponents/Cells/SelectionCell/SelectionCell.d.ts +3 -0
- package/dist/esm/helperComponents/Cells/SelectionCell/SelectionCell.js +86 -0
- package/dist/esm/helperComponents/Cells/SelectionCell/index.d.ts +1 -0
- package/dist/esm/helperComponents/Cells/SelectionCell/index.js +1 -0
- package/dist/esm/helperComponents/Cells/SelectionCell/styles.module.css +15 -0
- package/dist/esm/helperComponents/Cells/StatusCell/StatusCell.d.ts +39 -0
- package/dist/esm/helperComponents/Cells/StatusCell/StatusCell.js +66 -0
- package/dist/esm/helperComponents/Cells/StatusCell/constants.d.ts +13 -0
- package/dist/esm/helperComponents/Cells/StatusCell/constants.js +15 -0
- package/dist/esm/helperComponents/Cells/StatusCell/index.d.ts +1 -0
- package/dist/esm/helperComponents/Cells/StatusCell/index.js +1 -0
- package/dist/esm/helperComponents/Cells/StatusCell/styles.module.css +24 -0
- package/dist/esm/helperComponents/Cells/StatusCell/types.d.ts +3 -0
- package/dist/esm/helperComponents/Cells/StatusCell/types.js +1 -0
- package/dist/esm/helperComponents/Cells/TreeCell/TreeCell.d.ts +40 -0
- package/dist/esm/helperComponents/Cells/TreeCell/TreeCell.js +163 -0
- package/dist/esm/helperComponents/Cells/TreeCell/TreeLine/TreeLine.d.ts +9 -0
- package/dist/esm/helperComponents/Cells/TreeCell/TreeLine/TreeLine.js +6 -0
- package/dist/esm/helperComponents/Cells/TreeCell/TreeLine/index.d.ts +1 -0
- package/dist/esm/helperComponents/Cells/TreeCell/TreeLine/index.js +1 -0
- package/dist/esm/helperComponents/Cells/TreeCell/TreeLine/styles.module.css +39 -0
- package/dist/esm/helperComponents/Cells/TreeCell/constants.d.ts +1 -0
- package/dist/esm/helperComponents/Cells/TreeCell/constants.js +1 -0
- package/dist/esm/helperComponents/Cells/TreeCell/index.d.ts +1 -0
- package/dist/esm/helperComponents/Cells/TreeCell/index.js +1 -0
- package/dist/esm/helperComponents/Cells/TreeCell/rowHierarchicalSelection.d.ts +7 -0
- package/dist/esm/helperComponents/Cells/TreeCell/rowHierarchicalSelection.js +38 -0
- package/dist/esm/helperComponents/Cells/TreeCell/styles.module.css +112 -0
- package/dist/esm/helperComponents/Cells/index.d.ts +8 -0
- package/dist/esm/helperComponents/Cells/index.js +8 -0
- package/dist/esm/helperComponents/Cells/styles.module.css +13 -0
- package/dist/esm/helperComponents/ControlsChrome/ControlsChrome.d.ts +17 -0
- package/dist/esm/helperComponents/ControlsChrome/ControlsChrome.js +23 -0
- package/dist/esm/helperComponents/ControlsChrome/index.d.ts +1 -0
- package/dist/esm/helperComponents/ControlsChrome/index.js +1 -0
- package/dist/esm/helperComponents/ControlsChrome/styles.module.css +221 -0
- package/dist/esm/helperComponents/LoadMoreButton/LoadMoreButton.d.ts +6 -0
- package/dist/esm/helperComponents/LoadMoreButton/LoadMoreButton.js +12 -0
- package/dist/esm/helperComponents/LoadMoreButton/index.d.ts +2 -0
- package/dist/esm/helperComponents/LoadMoreButton/index.js +1 -0
- package/dist/esm/helperComponents/LoadMoreButton/styles.module.css +6 -0
- package/dist/esm/helperComponents/Rows/BodyRow.d.ts +20 -0
- package/dist/esm/helperComponents/Rows/BodyRow.js +31 -0
- package/dist/esm/helperComponents/Rows/HeaderRow.d.ts +10 -0
- package/dist/esm/helperComponents/Rows/HeaderRow.js +21 -0
- package/dist/esm/helperComponents/Rows/PinnedCells.d.ts +9 -0
- package/dist/esm/helperComponents/Rows/PinnedCells.js +6 -0
- package/dist/esm/helperComponents/Rows/Row.d.ts +12 -0
- package/dist/esm/helperComponents/Rows/Row.js +17 -0
- package/dist/esm/helperComponents/Rows/index.d.ts +2 -0
- package/dist/esm/helperComponents/Rows/index.js +2 -0
- package/dist/esm/helperComponents/Rows/styles.module.css +229 -0
- package/dist/esm/helperComponents/TableCard/TableCard.d.ts +28 -0
- package/dist/esm/helperComponents/TableCard/TableCard.js +74 -0
- package/dist/esm/helperComponents/TableCard/index.d.ts +1 -0
- package/dist/esm/helperComponents/TableCard/index.js +1 -0
- package/dist/esm/helperComponents/TableCard/styles.module.css +63 -0
- package/dist/esm/helperComponents/TableEmptyState/TableEmptyState.d.ts +13 -0
- package/dist/esm/helperComponents/TableEmptyState/TableEmptyState.js +9 -0
- package/dist/esm/helperComponents/TableEmptyState/hooks.d.ts +10 -0
- package/dist/esm/helperComponents/TableEmptyState/hooks.js +31 -0
- package/dist/esm/helperComponents/TableEmptyState/index.d.ts +2 -0
- package/dist/esm/helperComponents/TableEmptyState/index.js +2 -0
- package/dist/esm/helperComponents/TableEmptyState/styles.module.css +11 -0
- package/dist/esm/helperComponents/TablePagination/TablePagination.d.ts +9 -0
- package/dist/esm/helperComponents/TablePagination/TablePagination.js +28 -0
- package/dist/esm/helperComponents/TablePagination/index.d.ts +1 -0
- package/dist/esm/helperComponents/TablePagination/index.js +1 -0
- package/dist/esm/helperComponents/TablePagination/styles.module.css +14 -0
- package/dist/esm/helperComponents/index.d.ts +8 -0
- package/dist/esm/helperComponents/index.js +8 -0
- package/dist/esm/helperComponents/types.d.ts +7 -0
- package/dist/esm/helperComponents/types.js +1 -0
- package/dist/esm/helpers/getColumnId.d.ts +2 -0
- package/dist/esm/helpers/getColumnId.js +9 -0
- package/dist/esm/helpers/index.d.ts +9 -0
- package/dist/esm/helpers/index.js +9 -0
- package/dist/esm/helpers/masterSelection.d.ts +15 -0
- package/dist/esm/helpers/masterSelection.js +26 -0
- package/dist/esm/helpers/renderColumnsSettingsOverflowButton.d.ts +7 -0
- package/dist/esm/helpers/renderColumnsSettingsOverflowButton.js +12 -0
- package/dist/esm/helpers/renderExportToolbarButton.d.ts +8 -0
- package/dist/esm/helpers/renderExportToolbarButton.js +18 -0
- package/dist/esm/helpers/renderMasterSelectionToggle.d.ts +10 -0
- package/dist/esm/helpers/renderMasterSelectionToggle.js +17 -0
- package/dist/esm/helpers/renderTableSortingOverflowButton.d.ts +9 -0
- package/dist/esm/helpers/renderTableSortingOverflowButton.js +17 -0
- package/dist/esm/helpers/renderToolbarAfterOverflowButton.d.ts +9 -0
- package/dist/esm/helpers/renderToolbarAfterOverflowButton.js +6 -0
- package/dist/esm/helpers/rowSelectionState.d.ts +3 -0
- package/dist/esm/helpers/rowSelectionState.js +9 -0
- package/dist/esm/helpers/toolbarTooltipTrigger.module.css +5 -0
- package/dist/esm/helpers/tryParseLocalStorage.d.ts +2 -0
- package/dist/esm/helpers/tryParseLocalStorage.js +13 -0
- package/dist/esm/hooks/index.d.ts +7 -0
- package/dist/esm/hooks/index.js +7 -0
- package/dist/esm/hooks/useCellSizes.d.ts +10 -0
- package/dist/esm/hooks/useCellSizes.js +31 -0
- package/dist/esm/hooks/useColumnsSettingsToolbarSlot/index.d.ts +1 -0
- package/dist/esm/hooks/useColumnsSettingsToolbarSlot/index.js +1 -0
- package/dist/esm/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.d.ts +17 -0
- package/dist/esm/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.js +84 -0
- package/dist/esm/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.module.css +13 -0
- package/dist/esm/hooks/useExportToolbarSlot/index.d.ts +1 -0
- package/dist/esm/hooks/useExportToolbarSlot/index.js +1 -0
- package/dist/esm/hooks/useExportToolbarSlot/useExportToolbarSlot.d.ts +10 -0
- package/dist/esm/hooks/useExportToolbarSlot/useExportToolbarSlot.js +19 -0
- package/dist/esm/hooks/useHeaderGroups.d.ts +10 -0
- package/dist/esm/hooks/useHeaderGroups.js +37 -0
- package/dist/esm/hooks/useRowCells.d.ts +10 -0
- package/dist/esm/hooks/useRowCells.js +28 -0
- package/dist/esm/hooks/useTableSorting/index.d.ts +1 -0
- package/dist/esm/hooks/useTableSorting/index.js +1 -0
- package/dist/esm/hooks/useTableSorting/useTableSorting.d.ts +25 -0
- package/dist/esm/hooks/useTableSorting/useTableSorting.js +191 -0
- package/dist/esm/hooks/useTableSorting/useTableSorting.module.css +3 -0
- package/dist/esm/hooks/useTableSorting/utils.d.ts +16 -0
- package/dist/esm/hooks/useTableSorting/utils.js +77 -0
- package/dist/esm/hooks/useTableSortingToolbarSlot/index.d.ts +1 -0
- package/dist/esm/hooks/useTableSortingToolbarSlot/index.js +1 -0
- package/dist/esm/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.d.ts +24 -0
- package/dist/esm/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.js +51 -0
- package/dist/esm/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.module.css +8 -0
- package/dist/esm/index.d.ts +20 -0
- package/dist/esm/index.js +15 -0
- package/dist/esm/locale/index.d.ts +107 -0
- package/dist/esm/locale/index.js +55 -0
- 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/constants.d.ts +3 -0
- package/dist/esm/presets/constants.js +3 -0
- package/dist/esm/presets/entitiesTable/EntitiesTable.d.ts +9 -0
- package/dist/esm/presets/entitiesTable/EntitiesTable.js +75 -0
- package/dist/esm/presets/entitiesTable/constants.d.ts +1 -0
- package/dist/esm/presets/entitiesTable/constants.js +1 -0
- package/dist/esm/presets/entitiesTable/index.d.ts +7 -0
- package/dist/esm/presets/entitiesTable/index.js +6 -0
- package/dist/esm/presets/entitiesTable/toEntitiesTableProps.d.ts +13 -0
- package/dist/esm/presets/entitiesTable/toEntitiesTableProps.js +55 -0
- package/dist/esm/presets/entitiesTable/types.d.ts +55 -0
- package/dist/esm/presets/entitiesTable/types.js +1 -0
- package/dist/esm/presets/entitiesTable/useEntitiesTableProps.d.ts +13 -0
- package/dist/esm/presets/entitiesTable/useEntitiesTableProps.js +6 -0
- package/dist/esm/presets/entitiesTable/useEntitiesTableState.d.ts +3 -0
- package/dist/esm/presets/entitiesTable/useEntitiesTableState.js +39 -0
- package/dist/esm/presets/entitiesTable/utils.d.ts +9 -0
- package/dist/esm/presets/entitiesTable/utils.js +19 -0
- package/dist/esm/presets/index.d.ts +7 -0
- package/dist/esm/presets/index.js +7 -0
- package/dist/esm/presets/infiniteTable/InfiniteTable.d.ts +3 -0
- package/dist/esm/presets/infiniteTable/InfiniteTable.js +8 -0
- package/dist/esm/presets/infiniteTable/index.d.ts +5 -0
- package/dist/esm/presets/infiniteTable/index.js +4 -0
- package/dist/esm/presets/infiniteTable/toInfiniteTableProps.d.ts +11 -0
- package/dist/esm/presets/infiniteTable/toInfiniteTableProps.js +17 -0
- package/dist/esm/presets/infiniteTable/useInfiniteScrollRef.d.ts +17 -0
- package/dist/esm/presets/infiniteTable/useInfiniteScrollRef.js +26 -0
- package/dist/esm/presets/infiniteTable/useInfiniteTableProps.d.ts +4 -0
- package/dist/esm/presets/infiniteTable/useInfiniteTableProps.js +23 -0
- package/dist/esm/presets/serverAdminTable/ServerAdminTable.d.ts +4 -0
- package/dist/esm/presets/serverAdminTable/ServerAdminTable.js +8 -0
- package/dist/esm/presets/serverAdminTable/index.d.ts +4 -0
- package/dist/esm/presets/serverAdminTable/index.js +3 -0
- package/dist/esm/presets/serverAdminTable/toServerAdminTableProps.d.ts +13 -0
- package/dist/esm/presets/serverAdminTable/toServerAdminTableProps.js +22 -0
- package/dist/esm/presets/serverAdminTable/useServerAdminTableProps.d.ts +5 -0
- package/dist/esm/presets/serverAdminTable/useServerAdminTableProps.js +22 -0
- package/dist/esm/presets/serverSimpleTable/ServerSimpleTable.d.ts +3 -0
- package/dist/esm/presets/serverSimpleTable/ServerSimpleTable.js +8 -0
- package/dist/esm/presets/serverSimpleTable/index.d.ts +4 -0
- package/dist/esm/presets/serverSimpleTable/index.js +3 -0
- package/dist/esm/presets/serverSimpleTable/toServerSimpleTableProps.d.ts +13 -0
- package/dist/esm/presets/serverSimpleTable/toServerSimpleTableProps.js +22 -0
- package/dist/esm/presets/serverSimpleTable/useServerSimpleTableProps.d.ts +4 -0
- package/dist/esm/presets/serverSimpleTable/useServerSimpleTableProps.js +18 -0
- package/dist/esm/presets/simpleTable/SimpleTable.d.ts +3 -0
- package/dist/esm/presets/simpleTable/SimpleTable.js +8 -0
- package/dist/esm/presets/simpleTable/index.d.ts +4 -0
- package/dist/esm/presets/simpleTable/index.js +3 -0
- package/dist/esm/presets/simpleTable/toSimpleTableProps.d.ts +15 -0
- package/dist/esm/presets/simpleTable/toSimpleTableProps.js +18 -0
- package/dist/esm/presets/simpleTable/useSimpleTableProps.d.ts +4 -0
- package/dist/esm/presets/simpleTable/useSimpleTableProps.js +18 -0
- package/dist/esm/presets/treeTable/TreeTable.d.ts +3 -0
- package/dist/esm/presets/treeTable/TreeTable.js +8 -0
- package/dist/esm/presets/treeTable/index.d.ts +4 -0
- package/dist/esm/presets/treeTable/index.js +3 -0
- package/dist/esm/presets/treeTable/toTreeTableProps.d.ts +34 -0
- package/dist/esm/presets/treeTable/toTreeTableProps.js +54 -0
- package/dist/esm/presets/treeTable/useTreeTableProps.d.ts +4 -0
- package/dist/esm/presets/treeTable/useTreeTableProps.js +15 -0
- package/dist/esm/presets/wrapGetRowId.d.ts +2 -0
- package/dist/esm/presets/wrapGetRowId.js +7 -0
- package/dist/esm/style.css +1580 -0
- package/dist/esm/types.d.ts +59 -0
- package/dist/esm/types.js +1 -0
- package/dist/esm/utils.d.ts +2 -0
- package/dist/esm/utils.js +9 -0
- package/dist/tsconfig.cjs.tsbuildinfo +1 -0
- package/dist/tsconfig.esm.tsbuildinfo +1 -0
- package/package.json +74 -0
- package/src/columnUtils/actionsColumn.ts +17 -0
- package/src/columnUtils/defineColumns.ts +79 -0
- package/src/columnUtils/index.ts +8 -0
- package/src/columnUtils/mapCardViewProps.ts +51 -0
- package/src/columnUtils/statusColumn.ts +47 -0
- package/src/components/ServerTable/ServerTable.tsx +94 -0
- package/src/components/ServerTable/constants.ts +3 -0
- package/src/components/ServerTable/index.ts +1 -0
- package/src/components/Table/STRUCTURE.md +119 -0
- package/src/components/Table/Table.tsx +756 -0
- package/src/components/Table/components/TableCardsBody/TableCardsBody.tsx +117 -0
- package/src/components/Table/components/TableCardsBody/index.ts +1 -0
- package/src/components/Table/components/TableChrome/TableChrome.tsx +32 -0
- package/src/components/Table/components/TableChrome/index.ts +1 -0
- package/src/components/Table/components/TableRowsBody/TableRowsBody.tsx +118 -0
- package/src/components/Table/components/TableRowsBody/index.ts +1 -0
- package/src/components/Table/components/TableScrollHost/TableScrollHost.tsx +92 -0
- package/src/components/Table/components/TableScrollHost/index.ts +1 -0
- package/src/components/Table/components/TableSkeletonBody/TableSkeletonBody.tsx +82 -0
- package/src/components/Table/components/TableSkeletonBody/index.ts +1 -0
- package/src/components/Table/components/TableToolbar/TableToolbar.tsx +72 -0
- package/src/components/Table/components/TableToolbar/index.ts +1 -0
- package/src/components/Table/hooks/index.ts +13 -0
- package/src/components/Table/hooks/loadingTableCells.tsx +109 -0
- package/src/components/Table/hooks/useColumnOrderByDrag/index.ts +1 -0
- package/src/components/Table/hooks/useColumnOrderByDrag/useColumnOrderByDrag.ts +135 -0
- package/src/components/Table/hooks/useColumnOrderByDrag/utils/prepareInitialState.ts +30 -0
- package/src/components/Table/hooks/useColumnSettings/index.ts +1 -0
- package/src/components/Table/hooks/useColumnSettings/useColumnSettings.ts +174 -0
- package/src/components/Table/hooks/useColumnSettings/utils/collectReorderLeafIds.ts +11 -0
- package/src/components/Table/hooks/useColumnSettings/utils/createColumnsSettingsOption.ts +75 -0
- package/src/components/Table/hooks/useColumnSettings/utils/getEnabledColumnsInitialState.ts +36 -0
- package/src/components/Table/hooks/useColumnSettings/utils/index.ts +9 -0
- package/src/components/Table/hooks/useColumnSettings/utils/isColumnEnabledInitially.ts +13 -0
- package/src/components/Table/hooks/useColumnSettings/utils/isColumnVisibilityConfigurable.ts +26 -0
- package/src/components/Table/hooks/useColumnSettings/utils/isFilterableColumn.ts +15 -0
- package/src/components/Table/hooks/useColumnSettings/utils/mergeColumnOrderFromSettings.ts +19 -0
- package/src/components/Table/hooks/useColumnSettings/utils/prepareColumnsSettings.ts +53 -0
- package/src/components/Table/hooks/useColumnSettings/utils/prepareReorderableColumnsSettings.ts +34 -0
- package/src/components/Table/hooks/useColumnSizes.ts +190 -0
- package/src/components/Table/hooks/useColumnVirtualizer.ts +69 -0
- package/src/components/Table/hooks/useFilters/index.ts +1 -0
- package/src/components/Table/hooks/useFilters/useFilters.ts +67 -0
- package/src/components/Table/hooks/useFilters/utils/getInitialColumnsFiltersOpenValue.ts +13 -0
- package/src/components/Table/hooks/useFilters/utils/index.ts +1 -0
- package/src/components/Table/hooks/useLoadingTable.tsx +86 -0
- package/src/components/Table/hooks/usePageReset.ts +30 -0
- package/src/components/Table/hooks/useRowVirtualizer.ts +37 -0
- package/src/components/Table/hooks/useStateControl.ts +29 -0
- package/src/components/Table/hooks/useTableInstance.tsx +271 -0
- package/src/components/Table/hooks/useTableScroll.ts +176 -0
- package/src/components/Table/hooks/useTableToolbar.ts +265 -0
- package/src/components/Table/hooks/useTableView.ts +42 -0
- package/src/components/Table/index.ts +2 -0
- package/src/components/Table/styles.module.scss +510 -0
- package/src/components/Table/utils/columnSize.ts +44 -0
- package/src/components/Table/utils/getColumnIdentifier.ts +9 -0
- package/src/components/Table/utils/getColumnStyleVars.ts +11 -0
- package/src/components/Table/utils/getCurrentlyConfiguredHeaderWidth.ts +24 -0
- package/src/components/Table/utils/getPinnedGroups.ts +37 -0
- package/src/components/Table/utils/getTableColumnsDefinitions.ts +47 -0
- package/src/components/Table/utils/index.ts +8 -0
- package/src/components/Table/utils/isEveryArrayItemString.ts +2 -0
- package/src/components/Table/utils/saveTableState/mappers.ts +62 -0
- package/src/components/Table/utils/saveTableState/validators.ts +33 -0
- package/src/components/Table/utils/sortColumnDefinitions.ts +14 -0
- package/src/components/index.ts +3 -0
- package/src/components/types.ts +450 -0
- package/src/constants.ts +131 -0
- package/src/contexts/CellAutoResizeContext/CellAutoResizeContext.ts +8 -0
- package/src/contexts/CellAutoResizeContext/hooks/index.ts +2 -0
- package/src/contexts/CellAutoResizeContext/hooks/useCellAutoResizeController.ts +52 -0
- package/src/contexts/CellAutoResizeContext/hooks/useCellResize.ts +25 -0
- package/src/contexts/CellAutoResizeContext/index.ts +2 -0
- package/src/contexts/CellAutoResizeContext/types.ts +22 -0
- package/src/contexts/RowContext/RowContext.ts +17 -0
- package/src/contexts/RowContext/index.ts +1 -0
- package/src/contexts/TableContext/TableContext.ts +39 -0
- package/src/contexts/TableContext/index.ts +1 -0
- package/src/contexts/index.ts +4 -0
- package/src/helperComponents/Cells/BodyCell/BodyCell.tsx +68 -0
- package/src/helperComponents/Cells/BodyCell/index.ts +1 -0
- package/src/helperComponents/Cells/BodyCell/styles.module.scss +26 -0
- package/src/helperComponents/Cells/Cell.tsx +30 -0
- package/src/helperComponents/Cells/CopyCell/CopyCell.tsx +53 -0
- package/src/helperComponents/Cells/CopyCell/index.ts +1 -0
- package/src/helperComponents/Cells/CopyCell/styles.module.scss +53 -0
- package/src/helperComponents/Cells/HeaderCell/HeaderCell.tsx +109 -0
- package/src/helperComponents/Cells/HeaderCell/ResizeHandle.tsx +73 -0
- package/src/helperComponents/Cells/HeaderCell/helpers.tsx +18 -0
- package/src/helperComponents/Cells/HeaderCell/index.ts +1 -0
- package/src/helperComponents/Cells/HeaderCell/styles.module.scss +192 -0
- package/src/helperComponents/Cells/RowActionsCell/RowActionsCell.tsx +111 -0
- package/src/helperComponents/Cells/RowActionsCell/components/RowActionsButton.tsx +36 -0
- package/src/helperComponents/Cells/RowActionsCell/components/index.ts +1 -0
- package/src/helperComponents/Cells/RowActionsCell/index.ts +1 -0
- package/src/helperComponents/Cells/RowActionsCell/styles.module.scss +29 -0
- package/src/helperComponents/Cells/SelectionCell/SelectionCell.tsx +115 -0
- package/src/helperComponents/Cells/SelectionCell/index.ts +1 -0
- package/src/helperComponents/Cells/SelectionCell/styles.module.scss +39 -0
- package/src/helperComponents/Cells/StatusCell/StatusCell.tsx +157 -0
- package/src/helperComponents/Cells/StatusCell/constants.ts +16 -0
- package/src/helperComponents/Cells/StatusCell/index.ts +1 -0
- package/src/helperComponents/Cells/StatusCell/styles.module.scss +35 -0
- package/src/helperComponents/Cells/StatusCell/types.ts +5 -0
- package/src/helperComponents/Cells/TreeCell/TreeCell.tsx +374 -0
- package/src/helperComponents/Cells/TreeCell/TreeLine/TreeLine.tsx +24 -0
- package/src/helperComponents/Cells/TreeCell/TreeLine/index.ts +1 -0
- package/src/helperComponents/Cells/TreeCell/TreeLine/styles.module.scss +68 -0
- package/src/helperComponents/Cells/TreeCell/constants.ts +1 -0
- package/src/helperComponents/Cells/TreeCell/index.ts +1 -0
- package/src/helperComponents/Cells/TreeCell/rowHierarchicalSelection.ts +51 -0
- package/src/helperComponents/Cells/TreeCell/styles.module.scss +194 -0
- package/src/helperComponents/Cells/index.ts +8 -0
- package/src/helperComponents/Cells/styles.module.scss +13 -0
- package/src/helperComponents/ControlsChrome/ControlsChrome.tsx +51 -0
- package/src/helperComponents/ControlsChrome/index.ts +1 -0
- package/src/helperComponents/ControlsChrome/styles.module.scss +25 -0
- package/src/helperComponents/LoadMoreButton/LoadMoreButton.tsx +34 -0
- package/src/helperComponents/LoadMoreButton/index.ts +2 -0
- package/src/helperComponents/LoadMoreButton/styles.module.scss +9 -0
- package/src/helperComponents/Rows/BodyRow.tsx +117 -0
- package/src/helperComponents/Rows/HeaderRow.tsx +102 -0
- package/src/helperComponents/Rows/PinnedCells.tsx +18 -0
- package/src/helperComponents/Rows/Row.tsx +46 -0
- package/src/helperComponents/Rows/index.ts +2 -0
- package/src/helperComponents/Rows/styles.module.scss +314 -0
- package/src/helperComponents/TableCard/TableCard.tsx +167 -0
- package/src/helperComponents/TableCard/index.ts +1 -0
- package/src/helperComponents/TableCard/styles.module.scss +67 -0
- package/src/helperComponents/TableEmptyState/TableEmptyState.tsx +30 -0
- package/src/helperComponents/TableEmptyState/hooks.ts +50 -0
- package/src/helperComponents/TableEmptyState/index.ts +2 -0
- package/src/helperComponents/TableEmptyState/styles.module.scss +16 -0
- package/src/helperComponents/TablePagination/TablePagination.tsx +83 -0
- package/src/helperComponents/TablePagination/index.ts +1 -0
- package/src/helperComponents/TablePagination/styles.module.scss +23 -0
- package/src/helperComponents/index.ts +8 -0
- package/src/helperComponents/types.ts +10 -0
- package/src/helpers/getColumnId.ts +13 -0
- package/src/helpers/index.ts +9 -0
- package/src/helpers/masterSelection.ts +39 -0
- package/src/helpers/renderColumnsSettingsOverflowButton.tsx +22 -0
- package/src/helpers/renderExportToolbarButton.tsx +43 -0
- package/src/helpers/renderMasterSelectionToggle.tsx +38 -0
- package/src/helpers/renderTableSortingOverflowButton.tsx +33 -0
- package/src/helpers/renderToolbarAfterOverflowButton.tsx +30 -0
- package/src/helpers/rowSelectionState.ts +13 -0
- package/src/helpers/toolbarTooltipTrigger.module.scss +5 -0
- package/src/helpers/tryParseLocalStorage.ts +14 -0
- package/src/hooks/index.ts +7 -0
- package/src/hooks/useCellSizes.ts +48 -0
- package/src/hooks/useColumnsSettingsToolbarSlot/index.ts +1 -0
- package/src/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.module.scss +18 -0
- package/src/hooks/useColumnsSettingsToolbarSlot/useColumnsSettingsToolbarSlot.tsx +169 -0
- package/src/hooks/useExportToolbarSlot/index.ts +1 -0
- package/src/hooks/useExportToolbarSlot/useExportToolbarSlot.tsx +33 -0
- package/src/hooks/useHeaderGroups.ts +45 -0
- package/src/hooks/useRowCells.ts +34 -0
- package/src/hooks/useTableSorting/index.ts +1 -0
- package/src/hooks/useTableSorting/useTableSorting.module.scss +8 -0
- package/src/hooks/useTableSorting/useTableSorting.tsx +272 -0
- package/src/hooks/useTableSorting/utils.ts +107 -0
- package/src/hooks/useTableSortingToolbarSlot/index.ts +1 -0
- package/src/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.module.scss +13 -0
- package/src/hooks/useTableSortingToolbarSlot/useTableSortingToolbarSlot.tsx +116 -0
- package/src/index.ts +39 -0
- package/src/locale/index.ts +59 -0
- 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/constants.ts +5 -0
- package/src/presets/entitiesTable/EntitiesTable.tsx +115 -0
- package/src/presets/entitiesTable/constants.ts +1 -0
- package/src/presets/entitiesTable/index.ts +18 -0
- package/src/presets/entitiesTable/toEntitiesTableProps.ts +76 -0
- package/src/presets/entitiesTable/types.ts +86 -0
- package/src/presets/entitiesTable/useEntitiesTableProps.ts +28 -0
- package/src/presets/entitiesTable/useEntitiesTableState.ts +59 -0
- package/src/presets/entitiesTable/utils.ts +36 -0
- package/src/presets/index.ts +7 -0
- package/src/presets/infiniteTable/InfiniteTable.tsx +10 -0
- package/src/presets/infiniteTable/index.ts +5 -0
- package/src/presets/infiniteTable/toInfiniteTableProps.ts +47 -0
- package/src/presets/infiniteTable/useInfiniteScrollRef.ts +49 -0
- package/src/presets/infiniteTable/useInfiniteTableProps.ts +33 -0
- package/src/presets/serverAdminTable/ServerAdminTable.tsx +14 -0
- package/src/presets/serverAdminTable/index.ts +4 -0
- package/src/presets/serverAdminTable/toServerAdminTableProps.ts +44 -0
- package/src/presets/serverAdminTable/useServerAdminTableProps.ts +35 -0
- package/src/presets/serverSimpleTable/ServerSimpleTable.tsx +10 -0
- package/src/presets/serverSimpleTable/index.ts +4 -0
- package/src/presets/serverSimpleTable/toServerSimpleTableProps.ts +56 -0
- package/src/presets/serverSimpleTable/useServerSimpleTableProps.ts +27 -0
- package/src/presets/simpleTable/SimpleTable.tsx +10 -0
- package/src/presets/simpleTable/index.ts +4 -0
- package/src/presets/simpleTable/toSimpleTableProps.ts +46 -0
- package/src/presets/simpleTable/useSimpleTableProps.ts +25 -0
- package/src/presets/treeTable/TreeTable.tsx +10 -0
- package/src/presets/treeTable/index.ts +4 -0
- package/src/presets/treeTable/toTreeTableProps.ts +124 -0
- package/src/presets/treeTable/useTreeTableProps.ts +21 -0
- package/src/presets/wrapGetRowId.ts +8 -0
- package/src/types.ts +112 -0
- package/src/utils.ts +13 -0
package/README.md
ADDED
|
@@ -0,0 +1,2471 @@
|
|
|
1
|
+
# Table
|
|
2
|
+
|
|
3
|
+
`@cloud-ru/ds-table` — Таблица данных: клиентская Table, серверная ServerTable и preset-обёртки с упрощённым API.
|
|
4
|
+
|
|
5
|
+
Пакет `@cloud-ru/ds-table` предоставляет таблицы поверх `@tanstack/react-table`: полнофункциональные `Table` / `ServerTable` и preset-обёртки с упрощённым API.
|
|
6
|
+
|
|
7
|
+
## Установка
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
pnpm add @cloud-ru/ds-table
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
```ts
|
|
14
|
+
import { Table, ServerTable, SimpleTable, defineColumns } from '@cloud-ru/ds-table';
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## Смотри также
|
|
18
|
+
|
|
19
|
+
- **Pagination** — отдельный компонент пагинации.
|
|
20
|
+
- **InfoBlock** — основа пустых состояний таблицы.
|
|
21
|
+
- **Card** — самостоятельные карточки вне таблицы.
|
|
22
|
+
## Архитектура пакета
|
|
23
|
+
|
|
24
|
+
```mermaid
|
|
25
|
+
flowchart TB
|
|
26
|
+
subgraph public [Публичный API]
|
|
27
|
+
direction LR
|
|
28
|
+
defineColumns[defineColumns]
|
|
29
|
+
statusColumn[statusColumn]
|
|
30
|
+
actionsColumn[actionsColumn]
|
|
31
|
+
end
|
|
32
|
+
|
|
33
|
+
subgraph hooks [Хуки]
|
|
34
|
+
useSimple[useSimpleTableProps]
|
|
35
|
+
useAdmin[useAdminTableProps]
|
|
36
|
+
useTree[useTreeTableProps]
|
|
37
|
+
useInfinite[useInfiniteTableProps]
|
|
38
|
+
useEntities[useEntitiesTableProps]
|
|
39
|
+
end
|
|
40
|
+
|
|
41
|
+
subgraph presets [Preset-компоненты]
|
|
42
|
+
SimpleTable
|
|
43
|
+
ServerSimpleTable
|
|
44
|
+
AdminTable
|
|
45
|
+
ServerAdminTable
|
|
46
|
+
EntitiesTable
|
|
47
|
+
TreeTable
|
|
48
|
+
InfiniteTable
|
|
49
|
+
end
|
|
50
|
+
|
|
51
|
+
subgraph core [Core]
|
|
52
|
+
direction LR
|
|
53
|
+
Table
|
|
54
|
+
ServerTable
|
|
55
|
+
end
|
|
56
|
+
|
|
57
|
+
public -.->|columnDefinitions| Table
|
|
58
|
+
useSimple --> SimpleTable
|
|
59
|
+
useAdmin --> AdminTable
|
|
60
|
+
useTree --> TreeTable
|
|
61
|
+
useInfinite --> InfiniteTable
|
|
62
|
+
useEntities --> EntitiesTable
|
|
63
|
+
SimpleTable --> Table
|
|
64
|
+
ServerSimpleTable --> ServerTable
|
|
65
|
+
AdminTable --> Table
|
|
66
|
+
ServerAdminTable --> ServerTable
|
|
67
|
+
EntitiesTable --> ServerTable
|
|
68
|
+
TreeTable --> Table
|
|
69
|
+
InfiniteTable --> Table
|
|
70
|
+
ServerTable --> Table
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
`defineColumns`, `statusColumn` и `actionsColumn` — публичные утилиты: ими собирают `columnDefinitions` для **`Table`** напрямую. Preset-ы дают тот же результат через упрощённые пропсы (`columns`, `statusColumn`, `rowActions` в `AdminTable`).
|
|
74
|
+
|
|
75
|
+
`ServerTable` — обёртка над `Table` для серверной пагинации, сортировки и фильтрации.
|
|
76
|
+
|
|
77
|
+
## Какой сценарий выбрать
|
|
78
|
+
|
|
79
|
+
### Компоненты
|
|
80
|
+
|
|
81
|
+
| Сценарий
|
|
82
|
+
|
|
83
|
+
### Утилиты
|
|
84
|
+
|
|
85
|
+
| Сценарий | Утилита |
|
|
86
|
+
| ----------------------- | --------------------------------------------------- |
|
|
87
|
+
| Декларативные колонки | **`defineColumns`** |
|
|
88
|
+
| Колонка статуса | `statusColumn` |
|
|
89
|
+
| Колонка действий строки | `actionsColumn` |
|
|
90
|
+
|
|
91
|
+
Каждый preset доступен в двух формах: **компонент** (`<SimpleTable />`) и **хук** (`useSimpleTableProps()` + `<Table />`).
|
|
92
|
+
|
|
93
|
+
Карточный режим (`headlineKey`, `defaultView`, `view`) — сквозная опция всех preset-ов, не отдельный компонент.
|
|
94
|
+
|
|
95
|
+
## Table
|
|
96
|
+
|
|
97
|
+
Клиентская таблица данных: сортировка, поиск, выбор строк, пагинация, дерево, настройка колонок, режим карточек.
|
|
98
|
+
|
|
99
|
+
Клиентская таблица поверх `@tanstack/react-table`: данные передаются целиком, сортировка, поиск и пагинация выполняются локально. Служебные колонки — статус, выбор строки, действия, дерево — собираются готовыми фабриками.
|
|
100
|
+
|
|
101
|
+
Для типовых сценариев есть preset-обёртки с упрощённым API — см. **обзор пакета** и **`defineColumns`**. Для постраничных данных с бэкенда — **`ServerTable`**.
|
|
102
|
+
|
|
103
|
+
### Когда использовать
|
|
104
|
+
|
|
105
|
+
- Структурированные данные с одинаковым набором полей у каждой записи.
|
|
106
|
+
- Операции над строками: выбор, массовые действия, контекстные действия строки.
|
|
107
|
+
- Сравнение записей по колонкам: сортировка, фильтры, настройка видимости колонок.
|
|
108
|
+
|
|
109
|
+
Когда **не** нужен:
|
|
110
|
+
|
|
111
|
+
- Данные приходят с бэкенда постранично:
|
|
112
|
+
- используйте **`ServerTable`**.
|
|
113
|
+
- Простой справочник без поиска и фильтров:
|
|
114
|
+
- **`SimpleTable`** вместо ручной сборки `columnDefinitions`.
|
|
115
|
+
- Типичный админ-экран (поиск, статус, выбор, действия):
|
|
116
|
+
- **`AdminTable`** вместо полного `Table`.
|
|
117
|
+
- Простой список без колонок и сортировки:
|
|
118
|
+
- используйте список или карточки.
|
|
119
|
+
|
|
120
|
+
Рекомендации:
|
|
121
|
+
|
|
122
|
+
- ✅ Задавать `getRowId` по стабильному идентификатору данных при включённом выборе строк.
|
|
123
|
+
- ❌ Полагаться на индекс строки — при сортировке и фильтрации выбор переходит на другие записи.
|
|
124
|
+
|
|
125
|
+
- ✅ Для постраничных данных с бэкенда использовать **`ServerTable`** с `onChangePage`.
|
|
126
|
+
- ❌ Собирать `manualPagination` поверх `Table` вручную — это уже реализовано в `ServerTable`.
|
|
127
|
+
|
|
128
|
+
- ✅ Служебные колонки создавать фабриками `getStatusColumnDef` / `getRowActionsColumnDef` / `getTreeColumnDef`.
|
|
129
|
+
- ❌ Собирать закреплённую колонку статуса вручную — фабрика задаёт ширину, закрепление и отступы по дизайну.
|
|
130
|
+
|
|
131
|
+
- ✅ В режиме карточек передавать `headlineId` — id колонки, чей рендер становится заголовком карточки.
|
|
132
|
+
- ❌ Включать `view='cards'` без `headlineId` — карточки останутся без заголовка.
|
|
133
|
+
|
|
134
|
+
- ✅ Задавать уникальный `savedState.id` для каждой таблицы приложения.
|
|
135
|
+
- ❌ Использовать один id на несколько таблиц — сохранённые состояния перетирают друг друга в localStorage.
|
|
136
|
+
|
|
137
|
+
### Анатомия
|
|
138
|
+
|
|
139
|
+
#### View (default `table`, на mobile — `cards`)
|
|
140
|
+
|
|
141
|
+
Режим отображения данных (ось `VIEW`):
|
|
142
|
+
|
|
143
|
+
- `table` — классическая сетка со строками и колонками.
|
|
144
|
+
- `cards` — карточки с внешним бордером; заголовок карточки берётся из колонки `headlineId`, при множественном выборе на карточке отображается бэйдж выбора, при одиночном — radio; действия строки доступны на карточке.
|
|
145
|
+
|
|
146
|
+
Начальный вид зависит от раскладки (адаптивный дефолт): `table` на desktop, `cards` на mobile. Явные `defaultView` / `view` перекрывают его.
|
|
147
|
+
|
|
148
|
+
Управление режимом:
|
|
149
|
+
|
|
150
|
+
- `defaultView` — начальный режим для uncontrolled-сценария.
|
|
151
|
+
- `view` + `onViewChange` — управляемый режим.
|
|
152
|
+
- `showDataView` (default `false`) — показывать ли переключатель вида (сегмент-контрол в тулбаре). Управляет только видимостью тоггла; сам вид задаётся `view` / `defaultView`.
|
|
153
|
+
|
|
154
|
+
Три режима:
|
|
155
|
+
|
|
156
|
+
- **Только таблица / только карточки** (дефолт — тоггла нет) — вид задаётся `defaultView` (или адаптивным дефолтом: desktop `table`, mobile `cards`).
|
|
157
|
+
- **С переключателем** — `showDataView`; пользователь сам переключает table/cards, стартовый вид — `defaultView` / адаптивный дефолт.
|
|
158
|
+
|
|
159
|
+
Для «только таблицы» на mobile учтите адаптивный дефолт (`cards`): нужен `layoutPresets={{ mobile: { defaultView: 'table' } }}`.
|
|
160
|
+
|
|
161
|
+
Поведение в режиме карточек:
|
|
162
|
+
|
|
163
|
+
- `onRowClick` работает в обоих режимах — и в сетке, и на карточках.
|
|
164
|
+
- `suppressHeader` скрывает подписи-заголовки полей карточки.
|
|
165
|
+
- `getRowBackgroundColor` не применяется — карточки не тонируются.
|
|
166
|
+
|
|
167
|
+
#### Колонки (`columnDefinitions`)
|
|
168
|
+
|
|
169
|
+
`ColumnDefinition` — надстройка над `ColumnDef` из `@tanstack/react-table`:
|
|
170
|
+
|
|
171
|
+
- `header` — заголовок колонки (ReactNode или функция от контекста).
|
|
172
|
+
- `align` / `headerAlign` — выравнивание контента ячейки и заголовка (ось `COLUMN_ALIGN`: `left` / `right`).
|
|
173
|
+
- `size` — ширина колонки; меняется перетаскиванием за хэндл на границе заголовков.
|
|
174
|
+
- `pinned` — закрепление колонки (ось `COLUMN_PIN_POSITION`: `left` / `right`); закреплённая колонка обязана иметь `id` и `size`.
|
|
175
|
+
- `cellClassName` / `headerClassName` — CSS-классы ячеек тела и шапки.
|
|
176
|
+
- `noBodyCellPadding` / `noHeaderCellPadding` — отключение паддингов ячейки.
|
|
177
|
+
- `meta.skipOnExport` — пропуск колонки при экспорте.
|
|
178
|
+
|
|
179
|
+
#### Служебные колонки
|
|
180
|
+
|
|
181
|
+
Предопределённые колонки (идентификаторы — в `DefaultColumns`) создаются фабриками:
|
|
182
|
+
|
|
183
|
+
- `getStatusColumnDef` — закреплённая колонка статуса, рисуется компонентом **`Status`** из `@cloud-ru/ds-status` (точка-индикатор + подпись): `mapStatusToAppearance` переводит значение поля в appearance, `renderDescription` задаёт текст подписи. Без `renderDescription` отрисовывается только точка-индикатор.
|
|
184
|
+
- `getSelectionCellColumnDef` — колонка с чекбоксом или radio выбора строки. В мультивыборе мастер-чекбокс «выбрать всё» рендерится в строке заголовков таблицы.
|
|
185
|
+
- `getRowActionsColumnDef` — колонка с кнопкой действий строки; пункты выпадающего списка собирает `actionsGenerator` по данным строки.
|
|
186
|
+
- `getTreeColumnDef` — колонка с chevron раскрытия дерева (передаётся в `expanding.expandingColumnDefinition`).
|
|
187
|
+
|
|
188
|
+
Значения `STATUS_APPEARANCE` для статус-колонки:
|
|
189
|
+
|
|
190
|
+
- `neutral` — нейтральный статус. `primary` — синий акцент (у `@cloud-ru/ds-status` нет appearance `primary`, маппится на `blue`).
|
|
191
|
+
- `red` — ошибка, блокировка.
|
|
192
|
+
- `orange` / `yellow` — предупреждение.
|
|
193
|
+
- `green` — успешное состояние.
|
|
194
|
+
- `blue` / `violet` / `pink` — информационные и категорийные статусы.
|
|
195
|
+
- `loading` — спиннер вместо цветового индикатора.
|
|
196
|
+
|
|
197
|
+
Готовая ячейка `CopyCell` отображает значение с кнопкой копирования.
|
|
198
|
+
|
|
199
|
+
#### Сортировка (`sorting`)
|
|
200
|
+
|
|
201
|
+
- `initialState` — начальное состояние для uncontrolled-сценария.
|
|
202
|
+
- `state` + `onChange` — управляемый режим.
|
|
203
|
+
|
|
204
|
+
Функция сравнения задаётся на колонке через `sortingFn` (ось `SORT_FN`):
|
|
205
|
+
|
|
206
|
+
- `alphanumeric` — строки и числа.
|
|
207
|
+
- `datetime` — даты.
|
|
208
|
+
|
|
209
|
+
Для серверной сортировки — `manualSorting`: таблица не сортирует данные сама, только отдаёт состояние через `onChange`.
|
|
210
|
+
|
|
211
|
+
#### Выбор строк (`rowSelection`)
|
|
212
|
+
|
|
213
|
+
- `multiRow` — множественный выбор чекбоксами; без него — одиночный выбор radio.
|
|
214
|
+
- `enable` — предикат доступности выбора для конкретной строки.
|
|
215
|
+
- `appearance` — вид недоступной для выбора строки (ось `RowAppearance`):
|
|
216
|
+
- `disabled` — заблокированный чекбокс;
|
|
217
|
+
- `hide-toggler` — чекбокс скрыт.
|
|
218
|
+
- `initialState` / `state` + `onChange` — uncontrolled- и controlled-режимы.
|
|
219
|
+
|
|
220
|
+
Bulk-бар в тулбаре (чекбокс «выбрать все» и счётчик выбранных) появляется только при `rowSelection.multiRow`:
|
|
221
|
+
|
|
222
|
+
- `bulkActions` — массовые действия; `onClick` получает `selectionState` и `resetRowSelection`.
|
|
223
|
+
- `toolbarCheckBoxMode` — охват мастер-чекбокса выбора (ось `ToolbarCheckBoxMode`, только клиентская `Table`):
|
|
224
|
+
- `pageRows` — строки текущей страницы;
|
|
225
|
+
- `allRows` — все строки набора `data` (включая другие страницы пагинации).
|
|
226
|
+
|
|
227
|
+
В `view='table'` мастер-чекбокс в заголовке колонки выбора; в `view='cards'` — в bulk-баре тулбара.
|
|
228
|
+
|
|
229
|
+
#### Поиск и фильтры
|
|
230
|
+
|
|
231
|
+
- `search` — глобальный поиск: `initialState` / `state` + `onChange`, `placeholder`, `loading`.
|
|
232
|
+
- `enableFuzzySearch` — нечёткий поиск вместо точного совпадения подстроки.
|
|
233
|
+
- `columnFilters` — строка фильтров-чипов над таблицей (`FilterRow`; `initialOpen` раскрывает её сразу).
|
|
234
|
+
- `dataFiltered` — флаг «данные отфильтрованы снаружи»: при пустых данных показывается `noResultsState`.
|
|
235
|
+
- `manualFiltering` — фильтрация на сервере: таблица не фильтрует данные сама.
|
|
236
|
+
|
|
237
|
+
#### Пагинация (default `pageSize` 10)
|
|
238
|
+
|
|
239
|
+
- `pageSize` — число строк на страницу.
|
|
240
|
+
- `pagination` — `state` + `onChange` (управляемый режим), `options` (варианты числа строк на страницу), `optionsLabel`, `optionsRender`.
|
|
241
|
+
- `suppressPagination` — отключение пагинации.
|
|
242
|
+
- `autoResetPageIndex` — сброс на первую страницу при изменении данных, фильтров или сортировки.
|
|
243
|
+
- `pageCount` — количество страниц при внешнем управлении.
|
|
244
|
+
- `infiniteLoading` — режим «бесконечной» загрузки; взаимоисключающая ветка типа: вместе с ним пропы `pagination` / `suppressPagination` / `toolbarCheckBoxMode` недоступны.
|
|
245
|
+
|
|
246
|
+
#### Дерево (`expanding`)
|
|
247
|
+
|
|
248
|
+
- `getSubRows` — функция получения дочерних строк элемента.
|
|
249
|
+
- `expandingColumnDefinition` — определение колонки с chevron (создаётся `getTreeColumnDef`).
|
|
250
|
+
- `state` + `onChange` — управляемый `ExpandedState`; без них раскрытие живёт во внутреннем состоянии.
|
|
251
|
+
|
|
252
|
+
#### Настройка колонок (`columnsSettings`)
|
|
253
|
+
|
|
254
|
+
- `enableDrag` — переупорядочивание колонок: перетаскивание заголовков в таблице и строк в меню настроек (через `onItemsReorder` у `@cloud-ru/ds-list`). Оба канала пишут в один и тот же `columnOrder`.
|
|
255
|
+
- `enableSettingsMenu` — меню видимости колонок в тулбаре.
|
|
256
|
+
|
|
257
|
+
Поведение колонки в меню задаётся на самой колонке через `columnSettings.mode` (ось `COLUMN_SETTINGS_MODE`):
|
|
258
|
+
|
|
259
|
+
- `locked` — колонка есть в меню, но строка disabled (всегда видима, свитч нельзя выключить).
|
|
260
|
+
- `defaultVisible` — в меню, по умолчанию включена.
|
|
261
|
+
- `defaultHidden` — в меню, по умолчанию выключена.
|
|
262
|
+
|
|
263
|
+
`columnSettings.label` — название колонки в меню настроек. Колонки без `columnSettings` тоже показываются в меню (disabled, label из `header`); исключение — служебные `selection` / `rowActions`.
|
|
264
|
+
|
|
265
|
+
`savedState` сохраняет состояние таблицы в localStorage и query-параметрах: `id` обязан быть уникальным в рамках приложения; `resize` / `columnSettings` включают сохранение ширин и видимости колонок; `serializer` / `parser` / `filterQueryKey` настраивают сериализацию фильтров.
|
|
266
|
+
|
|
267
|
+
#### Цвет строки
|
|
268
|
+
|
|
269
|
+
`getRowBackgroundColor(data)` возвращает цвет фона строки по её данным (ось `TABLE_ROW_COLOR`) или `undefined`:
|
|
270
|
+
|
|
271
|
+
- `red` / `orange` / `yellow` — ошибка и предупреждения.
|
|
272
|
+
- `green` — успешное состояние.
|
|
273
|
+
- `blue` / `violet` / `pink` — категорийная подсветка.
|
|
274
|
+
- `neutral` — нейтральное выделение.
|
|
275
|
+
|
|
276
|
+
Работает только в `view='table'` — карточки не тонируются.
|
|
277
|
+
|
|
278
|
+
#### Пустые состояния и загрузка
|
|
279
|
+
|
|
280
|
+
- `noDataState` — экран при отсутствии данных.
|
|
281
|
+
- `noResultsState` — экран при пустом результате поиска или фильтров.
|
|
282
|
+
- `errorDataState` — экран при ошибке запроса.
|
|
283
|
+
- Все три — `EmptyStateProps` поверх `InfoBlock`.
|
|
284
|
+
- `loading` — skeleton-строки на время загрузки.
|
|
285
|
+
- Флаги `dataFiltered` / `dataError` определяют, какой из экранов показывается при пустых данных.
|
|
286
|
+
|
|
287
|
+
#### Тулбар
|
|
288
|
+
|
|
289
|
+
- `suppressToolbar` — скрыть тулбар целиком.
|
|
290
|
+
- `suppressSearch` — скрыть строку поиска.
|
|
291
|
+
- `suppressHeader` — скрыть шапку таблицы; в режиме карточек — подписи полей карточки.
|
|
292
|
+
- `moreActions` — пункты выпадающего списка кнопки дополнительных действий.
|
|
293
|
+
- `toolbarAfter` — дополнительный слот после строки поиска.
|
|
294
|
+
- `onRefresh` — кнопка обновления данных.
|
|
295
|
+
- `outline` — внешний бордер вокруг тулбара и таблицы.
|
|
296
|
+
- `fullWidth` — растягивание на ширину контейнера (`true` по умолчанию). При `false` на desktop ширина таблицы определяется суммой колонок; на mobile всегда `true` (`TABLE_LAYOUT_PRESETS`). Лучше всего работает, когда у всех колонок задан `size`. Если нужна fluid-колонка на остаток ширины — оставьте `fullWidth={true}` и не задавайте `size` хотя бы одной колонке.
|
|
297
|
+
|
|
298
|
+
### Примеры использования
|
|
299
|
+
|
|
300
|
+
{/* client:only='react': SSR демо невозможен — @cloud-ru/ds-list использует в dist directory-imports, которые Node-ESM не резолвит (тот же паттерн, что в @cloud-ru/ds-chips). */}
|
|
301
|
+
|
|
302
|
+
#### Базовая таблица
|
|
303
|
+
|
|
304
|
+
Колонки с выравниванием и форматированием, `outline`, пагинация с выбором числа строк.
|
|
305
|
+
|
|
306
|
+
```tsx
|
|
307
|
+
import { ColumnDefinition, Table } from '@cloud-ru/ds-table';
|
|
308
|
+
|
|
309
|
+
type User = {
|
|
310
|
+
id: string;
|
|
311
|
+
name: string;
|
|
312
|
+
email: string;
|
|
313
|
+
role: string;
|
|
314
|
+
balance: number;
|
|
315
|
+
};
|
|
316
|
+
|
|
317
|
+
const USERS: User[] = [
|
|
318
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', balance: 12990 },
|
|
319
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', balance: 8450 },
|
|
320
|
+
{ id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', balance: 4300 },
|
|
321
|
+
{ id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer', balance: 0 },
|
|
322
|
+
{ id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', balance: 990 },
|
|
323
|
+
{ id: 'u-6', name: 'Егор Морозов', email: 'egor.morozov@example.com', role: 'Admin', balance: 15600 },
|
|
324
|
+
{ id: 'u-7', name: 'Жанна Волкова', email: 'zhanna.volkova@example.com', role: 'Viewer', balance: 2100 },
|
|
325
|
+
{ id: 'u-8', name: 'Захар Соколов', email: 'zakhar.sokolov@example.com', role: 'Editor', balance: 7800 },
|
|
326
|
+
];
|
|
327
|
+
|
|
328
|
+
const balanceFormatter = new Intl.NumberFormat('ru-RU', {
|
|
329
|
+
style: 'currency',
|
|
330
|
+
currency: 'RUB',
|
|
331
|
+
maximumFractionDigits: 0,
|
|
332
|
+
});
|
|
333
|
+
|
|
334
|
+
const columns: ColumnDefinition<User>[] = [
|
|
335
|
+
{ accessorKey: 'name', header: 'Имя', enableSorting: true, size: 200 },
|
|
336
|
+
{ accessorKey: 'email', header: 'Email', size: 240 },
|
|
337
|
+
{ accessorKey: 'role', header: 'Роль', enableSorting: true, size: 140 },
|
|
338
|
+
{
|
|
339
|
+
accessorKey: 'balance',
|
|
340
|
+
header: 'Баланс',
|
|
341
|
+
align: 'right',
|
|
342
|
+
headerAlign: 'right',
|
|
343
|
+
enableSorting: true,
|
|
344
|
+
size: 140,
|
|
345
|
+
cell: ctx => balanceFormatter.format(Number(ctx.getValue() ?? 0)),
|
|
346
|
+
},
|
|
347
|
+
];
|
|
348
|
+
|
|
349
|
+
export function Basic() {
|
|
350
|
+
return <Table data={USERS} columnDefinitions={columns} pageSize={5} pagination={{ options: [5, 10] }} outline />;
|
|
351
|
+
}
|
|
352
|
+
```
|
|
353
|
+
|
|
354
|
+
#### Управляемая сортировка
|
|
355
|
+
|
|
356
|
+
`sorting.state` + `onChange`, начальная сортировка по убыванию суммы.
|
|
357
|
+
|
|
358
|
+
```tsx
|
|
359
|
+
import { ColumnDefinition, SortingState, Table } from '@cloud-ru/ds-table';
|
|
360
|
+
import { useState } from 'react';
|
|
361
|
+
|
|
362
|
+
type User = {
|
|
363
|
+
id: string;
|
|
364
|
+
name: string;
|
|
365
|
+
email: string;
|
|
366
|
+
role: string;
|
|
367
|
+
amount: number;
|
|
368
|
+
};
|
|
369
|
+
|
|
370
|
+
const USERS: User[] = [
|
|
371
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', amount: 12990 },
|
|
372
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', amount: 8450 },
|
|
373
|
+
{ id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', amount: 4300 },
|
|
374
|
+
{ id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer', amount: 0 },
|
|
375
|
+
{ id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', amount: 990 },
|
|
376
|
+
{ id: 'u-6', name: 'Егор Морозов', email: 'egor.morozov@example.com', role: 'Admin', amount: 15600 },
|
|
377
|
+
];
|
|
378
|
+
|
|
379
|
+
const columns: ColumnDefinition<User>[] = [
|
|
380
|
+
{ accessorKey: 'name', header: 'Имя', enableSorting: true, size: 200 },
|
|
381
|
+
{ accessorKey: 'email', header: 'Email', enableSorting: true, size: 260 },
|
|
382
|
+
{ accessorKey: 'role', header: 'Роль', enableSorting: true, size: 140 },
|
|
383
|
+
{ accessorKey: 'amount', header: 'Баланс', align: 'right', headerAlign: 'right', enableSorting: true, size: 140 },
|
|
384
|
+
];
|
|
385
|
+
|
|
386
|
+
export function Sorting() {
|
|
387
|
+
const [sorting, setSorting] = useState<SortingState>([{ id: 'amount', desc: true }]);
|
|
388
|
+
|
|
389
|
+
return (
|
|
390
|
+
<Table
|
|
391
|
+
data={USERS}
|
|
392
|
+
columnDefinitions={columns}
|
|
393
|
+
sorting={{ state: sorting, onChange: setSorting }}
|
|
394
|
+
suppressPagination
|
|
395
|
+
outline
|
|
396
|
+
/>
|
|
397
|
+
);
|
|
398
|
+
}
|
|
399
|
+
```
|
|
400
|
+
|
|
401
|
+
#### Статус-колонка и цвет строки
|
|
402
|
+
|
|
403
|
+
`getStatusColumnDef` с подписью в тултипе и подкраска строк через `getRowBackgroundColor`.
|
|
404
|
+
|
|
405
|
+
```tsx
|
|
406
|
+
import {
|
|
407
|
+
ColumnDefinition,
|
|
408
|
+
getStatusColumnDef,
|
|
409
|
+
MapStatusToAppearanceFnType,
|
|
410
|
+
STATUS_APPEARANCE,
|
|
411
|
+
Table,
|
|
412
|
+
TABLE_ROW_COLOR,
|
|
413
|
+
} from '@cloud-ru/ds-table';
|
|
414
|
+
|
|
415
|
+
type User = {
|
|
416
|
+
id: string;
|
|
417
|
+
name: string;
|
|
418
|
+
email: string;
|
|
419
|
+
role: string;
|
|
420
|
+
status: string;
|
|
421
|
+
};
|
|
422
|
+
|
|
423
|
+
const USERS: User[] = [
|
|
424
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', status: 'active' },
|
|
425
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', status: 'pending' },
|
|
426
|
+
{ id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', status: 'blocked' },
|
|
427
|
+
{ id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer', status: 'invited' },
|
|
428
|
+
{ id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', status: 'active' },
|
|
429
|
+
{ id: 'u-6', name: 'Егор Морозов', email: 'egor.morozov@example.com', role: 'Admin', status: 'blocked' },
|
|
430
|
+
];
|
|
431
|
+
|
|
432
|
+
const STATUS_LABELS: Record<string, string> = {
|
|
433
|
+
active: 'Активен',
|
|
434
|
+
pending: 'Ожидание',
|
|
435
|
+
blocked: 'Заблокирован',
|
|
436
|
+
invited: 'Приглашён',
|
|
437
|
+
};
|
|
438
|
+
|
|
439
|
+
const mapStatusToAppearance: MapStatusToAppearanceFnType = value => {
|
|
440
|
+
switch (value) {
|
|
441
|
+
case 'active':
|
|
442
|
+
return STATUS_APPEARANCE.Green;
|
|
443
|
+
case 'pending':
|
|
444
|
+
return STATUS_APPEARANCE.Yellow;
|
|
445
|
+
case 'blocked':
|
|
446
|
+
return STATUS_APPEARANCE.Red;
|
|
447
|
+
case 'invited':
|
|
448
|
+
return STATUS_APPEARANCE.Blue;
|
|
449
|
+
default:
|
|
450
|
+
return STATUS_APPEARANCE.Neutral;
|
|
451
|
+
}
|
|
452
|
+
};
|
|
453
|
+
|
|
454
|
+
const columns: ColumnDefinition<User>[] = [
|
|
455
|
+
getStatusColumnDef<User>({
|
|
456
|
+
accessorKey: 'status',
|
|
457
|
+
mapStatusToAppearance,
|
|
458
|
+
renderDescription: value => STATUS_LABELS[value] ?? value,
|
|
459
|
+
header: 'Статус',
|
|
460
|
+
size: 160,
|
|
461
|
+
}),
|
|
462
|
+
{ accessorKey: 'name', header: 'Имя', size: 200 },
|
|
463
|
+
{ accessorKey: 'email', header: 'Email', size: 260 },
|
|
464
|
+
{ accessorKey: 'role', header: 'Роль', size: 140 },
|
|
465
|
+
];
|
|
466
|
+
|
|
467
|
+
export function StatusColumn() {
|
|
468
|
+
return (
|
|
469
|
+
<Table
|
|
470
|
+
data={USERS}
|
|
471
|
+
columnDefinitions={columns}
|
|
472
|
+
getRowBackgroundColor={user => (user.status === 'blocked' ? TABLE_ROW_COLOR.Red : undefined)}
|
|
473
|
+
suppressPagination
|
|
474
|
+
outline
|
|
475
|
+
/>
|
|
476
|
+
);
|
|
477
|
+
}
|
|
478
|
+
```
|
|
479
|
+
|
|
480
|
+
#### Выбор строк и массовые действия
|
|
481
|
+
|
|
482
|
+
Множественный выбор, bulk-бар с действием удаления и `resetRowSelection`.
|
|
483
|
+
|
|
484
|
+
```tsx
|
|
485
|
+
import { TrashSVG } from '@cloud-ru/ds-icons/interface/system';
|
|
486
|
+
import { ColumnDefinition, RowSelectionState, Table } from '@cloud-ru/ds-table';
|
|
487
|
+
import { useState } from 'react';
|
|
488
|
+
|
|
489
|
+
type User = {
|
|
490
|
+
id: string;
|
|
491
|
+
name: string;
|
|
492
|
+
email: string;
|
|
493
|
+
role: string;
|
|
494
|
+
};
|
|
495
|
+
|
|
496
|
+
const INITIAL_USERS: User[] = [
|
|
497
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner' },
|
|
498
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin' },
|
|
499
|
+
{ id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor' },
|
|
500
|
+
{ id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer' },
|
|
501
|
+
{ id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor' },
|
|
502
|
+
{ id: 'u-6', name: 'Егор Морозов', email: 'egor.morozov@example.com', role: 'Admin' },
|
|
503
|
+
];
|
|
504
|
+
|
|
505
|
+
const columns: ColumnDefinition<User>[] = [
|
|
506
|
+
{ accessorKey: 'name', header: 'Имя', size: 200 },
|
|
507
|
+
{ accessorKey: 'email', header: 'Email', size: 260 },
|
|
508
|
+
{ accessorKey: 'role', header: 'Роль', size: 140 },
|
|
509
|
+
];
|
|
510
|
+
|
|
511
|
+
export function Selection() {
|
|
512
|
+
const [users, setUsers] = useState<User[]>(INITIAL_USERS);
|
|
513
|
+
const [selection, setSelection] = useState<RowSelectionState>({ 'u-2': true });
|
|
514
|
+
|
|
515
|
+
return (
|
|
516
|
+
<Table
|
|
517
|
+
data={users}
|
|
518
|
+
columnDefinitions={columns}
|
|
519
|
+
getRowId={user => user.id}
|
|
520
|
+
rowSelection={{ enable: true, multiRow: true, state: selection, onChange: setSelection }}
|
|
521
|
+
bulkActions={[
|
|
522
|
+
{
|
|
523
|
+
label: 'Удалить выбранные',
|
|
524
|
+
icon: TrashSVG,
|
|
525
|
+
onClick: (selectionState, resetRowSelection) => {
|
|
526
|
+
setUsers(prev => prev.filter(user => !selectionState[user.id]));
|
|
527
|
+
setSelection({});
|
|
528
|
+
resetRowSelection();
|
|
529
|
+
},
|
|
530
|
+
},
|
|
531
|
+
]}
|
|
532
|
+
suppressPagination
|
|
533
|
+
outline
|
|
534
|
+
/>
|
|
535
|
+
);
|
|
536
|
+
}
|
|
537
|
+
```
|
|
538
|
+
|
|
539
|
+
#### Действия строки
|
|
540
|
+
|
|
541
|
+
`getRowActionsColumnDef` с выпадающим списком: пункты меняют данные строки.
|
|
542
|
+
|
|
543
|
+
```tsx
|
|
544
|
+
import { ColumnDefinition, getRowActionsColumnDef, Table } from '@cloud-ru/ds-table';
|
|
545
|
+
import { useMemo, useState } from 'react';
|
|
546
|
+
|
|
547
|
+
type User = {
|
|
548
|
+
id: string;
|
|
549
|
+
name: string;
|
|
550
|
+
email: string;
|
|
551
|
+
status: 'active' | 'blocked';
|
|
552
|
+
};
|
|
553
|
+
|
|
554
|
+
const INITIAL_USERS: User[] = [
|
|
555
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', status: 'active' },
|
|
556
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', status: 'active' },
|
|
557
|
+
{ id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', status: 'blocked' },
|
|
558
|
+
{ id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', status: 'active' },
|
|
559
|
+
{ id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', status: 'blocked' },
|
|
560
|
+
];
|
|
561
|
+
|
|
562
|
+
export function RowActions() {
|
|
563
|
+
const [users, setUsers] = useState<User[]>(INITIAL_USERS);
|
|
564
|
+
|
|
565
|
+
const columns = useMemo<ColumnDefinition<User>[]>(
|
|
566
|
+
() => [
|
|
567
|
+
{ accessorKey: 'name', header: 'Имя', size: 200 },
|
|
568
|
+
{ accessorKey: 'email', header: 'Email', size: 260 },
|
|
569
|
+
{
|
|
570
|
+
accessorKey: 'status',
|
|
571
|
+
header: 'Статус',
|
|
572
|
+
size: 160,
|
|
573
|
+
cell: ctx => (ctx.getValue() === 'blocked' ? 'Заблокирован' : 'Активен'),
|
|
574
|
+
},
|
|
575
|
+
getRowActionsColumnDef<User>({
|
|
576
|
+
pinned: true,
|
|
577
|
+
actionsGenerator: cell => {
|
|
578
|
+
const user = cell.row.original;
|
|
579
|
+
|
|
580
|
+
return [
|
|
581
|
+
{
|
|
582
|
+
content: { label: user.status === 'blocked' ? 'Активировать' : 'Заблокировать' },
|
|
583
|
+
onClick: () =>
|
|
584
|
+
setUsers(prev =>
|
|
585
|
+
prev.map(item =>
|
|
586
|
+
item.id === user.id ? { ...item, status: item.status === 'blocked' ? 'active' : 'blocked' } : item,
|
|
587
|
+
),
|
|
588
|
+
),
|
|
589
|
+
},
|
|
590
|
+
{
|
|
591
|
+
content: { label: 'Удалить' },
|
|
592
|
+
onClick: () => setUsers(prev => prev.filter(item => item.id !== user.id)),
|
|
593
|
+
},
|
|
594
|
+
];
|
|
595
|
+
},
|
|
596
|
+
}),
|
|
597
|
+
],
|
|
598
|
+
[],
|
|
599
|
+
);
|
|
600
|
+
|
|
601
|
+
return <Table data={users} columnDefinitions={columns} getRowId={user => user.id} suppressPagination outline />;
|
|
602
|
+
}
|
|
603
|
+
```
|
|
604
|
+
|
|
605
|
+
#### Дерево
|
|
606
|
+
|
|
607
|
+
Иерархические данные через `expanding.getSubRows` + `getTreeColumnDef`.
|
|
608
|
+
|
|
609
|
+
```tsx
|
|
610
|
+
import { ColumnDefinition, Table } from '@cloud-ru/ds-table';
|
|
611
|
+
|
|
612
|
+
type OrgNode = {
|
|
613
|
+
id: string;
|
|
614
|
+
name: string;
|
|
615
|
+
type: string;
|
|
616
|
+
email: string;
|
|
617
|
+
subRows?: OrgNode[];
|
|
618
|
+
};
|
|
619
|
+
|
|
620
|
+
const ORG_TREE: OrgNode[] = [
|
|
621
|
+
{
|
|
622
|
+
id: 'org-cloud',
|
|
623
|
+
name: 'Cloud Platform',
|
|
624
|
+
type: 'Организация',
|
|
625
|
+
email: 'platform@example.com',
|
|
626
|
+
subRows: [
|
|
627
|
+
{
|
|
628
|
+
id: 'team-compute',
|
|
629
|
+
name: 'Compute',
|
|
630
|
+
type: 'Команда',
|
|
631
|
+
email: 'compute@example.com',
|
|
632
|
+
subRows: [
|
|
633
|
+
{ id: 'p-1', name: 'Анна Иванова', type: 'Owner', email: 'anna.ivanova@example.com' },
|
|
634
|
+
{ id: 'p-2', name: 'Борис Петров', type: 'Admin', email: 'boris.petrov@example.com' },
|
|
635
|
+
],
|
|
636
|
+
},
|
|
637
|
+
{
|
|
638
|
+
id: 'team-storage',
|
|
639
|
+
name: 'Storage',
|
|
640
|
+
type: 'Команда',
|
|
641
|
+
email: 'storage@example.com',
|
|
642
|
+
subRows: [{ id: 'p-3', name: 'Вера Сидорова', type: 'Editor', email: 'vera.sidorova@example.com' }],
|
|
643
|
+
},
|
|
644
|
+
],
|
|
645
|
+
},
|
|
646
|
+
{
|
|
647
|
+
id: 'org-data',
|
|
648
|
+
name: 'Data Platform',
|
|
649
|
+
type: 'Организация',
|
|
650
|
+
email: 'data@example.com',
|
|
651
|
+
subRows: [{ id: 'p-4', name: 'Егор Морозов', type: 'Admin', email: 'egor.morozov@example.com' }],
|
|
652
|
+
},
|
|
653
|
+
];
|
|
654
|
+
|
|
655
|
+
// `name` рендерится tree-колонкой (`expandingColumnDefinition`), поэтому
|
|
656
|
+
// в обычных колонках его нет — иначе значение продублируется.
|
|
657
|
+
const columns: ColumnDefinition<OrgNode>[] = [
|
|
658
|
+
{ accessorKey: 'type', header: 'Тип', size: 160 },
|
|
659
|
+
{ accessorKey: 'email', header: 'Email', size: 260 },
|
|
660
|
+
];
|
|
661
|
+
|
|
662
|
+
export function Tree() {
|
|
663
|
+
return (
|
|
664
|
+
<Table
|
|
665
|
+
data={ORG_TREE}
|
|
666
|
+
columnDefinitions={columns}
|
|
667
|
+
getRowId={node => node.id}
|
|
668
|
+
expanding={{
|
|
669
|
+
getSubRows: node => node.subRows,
|
|
670
|
+
expandingColumnDefinition: { accessorKey: 'name', header: 'Подразделение' },
|
|
671
|
+
}}
|
|
672
|
+
suppressPagination
|
|
673
|
+
outline
|
|
674
|
+
/>
|
|
675
|
+
);
|
|
676
|
+
}
|
|
677
|
+
```
|
|
678
|
+
|
|
679
|
+
#### Настройка колонок
|
|
680
|
+
|
|
681
|
+
Перетаскивание заголовков и строк в меню настроек (`enableDrag`) плюс видимость колонок (`enableSettingsMenu`).
|
|
682
|
+
|
|
683
|
+
```tsx
|
|
684
|
+
import { COLUMN_SETTINGS_MODE, ColumnDefinition, Table } from '@cloud-ru/ds-table';
|
|
685
|
+
|
|
686
|
+
type User = {
|
|
687
|
+
id: string;
|
|
688
|
+
name: string;
|
|
689
|
+
email: string;
|
|
690
|
+
role: string;
|
|
691
|
+
createdAt: string;
|
|
692
|
+
};
|
|
693
|
+
|
|
694
|
+
const USERS: User[] = [
|
|
695
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', createdAt: '12.01.2026' },
|
|
696
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', createdAt: '03.02.2026' },
|
|
697
|
+
{ id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', createdAt: '18.03.2026' },
|
|
698
|
+
{ id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer', createdAt: '27.04.2026' },
|
|
699
|
+
{ id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', createdAt: '09.05.2026' },
|
|
700
|
+
];
|
|
701
|
+
|
|
702
|
+
const columns: ColumnDefinition<User>[] = [
|
|
703
|
+
// `mode: Hidden` — колонка не показывается в меню настроек и видна всегда.
|
|
704
|
+
{
|
|
705
|
+
accessorKey: 'name',
|
|
706
|
+
header: 'Имя',
|
|
707
|
+
size: 200,
|
|
708
|
+
columnSettings: { label: 'Имя', mode: COLUMN_SETTINGS_MODE.Locked },
|
|
709
|
+
},
|
|
710
|
+
{ accessorKey: 'email', header: 'Email', size: 240, columnSettings: { label: 'Email' } },
|
|
711
|
+
{ accessorKey: 'role', header: 'Роль', size: 140, columnSettings: { label: 'Роль' } },
|
|
712
|
+
// `mode: DefaultFalse` — колонка скрыта по умолчанию, включается из меню настроек.
|
|
713
|
+
{
|
|
714
|
+
accessorKey: 'createdAt',
|
|
715
|
+
header: 'Создан',
|
|
716
|
+
size: 160,
|
|
717
|
+
columnSettings: { label: 'Дата создания', mode: COLUMN_SETTINGS_MODE.DefaultHidden },
|
|
718
|
+
},
|
|
719
|
+
];
|
|
720
|
+
|
|
721
|
+
export function ColumnSettings() {
|
|
722
|
+
return (
|
|
723
|
+
<Table
|
|
724
|
+
data={USERS}
|
|
725
|
+
columnDefinitions={columns}
|
|
726
|
+
columnsSettings={{ enableDrag: true, enableSettingsMenu: true }}
|
|
727
|
+
suppressPagination
|
|
728
|
+
outline
|
|
729
|
+
/>
|
|
730
|
+
);
|
|
731
|
+
}
|
|
732
|
+
```
|
|
733
|
+
|
|
734
|
+
#### Режим карточек
|
|
735
|
+
|
|
736
|
+
`defaultView="cards"` + `showDataView` + `headlineId`; переключатель table/cards в тулбаре.
|
|
737
|
+
|
|
738
|
+
```tsx
|
|
739
|
+
import { ColumnDefinition, Table, VIEW } from '@cloud-ru/ds-table';
|
|
740
|
+
|
|
741
|
+
type User = {
|
|
742
|
+
id: string;
|
|
743
|
+
name: string;
|
|
744
|
+
email: string;
|
|
745
|
+
role: string;
|
|
746
|
+
balance: number;
|
|
747
|
+
};
|
|
748
|
+
|
|
749
|
+
const USERS: User[] = [
|
|
750
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', balance: 12990 },
|
|
751
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', balance: 8450 },
|
|
752
|
+
{ id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', balance: 4300 },
|
|
753
|
+
{ id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer', balance: 0 },
|
|
754
|
+
{ id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', balance: 990 },
|
|
755
|
+
{ id: 'u-6', name: 'Егор Морозов', email: 'egor.morozov@example.com', role: 'Admin', balance: 15600 },
|
|
756
|
+
];
|
|
757
|
+
|
|
758
|
+
const columns: ColumnDefinition<User>[] = [
|
|
759
|
+
{ accessorKey: 'name', header: 'Имя', enableSorting: true, size: 200 },
|
|
760
|
+
{ accessorKey: 'email', header: 'Email', size: 240 },
|
|
761
|
+
{ accessorKey: 'role', header: 'Роль', size: 140 },
|
|
762
|
+
{ accessorKey: 'balance', header: 'Баланс', enableSorting: true, size: 140 },
|
|
763
|
+
];
|
|
764
|
+
|
|
765
|
+
export function CardView() {
|
|
766
|
+
return (
|
|
767
|
+
<Table
|
|
768
|
+
data={USERS}
|
|
769
|
+
columnDefinitions={columns}
|
|
770
|
+
// Стартовый вид — карточки; `showDataView` включает переключатель table/cards
|
|
771
|
+
// в тулбаре (по умолчанию его нет). `headlineId` задаёт заголовок карточки.
|
|
772
|
+
defaultView={VIEW.Cards}
|
|
773
|
+
showDataView
|
|
774
|
+
headlineId='name'
|
|
775
|
+
getRowId={user => user.id}
|
|
776
|
+
rowSelection={{ enable: true, multiRow: true }}
|
|
777
|
+
sorting={{ initialState: [{ id: 'name', desc: false }] }}
|
|
778
|
+
outline
|
|
779
|
+
/>
|
|
780
|
+
);
|
|
781
|
+
}
|
|
782
|
+
```
|
|
783
|
+
|
|
784
|
+
#### Мобильная раскладка
|
|
785
|
+
|
|
786
|
+
`AdaptiveProvider layoutType="mobile"` + `defaultView="cards"` — список карточек; в table-виде на mobile — сетка строк. По умолчанию `stickyControls.enabled: true`, offsets `0`; отступ под sticky header документации — `layoutPresets.mobile`.
|
|
787
|
+
|
|
788
|
+
```tsx
|
|
789
|
+
import { AdaptiveProvider, LAYOUT_TYPE } from '@cloud-ru/ds-adaptive';
|
|
790
|
+
import {
|
|
791
|
+
ColumnDefinition,
|
|
792
|
+
getStatusColumnDef,
|
|
793
|
+
MapStatusToAppearanceFnType,
|
|
794
|
+
STATUS_APPEARANCE,
|
|
795
|
+
Table,
|
|
796
|
+
VIEW,
|
|
797
|
+
} from '@cloud-ru/ds-table';
|
|
798
|
+
|
|
799
|
+
type User = {
|
|
800
|
+
id: string;
|
|
801
|
+
name: string;
|
|
802
|
+
email: string;
|
|
803
|
+
role: string;
|
|
804
|
+
status: string;
|
|
805
|
+
};
|
|
806
|
+
|
|
807
|
+
const USERS: User[] = [
|
|
808
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna@example.com', role: 'Owner', status: 'active' },
|
|
809
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris@example.com', role: 'Admin', status: 'pending' },
|
|
810
|
+
{ id: 'u-3', name: 'Вера Сидорова', email: 'vera@example.com', role: 'Editor', status: 'active' },
|
|
811
|
+
];
|
|
812
|
+
|
|
813
|
+
const mapStatusToAppearance: MapStatusToAppearanceFnType = value =>
|
|
814
|
+
value === 'active' ? STATUS_APPEARANCE.Green : STATUS_APPEARANCE.Orange;
|
|
815
|
+
|
|
816
|
+
const columns: ColumnDefinition<User>[] = [
|
|
817
|
+
getStatusColumnDef<User>({
|
|
818
|
+
accessorKey: 'status',
|
|
819
|
+
mapStatusToAppearance,
|
|
820
|
+
renderDescription: value => (value === 'active' ? 'Активен' : 'Ожидает'),
|
|
821
|
+
header: 'Статус',
|
|
822
|
+
size: 160,
|
|
823
|
+
}),
|
|
824
|
+
{ accessorKey: 'name', header: 'Имя', enableSorting: true },
|
|
825
|
+
{ accessorKey: 'email', header: 'Email' },
|
|
826
|
+
{ accessorKey: 'role', header: 'Роль' },
|
|
827
|
+
];
|
|
828
|
+
|
|
829
|
+
/** Высота sticky header сайта документации (`apps/docs` → `$docs-header-height`). */
|
|
830
|
+
const DOCS_HEADER_HEIGHT = 52;
|
|
831
|
+
|
|
832
|
+
export function MobileLayout() {
|
|
833
|
+
return (
|
|
834
|
+
<AdaptiveProvider layoutType={LAYOUT_TYPE.Mobile}>
|
|
835
|
+
<div style={{ maxWidth: 375 }}>
|
|
836
|
+
<Table
|
|
837
|
+
data={USERS}
|
|
838
|
+
columnDefinitions={columns}
|
|
839
|
+
defaultView={VIEW.Cards}
|
|
840
|
+
headlineId='name'
|
|
841
|
+
sorting={{}}
|
|
842
|
+
columnsSettings={{ enableSettingsMenu: true }}
|
|
843
|
+
layoutPresets={{
|
|
844
|
+
mobile: {
|
|
845
|
+
stickyControls: { enabled: true, offsetTop: DOCS_HEADER_HEIGHT, offsetBottom: 0 },
|
|
846
|
+
},
|
|
847
|
+
}}
|
|
848
|
+
outline
|
|
849
|
+
/>
|
|
850
|
+
</div>
|
|
851
|
+
</AdaptiveProvider>
|
|
852
|
+
);
|
|
853
|
+
}
|
|
854
|
+
```
|
|
855
|
+
|
|
856
|
+
#### Ширина таблицы
|
|
857
|
+
|
|
858
|
+
По умолчанию таблица растягивается на контейнер (`fullWidth`). При `fullWidth={false}` на desktop обводка и сетка сжимаются до суммы фиксированных колонок — удобно в модалках и узких формах. На mobile режим fit-content не применяется.
|
|
859
|
+
|
|
860
|
+
```tsx
|
|
861
|
+
import { ColumnDefinition, Table } from '@cloud-ru/ds-table';
|
|
862
|
+
|
|
863
|
+
type User = {
|
|
864
|
+
id: string;
|
|
865
|
+
name: string;
|
|
866
|
+
email: string;
|
|
867
|
+
role: string;
|
|
868
|
+
balance: number;
|
|
869
|
+
};
|
|
870
|
+
|
|
871
|
+
const USERS: User[] = [
|
|
872
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', balance: 12990 },
|
|
873
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', balance: 8450 },
|
|
874
|
+
{ id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', balance: 4300 },
|
|
875
|
+
{ id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer', balance: 0 },
|
|
876
|
+
{ id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', balance: 990 },
|
|
877
|
+
];
|
|
878
|
+
|
|
879
|
+
const balanceFormatter = new Intl.NumberFormat('ru-RU', {
|
|
880
|
+
style: 'currency',
|
|
881
|
+
currency: 'RUB',
|
|
882
|
+
maximumFractionDigits: 0,
|
|
883
|
+
});
|
|
884
|
+
|
|
885
|
+
const columns: ColumnDefinition<User>[] = [
|
|
886
|
+
{ accessorKey: 'name', header: 'Имя', enableSorting: true, size: 200 },
|
|
887
|
+
{ accessorKey: 'email', header: 'Email', size: 240 },
|
|
888
|
+
{ accessorKey: 'role', header: 'Роль', enableSorting: true, size: 140 },
|
|
889
|
+
{
|
|
890
|
+
accessorKey: 'balance',
|
|
891
|
+
header: 'Баланс',
|
|
892
|
+
align: 'right',
|
|
893
|
+
headerAlign: 'right',
|
|
894
|
+
enableSorting: true,
|
|
895
|
+
size: 140,
|
|
896
|
+
cell: ctx => balanceFormatter.format(Number(ctx.getValue() ?? 0)),
|
|
897
|
+
},
|
|
898
|
+
];
|
|
899
|
+
|
|
900
|
+
const tableProps = {
|
|
901
|
+
data: USERS,
|
|
902
|
+
columnDefinitions: columns,
|
|
903
|
+
pageSize: 5,
|
|
904
|
+
pagination: { options: [5, 10] },
|
|
905
|
+
outline: true,
|
|
906
|
+
suppressToolbar: true,
|
|
907
|
+
};
|
|
908
|
+
|
|
909
|
+
export function FullWidth() {
|
|
910
|
+
return (
|
|
911
|
+
<div style={{ display: 'flex', flexDirection: 'column', gap: 24, width: '100%', maxWidth: 960 }}>
|
|
912
|
+
<Table {...tableProps} />
|
|
913
|
+
<Table {...tableProps} fullWidth={false} />
|
|
914
|
+
</div>
|
|
915
|
+
);
|
|
916
|
+
}
|
|
917
|
+
```
|
|
918
|
+
|
|
919
|
+
### Props
|
|
920
|
+
|
|
921
|
+
**TableProps**
|
|
922
|
+
|
|
923
|
+
| Prop | Type | Default | Description |
|
|
924
|
+
|------|------|---------|-------------|
|
|
925
|
+
| `autoResetPageIndex` | `boolean` | `false` | Автоматический сброс пагинации к первой странице при изменении данных/фильтров/сортировки |
|
|
926
|
+
| `bulkActions` | `BulkAction` | — | Список действий для массовых операций |
|
|
927
|
+
| `cardColumns` | `number` | — | Желаемое число колонок карточного вида (`view='cards'`). <br/> На широком контейнере рисуется ровно столько колонок; при сужении сетка <br/> схлопывается до меньшего числа (порог — `cardMinWidth`). Без пропа число <br/> колонок определяется только шириной контейнера и `cardMinWidth` (auto-fill). |
|
|
928
|
+
| `cardMinWidth` | `number` | `320` | Минимальная ширина карточки в `view='cards'`, px. Порог, ниже которого <br/> колонки схлопываются. Карточка ужимается до ширины контейнера, если он уже. |
|
|
929
|
+
| `className` | `string` | — | CSS-класс |
|
|
930
|
+
| `columnDefinitions` | `ColumnDefinition` \| `Except` \| `TData` | — | Определение внешнего вида и функционала колонок |
|
|
931
|
+
| `columnFilters` | `FilterRow` \| `TFilters` | — | Фильтры |
|
|
932
|
+
| `columnVirtualizerInstanceRef` | `ColumnVirtualizer` | — | Ref на инстанс column-virtualizer'а для управления прокруткой снаружи |
|
|
933
|
+
| `columnVirtualizerOptions` | `Partial<VirtualizerOptions<HTMLElement, Element>>` | — | Дополнительные параметры column-virtualizer'а (`@tanstack/react-virtual`). <br/> Переопределяют дефолты (overscan=3). |
|
|
934
|
+
| `columnsSettings` | `{ enableDrag?: boolean; enableSettingsMenu?: boolean; } \| undefined` | — | Настройки колонок: `enableDrag` — переупорядочивание (заголовки таблицы и строки в меню настроек); <br/> `enableSettingsMenu` — меню показа колонок. |
|
|
935
|
+
| `copyPinnedRows` | `boolean` | `false` | Параметр отвечает за сохранение закрепленных строк в теле таблицы |
|
|
936
|
+
| `data` | `TData` | — | Данные для отрисовки |
|
|
937
|
+
| `data-test-id` | `string` | — | |
|
|
938
|
+
| `dataError` | `boolean` | — | Флаг, показывающий что произошла ошибка запроса при пустых данных |
|
|
939
|
+
| `dataFiltered` | `boolean` | — | Флаг, показывающий что данные были отфильтрованы при пустых данных |
|
|
940
|
+
| `defaultView` | `"cards"` \| `"table"` | `'table' (на mobile — `cards`)` | Начальный режим отображения (uncontrolled). <br/> Если не задан — дефолт по раскладке: `table` на desktop, `cards` на mobile (`TABLE_LAYOUT_PRESETS`). |
|
|
941
|
+
| `enableColumnVirtualization` | `boolean` | `false` | Включает виртуализацию колонок (windowing по горизонтали). <br/> Рекомендуется при > 30 видимых колонок. Несовместимо с `view='cards'`. <br/> Pinned-колонки (left/right) всегда отрисовываются вне зависимости от настройки. |
|
|
942
|
+
| `enableFuzzySearch` | `boolean` | — | Включить нечеткий поиск |
|
|
943
|
+
| `enableRowVirtualization` | `boolean` | `false` | Включает виртуализацию строк (windowing по вертикали). <br/> Рекомендуется при > 200 строк. Несовместимо с `view='cards'` — при картах игнорируется. |
|
|
944
|
+
| `enableSelectPinned` | `boolean` | `false` | Параметр отвечает за чекбокс выбора закрепленных строк |
|
|
945
|
+
| `errorDataState` | `EmptyStateProps` | — | Экран при ошибке запроса |
|
|
946
|
+
| `expanding` | `TData` \| `TreeColumnDefinitionProps` | — | Общие настройки раскрывающихся (tree) строк: `getSubRows`, `expandingColumnDefinition`, <br/> `initialState`, `state`, `onChange`. |
|
|
947
|
+
| `fullWidth` | `boolean` | `true` | Растягивать таблицу на всю ширину контейнера. <br/> При `false` ширина определяется суммой колонок (лучше всего, когда у всех колонок задан `size` / `width`). <br/> Явный проп = desktop-значение; на mobile всегда `true` (`TABLE_LAYOUT_PRESETS`). |
|
|
948
|
+
| `getRowBackgroundColor` | `TData` \| `TableRowColor` | — | Функция определения цвета фона строки по её данным. <br/> Работает только в `view='table'` — карточки (`view='cards'`) не тонируются. <br/> @param data данные строки <br/> @returns цвет фона строки или `undefined` |
|
|
949
|
+
| `getRowId` | `TData` | — | Функция получения уникального идентификатора строки |
|
|
950
|
+
| `hasMore` | `boolean` | — | Есть ли ещё данные для загрузки. Управляет видимостью кнопки / активностью observer-а. |
|
|
951
|
+
| `headerRowBackgroundColor` | `"blue"` \| `"green"` \| `"neutral"` \| `"orange"` \| `"pink"` \| `"red"` \| `"violet"` \| `"yellow"` | — | Accent-тон фона строки заголовков колонок (`tableHeadLine`). <br/> Работает только в `view='table'`. |
|
|
952
|
+
| `headlineId` | `string` | — | Id колонки, чей рендер используется как заголовок карточки в режиме `view='cards'`. <br/> Имеет смысл только при `view='cards'`. |
|
|
953
|
+
| `infiniteLoading` | `boolean` | `false` | Режим работы "бесконечной" загрузки |
|
|
954
|
+
| `keepPinnedRows` | `boolean` | `false` | Параметр отвечает за отображение закрепленных строк на всех страницах таблицы |
|
|
955
|
+
| `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'` — кнопка «Загрузить ещё» под таблицей. |
|
|
957
|
+
| `loading` | `boolean` | `false` | Состояние загрузки |
|
|
958
|
+
| `manualFiltering` | `boolean` | `false` | |
|
|
959
|
+
| `manualPagination` | `boolean` | `false` | |
|
|
960
|
+
| `manualSorting` | `boolean` | `false` | |
|
|
961
|
+
| `moreActions` | `TFilters` \| `ToolbarProps` | — | Элементы выпадающего списка кнопки с действиями |
|
|
962
|
+
| `noDataState` | `EmptyStateProps` | — | Экран при отсутствии данных |
|
|
963
|
+
| `noResultsState` | `EmptyStateProps` | — | Экран при отсутствии результатов поиска или фильтров |
|
|
964
|
+
| `onExport` | `(() => void)` | — | Колбэк экспорта данных. Рендерит иконку в тулбаре перед настройками колонок. |
|
|
965
|
+
| `onLoadMore` | `(() => void)` | — | Колбэк дозагрузки следующей порции данных. <br/> В режиме `loadMoreTrigger='scroll'` вызывается автоматически при достижении конца списка; <br/> в режиме `loadMoreTrigger='button'` — по нажатию кнопки «Загрузить ещё». |
|
|
966
|
+
| `onRefresh` | `(() => void)` | — | Колбэк обновления данных |
|
|
967
|
+
| `onRowClick` | `RowClickHandler` \| `TData` | — | Колбэк клика по строке |
|
|
968
|
+
| `onViewChange` | `((view: View) => void)` | — | Колбэк на смену режима отображения |
|
|
969
|
+
| `outline` | `boolean` | `false` | Внешний бордер для тулбара и таблицы |
|
|
970
|
+
| `pageCount` | `number` | — | Кол-во страниц (для внешнего управления) |
|
|
971
|
+
| `pageSize` | `number` | `10` | Максимальное кол-во строк на страницу |
|
|
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`. |
|
|
973
|
+
| `renderCard` | `((context: RenderCardContext<TData>) => ReactNode)` | — | Кастомный рендер карточки в `view='cards'`. Получает контекст с tanstack <br/> `row` / `table` и `defaultRender` (готовый элемент дефолтной карточки — <br/> можно обернуть). Возврат заменяет дефолтную карточку. |
|
|
974
|
+
| `rowAutoHeight` | `boolean` | — | |
|
|
975
|
+
| `rowPinning` | `Pick<RowPinningState, "top">` | `{ top: [], }` | Определение, какие строки должны быть закреплены в таблице |
|
|
976
|
+
| `rowSelection` | `RowAppearance` \| `TData` | — | Параметры выбора строк: `initialState`, `state`, `enable`, `appearance`, `multiRow`, `onChange`. |
|
|
977
|
+
| `rowVirtualizerInstanceRef` | `RowVirtualizer` | — | Ref на инстанс row-virtualizer'а для управления прокруткой снаружи |
|
|
978
|
+
| `rowVirtualizerOptions` | `Partial<VirtualizerOptions<HTMLElement, Element>>` | — | Дополнительные параметры row-virtualizer'а (`@tanstack/react-virtual`). <br/> Переопределяют дефолты (overscan=10, estimateSize=40). |
|
|
979
|
+
| `savedState` | `TFilters` \| `ToolbarPersistConfig` | — | Конфиг сохранения состояния в localStorage и queryParams. <br/> `id` должен быть уникальным для разных таблиц в рамках приложения. |
|
|
980
|
+
| `scrollContainerRef` | `RefObject<HTMLElement>` | — | Ссылка на контейнер, который скроллится |
|
|
981
|
+
| `scrollRef` | `Ref<HTMLElement>` | — | Ссылка на элемент, обозначающий самый конец прокручиваемого списка |
|
|
982
|
+
| `search` | `{ initialState?: string; state?: string; placeholder?: string \| undefined; loading?: boolean \| undefined; onChange?(value: string): void; } \| undefined` | — | Параметры глобального поиска: `initialState`, `state`, `placeholder`, `loading`, `onChange`. |
|
|
983
|
+
| `showDataView` | `boolean` | `false` | Показывать переключатель вида (таблица/карточки) в тулбаре. <br/> Управляет только видимостью тоггла; сам вид задаётся `view` / `defaultView`. <br/> По умолчанию тоггла нет — таблица показывает один вид (`defaultView` либо <br/> адаптивный дефолт). Включите `showDataView`, чтобы дать пользователю <br/> переключать table/cards. |
|
|
984
|
+
| `sorting` | `{ initialState?: SortingState; state?: SortingState; onChange?(state: SortingState): void; } \| undefined` | — | Параметры отвечают за возможность сортировки: <br/> `initialState` — начальное состояние; `state` — управляемое снаружи; `onChange` — колбэк на изменение. |
|
|
985
|
+
| `stickyControls` | `StickyControls` | — | Sticky-хром при скролле страницы: при `enabled: true` тулбар и пагинация липнут к верху/низу <br/> viewport, в table-view заголовок колонок — под тулбаром; тело растёт по контенту. <br/> При `enabled: false` все блоки идут сплошным потоком без sticky. <br/> Дефолты: desktop — `enabled: false` (offsets не применяются); <br/> mobile — `{ enabled: true, offsetTop: 0, offsetBottom: 0 }` (`TABLE_LAYOUT_PRESETS`); <br/> `backgroundPredefined` — `neutralBackground1Level` на всех раскладках. <br/> Явный проп = desktop-значение; mobile-override — `layoutPresets.mobile`. <br/> @example `stickyControls={{ enabled: true, offsetTop: 64 }}` — sticky на desktop, app header 64px. |
|
|
986
|
+
| `suppressHeader` | `boolean` | `false` | Отключение хедера таблицы; в режиме `view='cards'` скрывает подписи-заголовки полей карточки |
|
|
987
|
+
| `suppressPagination` | `boolean` | `false` | Отключение пагинации |
|
|
988
|
+
| `suppressSearch` | `boolean` | `false` | Отключение поиска |
|
|
989
|
+
| `suppressToolbar` | `boolean` | `false` | Отключение тулбара |
|
|
990
|
+
| `toolbarAfter` | `ReactNode` | — | Дополнительный слот в `Toolbar` после строки поиска |
|
|
991
|
+
| `toolbarCheckBoxMode` | `"allRows"` \| `"pageRows"` | — | Охват мастер-чекбокса выбора: текущая страница или все строки `data` (только клиентская таблица) |
|
|
992
|
+
| `view` | `"cards"` \| `"table"` | `'table' (на mobile — `cards`)` | Режим отображения таблицы (controlled). <br/> `table` — классическая сетка; `cards` — карточки (заголовок берётся из колонки `headlineId`). <br/> Переключатель вида в тулбаре включается отдельным пропом `showDataView`. |
|
|
993
|
+
|
|
994
|
+
##### Related types
|
|
995
|
+
|
|
996
|
+
- `ColumnDefinition` = `NormalColumnDefinition<TData> | PinnedColumnDefinition<TData> | FilterableColumnDefinition<TData>`
|
|
997
|
+
|
|
998
|
+
**EmptyStateProps**
|
|
999
|
+
|
|
1000
|
+
| Prop | Type | Default | Description |
|
|
1001
|
+
|------|------|---------|-------------|
|
|
1002
|
+
| `className` | `string \| undefined` | — | Дополнительный класс |
|
|
1003
|
+
| `content` | `string \| number \| boolean \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal \| null \| undefined` | — | Подзаголовок |
|
|
1004
|
+
| `footer` | `string \| number \| boolean \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal \| null \| undefined` | — | Вложенный контент (например ButtonGroup) |
|
|
1005
|
+
| `icon` | `IconPredefinedProps` | — | Иконка |
|
|
1006
|
+
| `title` | `string \| undefined` | — | Заголовок |
|
|
1007
|
+
|
|
1008
|
+
- `Except` = `{ [KeyType in keyof ObjectType as Filter<KeyType, KeysType>]: ObjectType[KeyType]; }`
|
|
1009
|
+
|
|
1010
|
+
- `RowClickHandler` = `(e: MouseEvent<HTMLDivElement>, row: RowInfo<TData>) => void`
|
|
1011
|
+
|
|
1012
|
+
- `TreeColumnDefinitionProps` = `TreeColumnDef | TreeColumnDefWithDescription<TData>`
|
|
1013
|
+
|
|
1014
|
+
- `View` = `"cards"` \| `"table"`
|
|
1015
|
+
|
|
1016
|
+
### Смотри также
|
|
1017
|
+
|
|
1018
|
+
- **Обзор пакета** — архитектура, выбор компонента, preset-ы.
|
|
1019
|
+
- **`defineColumns`** — декларативные колонки для preset-ов и escape hatch.
|
|
1020
|
+
- **SimpleTable** — минимальный клиентский preset.
|
|
1021
|
+
- **AdminTable** — админ-экран на клиенте.
|
|
1022
|
+
- **TreeTable** — иерархические данные.
|
|
1023
|
+
- **InfiniteTable** — бесконечная прокрутка.
|
|
1024
|
+
- **ServerTable** — постраничные данные с бэкенда.
|
|
1025
|
+
- **Pagination** — отдельный компонент пагинации.
|
|
1026
|
+
- **InfoBlock** — основа пустых состояний таблицы.
|
|
1027
|
+
### Адаптивность
|
|
1028
|
+
|
|
1029
|
+
`Table` — адаптивный компонент класса preset-defaults: DOM один, по раскладке меняются только дефолты пропсов. Раскладку компонент читает из контекста **`@cloud-ru/ds-adaptive`** — отдельного пропа `layoutType` нет.
|
|
1030
|
+
|
|
1031
|
+
> **Desktop-first.** Верстайте под desktop и поставьте один `<AdaptiveProvider>` в корне приложения — mobile-дефолты применяются автоматически. Override нужен только как escape-hatch.
|
|
1032
|
+
|
|
1033
|
+
На mobile тулбар, шапка и пагинация автоматически залипают при прокрутке (`stickyControls.enabled`); на desktop таблица прокручивается свободно.
|
|
1034
|
+
`offsetTop` / `offsetBottom` — дополнительный отступ chrome-контролов от краёв viewport (px), если над/под таблицей есть внешний sticky UI (app header, tab bar); работают только при `stickyControls.enabled`.
|
|
1035
|
+
|
|
1036
|
+
| Поле `stickyControls` | desktop | mobile |
|
|
1037
|
+
| ----------------------- | ------------------------- | ----------------------- |
|
|
1038
|
+
| `enabled` | `false` | `true` |
|
|
1039
|
+
| `offsetTop` | — (sticky выключен) | `0` |
|
|
1040
|
+
| `offsetBottom` | — (sticky выключен) | `0` |
|
|
1041
|
+
| `backgroundPredefined` | — (sticky выключен) | `neutralBackground1Level` |
|
|
1042
|
+
| `fullWidth` | `true` (явный проп) | `true` (`TABLE_LAYOUT_PRESETS`) |
|
|
1043
|
+
| `defaultView` | `table` | `cards` (`TABLE_LAYOUT_PRESETS`) |
|
|
1044
|
+
|
|
1045
|
+
Проп `showDataView` (видимость переключателя вида) **не** адаптивный — это обычный булев проп с дефолтом `false` на всех раскладках.
|
|
1046
|
+
|
|
1047
|
+
Ненулевые `offsetTop` / `offsetBottom` на mobile — через `layoutPresets.mobile`. Объект `stickyControls` в пресете **заменяет** DS-дефолт целиком — передайте все нужные поля (`enabled`, offsets).
|
|
1048
|
+
|
|
1049
|
+
```tsx
|
|
1050
|
+
<Table
|
|
1051
|
+
stickyControls={{ enabled: true, offsetTop: 64 }}
|
|
1052
|
+
layoutPresets={{
|
|
1053
|
+
mobile: { stickyControls: { enabled: true, offsetTop: 48, offsetBottom: 56 } },
|
|
1054
|
+
}}
|
|
1055
|
+
/>
|
|
1056
|
+
```
|
|
1057
|
+
|
|
1058
|
+
Источник mobile-дефолтов — экспортируемая константа `TABLE_LAYOUT_PRESETS`.
|
|
1059
|
+
|
|
1060
|
+
#### Как переопределить
|
|
1061
|
+
|
|
1062
|
+
**Desktop-first:** перенос пропа из desktop-макета не ломает mobile. Приоритет (от высшего к низшему): `layoutPresets[layout]` (инстанс) → DS-пресет `TABLE_LAYOUT_PRESETS` → явный проп (= desktop-значение) → базовый дефолт.
|
|
1063
|
+
|
|
1064
|
+
```tsx
|
|
1065
|
+
import { Table } from '@cloud-ru/ds-table'
|
|
1066
|
+
|
|
1067
|
+
// 1. Явный проп — задаёт DESKTOP-значение; mobile остаётся enabled=true (mobile не ломается)
|
|
1068
|
+
<Table stickyControls={{ enabled: true }} columnDefinitions={[]} data={[]} />
|
|
1069
|
+
|
|
1070
|
+
// 2. layoutPresets.mobile — единственный способ отключить sticky на mobile (явно)
|
|
1071
|
+
<Table layoutPresets={{ mobile: { stickyControls: { enabled: false } } }} columnDefinitions={[]} data={[]} />
|
|
1072
|
+
|
|
1073
|
+
// 2b. layoutPresets.desktop — включить sticky только на desktop, mobile-адаптив сохранён
|
|
1074
|
+
<Table layoutPresets={{ desktop: { stickyControls: { enabled: true } } }} columnDefinitions={[]} data={[]} />
|
|
1075
|
+
```
|
|
1076
|
+
|
|
1077
|
+
DS-пресет (`TABLE_LAYOUT_PRESETS`) — точка форка mobile-дефолтов на уровне всей дизайн-системы.
|
|
1078
|
+
|
|
1079
|
+
#### Как форсировать раскладку
|
|
1080
|
+
|
|
1081
|
+
Раскладка переключается только контекстом, не пропом:
|
|
1082
|
+
|
|
1083
|
+
```tsx
|
|
1084
|
+
import { AdaptiveProvider, withLayoutType } from '@cloud-ru/ds-adaptive';
|
|
1085
|
+
import { Table } from '@cloud-ru/ds-table';
|
|
1086
|
+
|
|
1087
|
+
// поддерево — вложенный провайдер
|
|
1088
|
+
<AdaptiveProvider layoutType='mobile'>
|
|
1089
|
+
<Table columnDefinitions={[]} data={[]} />
|
|
1090
|
+
</AdaptiveProvider>;
|
|
1091
|
+
|
|
1092
|
+
// компонент/секция — HOC (module-scope, не в рендере)
|
|
1093
|
+
const MobileTable = withLayoutType(Table, 'mobile');
|
|
1094
|
+
```
|
|
1095
|
+
|
|
1096
|
+
Подробнее о модели раскладки — в **`@cloud-ru/ds-adaptive`**.
|
|
1097
|
+
|
|
1098
|
+
## ServerTable
|
|
1099
|
+
|
|
1100
|
+
Таблица для серверных данных: постраничная загрузка items/total/limit/offset, controlled-поиск и серверная сортировка.
|
|
1101
|
+
|
|
1102
|
+
`ServerTable` — обёртка над **`Table`** для постраничных данных с бэкенда. Страница данных приходит снаружи (`items` / `total` / `limit` / `offset`), смена страницы, поиск и сортировка делегируются серверу: компонент вызывает `onChangePage`, `search.onChange` и `sorting.onChange`, а отрисовывает то, что передано в пропсах.
|
|
1103
|
+
|
|
1104
|
+
Для типовых серверных сценариев есть preset-ы `ServerSimpleTable` и `ServerAdminTable` (см. **обзор пакета**) — они маппят упрощённый API в `ServerTable`, как `SimpleTable` / `AdminTable` маппят в `Table`.
|
|
1105
|
+
|
|
1106
|
+
### Когда использовать
|
|
1107
|
+
|
|
1108
|
+
- Данные приходят с бэкенда постранично, известно общее количество строк (`total`).
|
|
1109
|
+
- Поиск и сортировка выполняются на сервере, а не на клиенте.
|
|
1110
|
+
- Объём данных слишком велик для загрузки на клиент целиком.
|
|
1111
|
+
|
|
1112
|
+
Когда **не** нужен:
|
|
1113
|
+
|
|
1114
|
+
- Данные загружены на клиент целиком:
|
|
1115
|
+
- используйте **`Table`** или **`SimpleTable`** — пагинация, поиск и сортировка работают локально.
|
|
1116
|
+
|
|
1117
|
+
Рекомендации по выбору API:
|
|
1118
|
+
|
|
1119
|
+
- Простой серверный список (колонки + пагинация) — `ServerSimpleTable`.
|
|
1120
|
+
- Админ-экран с поиском, статусом, выбором и действиями — `ServerAdminTable`.
|
|
1121
|
+
- Нестандартные колонки, фильтры или поведение тулбара — `ServerTable` напрямую.
|
|
1122
|
+
|
|
1123
|
+
### Анатомия
|
|
1124
|
+
|
|
1125
|
+
#### Постраничная загрузка (default `limit` 10, `offset` 0)
|
|
1126
|
+
|
|
1127
|
+
- `items` — строки текущей страницы.
|
|
1128
|
+
- `total` — общее количество строк; по нему рассчитывается число страниц.
|
|
1129
|
+
- `limit` / `offset` — размер страницы и смещение текущей страницы.
|
|
1130
|
+
- `onChangePage(offset, limit)` — вызывается при смене страницы или размера страницы; здесь выполняется запрос новой страницы.
|
|
1131
|
+
- `pagination.options` / `pagination.optionsLabel` — варианты числа строк на страницу и подпись к ним.
|
|
1132
|
+
|
|
1133
|
+
#### Поиск (controlled)
|
|
1134
|
+
|
|
1135
|
+
- `search.state` и `search.onChange` обязательны — значение поиска хранится снаружи, в отличие от `Table`.
|
|
1136
|
+
- `search.loading` — индикатор загрузки в строке поиска.
|
|
1137
|
+
- `search.initialValue` — начальное значение.
|
|
1138
|
+
- Ввод дебаунсится внутри компонента (500 мс, отдельный таймер на каждый инстанс) — `onChange` получает значение после паузы ввода. При смене запроса обычно сбрасывают `offset` в `0`.
|
|
1139
|
+
|
|
1140
|
+
#### Серверная сортировка
|
|
1141
|
+
|
|
1142
|
+
- По умолчанию включён `manualSorting` — таблица не сортирует `items` на клиенте.
|
|
1143
|
+
- Передайте управляемый `sorting.state` + `sorting.onChange`; при смене сортировки запросите новую страницу и сбросьте `offset` в `0`.
|
|
1144
|
+
- Колонки с `enableSorting: true` отображают индикатор сортировки; фактическое упорядочивание выполняет бэкенд.
|
|
1145
|
+
|
|
1146
|
+
#### Интеграция с бэкендом
|
|
1147
|
+
|
|
1148
|
+
Типичный контракт на стороне приложения:
|
|
1149
|
+
|
|
1150
|
+
1. Хранить `items`, `total`, `loading`, `offset`, `limit`, `search`, `sorting` в state.
|
|
1151
|
+
2. В `useEffect` (или data-fetch хуке) запрашивать страницу при изменении `offset` / `limit` / `search` / `sorting`.
|
|
1152
|
+
3. В `onChangePage` обновлять `offset` и `limit`; в `search.onChange` и `sorting.onChange` — сбрасывать `offset` в `0`.
|
|
1153
|
+
4. При параллельных запросах отбрасывать устаревшие ответы (счётчик `requestId` / `AbortController`) — иначе медленный ответ может перезаписать актуальные данные.
|
|
1154
|
+
5. Пробрасывать `loading` в `ServerTable` и в `search.loading` на время запроса.
|
|
1155
|
+
|
|
1156
|
+
#### Отличия от Table
|
|
1157
|
+
|
|
1158
|
+
- Данные передаются через `items` (вместо `data`) — только текущая страница.
|
|
1159
|
+
- Вырезаны `pageSize`, `pageCount`, `pagination.state`, `toolbarCheckBoxMode` — пагинацией управляет бэкенд через `limit` / `offset` / `total`.
|
|
1160
|
+
- Серверная сортировка — `manualSorting` + управляемый `sorting.state` / `onChange`.
|
|
1161
|
+
- Остальное API — колонки, служебные колонки, выбор строк, дерево, режим карточек, тулбар — наследуется от `Table`.
|
|
1162
|
+
|
|
1163
|
+
### Примеры использования
|
|
1164
|
+
|
|
1165
|
+
{/* client:only='react': SSR демо невозможен — @cloud-ru/ds-list использует в dist directory-imports, которые Node-ESM не резолвит (тот же паттерн, что в @cloud-ru/ds-chips). */}
|
|
1166
|
+
|
|
1167
|
+
#### Серверный сценарий
|
|
1168
|
+
|
|
1169
|
+
Имитация бэкенда: `onChangePage`, controlled-поиск и сортировка с `manualSorting`, сброс `offset` при фильтрах, отмена устаревших ответов через `requestId`.
|
|
1170
|
+
|
|
1171
|
+
```tsx
|
|
1172
|
+
import { ColumnDefinition, ServerTable, SortingState } from '@cloud-ru/ds-table';
|
|
1173
|
+
import { useEffect, useRef, useState } from 'react';
|
|
1174
|
+
|
|
1175
|
+
type User = {
|
|
1176
|
+
id: string;
|
|
1177
|
+
name: string;
|
|
1178
|
+
email: string;
|
|
1179
|
+
role: string;
|
|
1180
|
+
balance: number;
|
|
1181
|
+
};
|
|
1182
|
+
|
|
1183
|
+
const NAMES = [
|
|
1184
|
+
'Анна Иванова',
|
|
1185
|
+
'Борис Петров',
|
|
1186
|
+
'Вера Сидорова',
|
|
1187
|
+
'Глеб Кузнецов',
|
|
1188
|
+
'Дарья Орлова',
|
|
1189
|
+
'Егор Морозов',
|
|
1190
|
+
'Жанна Волкова',
|
|
1191
|
+
'Захар Соколов',
|
|
1192
|
+
];
|
|
1193
|
+
|
|
1194
|
+
const ROLES = ['Owner', 'Admin', 'Editor', 'Viewer'];
|
|
1195
|
+
|
|
1196
|
+
const ALL_USERS: User[] = Array.from({ length: 23 }, (_, index) => ({
|
|
1197
|
+
id: `u-${index + 1}`,
|
|
1198
|
+
name: NAMES[index % NAMES.length],
|
|
1199
|
+
email: `user-${index + 1}@example.com`,
|
|
1200
|
+
role: ROLES[index % ROLES.length],
|
|
1201
|
+
balance: (index * 1730) % 20000,
|
|
1202
|
+
}));
|
|
1203
|
+
|
|
1204
|
+
function compareUsers(a: User, b: User, columnId: string, desc: boolean): number {
|
|
1205
|
+
const left = a[columnId as keyof User];
|
|
1206
|
+
const right = b[columnId as keyof User];
|
|
1207
|
+
const order =
|
|
1208
|
+
typeof left === 'number' && typeof right === 'number' ? left - right : String(left).localeCompare(String(right));
|
|
1209
|
+
|
|
1210
|
+
return desc ? -order : order;
|
|
1211
|
+
}
|
|
1212
|
+
|
|
1213
|
+
type PageResponse = {
|
|
1214
|
+
items: User[];
|
|
1215
|
+
total: number;
|
|
1216
|
+
};
|
|
1217
|
+
|
|
1218
|
+
// Имитация бэкенда: фильтрация по имени, сортировка и срез по offset/limit с задержкой.
|
|
1219
|
+
function fetchUsers(offset: number, limit: number, query: string, sorting: SortingState): Promise<PageResponse> {
|
|
1220
|
+
return new Promise(resolve => {
|
|
1221
|
+
setTimeout(() => {
|
|
1222
|
+
const filtered = query
|
|
1223
|
+
? ALL_USERS.filter(user => user.name.toLowerCase().includes(query.toLowerCase()))
|
|
1224
|
+
: ALL_USERS;
|
|
1225
|
+
const sortRule = sorting[0];
|
|
1226
|
+
const sorted = sortRule ? [...filtered].sort((a, b) => compareUsers(a, b, sortRule.id, sortRule.desc)) : filtered;
|
|
1227
|
+
|
|
1228
|
+
resolve({ items: sorted.slice(offset, offset + limit), total: sorted.length });
|
|
1229
|
+
}, 400);
|
|
1230
|
+
});
|
|
1231
|
+
}
|
|
1232
|
+
|
|
1233
|
+
const columns: ColumnDefinition<User>[] = [
|
|
1234
|
+
{ accessorKey: 'name', header: 'Имя', enableSorting: true, size: 200 },
|
|
1235
|
+
{ accessorKey: 'email', header: 'Email', size: 240 },
|
|
1236
|
+
{ accessorKey: 'role', header: 'Роль', size: 140 },
|
|
1237
|
+
{ accessorKey: 'balance', header: 'Баланс', align: 'right', headerAlign: 'right', enableSorting: true, size: 140 },
|
|
1238
|
+
];
|
|
1239
|
+
|
|
1240
|
+
export function ServerDriven() {
|
|
1241
|
+
const [items, setItems] = useState<User[]>([]);
|
|
1242
|
+
const [total, setTotal] = useState(0);
|
|
1243
|
+
const [loading, setLoading] = useState(false);
|
|
1244
|
+
const [offset, setOffset] = useState(0);
|
|
1245
|
+
const [limit, setLimit] = useState(5);
|
|
1246
|
+
const [search, setSearch] = useState('');
|
|
1247
|
+
const [sorting, setSorting] = useState<SortingState>([]);
|
|
1248
|
+
const requestId = useRef(0);
|
|
1249
|
+
|
|
1250
|
+
useEffect(() => {
|
|
1251
|
+
const currentRequest = ++requestId.current;
|
|
1252
|
+
|
|
1253
|
+
setLoading(true);
|
|
1254
|
+
fetchUsers(offset, limit, search, sorting).then(response => {
|
|
1255
|
+
// Ответы устаревших запросов отбрасываются — состояние обновляет только последний.
|
|
1256
|
+
if (currentRequest !== requestId.current) {
|
|
1257
|
+
return;
|
|
1258
|
+
}
|
|
1259
|
+
|
|
1260
|
+
setItems(response.items);
|
|
1261
|
+
setTotal(response.total);
|
|
1262
|
+
setLoading(false);
|
|
1263
|
+
});
|
|
1264
|
+
}, [offset, limit, search, sorting]);
|
|
1265
|
+
|
|
1266
|
+
return (
|
|
1267
|
+
<ServerTable
|
|
1268
|
+
items={items}
|
|
1269
|
+
total={total}
|
|
1270
|
+
limit={limit}
|
|
1271
|
+
offset={offset}
|
|
1272
|
+
loading={loading}
|
|
1273
|
+
columnDefinitions={columns}
|
|
1274
|
+
onChangePage={(nextOffset, nextLimit) => {
|
|
1275
|
+
setOffset(nextOffset);
|
|
1276
|
+
setLimit(nextLimit);
|
|
1277
|
+
}}
|
|
1278
|
+
search={{
|
|
1279
|
+
state: search,
|
|
1280
|
+
placeholder: 'Поиск по имени',
|
|
1281
|
+
loading,
|
|
1282
|
+
onChange: value => {
|
|
1283
|
+
setOffset(0);
|
|
1284
|
+
setSearch(value);
|
|
1285
|
+
},
|
|
1286
|
+
}}
|
|
1287
|
+
sorting={{
|
|
1288
|
+
state: sorting,
|
|
1289
|
+
onChange: nextSorting => {
|
|
1290
|
+
setOffset(0);
|
|
1291
|
+
setSorting(nextSorting);
|
|
1292
|
+
},
|
|
1293
|
+
}}
|
|
1294
|
+
manualSorting
|
|
1295
|
+
pagination={{ options: [5, 10] }}
|
|
1296
|
+
outline
|
|
1297
|
+
/>
|
|
1298
|
+
);
|
|
1299
|
+
}
|
|
1300
|
+
```
|
|
1301
|
+
|
|
1302
|
+
### Props
|
|
1303
|
+
|
|
1304
|
+
**ServerTableProps**
|
|
1305
|
+
|
|
1306
|
+
| Prop | Type | Default | Description |
|
|
1307
|
+
|------|------|---------|-------------|
|
|
1308
|
+
| `autoResetPageIndex` | `boolean` | — | Автоматический сброс пагинации к первой странице при изменении данных/фильтров/сортировки |
|
|
1309
|
+
| `bulkActions` | `BulkAction` | — | Список действий для массовых операций |
|
|
1310
|
+
| `cardColumns` | `number` | — | Желаемое число колонок карточного вида (`view='cards'`). <br/> На широком контейнере рисуется ровно столько колонок; при сужении сетка <br/> схлопывается до меньшего числа (порог — `cardMinWidth`). Без пропа число <br/> колонок определяется только шириной контейнера и `cardMinWidth` (auto-fill). |
|
|
1311
|
+
| `cardMinWidth` | `number` | `320` | Минимальная ширина карточки в `view='cards'`, px. Порог, ниже которого <br/> колонки схлопываются. Карточка ужимается до ширины контейнера, если он уже. |
|
|
1312
|
+
| `className` | `string` | — | CSS-класс |
|
|
1313
|
+
| `columnDefinitions` | `ColumnDefinition` \| `Except` \| `TData` | — | Определение внешнего вида и функционала колонок |
|
|
1314
|
+
| `columnFilters` | `FilterRow` \| `TFilters` | — | Фильтры |
|
|
1315
|
+
| `columnVirtualizerInstanceRef` | `ColumnVirtualizer` | — | Ref на инстанс column-virtualizer'а для управления прокруткой снаружи |
|
|
1316
|
+
| `columnVirtualizerOptions` | `Partial<VirtualizerOptions<HTMLElement, Element>>` | — | Дополнительные параметры column-virtualizer'а (`@tanstack/react-virtual`). <br/> Переопределяют дефолты (overscan=3). |
|
|
1317
|
+
| `columnsSettings` | `{ enableDrag?: boolean; enableSettingsMenu?: boolean; } \| undefined` | — | Настройки колонок: `enableDrag` — переупорядочивание (заголовки таблицы и строки в меню настроек); <br/> `enableSettingsMenu` — меню показа колонок. |
|
|
1318
|
+
| `copyPinnedRows` | `boolean` | `false` | Параметр отвечает за сохранение закрепленных строк в теле таблицы |
|
|
1319
|
+
| `data-test-id` | `string` | — | |
|
|
1320
|
+
| `dataError` | `boolean` | — | Флаг, показывающий что произошла ошибка запроса при пустых данных |
|
|
1321
|
+
| `dataFiltered` | `boolean` | — | Флаг, показывающий что данные были отфильтрованы при пустых данных |
|
|
1322
|
+
| `defaultView` | `"cards"` \| `"table"` | `'table' (на mobile — `cards`)` | Начальный режим отображения (uncontrolled). <br/> Если не задан — дефолт по раскладке: `table` на desktop, `cards` на mobile (`TABLE_LAYOUT_PRESETS`). |
|
|
1323
|
+
| `enableColumnVirtualization` | `boolean` | `false` | Включает виртуализацию колонок (windowing по горизонтали). <br/> Рекомендуется при > 30 видимых колонок. Несовместимо с `view='cards'`. <br/> Pinned-колонки (left/right) всегда отрисовываются вне зависимости от настройки. |
|
|
1324
|
+
| `enableFuzzySearch` | `boolean` | — | Включить нечеткий поиск |
|
|
1325
|
+
| `enableRowVirtualization` | `boolean` | `false` | Включает виртуализацию строк (windowing по вертикали). <br/> Рекомендуется при > 200 строк. Несовместимо с `view='cards'` — при картах игнорируется. |
|
|
1326
|
+
| `enableSelectPinned` | `boolean` | — | Параметр отвечает за чекбокс выбора закрепленных строк |
|
|
1327
|
+
| `errorDataState` | `EmptyStateProps` | — | Экран при ошибке запроса |
|
|
1328
|
+
| `expanding` | `TData` \| `TreeColumnDefinitionProps` | — | Общие настройки раскрывающихся (tree) строк: `getSubRows`, `expandingColumnDefinition`, <br/> `initialState`, `state`, `onChange`. |
|
|
1329
|
+
| `fullWidth` | `boolean` | `true` | Растягивать таблицу на всю ширину контейнера. <br/> При `false` ширина определяется суммой колонок (лучше всего, когда у всех колонок задан `size` / `width`). <br/> Явный проп = desktop-значение; на mobile всегда `true` (`TABLE_LAYOUT_PRESETS`). |
|
|
1330
|
+
| `getRowBackgroundColor` | `TData` \| `TableRowColor` | — | Функция определения цвета фона строки по её данным. <br/> Работает только в `view='table'` — карточки (`view='cards'`) не тонируются. <br/> @param data данные строки <br/> @returns цвет фона строки или `undefined` |
|
|
1331
|
+
| `getRowId` | `TData` | — | Функция получения уникального идентификатора строки |
|
|
1332
|
+
| `hasMore` | `undefined` | — | |
|
|
1333
|
+
| `headerRowBackgroundColor` | `"blue"` \| `"green"` \| `"neutral"` \| `"orange"` \| `"pink"` \| `"red"` \| `"violet"` \| `"yellow"` | — | Accent-тон фона строки заголовков колонок (`tableHeadLine`). <br/> Работает только в `view='table'`. |
|
|
1334
|
+
| `headlineId` | `string` | — | Id колонки, чей рендер используется как заголовок карточки в режиме `view='cards'`. <br/> Имеет смысл только при `view='cards'`. |
|
|
1335
|
+
| `infiniteLoading` | `undefined` | — | |
|
|
1336
|
+
| `items` | `TData` | — | Данные для отрисовки |
|
|
1337
|
+
| `keepPinnedRows` | `boolean` | `false` | Параметр отвечает за отображение закрепленных строк на всех страницах таблицы |
|
|
1338
|
+
| `layoutPresets` | `LayoutPresets` \| `TableLayoutDefaults` | — | Override дефолтов адаптива для этого инстанса (`mergePresets` поверх `TABLE_LAYOUT_PRESETS`). <br/> `stickyControls` в пресете tier'а заменяет DS-объект целиком — указывайте все нужные поля. <br/> Escape-hatch: обычно не нужен — DS-пресет применяется автоматически по `AdaptiveProvider`. |
|
|
1339
|
+
| `limit` | `number` | `10` | Кол-во строк на страницу |
|
|
1340
|
+
| `loadMoreTrigger` | `undefined` | — | |
|
|
1341
|
+
| `loading` | `boolean` | — | Состояние загрузки |
|
|
1342
|
+
| `manualFiltering` | `boolean` | `true` | |
|
|
1343
|
+
| `manualPagination` | `boolean` | `true` | |
|
|
1344
|
+
| `manualSorting` | `boolean` | `true` | |
|
|
1345
|
+
| `moreActions` | `TFilters` \| `ToolbarProps` | — | Элементы выпадающего списка кнопки с действиями |
|
|
1346
|
+
| `noDataState` | `EmptyStateProps` | — | Экран при отсутствии данных |
|
|
1347
|
+
| `noResultsState` | `EmptyStateProps` | — | Экран при отсутствии результатов поиска или фильтров |
|
|
1348
|
+
| `offset` | `number` | `0` | Смещение |
|
|
1349
|
+
| `onChangePage` | `(offset: number, limit: number) => void` | — | |
|
|
1350
|
+
| `onExport` | `(() => void)` | — | Колбэк экспорта данных. Рендерит иконку в тулбаре перед настройками колонок. |
|
|
1351
|
+
| `onLoadMore` | `undefined` | — | |
|
|
1352
|
+
| `onRefresh` | `(() => void)` | — | Колбэк обновления данных |
|
|
1353
|
+
| `onRowClick` | `RowClickHandler` \| `TData` | — | Колбэк клика по строке |
|
|
1354
|
+
| `onViewChange` | `((view: View) => void)` | — | Колбэк на смену режима отображения |
|
|
1355
|
+
| `outline` | `boolean` | — | Внешний бордер для тулбара и таблицы |
|
|
1356
|
+
| `pagination` | `{ options?: number[]; optionsLabel?: string; } \| undefined` | — | Параметры пагинации: `options`, `optionsLabel` |
|
|
1357
|
+
| `renderCard` | `((context: RenderCardContext<TData>) => ReactNode)` | — | Кастомный рендер карточки в `view='cards'`. Получает контекст с tanstack <br/> `row` / `table` и `defaultRender` (готовый элемент дефолтной карточки — <br/> можно обернуть). Возврат заменяет дефолтную карточку. |
|
|
1358
|
+
| `rowAutoHeight` | `boolean` | — | |
|
|
1359
|
+
| `rowPinning` | `Pick<RowPinningState, "top">` | — | Определение, какие строки должны быть закреплены в таблице |
|
|
1360
|
+
| `rowSelection` | `RowAppearance` \| `TData` | — | Параметры выбора строк: `initialState`, `state`, `enable`, `appearance`, `multiRow`, `onChange`. |
|
|
1361
|
+
| `rowVirtualizerInstanceRef` | `RowVirtualizer` | — | Ref на инстанс row-virtualizer'а для управления прокруткой снаружи |
|
|
1362
|
+
| `rowVirtualizerOptions` | `Partial<VirtualizerOptions<HTMLElement, Element>>` | — | Дополнительные параметры row-virtualizer'а (`@tanstack/react-virtual`). <br/> Переопределяют дефолты (overscan=10, estimateSize=40). |
|
|
1363
|
+
| `savedState` | `TFilters` \| `ToolbarPersistConfig` | — | Конфиг сохранения состояния в localStorage и queryParams. <br/> `id` должен быть уникальным для разных таблиц в рамках приложения. |
|
|
1364
|
+
| `scrollContainerRef` | `RefObject<HTMLElement>` | — | Ссылка на контейнер, который скроллится |
|
|
1365
|
+
| `scrollRef` | `Ref<HTMLElement>` | — | Ссылка на элемент, обозначающий самый конец прокручиваемого списка |
|
|
1366
|
+
| `search` | `{ initialState?: string; state: string; placeholder?: string; loading?: boolean \| undefined; onChange(value: string): void; } \| undefined` | — | Параметры глобального поиска: `initialState`, `state`, `placeholder`, `loading`, `onChange`. |
|
|
1367
|
+
| `showDataView` | `boolean` | `false` | Показывать переключатель вида (таблица/карточки) в тулбаре. <br/> Управляет только видимостью тоггла; сам вид задаётся `view` / `defaultView`. <br/> По умолчанию тоггла нет — таблица показывает один вид (`defaultView` либо <br/> адаптивный дефолт). Включите `showDataView`, чтобы дать пользователю <br/> переключать table/cards. |
|
|
1368
|
+
| `sorting` | `{ initialState?: SortingState; state?: SortingState; onChange?(state: SortingState): void; } \| undefined` | — | Параметры отвечают за возможность сортировки: <br/> `initialState` — начальное состояние; `state` — управляемое снаружи; `onChange` — колбэк на изменение. |
|
|
1369
|
+
| `stickyControls` | `StickyControls` | — | Sticky-хром при скролле страницы: при `enabled: true` тулбар и пагинация липнут к верху/низу <br/> viewport, в table-view заголовок колонок — под тулбаром; тело растёт по контенту. <br/> При `enabled: false` все блоки идут сплошным потоком без sticky. <br/> Дефолты: desktop — `enabled: false` (offsets не применяются); <br/> mobile — `{ enabled: true, offsetTop: 0, offsetBottom: 0 }` (`TABLE_LAYOUT_PRESETS`); <br/> `backgroundPredefined` — `neutralBackground1Level` на всех раскладках. <br/> Явный проп = desktop-значение; mobile-override — `layoutPresets.mobile`. <br/> @example `stickyControls={{ enabled: true, offsetTop: 64 }}` — sticky на desktop, app header 64px. |
|
|
1370
|
+
| `suppressHeader` | `boolean` | — | Отключение хедера таблицы; в режиме `view='cards'` скрывает подписи-заголовки полей карточки |
|
|
1371
|
+
| `suppressPagination` | `boolean` | — | Отключение пагинации |
|
|
1372
|
+
| `suppressSearch` | `boolean` | — | Отключение поиска |
|
|
1373
|
+
| `suppressToolbar` | `boolean` | — | Отключение тулбара |
|
|
1374
|
+
| `toolbarAfter` | `ReactNode` | — | Дополнительный слот в `Toolbar` после строки поиска |
|
|
1375
|
+
| `total` | `number` | `10` | Общее кол-во строк |
|
|
1376
|
+
| `view` | `"cards"` \| `"table"` | `'table' (на mobile — `cards`)` | Режим отображения таблицы (controlled). <br/> `table` — классическая сетка; `cards` — карточки (заголовок берётся из колонки `headlineId`). <br/> Переключатель вида в тулбаре включается отдельным пропом `showDataView`. |
|
|
1377
|
+
|
|
1378
|
+
##### Related types
|
|
1379
|
+
|
|
1380
|
+
- `ColumnDefinition` = `NormalColumnDefinition<TData> | PinnedColumnDefinition<TData> | FilterableColumnDefinition<TData>`
|
|
1381
|
+
|
|
1382
|
+
**EmptyStateProps**
|
|
1383
|
+
|
|
1384
|
+
| Prop | Type | Default | Description |
|
|
1385
|
+
|------|------|---------|-------------|
|
|
1386
|
+
| `className` | `string \| undefined` | — | Дополнительный класс |
|
|
1387
|
+
| `content` | `string \| number \| boolean \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal \| null \| undefined` | — | Подзаголовок |
|
|
1388
|
+
| `footer` | `string \| number \| boolean \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal \| null \| undefined` | — | Вложенный контент (например ButtonGroup) |
|
|
1389
|
+
| `icon` | `IconPredefinedProps` | — | Иконка |
|
|
1390
|
+
| `title` | `string \| undefined` | — | Заголовок |
|
|
1391
|
+
|
|
1392
|
+
- `Except` = `{ [KeyType in keyof ObjectType as Filter<KeyType, KeysType>]: ObjectType[KeyType]; }`
|
|
1393
|
+
|
|
1394
|
+
- `RowClickHandler` = `(e: MouseEvent<HTMLDivElement>, row: RowInfo<TData>) => void`
|
|
1395
|
+
|
|
1396
|
+
**StickyControlsLayoutDefaults**
|
|
1397
|
+
|
|
1398
|
+
| Prop | Type | Default | Description |
|
|
1399
|
+
|------|------|---------|-------------|
|
|
1400
|
+
| `enabled` | `boolean \| undefined` | — | Включить sticky-хром при скролле страницы. |
|
|
1401
|
+
| `offsetBottom` | `number \| undefined` | — | Отступ снизу (px): высота внешнего sticky UI под таблицей (mobile tab bar). <br/> Только при `enabled: true`. |
|
|
1402
|
+
| `offsetTop` | `number \| undefined` | — | Отступ сверху (px): высота внешнего sticky UI над таблицей (app header, tabs). <br/> Только при `enabled: true`. |
|
|
1403
|
+
|
|
1404
|
+
**TableLayoutDefaults**
|
|
1405
|
+
|
|
1406
|
+
| Prop | Type | Default | Description |
|
|
1407
|
+
|------|------|---------|-------------|
|
|
1408
|
+
| `defaultView` | `"cards"` \| `"table"` | — | Начальный вид (uncontrolled). |
|
|
1409
|
+
| `fullWidth` | `boolean` | — | |
|
|
1410
|
+
| `stickyControls` | `StickyControlsLayoutDefaults` | — | |
|
|
1411
|
+
|
|
1412
|
+
- `TreeColumnDefinitionProps` = `TreeColumnDef | TreeColumnDefWithDescription<TData>`
|
|
1413
|
+
|
|
1414
|
+
- `View` = `"cards"` \| `"table"`
|
|
1415
|
+
|
|
1416
|
+
### Смотри также
|
|
1417
|
+
|
|
1418
|
+
- **Обзор пакета** — `ServerSimpleTable`, `ServerAdminTable` и выбор компонента.
|
|
1419
|
+
- **Table** — клиентская таблица для данных, загруженных целиком.
|
|
1420
|
+
- **SimpleTable** — клиентский аналог `ServerSimpleTable`.
|
|
1421
|
+
- **AdminTable** — клиентский аналог `ServerAdminTable`.
|
|
1422
|
+
|
|
1423
|
+
## SimpleTable
|
|
1424
|
+
|
|
1425
|
+
Минимальная клиентская таблица: данные, колонки и пагинация с предустановленными дефолтами.
|
|
1426
|
+
|
|
1427
|
+
`SimpleTable` — preset-обёртка над **`Table`** для простых списков: декларативные колонки через `defineColumns`, пагинация и `outline` включены по умолчанию.
|
|
1428
|
+
|
|
1429
|
+
### Когда использовать
|
|
1430
|
+
|
|
1431
|
+
- Справочники, настройки, демо-экраны — данные целиком на клиенте, без поиска и фильтров.
|
|
1432
|
+
- Нужен минимальный API вместо полного `Table`.
|
|
1433
|
+
- Компактная таблица в модалке или боковой панели — `fullWidth={false}` при фиксированных колонках.
|
|
1434
|
+
|
|
1435
|
+
Когда **не** нужен:
|
|
1436
|
+
|
|
1437
|
+
- Поиск, фильтры, выбор строк — используйте `AdminTable`.
|
|
1438
|
+
- Данные с бэкенда постранично — `ServerSimpleTable` или `ServerTable`.
|
|
1439
|
+
|
|
1440
|
+
### Примеры использования
|
|
1441
|
+
|
|
1442
|
+
{/* client:only='react': SSR демо невозможен — @cloud-ru/ds-table тянет toolbar с directory-imports (см. table.mdx). */}
|
|
1443
|
+
|
|
1444
|
+
#### Базовое использование
|
|
1445
|
+
|
|
1446
|
+
```tsx
|
|
1447
|
+
import { SimpleColumnDef, SimpleTable } from '@cloud-ru/ds-table';
|
|
1448
|
+
|
|
1449
|
+
type User = {
|
|
1450
|
+
id: string;
|
|
1451
|
+
name: string;
|
|
1452
|
+
email: string;
|
|
1453
|
+
role: string;
|
|
1454
|
+
balance: number;
|
|
1455
|
+
};
|
|
1456
|
+
|
|
1457
|
+
const USERS: User[] = [
|
|
1458
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', balance: 12990 },
|
|
1459
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', balance: 8450 },
|
|
1460
|
+
{ id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', balance: 4300 },
|
|
1461
|
+
{ id: 'u-4', name: 'Глеб Кузнецов', email: 'gleb.kuznetsov@example.com', role: 'Viewer', balance: 0 },
|
|
1462
|
+
{ id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', balance: 990 },
|
|
1463
|
+
];
|
|
1464
|
+
|
|
1465
|
+
const columns: SimpleColumnDef<User>[] = [
|
|
1466
|
+
{ key: 'name', header: 'Имя', sortable: true, width: 200 },
|
|
1467
|
+
{ key: 'email', header: 'Email', width: 240 },
|
|
1468
|
+
{ key: 'role', header: 'Роль', sortable: true, width: 140 },
|
|
1469
|
+
{ key: 'balance', header: 'Баланс', sortable: true, align: 'right', width: 140, format: 'currency' },
|
|
1470
|
+
];
|
|
1471
|
+
|
|
1472
|
+
export function SimpleTableBasic() {
|
|
1473
|
+
return <SimpleTable data={USERS} columns={columns} pageSize={5} getRowId={user => user.id} outline />;
|
|
1474
|
+
}
|
|
1475
|
+
```
|
|
1476
|
+
|
|
1477
|
+
#### Через хук useSimpleTableProps
|
|
1478
|
+
|
|
1479
|
+
```tsx
|
|
1480
|
+
import { SimpleColumnDef, Table, useSimpleTableProps } from '@cloud-ru/ds-table';
|
|
1481
|
+
|
|
1482
|
+
type User = {
|
|
1483
|
+
id: string;
|
|
1484
|
+
name: string;
|
|
1485
|
+
email: string;
|
|
1486
|
+
role: string;
|
|
1487
|
+
balance: number;
|
|
1488
|
+
};
|
|
1489
|
+
|
|
1490
|
+
const USERS: User[] = [
|
|
1491
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', balance: 12990 },
|
|
1492
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', balance: 8450 },
|
|
1493
|
+
{ id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', balance: 4300 },
|
|
1494
|
+
];
|
|
1495
|
+
|
|
1496
|
+
const columns: SimpleColumnDef<User>[] = [
|
|
1497
|
+
{ key: 'name', header: 'Имя', sortable: true, width: 200 },
|
|
1498
|
+
{ key: 'email', header: 'Email', width: 240 },
|
|
1499
|
+
{ key: 'role', header: 'Роль', sortable: true, width: 140 },
|
|
1500
|
+
];
|
|
1501
|
+
|
|
1502
|
+
export function SimpleTableWithHook() {
|
|
1503
|
+
const tableProps = useSimpleTableProps({
|
|
1504
|
+
data: USERS,
|
|
1505
|
+
columns,
|
|
1506
|
+
pageSize: 5,
|
|
1507
|
+
getRowId: user => user.id,
|
|
1508
|
+
outline: true,
|
|
1509
|
+
});
|
|
1510
|
+
|
|
1511
|
+
return <Table {...tableProps} />;
|
|
1512
|
+
}
|
|
1513
|
+
```
|
|
1514
|
+
|
|
1515
|
+
#### Карточный режим
|
|
1516
|
+
|
|
1517
|
+
```tsx
|
|
1518
|
+
import { SimpleColumnDef, SimpleTable, VIEW } from '@cloud-ru/ds-table';
|
|
1519
|
+
import { useState } from 'react';
|
|
1520
|
+
|
|
1521
|
+
type User = {
|
|
1522
|
+
id: string;
|
|
1523
|
+
name: string;
|
|
1524
|
+
email: string;
|
|
1525
|
+
role: string;
|
|
1526
|
+
};
|
|
1527
|
+
|
|
1528
|
+
const USERS: User[] = [
|
|
1529
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner' },
|
|
1530
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin' },
|
|
1531
|
+
{ id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor' },
|
|
1532
|
+
];
|
|
1533
|
+
|
|
1534
|
+
const columns: SimpleColumnDef<User>[] = [
|
|
1535
|
+
{ key: 'name', header: 'Имя', sortable: true, width: 200 },
|
|
1536
|
+
{ key: 'email', header: 'Email', width: 240 },
|
|
1537
|
+
{ key: 'role', header: 'Роль', width: 140 },
|
|
1538
|
+
];
|
|
1539
|
+
|
|
1540
|
+
export function SimpleTableCardView() {
|
|
1541
|
+
const [view, setView] = useState<typeof VIEW.Table | typeof VIEW.Cards>(VIEW.Cards);
|
|
1542
|
+
|
|
1543
|
+
return (
|
|
1544
|
+
<SimpleTable
|
|
1545
|
+
data={USERS}
|
|
1546
|
+
columns={columns}
|
|
1547
|
+
pageSize={5}
|
|
1548
|
+
getRowId={user => user.id}
|
|
1549
|
+
headlineKey='name'
|
|
1550
|
+
view={view}
|
|
1551
|
+
onViewChange={setView}
|
|
1552
|
+
outline
|
|
1553
|
+
/>
|
|
1554
|
+
);
|
|
1555
|
+
}
|
|
1556
|
+
```
|
|
1557
|
+
|
|
1558
|
+
## AdminTable
|
|
1559
|
+
|
|
1560
|
+
Админ-таблица: поиск, статус, выбор строк и действия с предустановленными дефолтами.
|
|
1561
|
+
|
|
1562
|
+
`AdminTable` — preset над **`Table`** для типичных админ-экранов: поиск, колонка статуса, настройки колонок, опционально фильтры, выбор строк и действия.
|
|
1563
|
+
|
|
1564
|
+
### Когда использовать
|
|
1565
|
+
|
|
1566
|
+
- Списки сущностей с поиском и статусом на клиенте.
|
|
1567
|
+
- Нужен упрощённый API вместо сборки `columnDefinitions` + toolbar-пропсов вручную.
|
|
1568
|
+
|
|
1569
|
+
Когда **не** нужен:
|
|
1570
|
+
|
|
1571
|
+
- Данные с бэкенда постранично — `ServerAdminTable`.
|
|
1572
|
+
- Простой справочник без поиска — `SimpleTable`.
|
|
1573
|
+
|
|
1574
|
+
### Примеры использования
|
|
1575
|
+
|
|
1576
|
+
#### Базовое использование
|
|
1577
|
+
|
|
1578
|
+
```tsx
|
|
1579
|
+
import { AdminTable, SimpleColumnDef, STATUS_APPEARANCE } from '@cloud-ru/ds-table';
|
|
1580
|
+
|
|
1581
|
+
type User = {
|
|
1582
|
+
id: string;
|
|
1583
|
+
name: string;
|
|
1584
|
+
email: string;
|
|
1585
|
+
role: string;
|
|
1586
|
+
status: string;
|
|
1587
|
+
amount: number;
|
|
1588
|
+
};
|
|
1589
|
+
|
|
1590
|
+
const USERS: User[] = [
|
|
1591
|
+
{
|
|
1592
|
+
id: 'u-1',
|
|
1593
|
+
name: 'Анна Иванова',
|
|
1594
|
+
email: 'anna.ivanova@example.com',
|
|
1595
|
+
role: 'Owner',
|
|
1596
|
+
status: 'active',
|
|
1597
|
+
amount: 12990,
|
|
1598
|
+
},
|
|
1599
|
+
{
|
|
1600
|
+
id: 'u-2',
|
|
1601
|
+
name: 'Борис Петров',
|
|
1602
|
+
email: 'boris.petrov@example.com',
|
|
1603
|
+
role: 'Admin',
|
|
1604
|
+
status: 'pending',
|
|
1605
|
+
amount: 8450,
|
|
1606
|
+
},
|
|
1607
|
+
{
|
|
1608
|
+
id: 'u-3',
|
|
1609
|
+
name: 'Вера Сидорова',
|
|
1610
|
+
email: 'vera.sidorova@example.com',
|
|
1611
|
+
role: 'Editor',
|
|
1612
|
+
status: 'blocked',
|
|
1613
|
+
amount: 4300,
|
|
1614
|
+
},
|
|
1615
|
+
{
|
|
1616
|
+
id: 'u-4',
|
|
1617
|
+
name: 'Глеб Кузнецов',
|
|
1618
|
+
email: 'gleb.kuznetsov@example.com',
|
|
1619
|
+
role: 'Viewer',
|
|
1620
|
+
status: 'invited',
|
|
1621
|
+
amount: 0,
|
|
1622
|
+
},
|
|
1623
|
+
{ id: 'u-5', name: 'Дарья Орлова', email: 'darya.orlova@example.com', role: 'Editor', status: 'active', amount: 990 },
|
|
1624
|
+
];
|
|
1625
|
+
|
|
1626
|
+
const columns: SimpleColumnDef<User>[] = [
|
|
1627
|
+
{ key: 'name', header: 'Имя', sortable: true, width: 200 },
|
|
1628
|
+
{ key: 'email', header: 'Email', width: 240 },
|
|
1629
|
+
{ key: 'role', header: 'Роль', sortable: true, width: 140 },
|
|
1630
|
+
{ key: 'amount', header: 'Сумма', sortable: true, align: 'right', width: 140, format: 'currency' },
|
|
1631
|
+
];
|
|
1632
|
+
|
|
1633
|
+
const statusLabels: Record<string, string> = {
|
|
1634
|
+
active: 'Активен',
|
|
1635
|
+
pending: 'Ожидание',
|
|
1636
|
+
blocked: 'Заблокирован',
|
|
1637
|
+
invited: 'Приглашён',
|
|
1638
|
+
};
|
|
1639
|
+
|
|
1640
|
+
export function AdminTableBasic() {
|
|
1641
|
+
return (
|
|
1642
|
+
<AdminTable
|
|
1643
|
+
data={USERS}
|
|
1644
|
+
columns={columns}
|
|
1645
|
+
statusColumn={{
|
|
1646
|
+
key: 'status',
|
|
1647
|
+
mapStatusToAppearance: value => {
|
|
1648
|
+
switch (value) {
|
|
1649
|
+
case 'active':
|
|
1650
|
+
return STATUS_APPEARANCE.Green;
|
|
1651
|
+
case 'pending':
|
|
1652
|
+
return STATUS_APPEARANCE.Yellow;
|
|
1653
|
+
case 'blocked':
|
|
1654
|
+
return STATUS_APPEARANCE.Red;
|
|
1655
|
+
case 'invited':
|
|
1656
|
+
return STATUS_APPEARANCE.Blue;
|
|
1657
|
+
default:
|
|
1658
|
+
return STATUS_APPEARANCE.Neutral;
|
|
1659
|
+
}
|
|
1660
|
+
},
|
|
1661
|
+
renderDescription: status => statusLabels[status] ?? status,
|
|
1662
|
+
}}
|
|
1663
|
+
pageSize={5}
|
|
1664
|
+
getRowId={user => user.id}
|
|
1665
|
+
search
|
|
1666
|
+
outline
|
|
1667
|
+
/>
|
|
1668
|
+
);
|
|
1669
|
+
}
|
|
1670
|
+
```
|
|
1671
|
+
|
|
1672
|
+
#### Через хук useAdminTableProps
|
|
1673
|
+
|
|
1674
|
+
```tsx
|
|
1675
|
+
import { SimpleColumnDef, STATUS_APPEARANCE, Table, useAdminTableProps } from '@cloud-ru/ds-table';
|
|
1676
|
+
|
|
1677
|
+
type User = {
|
|
1678
|
+
id: string;
|
|
1679
|
+
name: string;
|
|
1680
|
+
email: string;
|
|
1681
|
+
role: string;
|
|
1682
|
+
status: string;
|
|
1683
|
+
amount: number;
|
|
1684
|
+
};
|
|
1685
|
+
|
|
1686
|
+
const USERS: User[] = [
|
|
1687
|
+
{
|
|
1688
|
+
id: 'u-1',
|
|
1689
|
+
name: 'Анна Иванова',
|
|
1690
|
+
email: 'anna.ivanova@example.com',
|
|
1691
|
+
role: 'Owner',
|
|
1692
|
+
status: 'active',
|
|
1693
|
+
amount: 12990,
|
|
1694
|
+
},
|
|
1695
|
+
{
|
|
1696
|
+
id: 'u-2',
|
|
1697
|
+
name: 'Борис Петров',
|
|
1698
|
+
email: 'boris.petrov@example.com',
|
|
1699
|
+
role: 'Admin',
|
|
1700
|
+
status: 'pending',
|
|
1701
|
+
amount: 8450,
|
|
1702
|
+
},
|
|
1703
|
+
{
|
|
1704
|
+
id: 'u-3',
|
|
1705
|
+
name: 'Вера Сидорова',
|
|
1706
|
+
email: 'vera.sidorova@example.com',
|
|
1707
|
+
role: 'Editor',
|
|
1708
|
+
status: 'blocked',
|
|
1709
|
+
amount: 4300,
|
|
1710
|
+
},
|
|
1711
|
+
];
|
|
1712
|
+
|
|
1713
|
+
const columns: SimpleColumnDef<User>[] = [
|
|
1714
|
+
{ key: 'name', header: 'Имя', sortable: true, width: 200 },
|
|
1715
|
+
{ key: 'email', header: 'Email', width: 240 },
|
|
1716
|
+
{ key: 'role', header: 'Роль', sortable: true, width: 140 },
|
|
1717
|
+
];
|
|
1718
|
+
|
|
1719
|
+
export function AdminTableWithHook() {
|
|
1720
|
+
const tableProps = useAdminTableProps({
|
|
1721
|
+
data: USERS,
|
|
1722
|
+
columns,
|
|
1723
|
+
statusColumn: {
|
|
1724
|
+
key: 'status',
|
|
1725
|
+
mapStatusToAppearance: value => (value === 'active' ? STATUS_APPEARANCE.Green : STATUS_APPEARANCE.Yellow),
|
|
1726
|
+
renderDescription: status => (status === 'active' ? 'Активен' : 'Ожидание'),
|
|
1727
|
+
},
|
|
1728
|
+
pageSize: 5,
|
|
1729
|
+
getRowId: user => user.id,
|
|
1730
|
+
search: true,
|
|
1731
|
+
});
|
|
1732
|
+
|
|
1733
|
+
return <Table {...tableProps} outline />;
|
|
1734
|
+
}
|
|
1735
|
+
```
|
|
1736
|
+
|
|
1737
|
+
#### Карточный режим
|
|
1738
|
+
|
|
1739
|
+
```tsx
|
|
1740
|
+
import { AdminTable, SimpleColumnDef, VIEW } from '@cloud-ru/ds-table';
|
|
1741
|
+
import { useState } from 'react';
|
|
1742
|
+
|
|
1743
|
+
type User = {
|
|
1744
|
+
id: string;
|
|
1745
|
+
name: string;
|
|
1746
|
+
email: string;
|
|
1747
|
+
role: string;
|
|
1748
|
+
amount: number;
|
|
1749
|
+
};
|
|
1750
|
+
|
|
1751
|
+
const USERS: User[] = [
|
|
1752
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna.ivanova@example.com', role: 'Owner', amount: 12990 },
|
|
1753
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris.petrov@example.com', role: 'Admin', amount: 8450 },
|
|
1754
|
+
{ id: 'u-3', name: 'Вера Сидорова', email: 'vera.sidorova@example.com', role: 'Editor', amount: 4300 },
|
|
1755
|
+
];
|
|
1756
|
+
|
|
1757
|
+
const columns: SimpleColumnDef<User>[] = [
|
|
1758
|
+
{ key: 'name', header: 'Имя', sortable: true, width: 200 },
|
|
1759
|
+
{ key: 'email', header: 'Email', width: 240 },
|
|
1760
|
+
{ key: 'role', header: 'Роль', sortable: true, width: 140 },
|
|
1761
|
+
];
|
|
1762
|
+
|
|
1763
|
+
export function AdminTableCardView() {
|
|
1764
|
+
const [view, setView] = useState<typeof VIEW.Table | typeof VIEW.Cards>(VIEW.Cards);
|
|
1765
|
+
|
|
1766
|
+
return (
|
|
1767
|
+
<AdminTable
|
|
1768
|
+
data={USERS}
|
|
1769
|
+
columns={columns}
|
|
1770
|
+
pageSize={5}
|
|
1771
|
+
getRowId={user => user.id}
|
|
1772
|
+
search
|
|
1773
|
+
headlineKey='name'
|
|
1774
|
+
view={view}
|
|
1775
|
+
onViewChange={setView}
|
|
1776
|
+
outline
|
|
1777
|
+
/>
|
|
1778
|
+
);
|
|
1779
|
+
}
|
|
1780
|
+
```
|
|
1781
|
+
|
|
1782
|
+
## TreeTable
|
|
1783
|
+
|
|
1784
|
+
Иерархическая таблица: expanding, без пагинации, с опциональным выбором строк.
|
|
1785
|
+
|
|
1786
|
+
`TreeTable` — preset для иерархических данных: `getChildren`, tree-колонка через `primaryColumn`, без пагинации.
|
|
1787
|
+
|
|
1788
|
+
### Когда использовать
|
|
1789
|
+
|
|
1790
|
+
- Оргструктура, вложенные ресурсы, каталоги с подуровнями.
|
|
1791
|
+
- Нужен expand/collapse без ручной настройки `expanding` на `Table`.
|
|
1792
|
+
|
|
1793
|
+
Когда **не** нужен:
|
|
1794
|
+
|
|
1795
|
+
- Плоский список — `SimpleTable` / `AdminTable`.
|
|
1796
|
+
- Закрепление строк (`rowPinning`) — только на полном `Table`.
|
|
1797
|
+
|
|
1798
|
+
### Примеры использования
|
|
1799
|
+
|
|
1800
|
+
#### Базовое дерево
|
|
1801
|
+
|
|
1802
|
+
```tsx
|
|
1803
|
+
import { SimpleColumnDef, TreeTable } from '@cloud-ru/ds-table';
|
|
1804
|
+
|
|
1805
|
+
type OrgNode = {
|
|
1806
|
+
id: string;
|
|
1807
|
+
name: string;
|
|
1808
|
+
role: string;
|
|
1809
|
+
email: string;
|
|
1810
|
+
children?: OrgNode[];
|
|
1811
|
+
};
|
|
1812
|
+
|
|
1813
|
+
const TREE: OrgNode[] = [
|
|
1814
|
+
{
|
|
1815
|
+
id: 'org-1',
|
|
1816
|
+
name: 'Облако',
|
|
1817
|
+
role: 'Отдел',
|
|
1818
|
+
email: 'cloud@example.com',
|
|
1819
|
+
children: [
|
|
1820
|
+
{ id: 'team-1', name: 'Compute', role: 'Команда', email: 'compute@example.com' },
|
|
1821
|
+
{ id: 'team-2', name: 'Storage', role: 'Команда', email: 'storage@example.com' },
|
|
1822
|
+
],
|
|
1823
|
+
},
|
|
1824
|
+
];
|
|
1825
|
+
|
|
1826
|
+
const columns: SimpleColumnDef<OrgNode>[] = [
|
|
1827
|
+
{ key: 'role', header: 'Тип', width: 160 },
|
|
1828
|
+
{ key: 'email', header: 'Email', width: 240 },
|
|
1829
|
+
];
|
|
1830
|
+
|
|
1831
|
+
export function TreeTableBasic() {
|
|
1832
|
+
return (
|
|
1833
|
+
<TreeTable
|
|
1834
|
+
data={TREE}
|
|
1835
|
+
getChildren={row => row.children}
|
|
1836
|
+
primaryColumn={{ key: 'name', header: 'Подразделение' }}
|
|
1837
|
+
secondaryColumns={columns}
|
|
1838
|
+
getRowId={row => row.id}
|
|
1839
|
+
expandingInitialState={{ 'org-1': true }}
|
|
1840
|
+
outline
|
|
1841
|
+
/>
|
|
1842
|
+
);
|
|
1843
|
+
}
|
|
1844
|
+
```
|
|
1845
|
+
|
|
1846
|
+
#### Через хук useTreeTableProps
|
|
1847
|
+
|
|
1848
|
+
```tsx
|
|
1849
|
+
import { SimpleColumnDef, Table, useTreeTableProps } from '@cloud-ru/ds-table';
|
|
1850
|
+
|
|
1851
|
+
type OrgNode = {
|
|
1852
|
+
id: string;
|
|
1853
|
+
name: string;
|
|
1854
|
+
role: string;
|
|
1855
|
+
children?: OrgNode[];
|
|
1856
|
+
};
|
|
1857
|
+
|
|
1858
|
+
const TREE: OrgNode[] = [
|
|
1859
|
+
{
|
|
1860
|
+
id: 'org-1',
|
|
1861
|
+
name: 'Облако',
|
|
1862
|
+
role: 'Отдел',
|
|
1863
|
+
children: [{ id: 'team-1', name: 'Compute', role: 'Команда' }],
|
|
1864
|
+
},
|
|
1865
|
+
];
|
|
1866
|
+
|
|
1867
|
+
const columns: SimpleColumnDef<OrgNode>[] = [{ key: 'role', header: 'Тип', width: 160 }];
|
|
1868
|
+
|
|
1869
|
+
export function TreeTableWithHook() {
|
|
1870
|
+
const tableProps = useTreeTableProps({
|
|
1871
|
+
data: TREE,
|
|
1872
|
+
getChildren: row => row.children,
|
|
1873
|
+
primaryColumn: { key: 'name', header: 'Подразделение' },
|
|
1874
|
+
secondaryColumns: columns,
|
|
1875
|
+
getRowId: row => row.id,
|
|
1876
|
+
expandingInitialState: { 'org-1': true },
|
|
1877
|
+
});
|
|
1878
|
+
|
|
1879
|
+
return <Table {...tableProps} outline />;
|
|
1880
|
+
}
|
|
1881
|
+
```
|
|
1882
|
+
|
|
1883
|
+
#### С выбором строк
|
|
1884
|
+
|
|
1885
|
+
```tsx
|
|
1886
|
+
import { SimpleColumnDef, TreeTable } from '@cloud-ru/ds-table';
|
|
1887
|
+
|
|
1888
|
+
type OrgNode = {
|
|
1889
|
+
id: string;
|
|
1890
|
+
name: string;
|
|
1891
|
+
role: string;
|
|
1892
|
+
children?: OrgNode[];
|
|
1893
|
+
};
|
|
1894
|
+
|
|
1895
|
+
const TREE: OrgNode[] = [
|
|
1896
|
+
{
|
|
1897
|
+
id: 'org-1',
|
|
1898
|
+
name: 'Облако',
|
|
1899
|
+
role: 'Отдел',
|
|
1900
|
+
children: [
|
|
1901
|
+
{ id: 'team-1', name: 'Compute', role: 'Команда' },
|
|
1902
|
+
{ id: 'team-2', name: 'Storage', role: 'Команда' },
|
|
1903
|
+
],
|
|
1904
|
+
},
|
|
1905
|
+
];
|
|
1906
|
+
|
|
1907
|
+
const columns: SimpleColumnDef<OrgNode>[] = [{ key: 'role', header: 'Тип', width: 160 }];
|
|
1908
|
+
|
|
1909
|
+
export function TreeTableWithSelection() {
|
|
1910
|
+
return (
|
|
1911
|
+
<TreeTable
|
|
1912
|
+
data={TREE}
|
|
1913
|
+
getChildren={row => row.children}
|
|
1914
|
+
primaryColumn={{ key: 'name', header: 'Подразделение', showToggle: true }}
|
|
1915
|
+
secondaryColumns={columns}
|
|
1916
|
+
getRowId={row => row.id}
|
|
1917
|
+
expandingInitialState={{ 'org-1': true }}
|
|
1918
|
+
selection={{ multiRow: true, initialState: { 'team-1': true } }}
|
|
1919
|
+
outline
|
|
1920
|
+
/>
|
|
1921
|
+
);
|
|
1922
|
+
}
|
|
1923
|
+
```
|
|
1924
|
+
|
|
1925
|
+
## InfiniteTable
|
|
1926
|
+
|
|
1927
|
+
Таблица с бесконечной прокруткой: infiniteLoading, scrollRef и виртуализация строк из коробки.
|
|
1928
|
+
|
|
1929
|
+
`InfiniteTable` — preset для длинных списков без пагинации: включает `infiniteLoading`, подключает `scrollRef` и `IntersectionObserver` через `onLoadMore` / `hasMore`, по умолчанию включает виртуализацию строк (`enableRowVirtualization`).
|
|
1930
|
+
|
|
1931
|
+
### Когда использовать
|
|
1932
|
+
|
|
1933
|
+
- Лента записей с подгрузкой при скролле.
|
|
1934
|
+
- Не нужна постраничная навигация.
|
|
1935
|
+
|
|
1936
|
+
Когда **не** нужен:
|
|
1937
|
+
|
|
1938
|
+
- Классическая пагинация — `SimpleTable` / `ServerTable`.
|
|
1939
|
+
- Нужен полный контроль над виртуализацией колонок или кастомными параметрами virtualizer — базовый `Table`.
|
|
1940
|
+
|
|
1941
|
+
Чтобы отключить виртуализацию строк: `enableRowVirtualization={false}`.
|
|
1942
|
+
|
|
1943
|
+
### Примеры использования
|
|
1944
|
+
|
|
1945
|
+
#### Подгрузка при скролле
|
|
1946
|
+
|
|
1947
|
+
```tsx
|
|
1948
|
+
import { InfiniteTable, SimpleColumnDef } from '@cloud-ru/ds-table';
|
|
1949
|
+
import { useCallback, useState } from 'react';
|
|
1950
|
+
|
|
1951
|
+
type User = {
|
|
1952
|
+
id: string;
|
|
1953
|
+
name: string;
|
|
1954
|
+
email: string;
|
|
1955
|
+
role: string;
|
|
1956
|
+
};
|
|
1957
|
+
|
|
1958
|
+
const ALL_USERS: User[] = Array.from({ length: 20 }, (_, index) => ({
|
|
1959
|
+
id: `u-${index + 1}`,
|
|
1960
|
+
name: `Пользователь ${index + 1}`,
|
|
1961
|
+
email: `user${index + 1}@example.com`,
|
|
1962
|
+
role: index % 2 === 0 ? 'Editor' : 'Viewer',
|
|
1963
|
+
}));
|
|
1964
|
+
|
|
1965
|
+
const columns: SimpleColumnDef<User>[] = [
|
|
1966
|
+
{ key: 'name', header: 'Имя', width: 200 },
|
|
1967
|
+
{ key: 'email', header: 'Email', width: 240 },
|
|
1968
|
+
{ key: 'role', header: 'Роль', width: 140 },
|
|
1969
|
+
];
|
|
1970
|
+
|
|
1971
|
+
const PAGE = 5;
|
|
1972
|
+
|
|
1973
|
+
export function InfiniteTableBasic() {
|
|
1974
|
+
const [items, setItems] = useState(() => ALL_USERS.slice(0, PAGE));
|
|
1975
|
+
const [loading, setLoading] = useState(false);
|
|
1976
|
+
const hasMore = items.length < ALL_USERS.length;
|
|
1977
|
+
|
|
1978
|
+
const onLoadMore = useCallback(() => {
|
|
1979
|
+
setLoading(true);
|
|
1980
|
+
window.setTimeout(() => {
|
|
1981
|
+
setItems(ALL_USERS.slice(0, Math.min(items.length + PAGE, ALL_USERS.length)));
|
|
1982
|
+
setLoading(false);
|
|
1983
|
+
}, 300);
|
|
1984
|
+
}, [items.length]);
|
|
1985
|
+
|
|
1986
|
+
return (
|
|
1987
|
+
<div style={{ display: 'grid', gridTemplateRows: 'minmax(0, 1fr)', height: 360 }}>
|
|
1988
|
+
<InfiniteTable
|
|
1989
|
+
data={items}
|
|
1990
|
+
columns={columns}
|
|
1991
|
+
getRowId={user => user.id}
|
|
1992
|
+
loading={loading}
|
|
1993
|
+
hasMore={hasMore}
|
|
1994
|
+
onLoadMore={onLoadMore}
|
|
1995
|
+
outline
|
|
1996
|
+
/>
|
|
1997
|
+
</div>
|
|
1998
|
+
);
|
|
1999
|
+
}
|
|
2000
|
+
```
|
|
2001
|
+
|
|
2002
|
+
#### Через хук useInfiniteTableProps
|
|
2003
|
+
|
|
2004
|
+
```tsx
|
|
2005
|
+
import { SimpleColumnDef, Table, useInfiniteTableProps } from '@cloud-ru/ds-table';
|
|
2006
|
+
import { useCallback, useState } from 'react';
|
|
2007
|
+
|
|
2008
|
+
type User = { id: string; name: string; email: string };
|
|
2009
|
+
|
|
2010
|
+
const ALL_USERS: User[] = Array.from({ length: 12 }, (_, index) => ({
|
|
2011
|
+
id: `u-${index + 1}`,
|
|
2012
|
+
name: `Пользователь ${index + 1}`,
|
|
2013
|
+
email: `user${index + 1}@example.com`,
|
|
2014
|
+
}));
|
|
2015
|
+
|
|
2016
|
+
const columns: SimpleColumnDef<User>[] = [
|
|
2017
|
+
{ key: 'name', header: 'Имя', width: 200 },
|
|
2018
|
+
{ key: 'email', header: 'Email', width: 240 },
|
|
2019
|
+
];
|
|
2020
|
+
|
|
2021
|
+
const PAGE = 4;
|
|
2022
|
+
|
|
2023
|
+
export function InfiniteTableWithHook() {
|
|
2024
|
+
const [items, setItems] = useState(() => ALL_USERS.slice(0, PAGE));
|
|
2025
|
+
const [loading, setLoading] = useState(false);
|
|
2026
|
+
const hasMore = items.length < ALL_USERS.length;
|
|
2027
|
+
|
|
2028
|
+
const onLoadMore = useCallback(() => {
|
|
2029
|
+
setLoading(true);
|
|
2030
|
+
window.setTimeout(() => {
|
|
2031
|
+
setItems(ALL_USERS.slice(0, Math.min(items.length + PAGE, ALL_USERS.length)));
|
|
2032
|
+
setLoading(false);
|
|
2033
|
+
}, 300);
|
|
2034
|
+
}, [items.length]);
|
|
2035
|
+
|
|
2036
|
+
const tableProps = useInfiniteTableProps({
|
|
2037
|
+
data: items,
|
|
2038
|
+
columns,
|
|
2039
|
+
getRowId: user => user.id,
|
|
2040
|
+
loading,
|
|
2041
|
+
hasMore,
|
|
2042
|
+
onLoadMore,
|
|
2043
|
+
});
|
|
2044
|
+
|
|
2045
|
+
return (
|
|
2046
|
+
<div style={{ display: 'grid', gridTemplateRows: 'minmax(0, 1fr)', height: 360 }}>
|
|
2047
|
+
<Table {...tableProps} outline />
|
|
2048
|
+
</div>
|
|
2049
|
+
);
|
|
2050
|
+
}
|
|
2051
|
+
```
|
|
2052
|
+
|
|
2053
|
+
#### Без подгрузки (hasMore: false)
|
|
2054
|
+
|
|
2055
|
+
```tsx
|
|
2056
|
+
import { InfiniteTable, SimpleColumnDef } from '@cloud-ru/ds-table';
|
|
2057
|
+
|
|
2058
|
+
type User = { id: string; name: string; email: string };
|
|
2059
|
+
|
|
2060
|
+
const USERS: User[] = [
|
|
2061
|
+
{ id: 'u-1', name: 'Анна Иванова', email: 'anna@example.com' },
|
|
2062
|
+
{ id: 'u-2', name: 'Борис Петров', email: 'boris@example.com' },
|
|
2063
|
+
];
|
|
2064
|
+
|
|
2065
|
+
const columns: SimpleColumnDef<User>[] = [
|
|
2066
|
+
{ key: 'name', header: 'Имя', width: 200 },
|
|
2067
|
+
{ key: 'email', header: 'Email', width: 240 },
|
|
2068
|
+
];
|
|
2069
|
+
|
|
2070
|
+
export function InfiniteTableStatic() {
|
|
2071
|
+
return (
|
|
2072
|
+
<div style={{ display: 'grid', gridTemplateRows: 'minmax(0, 1fr)', height: 280 }}>
|
|
2073
|
+
<InfiniteTable data={USERS} columns={columns} getRowId={user => user.id} hasMore={false} outline />
|
|
2074
|
+
</div>
|
|
2075
|
+
);
|
|
2076
|
+
}
|
|
2077
|
+
```
|
|
2078
|
+
|
|
2079
|
+
## EntitiesTable
|
|
2080
|
+
|
|
2081
|
+
Server-driven список сущностей: state пагинации/поиска, queryFn и product-дефолты поверх ServerTable.
|
|
2082
|
+
|
|
2083
|
+
`EntitiesTable` — product-preset над **`ServerTable`** для экранов «список сущностей с бэкенда»: локальный state (`offset`, `limit`, `search`, `sorting`), вызов `queryFn` и предустановленные дефолты (`savedState`, drag колонок, пагинация `[10, 25, 50, 100]`).
|
|
2084
|
+
|
|
2085
|
+
### Когда использовать
|
|
2086
|
+
|
|
2087
|
+
- Миграция с `@cloud-ru/uikit-product-entities-table` — тот же вход: `columnDefinitions` + `queryFn`.
|
|
2088
|
+
- Нужен единый glue для react-query (или совместимого query-хука) без ручной сборки `ServerTable` props.
|
|
2089
|
+
|
|
2090
|
+
Когда **не** нужен:
|
|
2091
|
+
|
|
2092
|
+
- Ручной fetch и упрощённый API (`columns`, `statusColumn`) — **`ServerAdminTable`**.
|
|
2093
|
+
- Клиентские данные в памяти — **`AdminTable`** или **`SimpleTable`**.
|
|
2094
|
+
|
|
2095
|
+
#### EntitiesTable vs ServerAdminTable
|
|
2096
|
+
|
|
2097
|
+
| | `EntitiesTable` | `ServerAdminTable` |
|
|
2098
|
+
| --- | --- | --- |
|
|
2099
|
+
| Вход колонок | `columnDefinitions` | `columns` + `statusColumn` / `rowActions` |
|
|
2100
|
+
| Данные | `queryFn` (custom hook на render) | `items` / `total` / `loading` вручную |
|
|
2101
|
+
| State пагинации | внутри (`useEntitiesTableState`) | снаружи |
|
|
2102
|
+
| `savedState` | из обязательного `id` | не задаётся preset-ом |
|
|
2103
|
+
| Drag колонок | включён по умолчанию | только меню настроек |
|
|
2104
|
+
|
|
2105
|
+
Оба preset-а валидны; выбор — по входному API и способу загрузки данных.
|
|
2106
|
+
|
|
2107
|
+
#### Переход на ServerAdminTable
|
|
2108
|
+
|
|
2109
|
+
Если экран укладывается в `columns` + `statusColumn` и вы сами управляете fetch — уберите `queryFn`, state страницы вынесите наружу, колонки упростите. `savedState` из `id` не переносится; drag — через `columnsSettings`.
|
|
2110
|
+
|
|
2111
|
+
```tsx
|
|
2112
|
+
// Было
|
|
2113
|
+
<EntitiesTable id="entities" queryFn={useEntitiesQuery} columnDefinitions={columnDefinitions} getRowId={row => row.id} />
|
|
2114
|
+
|
|
2115
|
+
// Стало: items/total/loading + offset/limit/search снаружи
|
|
2116
|
+
<ServerAdminTable
|
|
2117
|
+
items={items}
|
|
2118
|
+
total={total}
|
|
2119
|
+
offset={offset}
|
|
2120
|
+
limit={limit}
|
|
2121
|
+
loading={loading}
|
|
2122
|
+
columns={columns}
|
|
2123
|
+
statusColumn={statusColumn}
|
|
2124
|
+
getRowId={row => row.id}
|
|
2125
|
+
onChangePage={(nextOffset, nextLimit) => { setOffset(nextOffset); setLimit(nextLimit); }}
|
|
2126
|
+
search={{ state: search, onChange: value => { setOffset(0); setSearch(value); } }}
|
|
2127
|
+
columnsSettings={{ enableDrag: true, enableSettingsMenu: true }}
|
|
2128
|
+
/>
|
|
2129
|
+
```
|
|
2130
|
+
|
|
2131
|
+
### Примеры использования
|
|
2132
|
+
|
|
2133
|
+
{/* client:only='react': SSR демо невозможен — @cloud-ru/ds-table тянет toolbar с directory-imports (см. table.mdx). */}
|
|
2134
|
+
|
|
2135
|
+
#### Базовое использование
|
|
2136
|
+
|
|
2137
|
+
```tsx
|
|
2138
|
+
import {
|
|
2139
|
+
ColumnDefinition,
|
|
2140
|
+
EntitiesTable,
|
|
2141
|
+
getRowActionsColumnDef,
|
|
2142
|
+
getStatusColumnDef,
|
|
2143
|
+
STATUS_APPEARANCE,
|
|
2144
|
+
} from '@cloud-ru/ds-table';
|
|
2145
|
+
|
|
2146
|
+
type Entity = {
|
|
2147
|
+
id: string;
|
|
2148
|
+
name: string;
|
|
2149
|
+
status: 'Active' | 'Paused';
|
|
2150
|
+
owner: string;
|
|
2151
|
+
};
|
|
2152
|
+
|
|
2153
|
+
const ENTITIES: Entity[] = [
|
|
2154
|
+
{ id: 'e-1', name: 'Compute cluster', status: 'Active', owner: 'Anna' },
|
|
2155
|
+
{ id: 'e-2', name: 'Object storage', status: 'Paused', owner: 'Boris' },
|
|
2156
|
+
{ id: 'e-3', name: 'CDN edge', status: 'Active', owner: 'Vera' },
|
|
2157
|
+
];
|
|
2158
|
+
|
|
2159
|
+
const columnDefinitions: ColumnDefinition<Entity>[] = [
|
|
2160
|
+
getStatusColumnDef({
|
|
2161
|
+
accessorKey: 'status',
|
|
2162
|
+
header: 'Status',
|
|
2163
|
+
size: 120,
|
|
2164
|
+
mapStatusToAppearance: value => (value === 'Active' ? STATUS_APPEARANCE.Green : STATUS_APPEARANCE.Yellow),
|
|
2165
|
+
renderDescription: value => String(value),
|
|
2166
|
+
}),
|
|
2167
|
+
{ id: 'name', accessorKey: 'name', header: 'Name', enableSorting: true },
|
|
2168
|
+
{ id: 'owner', accessorKey: 'owner', header: 'Owner', enableSorting: true },
|
|
2169
|
+
getRowActionsColumnDef({
|
|
2170
|
+
actionsGenerator: cell => [{ content: { label: `Open ${cell.row.original.name}` }, onClick: () => {} }],
|
|
2171
|
+
}),
|
|
2172
|
+
];
|
|
2173
|
+
|
|
2174
|
+
function useEntitiesQuery({
|
|
2175
|
+
params,
|
|
2176
|
+
}: {
|
|
2177
|
+
params: { offset: number; limit: number; search?: string; ordering?: string };
|
|
2178
|
+
}) {
|
|
2179
|
+
const normalizedSearch = params.search?.trim().toLowerCase() ?? '';
|
|
2180
|
+
const filtered = normalizedSearch
|
|
2181
|
+
? ENTITIES.filter(entity => entity.name.toLowerCase().includes(normalizedSearch))
|
|
2182
|
+
: ENTITIES;
|
|
2183
|
+
|
|
2184
|
+
return {
|
|
2185
|
+
data: {
|
|
2186
|
+
total: filtered.length,
|
|
2187
|
+
data: filtered.slice(params.offset, params.offset + params.limit),
|
|
2188
|
+
},
|
|
2189
|
+
isLoading: false,
|
|
2190
|
+
isFetching: false,
|
|
2191
|
+
isError: false,
|
|
2192
|
+
isSuccess: true,
|
|
2193
|
+
refetch: () => {},
|
|
2194
|
+
};
|
|
2195
|
+
}
|
|
2196
|
+
|
|
2197
|
+
export function EntitiesTableBasic() {
|
|
2198
|
+
return (
|
|
2199
|
+
<EntitiesTable<Entity, { params: { offset: number; limit: number; search?: string; ordering?: string } }>
|
|
2200
|
+
id='entities-table-basic'
|
|
2201
|
+
queryFn={useEntitiesQuery}
|
|
2202
|
+
columnDefinitions={columnDefinitions}
|
|
2203
|
+
defaultLimit={5}
|
|
2204
|
+
searchPlaceholder='Search entities'
|
|
2205
|
+
getRowId={entity => entity.id}
|
|
2206
|
+
/>
|
|
2207
|
+
);
|
|
2208
|
+
}
|
|
2209
|
+
```
|
|
2210
|
+
|
|
2211
|
+
#### Через useEntitiesTableState + useEntitiesTableProps
|
|
2212
|
+
|
|
2213
|
+
```tsx
|
|
2214
|
+
import {
|
|
2215
|
+
ColumnDefinition,
|
|
2216
|
+
getRowActionsColumnDef,
|
|
2217
|
+
getStatusColumnDef,
|
|
2218
|
+
ServerTable,
|
|
2219
|
+
STATUS_APPEARANCE,
|
|
2220
|
+
useEntitiesTableProps,
|
|
2221
|
+
useEntitiesTableState,
|
|
2222
|
+
} from '@cloud-ru/ds-table';
|
|
2223
|
+
|
|
2224
|
+
type Entity = {
|
|
2225
|
+
id: string;
|
|
2226
|
+
name: string;
|
|
2227
|
+
status: 'Active' | 'Paused';
|
|
2228
|
+
owner: string;
|
|
2229
|
+
};
|
|
2230
|
+
|
|
2231
|
+
const ENTITIES: Entity[] = [
|
|
2232
|
+
{ id: 'e-1', name: 'Compute cluster', status: 'Active', owner: 'Anna' },
|
|
2233
|
+
{ id: 'e-2', name: 'Object storage', status: 'Paused', owner: 'Boris' },
|
|
2234
|
+
{ id: 'e-3', name: 'CDN edge', status: 'Active', owner: 'Vera' },
|
|
2235
|
+
];
|
|
2236
|
+
|
|
2237
|
+
const columnDefinitions: ColumnDefinition<Entity>[] = [
|
|
2238
|
+
getStatusColumnDef({
|
|
2239
|
+
accessorKey: 'status',
|
|
2240
|
+
header: 'Status',
|
|
2241
|
+
size: 120,
|
|
2242
|
+
mapStatusToAppearance: value => (value === 'Active' ? STATUS_APPEARANCE.Green : STATUS_APPEARANCE.Yellow),
|
|
2243
|
+
renderDescription: value => String(value),
|
|
2244
|
+
}),
|
|
2245
|
+
{ id: 'name', accessorKey: 'name', header: 'Name', enableSorting: true },
|
|
2246
|
+
{ id: 'owner', accessorKey: 'owner', header: 'Owner', enableSorting: true },
|
|
2247
|
+
getRowActionsColumnDef({
|
|
2248
|
+
actionsGenerator: cell => [{ content: { label: `Open ${cell.row.original.name}` }, onClick: () => {} }],
|
|
2249
|
+
}),
|
|
2250
|
+
];
|
|
2251
|
+
|
|
2252
|
+
function useEntitiesQuery({
|
|
2253
|
+
params,
|
|
2254
|
+
}: {
|
|
2255
|
+
params: { offset: number; limit: number; search?: string; ordering?: string };
|
|
2256
|
+
}) {
|
|
2257
|
+
const normalizedSearch = params.search?.trim().toLowerCase() ?? '';
|
|
2258
|
+
const filtered = normalizedSearch
|
|
2259
|
+
? ENTITIES.filter(entity => entity.name.toLowerCase().includes(normalizedSearch))
|
|
2260
|
+
: ENTITIES;
|
|
2261
|
+
|
|
2262
|
+
return {
|
|
2263
|
+
data: {
|
|
2264
|
+
total: filtered.length,
|
|
2265
|
+
data: filtered.slice(params.offset, params.offset + params.limit),
|
|
2266
|
+
},
|
|
2267
|
+
isLoading: false,
|
|
2268
|
+
isFetching: false,
|
|
2269
|
+
isError: false,
|
|
2270
|
+
isSuccess: true,
|
|
2271
|
+
refetch: () => {},
|
|
2272
|
+
};
|
|
2273
|
+
}
|
|
2274
|
+
|
|
2275
|
+
export function EntitiesTableWithHook() {
|
|
2276
|
+
const tableState = useEntitiesTableState({ defaultLimit: 5 });
|
|
2277
|
+
const params = { params: tableState.paginationParams } as {
|
|
2278
|
+
params: { offset: number; limit: number; search?: string; ordering?: string };
|
|
2279
|
+
};
|
|
2280
|
+
const query = useEntitiesQuery(params);
|
|
2281
|
+
|
|
2282
|
+
const tableProps = useEntitiesTableProps({
|
|
2283
|
+
input: {
|
|
2284
|
+
id: 'entities-table-with-hook',
|
|
2285
|
+
columnDefinitions,
|
|
2286
|
+
searchPlaceholder: 'Search entities',
|
|
2287
|
+
getRowId: (entity: Entity) => entity.id,
|
|
2288
|
+
},
|
|
2289
|
+
tableState,
|
|
2290
|
+
query,
|
|
2291
|
+
});
|
|
2292
|
+
|
|
2293
|
+
return <ServerTable {...tableProps} />;
|
|
2294
|
+
}
|
|
2295
|
+
```
|
|
2296
|
+
|
|
2297
|
+
#### С серверными фильтрами
|
|
2298
|
+
|
|
2299
|
+
```tsx
|
|
2300
|
+
import { FiltersState } from '@cloud-ru/ds-chips';
|
|
2301
|
+
import {
|
|
2302
|
+
ColumnDefinition,
|
|
2303
|
+
EntitiesTable,
|
|
2304
|
+
getRowActionsColumnDef,
|
|
2305
|
+
getStatusColumnDef,
|
|
2306
|
+
STATUS_APPEARANCE,
|
|
2307
|
+
} from '@cloud-ru/ds-table';
|
|
2308
|
+
|
|
2309
|
+
type Entity = {
|
|
2310
|
+
id: string;
|
|
2311
|
+
name: string;
|
|
2312
|
+
status: 'Active' | 'Paused' | 'Archived';
|
|
2313
|
+
service: string;
|
|
2314
|
+
};
|
|
2315
|
+
|
|
2316
|
+
type QueryParams = FiltersState & {
|
|
2317
|
+
params: { offset: number; limit: number; search?: string; ordering?: string };
|
|
2318
|
+
single?: string;
|
|
2319
|
+
};
|
|
2320
|
+
|
|
2321
|
+
const ENTITIES: Entity[] = [
|
|
2322
|
+
{ id: 'e-1', name: 'Compute cluster', status: 'Active', service: 'compute' },
|
|
2323
|
+
{ id: 'e-2', name: 'Object storage', status: 'Paused', service: 'storage' },
|
|
2324
|
+
{ id: 'e-3', name: 'CDN edge', status: 'Archived', service: 'cdn' },
|
|
2325
|
+
];
|
|
2326
|
+
|
|
2327
|
+
const columnDefinitions: ColumnDefinition<Entity>[] = [
|
|
2328
|
+
getStatusColumnDef({
|
|
2329
|
+
accessorKey: 'status',
|
|
2330
|
+
header: 'Status',
|
|
2331
|
+
size: 120,
|
|
2332
|
+
mapStatusToAppearance: value => {
|
|
2333
|
+
if (value === 'Active') return STATUS_APPEARANCE.Green;
|
|
2334
|
+
if (value === 'Paused') return STATUS_APPEARANCE.Yellow;
|
|
2335
|
+
return STATUS_APPEARANCE.Neutral;
|
|
2336
|
+
},
|
|
2337
|
+
renderDescription: value => String(value),
|
|
2338
|
+
}),
|
|
2339
|
+
{ id: 'name', accessorKey: 'name', header: 'Name', enableSorting: true },
|
|
2340
|
+
{ id: 'service', accessorKey: 'service', header: 'Service', enableSorting: true },
|
|
2341
|
+
getRowActionsColumnDef({
|
|
2342
|
+
actionsGenerator: cell => [{ content: { label: `Open ${cell.row.original.name}` }, onClick: () => {} }],
|
|
2343
|
+
}),
|
|
2344
|
+
];
|
|
2345
|
+
|
|
2346
|
+
function useEntitiesQuery(queryProps: QueryParams) {
|
|
2347
|
+
const { params, single } = queryProps;
|
|
2348
|
+
const filtered = ENTITIES.filter(entity => {
|
|
2349
|
+
const matchesSearch = !params.search || entity.name.toLowerCase().includes(params.search.toLowerCase());
|
|
2350
|
+
const matchesStatus = !single || entity.status.toLowerCase() === single.toLowerCase();
|
|
2351
|
+
|
|
2352
|
+
return matchesSearch && matchesStatus;
|
|
2353
|
+
});
|
|
2354
|
+
|
|
2355
|
+
return {
|
|
2356
|
+
data: {
|
|
2357
|
+
total: filtered.length,
|
|
2358
|
+
data: filtered.slice(params.offset, params.offset + params.limit),
|
|
2359
|
+
},
|
|
2360
|
+
isLoading: false,
|
|
2361
|
+
isFetching: false,
|
|
2362
|
+
isError: false,
|
|
2363
|
+
isSuccess: true,
|
|
2364
|
+
refetch: () => {},
|
|
2365
|
+
};
|
|
2366
|
+
}
|
|
2367
|
+
|
|
2368
|
+
export function EntitiesTableWithFilters() {
|
|
2369
|
+
return (
|
|
2370
|
+
<EntitiesTable<Entity, QueryParams>
|
|
2371
|
+
id='entities-table-with-filters'
|
|
2372
|
+
queryFn={useEntitiesQuery}
|
|
2373
|
+
columnDefinitions={columnDefinitions}
|
|
2374
|
+
defaultLimit={5}
|
|
2375
|
+
searchPlaceholder='Search entities'
|
|
2376
|
+
getRowId={entity => entity.id}
|
|
2377
|
+
columnFilters={{
|
|
2378
|
+
filters: [
|
|
2379
|
+
{
|
|
2380
|
+
id: 'single',
|
|
2381
|
+
type: 'single',
|
|
2382
|
+
label: 'Status',
|
|
2383
|
+
pinned: true,
|
|
2384
|
+
options: [
|
|
2385
|
+
{ value: 'active', label: 'Active' },
|
|
2386
|
+
{ value: 'paused', label: 'Paused' },
|
|
2387
|
+
{ value: 'archived', label: 'Archived' },
|
|
2388
|
+
],
|
|
2389
|
+
},
|
|
2390
|
+
],
|
|
2391
|
+
}}
|
|
2392
|
+
/>
|
|
2393
|
+
);
|
|
2394
|
+
}
|
|
2395
|
+
```
|
|
2396
|
+
|
|
2397
|
+
### Props
|
|
2398
|
+
|
|
2399
|
+
| Prop | Type | Default | Description |
|
|
2400
|
+
|------|------|---------|-------------|
|
|
2401
|
+
| `autoResetPageIndex` | `boolean` | — | Автоматический сброс пагинации к первой странице при изменении данных/фильтров/сортировки |
|
|
2402
|
+
| `bulkActions` | `BulkAction[]` | — | Список действий для массовых операций |
|
|
2403
|
+
| `cardColumns` | `number` | — | Желаемое число колонок карточного вида (`view='cards'`). <br/> На широком контейнере рисуется ровно столько колонок; при сужении сетка <br/> схлопывается до меньшего числа (порог — `cardMinWidth`). Без пропа число <br/> колонок определяется только шириной контейнера и `cardMinWidth` (auto-fill). |
|
|
2404
|
+
| `cardMinWidth` | `number` | `320` | Минимальная ширина карточки в `view='cards'`, px. Порог, ниже которого <br/> колонки схлопываются. Карточка ужимается до ширины контейнера, если он уже. |
|
|
2405
|
+
| `className` | `string` | — | CSS-класс |
|
|
2406
|
+
| `columnDefinitions` | `ColumnDefinition<T>[]` | — | Определение внешнего вида и функционала колонок |
|
|
2407
|
+
| `columnFilters` | `(Omit<ChipChoiceRowProps<P>, "data-test-id" \| "size"> & { open?: boolean; initialOpen?: boolean; onOpenChange?(isOpen: boolean): void; } & { ...; }) \| undefined` | — | Фильтры |
|
|
2408
|
+
| `columnVirtualizerInstanceRef` | `MutableRefObject<ColumnVirtualizer>` | — | Ref на инстанс column-virtualizer'а для управления прокруткой снаружи |
|
|
2409
|
+
| `columnVirtualizerOptions` | `Partial<VirtualizerOptions<HTMLElement, Element>>` | — | Дополнительные параметры column-virtualizer'а (`@tanstack/react-virtual`). <br/> Переопределяют дефолты (overscan=3). |
|
|
2410
|
+
| `copyPinnedRows` | `boolean` | `false` | Параметр отвечает за сохранение закрепленных строк в теле таблицы |
|
|
2411
|
+
| `data-test-id` | `string` | — | |
|
|
2412
|
+
| `dataFiltered` | `boolean` | — | Флаг, показывающий что данные были отфильтрованы при пустых данных |
|
|
2413
|
+
| `defaultLimit` | `number` | — | |
|
|
2414
|
+
| `defaultOffset` | `number` | — | |
|
|
2415
|
+
| `defaultSearch` | `string` | — | |
|
|
2416
|
+
| `defaultSort` | `SortingState` | — | |
|
|
2417
|
+
| `defaultView` | `"cards"` \| `"table"` | `'table' (на mobile — `cards`)` | Начальный режим отображения (uncontrolled). <br/> Если не задан — дефолт по раскладке: `table` на desktop, `cards` на mobile (`TABLE_LAYOUT_PRESETS`). |
|
|
2418
|
+
| `enableColumnVirtualization` | `boolean` | `false` | Включает виртуализацию колонок (windowing по горизонтали). <br/> Рекомендуется при > 30 видимых колонок. Несовместимо с `view='cards'`. <br/> Pinned-колонки (left/right) всегда отрисовываются вне зависимости от настройки. |
|
|
2419
|
+
| `enableFuzzySearch` | `boolean` | — | Включить нечеткий поиск |
|
|
2420
|
+
| `enableRowVirtualization` | `boolean` | `false` | Включает виртуализацию строк (windowing по вертикали). <br/> Рекомендуется при > 200 строк. Несовместимо с `view='cards'` — при картах игнорируется. |
|
|
2421
|
+
| `enableSelectPinned` | `boolean` | — | Параметр отвечает за чекбокс выбора закрепленных строк |
|
|
2422
|
+
| `errorDataState` | `EmptyStateProps` | — | Экран при ошибке запроса |
|
|
2423
|
+
| `expanding` | `{ getSubRows: (element: T) => T[]; expandingColumnDefinition: TreeColumnDefinitionProps<T>; initialState?: ExpandedState; state?: ExpandedState \| undefined; onChange?(state: ExpandedState): void; } \| undefined` | — | Общие настройки раскрывающихся (tree) строк: `getSubRows`, `expandingColumnDefinition`, <br/> `initialState`, `state`, `onChange`. |
|
|
2424
|
+
| `fullWidth` | `boolean` | `true` | Растягивать таблицу на всю ширину контейнера. <br/> При `false` ширина определяется суммой колонок (лучше всего, когда у всех колонок задан `size` / `width`). <br/> Явный проп = desktop-значение; на mobile всегда `true` (`TABLE_LAYOUT_PRESETS`). |
|
|
2425
|
+
| `getRowBackgroundColor` | `((data: T) => TableRowColor)` | — | Функция определения цвета фона строки по её данным. <br/> Работает только в `view='table'` — карточки (`view='cards'`) не тонируются. <br/> @param data данные строки <br/> @returns цвет фона строки или `undefined` |
|
|
2426
|
+
| `getRowId` | `((originalRow: T, index: number, parent?: Row<T>) => string)` | — | Функция получения уникального идентификатора строки |
|
|
2427
|
+
| `hasMore` | `undefined` | — | |
|
|
2428
|
+
| `headerRowBackgroundColor` | `"blue"` \| `"green"` \| `"neutral"` \| `"orange"` \| `"pink"` \| `"red"` \| `"violet"` \| `"yellow"` | — | Accent-тон фона строки заголовков колонок (`tableHeadLine`). <br/> Работает только в `view='table'`. |
|
|
2429
|
+
| `headlineId` | `string` | — | Id колонки, чей рендер используется как заголовок карточки в режиме `view='cards'`. <br/> Имеет смысл только при `view='cards'`. |
|
|
2430
|
+
| `id` | `string` | — | |
|
|
2431
|
+
| `infiniteLoading` | `undefined` | — | |
|
|
2432
|
+
| `keepPinnedRows` | `boolean` | `false` | Параметр отвечает за отображение закрепленных строк на всех страницах таблицы |
|
|
2433
|
+
| `layoutPresets` | `Partial<Record<LayoutType, Partial<TableLayoutDefaults>>>` | — | Override дефолтов адаптива для этого инстанса (`mergePresets` поверх `TABLE_LAYOUT_PRESETS`). <br/> `stickyControls` в пресете tier'а заменяет DS-объект целиком — указывайте все нужные поля. <br/> Escape-hatch: обычно не нужен — DS-пресет применяется автоматически по `AdaptiveProvider`. |
|
|
2434
|
+
| `loadMoreTrigger` | `undefined` | — | |
|
|
2435
|
+
| `manualFiltering` | `boolean` | — | |
|
|
2436
|
+
| `manualPagination` | `boolean` | — | |
|
|
2437
|
+
| `manualSorting` | `boolean` | — | |
|
|
2438
|
+
| `moreActions` | `Action[]` | — | Элементы выпадающего списка кнопки с действиями |
|
|
2439
|
+
| `noDataState` | `EmptyStateProps` | — | Экран при отсутствии данных |
|
|
2440
|
+
| `noResultsState` | `EmptyStateProps` | — | Экран при отсутствии результатов поиска или фильтров |
|
|
2441
|
+
| `onExport` | `(() => void)` | — | Колбэк экспорта данных. Рендерит иконку в тулбаре перед настройками колонок. |
|
|
2442
|
+
| `onLoadMore` | `undefined` | — | |
|
|
2443
|
+
| `onPaginationOrDataChange` | `((data: T[]) => void)` | — | |
|
|
2444
|
+
| `onQuerySuccess` | `(() => void)` | — | |
|
|
2445
|
+
| `onRowClick` | `RowClickHandler<T>` | — | Колбэк клика по строке |
|
|
2446
|
+
| `onViewChange` | `((view: View) => void)` | — | Колбэк на смену режима отображения |
|
|
2447
|
+
| `queryFn` | `EntityQueryFn<P, T>` | — | |
|
|
2448
|
+
| `queryProps` | `Omit<P, "params">` | — | |
|
|
2449
|
+
| `ref` | `Ref<EntitiesTableHandle<T>>` | — | |
|
|
2450
|
+
| `renderCard` | `((context: RenderCardContext<T>) => ReactNode)` | — | Кастомный рендер карточки в `view='cards'`. Получает контекст с tanstack <br/> `row` / `table` и `defaultRender` (готовый элемент дефолтной карточки — <br/> можно обернуть). Возврат заменяет дефолтную карточку. |
|
|
2451
|
+
| `rowAutoHeight` | `boolean` | — | |
|
|
2452
|
+
| `rowPinning` | `Pick<RowPinningState, "top">` | — | Определение, какие строки должны быть закреплены в таблице |
|
|
2453
|
+
| `rowSelection` | `{ initialState?: RowSelectionState; state?: RowSelectionState; enable?: boolean \| ((row: Row<T>) => boolean) \| undefined; multiRow?: boolean \| undefined; onChange?(state: RowSelectionState): void; appearance?: RowAppearance \| undefined; } \| undefined` | — | Параметры выбора строк: `initialState`, `state`, `enable`, `appearance`, `multiRow`, `onChange`. |
|
|
2454
|
+
| `rowVirtualizerInstanceRef` | `MutableRefObject<RowVirtualizer>` | — | Ref на инстанс row-virtualizer'а для управления прокруткой снаружи |
|
|
2455
|
+
| `rowVirtualizerOptions` | `Partial<VirtualizerOptions<HTMLElement, Element>>` | — | Дополнительные параметры row-virtualizer'а (`@tanstack/react-virtual`). <br/> Переопределяют дефолты (overscan=10, estimateSize=40). |
|
|
2456
|
+
| `scrollContainerRef` | `RefObject<HTMLElement>` | — | Ссылка на контейнер, который скроллится |
|
|
2457
|
+
| `scrollRef` | `Ref<HTMLElement>` | — | Ссылка на элемент, обозначающий самый конец прокручиваемого списка |
|
|
2458
|
+
| `searchPlaceholder` | `string` | — | |
|
|
2459
|
+
| `showDataView` | `boolean` | `false` | Показывать переключатель вида (таблица/карточки) в тулбаре. <br/> Управляет только видимостью тоггла; сам вид задаётся `view` / `defaultView`. <br/> По умолчанию тоггла нет — таблица показывает один вид (`defaultView` либо <br/> адаптивный дефолт). Включите `showDataView`, чтобы дать пользователю <br/> переключать table/cards. |
|
|
2460
|
+
| `stickyControls` | `StickyControls` | — | Sticky-хром при скролле страницы: при `enabled: true` тулбар и пагинация липнут к верху/низу <br/> viewport, в table-view заголовок колонок — под тулбаром; тело растёт по контенту. <br/> При `enabled: false` все блоки идут сплошным потоком без sticky. <br/> Дефолты: desktop — `enabled: false` (offsets не применяются); <br/> mobile — `{ enabled: true, offsetTop: 0, offsetBottom: 0 }` (`TABLE_LAYOUT_PRESETS`); <br/> `backgroundPredefined` — `neutralBackground1Level` на всех раскладках. <br/> Явный проп = desktop-значение; mobile-override — `layoutPresets.mobile`. <br/> @example `stickyControls={{ enabled: true, offsetTop: 64 }}` — sticky на desktop, app header 64px. |
|
|
2461
|
+
| `suppressHeader` | `boolean` | — | Отключение хедера таблицы; в режиме `view='cards'` скрывает подписи-заголовки полей карточки |
|
|
2462
|
+
| `suppressPagination` | `boolean` | — | Отключение пагинации |
|
|
2463
|
+
| `suppressSearch` | `boolean` | — | Отключение поиска |
|
|
2464
|
+
| `suppressToolbar` | `boolean` | — | Отключение тулбара |
|
|
2465
|
+
| `toolbarAfter` | `ReactNode` | — | Дополнительный слот в `Toolbar` после строки поиска |
|
|
2466
|
+
| `view` | `"cards"` \| `"table"` | `'table' (на mobile — `cards`)` | Режим отображения таблицы (controlled). <br/> `table` — классическая сетка; `cards` — карточки (заголовок берётся из колонки `headlineId`). <br/> Переключатель вида в тулбаре включается отдельным пропом `showDataView`. |
|
|
2467
|
+
|
|
2468
|
+
### Смотри также
|
|
2469
|
+
|
|
2470
|
+
- **`ServerAdminTable`** — ручной fetch и упрощённый API колонок.
|
|
2471
|
+
- **`ServerTable`** — escape hatch без product-дефолтов.
|