Arc Rider Docs · Markdown

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) =&gt; ({ id: String(index + 1), columns: columns.map((column, i) =&gt; ({ value: values[i], width: column.width, })), }));

export default function Example() { return ( &lt;ArcWidgetTable data={{ height: '400px', rowHoverAction: { hoverActive: true }, header: { columns }, table: rows, scrollBar: { showScrollBar: false }, footer: { showFooter: true, rightSideContent: Total: ${rows.length} }, }} /&gt; ); }</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.

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 &amp; {}); 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 &amp; {}); fontSize?: string; fontColor?: string; backgroundColor?: string; styles?: ArcWidgetCssStyles | string; sortIcons?: ArcWidgetTableSortIcons; }

export interface ArcWidgetTableColumn { value?: ArcWidgetSlot; field?: string; title?: ArcWidgetSlot; width?: 'fraction' | 'auto' | (string &amp; {}); 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 &amp; {}); 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 &amp; {}); 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&lt;ArcWidgetTableData&gt; { onCellClick?: (event: MouseEvent, payload: ArcWidgetTableCellPayload) =&gt; void; onCellHoverEnter?: (payload: ArcWidgetTableCellPayload) =&gt; void; onCellHoverLeave?: (payload: ArcWidgetTableCellPayload) =&gt; void; onFooterActionClick?: (event: MouseEvent) =&gt; void; }</code></pre>