kaminari gem

Gema Kaminari

¿Qué es Kaminari?

Kaminari es una joya de paginación para Ruby on Rails que proporciona una forma sencilla y flexible de paginar registros en su aplicación. Con Kaminari, puede agregar fácilmente paginación a sus vistas y controladores, y personalizar las opciones de paginación para que se ajusten a sus necesidades específicas.

Instalación de Kaminari

Para usar Kaminari en tu Aplicación de rieles, primero necesitas instalar la gema. Puedes hacer esto agregando la siguiente línea a tu Gemfile:

joya 'kaminari'

Después de agregar la gema a su Gemfile, ejecute instalación del paquete para instalar la gema y sus dependencias.

Usando Kaminari en tus controladores

Una vez que haya instalado Kaminari, puede comenzar a usarlo en sus controladores para paginar registros. Aquí hay un ejemplo de cómo paginar una lista de usuarios en un UsersController:

clase UsuariosControlador < Controlador de aplicaciones
definición índice
@usuarios = Usuario.orden(:nombre).página(parámetros[:página]).por(10)
fin
fin

En este ejemplo, estamos usando el página método para especificar el número de página actual y el por Método para especificar el número de registros por página. El orden El método se utiliza para ordenar a los usuarios por su nombre.

Usando Kaminari en tus vistas

Una vez que haya paginado sus registros en su controlador, puede usar los asistentes de vista de Kaminari para mostrar los enlaces de paginación en sus vistas. A continuación se muestra un ejemplo de cómo mostrar los enlaces de paginación en una vista index.html.erb:

<%= paginar @usuarios %>

En este ejemplo, estamos usando el paginar ayuda para generar los enlaces de paginación para el @usuarios recopilación. Kaminari generará automáticamente enlaces para las páginas anterior, siguiente y numerada en función de la página actual y el número de páginas de la colección.

Personalización de las opciones de paginación

Kaminari proporciona una variedad de opciones de personalización que puede utilizar para configurar los enlaces y el comportamiento de la paginación. A continuación se muestran algunos ejemplos de opciones de personalización comunes:

  • Cambiar el número predeterminado de registros por página

De forma predeterminada, Kaminari muestra 25 registros por página. Puede cambiar esto configurando el default_por_página opción de configuración en un archivo inicializador:

#config/inicializadores/kaminari.rb
Kaminari.configurar hacer |config|
config.default_per_page = 10
fin

En este ejemplo, configuramos el número predeterminado de registros por página en 10.

  • Cambiar las etiquetas de los enlaces de paginación

Puede personalizar las etiquetas de los enlaces de paginación utilizando el nombre_parámetro y parámetros opciones en el paginar ayudante:

<%= paginar @usuarios, parámetro_nombre: :número de página, parámetros: {foo: 'bar' } %>

En este ejemplo, estamos configurando el parámetro de paginación en número de página en lugar del valor predeterminado página, y pasando un foo=barra parámetro a los enlaces de paginación generados. También puede personalizar las etiquetas de los enlaces de paginación individuales utilizando el tema opción y crear una plantilla de vista personalizada.

  • Personalizando el tema de paginación

Kaminari proporciona varios temas integrados para los enlaces de paginación, incluidos por defecto, twitter-bootstrap, y materializar. Puede personalizar el tema configurando el tema opción de configuración en un archivo inicializador:

 
#config/inicializadores/kaminari.rb
Kaminari.configurar hacer |configuración|
config.default_theme = :twitter-bootstrap
fin
``
Artículos Relacionados

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

es_ESSpanish