¿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:
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
``
Acerca del autor de la publicación
Spanish 
English 
Japanese 
German 
French