Qu’est-ce que Kaminari ?
Kaminari est un joyau de pagination pour Ruby on Rails qui fournit un moyen simple et flexible de paginer des enregistrements dans votre application. Avec Kaminari, vous pouvez facilement ajouter une pagination à vos vues et contrôleurs, et personnaliser les options de pagination pour répondre à vos besoins spécifiques.
Installation de Kaminari
Pour utiliser Kaminari dans votre Application Rails, vous devez d'abord installer la gemme. Vous pouvez le faire en ajoutant la ligne suivante à votre Gemfile :
gemme 'kaminari'
Après avoir ajouté la gemme à votre Gemfile, exécutez installation groupée
pour installer la gem et ses dépendances.
Utiliser Kaminari dans vos contrôleurs
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:
classe Contrôleur d'utilisateurs < Contrôleur d'application
déf indice
@utilisateurs = Utilisateur.commande(:nom).page(params[:page]).par(10)
fin
fin
In this example, we’re using the page
méthode pour spécifier le numéro de page actuel et le par
méthode pour spécifier le nombre d’enregistrements par page. Le commande
La méthode est utilisée pour trier les utilisateurs par leur nom.
Utiliser Kaminari dans vos vues
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:
<%= paginer @utilisateurs %>
In this example, we’re using the paginer
assistant pour générer les liens de pagination pour le @utilisateurs
collection. Kaminari générera automatiquement des liens vers les pages précédentes, suivantes et numérotées en fonction de la page actuelle et du nombre de pages de la collection.
Personnalisation des options de pagination
Kaminari fournit une variété d'options de personnalisation que vous pouvez utiliser pour configurer les liens et le comportement de pagination. Voici quelques exemples d’options de personnalisation courantes :
- Modification du nombre par défaut d'enregistrements par page
Par défaut, Kaminari affiche 25 enregistrements par page. Vous pouvez modifier cela en réglant le par défaut_par_page
option de configuration dans un fichier d'initialisation :
#config/initialiseurs/kaminari.rb
Kaminari.configure faire |configuration|
config.default_per_page = 10
fin
In this example, we’re setting the default number of records per page to 10.
- Changer les étiquettes des liens de pagination
Vous pouvez personnaliser les étiquettes des liens de pagination en utilisant le nom_paramètre
et paramètres
options dans le paginer
assistant:
<%= paginer @utilisateurs, paramètre_nom: :numéro de page, paramètres: {foo : 'bar' } %>
In this example, we’re setting the pagination parameter to numéro de page
au lieu de la valeur par défaut page
, et en passant un foo=barre
paramètre aux liens de pagination générés. Vous pouvez également personnaliser les étiquettes des liens de pagination individuels en utilisant le thème
option et création d’un modèle de vue personnalisé.
- Personnalisation du thème de pagination
Kaminari propose plusieurs thèmes intégrés pour les liens de pagination, notamment défaut
, twitter-bootstrap
, et se concrétiser
. Vous pouvez personnaliser le thème en définissant le thème
option de configuration dans un fichier d'initialisation :
#config/initialiseurs/kaminari.rb
Kaminari.configurer faire |configuration|
config.default_theme = :twitter-bootstrap
fin
``