Paginación remota de Grid
La paginación remota es una función que permite que la cuadrícula cargue y muestre datos de forma dinámica, obteniendo solo una porción de los datos del servidor según sea necesario. Esto resulta en un mejor rendimiento, particularmente para conjuntos de datos grandes, al evitar la necesidad de obtener todos los registros a la vez.
Beneficios clave de la paginación remota
- Mejor rendimiento: Carga solo los datos necesarios, reduciendo los tiempos de carga.
- Escalable: Maneja grandes conjuntos de datos de manera eficiente.
- Control del usuario: Ofrece flexibilidad a los desarrolladores y usuarios en cómo se presentan los datos.
Cómo funciona la paginación remota
La paginación remota divide los datos en “páginas” que se solicitan individualmente desde un servidor remoto. Esto garantiza que solo la porción de datos necesaria se cargue a la vez. Se puede configurar tanto para los componentes Grid como Tree Grid usando las propiedades integradas en la herramienta.
Los usuarios utilizan un Configurator para configurar todo lo necesario para que funcione la paginación remota. ¿Qué se necesita?
pageIndex- El índice de la página a partir de la cual se obtendrán los datos. Si este parámetro no se proporciona, el índice de página predeterminado es 0, que obtiene la primera página de datos.pageSize- El número máximo de registros a obtener y mostrar por página. Si este parámetro no se proporciona, se obtienen todos los registros y el número total de páginas será 1.totalRecords- Devuelve el número total de registros disponibles en el servidor. Este número es necesario para que el Paginator calcule el número total de páginas.
Flujo del usuario:
Flujo de usuario del Configurator
Configuración del usuario
La paginación remota puede ser implementada por desarrolladores siguiendo dos enfoques, dependiendo de cómo maneja el API los datos y el conteo total de registros.
-
Usando un extremo combinado para datos y conteo total de registros
En este caso, el API devuelve tanto los datos paginados como el número total de registros en una única respuesta. -
Usando extremos separados para datos y conteo total de registros
En esta configuración, se realizan dos llamadas API: una para recuperar los datos paginados y otra para obtener el conteo total de registros.
Extremo único
Este es un ejemplo de estructura de datos admitida:
{
"items": [
{
"categoryId": 0,
"description": "string",
"name": "string"
}
],
"totalRecordsCount": 0,
"pageSize": 0,
"pageNumber": 0,
"totalPages": 0
}
Pasos:
- Conecte la Grid a un extremo que devuelva un objeto con una colección de elementos y un campo de conteo total de registros. Objeto que proporciona una colección de elementos y el conteo total de registros.
- Agregue la función de paginación remota y seleccione el modo de paginación Remote para cargar el diálogo de configuración.
- A través del diálogo de configuración de paginación, seleccione la propiedad de campo que corresponde al conteo total de registros. En el ejemplo anterior, sería “totalRecordsCount”.
- A través del diálogo de configuración de paginación, especifique el parámetro de consulta que se utilizará para el índice de página y el que se usa para el tamaño de página.
- Haga clic en guardar
Resultado:
- Se crean dos variables de tipo número para almacenar los valores de índice de página y tamaño de página.
- Se creará una tercera variable para almacenar el contexto de datos de la Grid. Tipo de objeto, inicializado a partir de la solicitud de datos. Los parámetros de consulta de la solicitud se enlazarán a las variables de índice de página y tamaño de página.
- La Grid se enlazará a la colección result.items del contexto de datos de la tercera variable.
- El conteo total de registros se enlazará al campo result.totalRecordsCount.
- Se crearán automáticamente dos interacciones para PerPageChanged y PageChange.
- PerPageChange tendrá Source (valor) establecido en el tamaño de página proveniente del contexto de evento proporcionado por igx-paginator. La variable Target será el tamaño de página.
- PageChange tendrá Source (valor) establecido en el índice de página (página actual) proveniente del contexto de evento proporcionado por igx-paginator. La variable Target será el índice de página.
Comportamiento: En la vista previa, la carga inicial realizará solo una solicitud. Después de un cambio de página o un cambio del valor por página, se realizará una nueva solicitud para obtener los datos en función de los nuevos valores de página y tamaño.
Dos extremos diferentes
Pasos:
- Enlace la propiedad
Datade la grid a un extremo que espere parámetros de consulta de página y tamaño. - Agregue la función de paginación remota y seleccione el modo de paginación Remote para cargar el diálogo de configuración.
- Conecte totalRecordsCount a un extremo diferente (diferente a la propiedad
Datade la grid) que devuelva solo el conteo total de registros. - A través del diálogo de configuración de paginación, especifique el parámetro de consulta que se utilizará para el índice de página y el que se usa para el tamaño de página.
- Haga clic en guardar
Resultado:
- Se crean dos variables de tipo número para almacenar los valores de índice de página y tamaño de página.
- La fuente de datos de la grid tendrá parámetros de consulta enlazados a las dos variables recién creadas.
- Se creará una tercera variable para almacenar el conteo total de registros. Tipo de objeto, inicializado a partir de la solicitud de datos. (Tenga en cuenta que actualmente AB no admite tipos de resultado primitivos)
- Se crearán automáticamente dos interacciones para PerPageChanged y PageChange.
- PerPageChange tendrá Source (valor) establecido en el tamaño de página proveniente del contexto de evento proporcionado por igx-paginator. La variable Target será el tamaño de página.
- PageChange tendrá Source (valor) establecido en el índice de página (página actual) proveniente del contexto de evento proporcionado por igx-paginator. La variable Target será el índice de página.
Comportamiento:
- Al ir a la vista previa, la carga inicial realizará dos solicitudes, una para los datos divididos de la grid y otra para el conteo total de registros. Después de eso, cuando haya un cambio de página o un cambio de tamaño de página, solo se realizará una solicitud para los datos divididos de la Grid.
Limitaciones conocidas
Cuando el usuario configura la paginación remota con el configurador y lo ejecuta nuevamente, la variable redundante, que se inicializa desde el extremo API, permanecerá existente.
