Premium Widgets
Custom Table
Table en React
Listas con columnas ordenables, acciones de fila y componentes incrustados. Adecuado para pedidos, inventario y listas de selección.
Referencia para @arcrider/arcwidgets-react@0.1.0-alpha.5. <a href="/docs/react/intro/setup-react">Instalación</a> · <a href="/docs/react/intro/react-components">Todos los componentes</a>.
Ejemplo completo
import { ArcWidgetTable } from '@arcrider/arcwidgets-react';
const columns = [ { title: 'Status', width: '100px' }, { title: 'Appointment', width: '120px' }, { title: 'Patient', width: 'fraction' }, { title: 'Date of birth', width: '140px' }, ]; const appointments = [ ['Planned', '14.06.2026', 'Albert Bear', '01.01.1980'], ['-', '15.06.2026', 'Maya Bee', '02.02.1990'], ['Completed', '16.06.2026', 'Carla Summer', '03.03.1985'], ['Scheduled', '17.06.2026', 'Dieter Fox', '04.04.1975'], ['Open', '18.06.2026', 'Eva Green', '05.05.1992'], ]; const rows = appointments.map((values, index) => ({ id: String(index + 1), columns: columns.map((column, i) => ({ value: values[i], width: column.width, })), }));
export default function Example() { return ( <ArcWidgetTable data={{ height: '400px', rowHoverAction: { hoverActive: true }, header: { columns }, table: rows, scrollBar: { showScrollBar: false }, footer: { showFooter: true, rightSideContent: Total: ${rows.length} }, }} /> ); }</code></pre>
Props del componente
id
ID de DOM opcional. No es necesario en el uso normal; se genera automáticamente si se omite.
data
Configuración de tipo ArcWidgetTableData. Pasa los cambios como objetos nuevos; gestiona los datos de negocio y la selección en el estado de React.
onAction
Fallback opcional (type: string, ...args: unknown[]) => unknown. El callback concreto tiene prioridad. Detalles: <a href="/docs/react/patterns/react-state-events">Estado y eventos</a>.
onCellClick
Evento del ratón y posición de la celda. Requiere clickable: true en la fila o la celda.
onCellClick?: (event: MouseEvent, payload: ArcWidgetTableCellPayload) => void;
onCellHoverEnter
Posición de la celda sobre la que se entra; requiere hover_enterable: true en la celda.
onCellHoverEnter?: (payload: ArcWidgetTableCellPayload) => void;
onCellHoverLeave
Posición de la celda que se abandona; requiere hover_leaveable: true en la celda.
onCellHoverLeave?: (payload: ArcWidgetTableCellPayload) => void;
onFooterActionClick
Evento del ratón del botón de acción del pie; requiere footer.showActionButton: true.
onFooterActionClick?: (event: MouseEvent) => void;
Configuración
Los siguientes campos pertenecen a data. Los tamaños se indican como strings, los números y valores de tiempo según su tipo respectivo.
height
Alto del widget, p. ej. "320px", o "auto" para que crezca con las filas (combínalo con maxHeight para el scroll). Los valores en porcentaje necesitan un contenedor padre con altura fija.
Tipo: string.
minHeight
Límite inferior de altura.
Tipo: string.
width
Ancho CSS de la tabla. Por defecto 100%.
Tipo: string.
maxHeight
Límite superior de altura. Con height: "auto", el cuerpo se desplaza por encima de este límite.
Tipo: string.
groupedBy
field de las celdas por el que se agrupan las filas; omítelo para tablas planas. Se ignora cuando las filas tienen items anidados.
Tipo: string.
groupsCollapsed
Estado inicial de los grupos. Los grupos empiezan contraídos por defecto; establece false para que empiecen desplegados. La elección del usuario por grupo se recuerda.
Tipo: boolean.
collapsible
Desplegar y contraer filas con items anidados: columna del conmutador, sangría e iconos propios opcionales.
Tipo: ArcWidgetTableCollapsible.
rowHoverAction
Resaltado de la fila al pasar el cursor sobre ella. Desactivado por defecto; actívalo con hoverActive: true.
Tipo: ArcWidgetTableHoverAction.
actions
Ajustes de hover para todas las filas, p. ej. [{ type: 'hover', enabled: false }]. Las filas y celdas pueden sobrescribirlos con sus propias actions.
Tipo: ArcWidgetAction[].
header
Encabezados de columna, anchos, alineación, columnas fijadas y opciones de ordenación.
Tipo: ArcWidgetTableHeader.
emptyTable
title es el texto de fallback simple. Si value está establecido, ese contenido sustituye por completo al fallback. Para mostrar título y descripción juntos, usa un elemento JSX en value, como en el ejemplo en vivo.
Representación cuando la lista de filas está vacía. El texto integrado está en alemán, así que establece title o value para otros idiomas.
Tipo: ArcWidgetTableEmpty.
scrollBar
Aspecto de las barras de desplazamiento. La barra horizontal aparece automáticamente cuando las columnas son más anchas que la tabla; showScrollBar: true muestra también la vertical.
Tipo: ArcWidgetTableScrollBar.
table
Filas de datos con columns; las subfilas opcionales están en items.
Tipo: ArcWidgetTableRow[].
footerColumns
Fila de resumen entre el cuerpo y el pie, p. ej. para totales. Usa la rejilla de columnas del encabezado; sin columns propias, muestra el texto footer de cada columna del encabezado.
Tipo: ArcWidgetTableFooterColumns.
footer
Contenidos y visibilidad del pie de tabla.
Tipo: ArcWidgetTableFooter.
styles
Superficie y líneas de la tabla: backgroundColor, fontColor, fontSize, borderColor, borderSize, borderRadius y borders para el borde exterior, las líneas de fila y las líneas de columna. Las demás claves CSS se aplican al elemento del widget.
Tipo: ArcWidgetTableStyles | string.
Comportamiento y límites
- Cada columna necesita un ancho. Mejor al menos una vez
width: "fraction" o "auto"; el encabezado y las celdas deben tener el mismo orden de columnas. Si todas las columnas son fijas y juntas son más estrechas que la tabla, la última columna crece y llena el espacio restante.
- Establece
clickable: true en la fila o la celda para que se dispare onCellClick. row_index apunta a data.table y no se ve afectado por la ordenación; es null cuando la tabla tiene items anidados, así que usa ahí flat_index.
- Alinea las columnas con
alignX: 'left' | 'center' | 'right' en la columna del encabezado y en sus celdas.
- Con contenidos de celda JSX, la ordenación necesita un
sort.value escalar. Las columnas de fecha se ordenan con new Date(value), así que los strings localizados como "14.06.2026" necesitan un sort.value con una marca de tiempo o una fecha ISO.
- Las filas anidadas se describen mediante
items; collapsible controla la sangría y el despliegue. Los ejemplos planos pueden mapear row_index directamente a la lista de datos.
Los campos ArcWidgetSlot admitidos permiten elementos JSX individuales, texto o descriptores de widget. Pasa texto externo como texto JSX; los strings HTML se interpretan como HTML. <a href="/docs/react/patterns/nested-widget-descriptors">Combinar contenidos</a>.
Tipos de datos
Estos tipos relacionados con el widget se exportan desde el paquete. También están disponibles tipos comunes como ArcWidgetSlot, ArcWidgetStyles y ArcReactWidgetProps. Los objetos de configuración son cerrados, por lo que una clave mal escrita o no admitida se notifica como error de tipo.
export interface ArcWidgetTableCellPayload {
row_index: number | null;
col_index: number;
flat_index: number | null;
group_value: string | null;
}
export interface ArcWidgetTableSort { enabled?: boolean; type?: 'text' | 'number' | 'date'; value?: string | number; }
export interface ArcWidgetTableSortIcons { color?: string; activeColor?: string; hoverColor?: string; }
export interface ArcWidgetTableHeaderColumn { title?: ArcWidgetSlot; width?: 'fraction' | 'auto' | (string & {}); minWidth?: string; alignX?: 'left' | 'center' | 'right'; fixed?: 'left' | 'right'; sort?: ArcWidgetTableSort; fontColor?: string; backgroundColor?: string; styles?: ArcWidgetCssStyles | string; footer?: string; }
export interface ArcWidgetTableHeader { showHeader?: boolean; columns?: ArcWidgetTableHeaderColumn[]; height?: 'auto' | (string & {}); fontSize?: string; fontColor?: string; backgroundColor?: string; styles?: ArcWidgetCssStyles | string; sortIcons?: ArcWidgetTableSortIcons; }
export interface ArcWidgetTableColumn { value?: ArcWidgetSlot; field?: string; title?: ArcWidgetSlot; width?: 'fraction' | 'auto' | (string & {}); minWidth?: string; alignX?: 'left' | 'center' | 'right'; fixed?: 'left' | 'right'; fontColor?: string; backgroundColor?: string; paddingX?: string; paddingY?: string; styles?: ArcWidgetCssStyles | string; actions?: ArcWidgetAction[]; clickable?: boolean; hover_enterable?: boolean; hover_leaveable?: boolean; sort?: ArcWidgetTableSort; span?: number; groupValue?: ArcWidgetSlot; groupByValue?: string | number; groupExpandAction?: boolean; }
export interface ArcWidgetTableGroupRowSettings { height?: string; }
export interface ArcWidgetTableHoverAction { hoverActive?: boolean; backgroundColor?: string; fontColor?: string; }
export interface ArcWidgetTableRow { id?: string | number; columns?: ArcWidgetTableColumn[]; items?: ArcWidgetTableRow[]; clickable?: boolean; rowColor?: string; fontColor?: string; rowHeight?: string; rowPaddingY?: string; styles?: ArcWidgetCssStyles | string; actions?: ArcWidgetAction[]; rowHoverAction?: ArcWidgetTableHoverAction; groupRowColor?: string; groupRowSettings?: ArcWidgetTableGroupRowSettings; }
export interface ArcWidgetTableEmpty { title?: string; value?: ArcWidgetSlot; backgroundColor?: string; }
export interface ArcWidgetTableFooter { showFooter?: boolean; height?: 'auto' | (string & {}); backgroundColor?: string; showActionButton?: boolean; actionButtonTitle?: string; leftSideContent?: ArcWidgetSlot; rightSideContent?: ArcWidgetSlot; styles?: ArcWidgetCssStyles | string; }
export interface ArcWidgetTableFooterColumn { footer?: string; alignX?: 'left' | 'center' | 'right'; fixed?: 'left' | 'right'; minWidth?: string; fontColor?: string; backgroundColor?: string; }
export interface ArcWidgetTableFooterColumns { show?: boolean; backgroundColor?: string; columns?: ArcWidgetTableFooterColumn[]; }
export interface ArcWidgetTableScrollBarHandle { backgroundColor?: string; borderRadius?: string; }
export interface ArcWidgetTableScrollBar { showScrollBar?: boolean; height?: string; backgroundColor?: string; handle?: ArcWidgetTableScrollBarHandle; }
export interface ArcWidgetTableBorderLineStyle { enabled?: boolean; color?: string; width?: string; }
export type ArcWidgetTableBorderLine = boolean | ArcWidgetTableBorderLineStyle;
export interface ArcWidgetTableBorders { color?: string; width?: string; outer?: ArcWidgetTableBorderLine; columns?: ArcWidgetTableBorderLine; rows?: ArcWidgetTableBorderLine; }
export interface ArcWidgetTableStyles extends ArcWidgetCssStyles { backgroundColor?: string; fontColor?: string; fontSize?: string; borderColor?: string; borderSize?: string; borderRadius?: string; borders?: ArcWidgetTableBorders; }
export interface ArcWidgetTableCollapsible { enabled?: boolean; defaultCollapsed?: boolean; expandColumn?: number; indentColumn?: number; indentSize?: string; iconSize?: string; iconExpand?: ArcWidgetSlot; iconCollapse?: ArcWidgetSlot; }
export interface ArcWidgetTableData { table?: ArcWidgetTableRow[]; header?: ArcWidgetTableHeader; height?: 'auto' | (string & {}); minHeight?: string; maxHeight?: string; width?: string; groupedBy?: string; groupsCollapsed?: boolean; collapsible?: ArcWidgetTableCollapsible; rowHoverAction?: ArcWidgetTableHoverAction; actions?: ArcWidgetAction[]; emptyTable?: ArcWidgetTableEmpty; scrollBar?: ArcWidgetTableScrollBar; footerColumns?: ArcWidgetTableFooterColumns; footer?: ArcWidgetTableFooter; styles?: ArcWidgetTableStyles | string; }
export interface ArcWidgetTableProps extends ArcReactWidgetProps<ArcWidgetTableData> { onCellClick?: (event: MouseEvent, payload: ArcWidgetTableCellPayload) => void; onCellHoverEnter?: (payload: ArcWidgetTableCellPayload) => void; onCellHoverLeave?: (payload: ArcWidgetTableCellPayload) => void; onFooterActionClick?: (event: MouseEvent) => void; }</code></pre>