Saltar al contenido principal

Paginación de tabla

Uso​

Descripción general​

La paginación permite a los usuarios navegar por grandes conjuntos de datos dividiendo el contenido en páginas manejables. Proporciona controles para navegar por las páginas y ajustar la cantidad de elementos que se muestran a la vez, lo cual es esencial para mantener el rendimiento y la legibilidad en aplicaciones con gran cantidad de datos.

Cuándo se debe utilizar​

  • Para administrar grandes conjuntos de datos: Utilícela cuando una tabla tenga cientos o miles de filas, y presentarlas todas a la vez afecta el rendimiento o los tiempos de carga de la página.
  • Para mejorar la escaneabilidad: Utilícela cuando demasiados datos en una página abrumen a los usuarios y dificulte encontrar o comparar valores.
  • Para mejorar la accesibilidad: Utilícela cuando las tablas grandes creen problemas de navegación para los lectores de pantalla o los usuarios de teclado (por ejemplo, explorar una tabla con cientos de filas no resulta práctico).
  • Para vistas filtradas: Utilícela cuando los usuarios suelen ver un subconjunto de datos, como resultados de búsqueda o vistas filtradas. La paginación los mantiene orientados y ayuda con fragmentos manejables.

Cuándo no se debe utilizar​

  • Para conjuntos de datos pequeños: Evítela si todas las filas se pueden mostrar sin problemas de rendimiento o abrumar al usuario (por ejemplo, de 20 a 50 filas).
  • Para tareas de comparación amplia: Evítela cuando los usuarios necesiten comparar muchas filas a la vez; analice la posibilidad del desplazamiento virtual o las vistas filtradas en su lugar.
  • Para tareas de vista única: No la use si el conjunto de datos representa un conjunto completo que no se puede dividir en páginas, como una tabla de configuración.

Formato​

Anatomía​

Anatomía del componente paginación, con leyendas numeradas para el selector “Filas por página”, la visualización del intervalo de elementos y los botones de navegación.

El componente de paginación aparece en la parte inferior del contenido que controla y consta de los siguientes elementos:

  1. Selección de filas por página: Menú desplegable que permite a los usuarios cambiar la cantidad de elementos que se muestran en cada página.
  2. Visualización de intervalo de elementos: Rótulo de texto que comunica qué elementos se están viendo actualmente en el contexto de la cantidad total de elementos (por ejemplo, “1 - 10 de 25”).
  3. Controles de navegación: Botones de ícono que permiten a los usuarios desplazarse a la página de datos anterior o siguiente, así como navegar a la primera y última página.

Contenido​

Pautas generales de redacción​

  • En todos los aspectos del diseño de las interfaces de productos de Guidewire, utilice mayúsculas como se usan en las oraciones. No use mayúsculas en todas las palabras.
  • Use verbos en tiempo presente y voz activa en la mayoría de las situaciones.
  • Use contracciones comunes para darle al texto un tono más natural e informal (pauta correspondiente al inglés).
  • Use un lenguaje sencillo. Evite la jerga innecesaria y el lenguaje complejo.
  • Las palabras y las oraciones deben ser breves.

Comportamientos​

Estados​

Los estados principales del componente paginación se relacionan con sus controles de navegación.

  • El botón Página anterior debe estar deshabilitado cuando el usuario se encuentre en la primera página de datos.
  • El botón Página siguiente debe estar deshabilitado cuando el usuario se encuentre en la última página de datos.

Interacciones​

  • Si selecciona un nuevo valor del menú desplegable Filas por página, se vuelve a cargar el componente asociado para mostrar la cantidad de elementos seleccionada.
  • Al hacer clic en los botones Página siguiente o Página anterior, el usuario navega por el conjunto de datos una página a la vez.

Métodos de uso de paginación​

  • Uso predeterminado: Utilice el componente en un contexto estándar y sincrónico. Los clientes proporcionan los valores directamente al componente.
  • Uso de tablas asíncronas: Cuando se usa con tablas que recuperan datos de forma asíncrona desde un servidor, la paginación refleja el estado actual de la tabla. El componente en sí permanece sincrónico; la tabla administra la lógica asíncrona. Este método se aplica tanto al uso predeterminado como cuando se usa la TanStack Table.
  • Uso de TanStack Table: Cuando se utiliza una tabla administrada por TanStack Table, el consumidor pasa el estado de paginación de la tabla al componente de paginación. Esto permite que la interfaz de usuario de paginación refleje el estado actual de la tabla, incluidas las actualizaciones asíncronas o controladas por el servidor administradas por la tabla.

Accesibilidad​

Este componente de Jutro ha sido validado para cumplir con las pautas de accesibilidad de WCAG 2.2 AA en su configuración base predeterminada. Esto incluye garantizar que se cumpla lo siguiente:

  • La relación de contraste de los elementos textuales con respecto a su fondo es superior a 4,5:1.
  • El contenido no textual que debe transmitir significado (como íconos e indicadores de foco) tiene una relación de contraste de al menos 3:1 con sus colores adyacentes.
  • El elemento se puede operar con teclado, así como con mouse.
  • Se puede acceder al contenido mediante lectores de pantalla, como JAWS y VoiceOver.

El cumplimiento de los criterios de accesibilidad depende, en última instancia, de cómo se implementa y personaliza este componente. Los cambios realizados por el autor del contenido pueden afectar la accesibilidad. Para obtener más información sobre nuestro modelo de responsabilidad compartida, revise nuestra declaración completa sobre accesibilidad de Jutro.

Cuando utilice este componente en su aplicación, respete estas prácticas recomendadas:

  • Interacción con el teclado: Todos los controles dentro del componente paginación deben poder recibir el foco y poder manejarse con el teclado. Los usuarios deben poder navegar entre el menú desplegable y los botones de navegación con la tecla Tab y activarlos con las teclas Enter o Space.
  • Lector de pantalla: El componente paginación debe estar encapsulado en un elemento <nav> con una aria-label de “Paginación” para identificarlo como una región de referencia. Todos los controles deben tener nombres claros y accesibles. Para los botones de navegación, use atributos aria-label como “Ir a la página anterior” e “Ir a la página siguiente”. La visualización del intervalo de elementos (por ejemplo, “1 - 10 de 25”) debe estar asociada mediante programación con los controles, de modo que se pueda anunciar a los usuarios de lectores de pantalla, lo que proporciona un contexto esencial para la navegación.