Skip to main content

Expandiendo APIs

Estado

El estado de expansión se almacena en la tabla utilizando la siguiente forma:

export type ExpandedState = true | Record<string, boolean>;

export type ExpandedTableState = {
expanded: ExpandedState;
};

API de Fila

toggleExpanded

toggleExpanded: (expanded?: boolean) => void

Alterna el estado de expansión (o lo establece si se proporciona expanded) para la fila.

getIsExpanded

getIsExpanded: () => boolean;

Devuelve si la fila está expandida.

getIsAllParentsExpanded

getIsAllParentsExpanded: () => boolean;

Devuelve si todas las filas padre de la fila están expandidas.

getCanExpand

getCanExpand: () => boolean;

Devuelve si la fila puede ser expandida.

getToggleExpandedHandler

getToggleExpandedHandler: () => () => void

Devuelve una función que se puede utilizar para alternar el estado de expansión de la fila. Esta función puede usarse para enlazar a un controlador de eventos de un botón.

Opciones de Tabla

manualExpanding

manualExpanding?: boolean

Habilita la expansión manual de filas. Si se establece en true, getExpandedRowModel no se utilizará para expandir filas y se esperaría que usted realice la expansión en su propio modelo de datos. Esto es útil si está realizando una expansión del lado del servidor.

onExpandedChange

onExpandedChange?: OnChangeFn<ExpandedState>

Esta función se llama cuando cambia el estado expanded de la tabla. Si se proporciona una función, usted será responsable de gestionar este estado por su cuenta. Para pasar el estado gestionado de vuelta a la tabla, utilice la opción tableOptions.state.expanded.

autoResetExpanded

autoResetExpanded?: boolean

Habilite esta configuración para restablecer automáticamente el estado de expansión de la tabla cuando cambie el estado de expansión.

enableExpanding

enableExpanding?: boolean

Habilita/deshabilita la expansión para todas las filas.

getExpandedRowModel

getExpandedRowModel?: (table: Table<TData>) => () => RowModel<TData>

Esta función es responsable de devolver el modelo de fila expandida. Si no se proporciona esta función, la tabla no expandirá las filas. Puede utilizar la función getExpandedRowModel exportada por defecto para obtener el modelo de fila expandida o implementar el suyo propio.

getIsRowExpanded

getIsRowExpanded?: (row: Row<TData>) => boolean

Si se proporciona, le permite anular el comportamiento predeterminado para determinar si una fila está expandida actualmente.

getRowCanExpand

getRowCanExpand?: (row: Row<TData>) => boolean

Si se proporciona, le permite anular el comportamiento predeterminado para determinar si una fila puede ser expandida.

paginateExpandedRows

paginateExpandedRows?: boolean

Si es true, las filas expandidas se paginarán junto con el resto de la tabla (lo que significa que las filas expandidas pueden abarcar varias páginas).

Si es false, las filas expandidas no se considerarán para la paginación (lo que significa que las filas expandidas siempre se renderizarán en la página de sus padres. Esto también significa que se renderizarán más filas que el tamaño de página establecido).

API de Tabla

setExpanded

setExpanded: (updater: Updater<ExpandedState>) => void

Actualiza el estado de expansión de la tabla mediante una función de actualización o un valor.

toggleAllRowsExpanded

toggleAllRowsExpanded: (expanded?: boolean) => void

Alterna el estado de expansión para todas las filas. Opcionalmente, proporcione un valor para establecer el estado de expansión.

resetExpanded

resetExpanded: (defaultState?: boolean) => void

Restablece el estado de expansión de la tabla al estado inicial. Si se proporciona defaultState, el estado de expansión se restablecerá a {}.

getCanSomeRowsExpand

getCanSomeRowsExpand: () => boolean;

Devuelve si hay filas que se puedan expandir.

getToggleAllRowsExpandedHandler

getToggleAllRowsExpandedHandler: () => (event: unknown) => void

Devuelve un controlador que se puede utilizar para alternar el estado de expansión de todas las filas. Este controlador está destinado a ser utilizado con un elemento input[type=checkbox].

getIsSomeRowsExpanded

getIsSomeRowsExpanded: () => boolean;

Devuelve si hay filas que están actualmente expandidas.

getIsAllRowsExpanded

getIsAllRowsExpanded: () => boolean;

Devuelve si todas las filas están actualmente expandidas.

getExpandedDepth

getExpandedDepth: () => number;

Devuelve la profundidad máxima de las filas expandidas.

getExpandedRowModel

getExpandedRowModel: () => RowModel<TData>;

Devuelve el modelo de fila después de aplicar la expansión.

getPreExpandedRowModel

getPreExpandedRowModel: () => RowModel<TData>;

Devuelve el modelo de fila antes de aplicar la expansión.