Table (tabla)

Las tablas muestran conjuntos de datos. Pueden ser totalmente personalizadas.

Las tablas muestran información de una forma fácil de analizar, revelando así patrones e ideas a los usuarios. Se pueden integrar en contenido principal, tal como tarjetas.

Las tablas pueden incluir:

• Un elemento visual correspondiente
• Navegación
• Herramientas para consultar y manipular los datos

Cuando se incluyen herramientas, se deberían poner directamente arriba o debajo de la tabla.

Estructura

Un ejemplo sencillo sin florituras.

Una tabla de datos contiene una cabecera en la parte superior con los nombres de las columnas, seguida por las filas de datos.

Ordenando & Seleccionando

The Table component has a close mapping to the native <table> elements. This constraint makes building rich data tables challenging.

The DataGrid component is designed for use-cases that are focused around handling a large amounts of tabular data. While it comes with a more rigid structure, in exchange, you gain more powerful features.

<DataGrid
  rows={rows}
  columns={columns}
  pageSize={5}
  checkboxSelection
  disableSelectionOnClick
/>

Tabla Sencilla

Un checkbox debe acompañar a cada fila por si el usuario necesita seleccionar o manipular datos.

Tabla Densa

Este ejemplo demuestra el uso del Checkbox y las filas cliqueables para seleccionar, con una Toolbar personalizado. Utiliza el componente TableSortLabel para ayudar a dar estilo a las cabeceras de las columnas.

La Tabla tiene un ancho fijo para demostrar el desplazamiento horizontal. Para evitar que se desplacen los controles de paginación, el componente TablePagination se usa fuera de la Tabla. (El ejemplo de la 'Acción de paginación de tabla personalizado' de abajo demuestra la paginación dentro del TableFooter.)

Tablas personalizadas

He aquí un ejemplo de personalización del componente. You can learn more about this in the overrides documentation page.

Opciones de paginación personalizada

Es posible personalizar las opciones en el item "Filas por página" usando la propiedad rowsPerPageOptions. Debes proveer alguna de estas opciones de array:

• numbers, cada número será usado para la etiqueta y el valor de la opción.

  <TablePagination rowsPerPageOptions={[10, 50]} />

• objects, the value and label keys will be used respectively for the value and label of the option (useful for language strings such as 'All').

  <TablePagination rowsPerPageOptions={[10, 50, { value: -1, label: 'All' }]} />

Custom pagination actions

La propiedad ActionsComponent del componente TablePagination permite la implementación de acciones personalizadas.

Fixed header

An example of a table with scrollable rows and fixed column headers. It leverages the stickyHeader prop (⚠️ no IE 11 support).

Collapsible table

An example of a table with expandable rows, revealing more information. It utilizes the Collapse component.

Tabla Expandible

Un ejemplo sencillo con filas & columnas expandibles.

Tabla Virtualizada

En el siguiente ejemplo, demostramos como usar react-virtualized con el componente Table. Renderiza 200 filas y puede manejar más con facilidad. La virtualización ayuda con problemas de rendimiento.

Accesibilidad

(WAI tutorial: https://www.w3.org/WAI/tutorials/tables/)

Caption

A caption functions like a heading for a table. Most screen readers announce the content of captions. Captions help users to find a table and understand what it’s about and decide if they want to read it.

API

• <Table />
• <TableBody />
• <TableCell />
• <TableContainer />
• <TableFooter />
• <TableHead />
• <TablePagination />
• <TableRow />
• <TableSortLabel />