DataTableReferencia de API
Todo lo que exporta
Componentes, hooks, utilidades y tipos disponibles en el paquete.
Todo lo que expone @fesa/components/datatable, campo a campo y con sus valores por defecto. Para el "cómo se usa junto", ve a la guía y las recetas.
Componentes
| Export | Qué es |
|---|---|
SmartDataTable | La tabla autogestionada (la que usarás el 95% del tiempo). |
CustomDataTable | El motor controlado por props (casos legacy o estado externo). |
TableFiltersMenu | El menú de filtros facetados, usable por separado. |
MobileCardList | La lista de tarjetas móvil, usable por separado. |
DataTableLabelsProvider | Provider de textos (i18n). |
CustomTableHeader / Body / Row / Pagination / Toolbar | Sub-componentes para composiciones a medida. |
Hooks
| Export | Para qué |
|---|---|
useSmartTable | Wiring completo de un listado (URL + filtros + fetch + navegación). Detalle |
useTableSearchParams | Leer/escribir el estado de la tabla en la URL. Detalle |
useTableFilters | Estado + UI de los filtros facetados. Detalle |
useRowNavigate | Doble clic en fila → navegar a su detalle. |
useDataTableLiveRefresh | Recargar la tabla cuando llega un evento externo (SSE…). |
useDataTableStore / useDataTableStoreApi / useDataTableRefetch | Acceso al store desde celdas/diálogos dentro de la tabla. |
useMediaQuery | Media query SSR-safe (useSyncExternalStore). |
useDataTableState / useFullscreen / useCopyClipboard / usePrint / useColumnPinning / useColumnResizing / useVirtualization / useKeyboardNavigation / usePersistence / usePrefetch / usePaginationPrefetch / useAbortController / useSafeTransition | Hooks internos exportados para composiciones avanzadas. |
Utilidades
| Export | Para qué |
|---|---|
exportRows(format, rows, columns, options?) | Genera y descarga CSV/JSON/XLSX fuera de la tabla. |
buildCsv / buildJson / downloadFile | Piezas del export por separado. |
parseRangeToken(token) / buildRangeToken(from, to) | Convertir el token "desde..hasta" de los filtros de rango. |
applyColumnOrder / moveColumn | La matemática del reordenado de columnas. |
DEFAULT_DATATABLE_LABELS / mergeDataTableLabels | Los textos por defecto y su merge. |
Tipos principales
CustomColumnDef, SmartDataTableProps/Ref, CustomDataTableProps/Ref, DataTableFetchParams/Result/Fn, FilterDefinition, RangeFilterValue, BulkActionsContext, DataTableLabels/Override, ColumnOrderConfig y todas las configs de la sección de configs.