¿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
Once you’ve installed Kaminari, you can start using it in your controllers to paginate records. Here’s an example of how to paginate a list of users in a UsersController:
clase UsuariosControlador < Controlador de aplicaciones
definición índice
@usuarios = Usuario.orden(:nombre).página(parámetros[:página]).por(10)
fin
fin
In this example, we’re using the 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
Once you’ve paginated your records in your controller, you can use Kaminari’s view helpers to display the pagination links in your views. Here’s an example of how to display the pagination links in an index.html.erb view:
<%= paginar @usuarios %>
In this example, we’re using the 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
In this example, we’re setting the default number of records per page to 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' } %>
In this example, we’re setting the pagination parameter to 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
``