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
Une fois que vous avez installé Kaminari, vous pouvez commencer à l'utiliser dans vos contrôleurs pour paginer les enregistrements. Voici un exemple de la façon de paginer une liste d'utilisateurs dans un UsersController :
classe Contrôleur d'utilisateurs < Contrôleur d'application
déf indice
@utilisateurs = Utilisateur.commande(:nom).page(params[:page]).par(10)
fin
fin
Dans cet exemple, nous utilisons le 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
Une fois que vous avez paginé vos enregistrements dans votre contrôleur, vous pouvez utiliser les assistants de vue de Kaminari pour afficher les liens de pagination dans vos vues. Voici un exemple de la façon d'afficher les liens de pagination dans une vue index.html.erb :
<%= paginer @utilisateurs %>
Dans cet exemple, nous utilisons le 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 :
Kaminari.configure faire |configuration|
config.default_per_page = 10
fin
Dans cet exemple, nous définissons le nombre par défaut d'enregistrements par page sur 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' } %>
Dans cet exemple, nous définissons le paramètre de pagination sur 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
``
À propos de l'auteur du message
French 
English 
Japanese 
German 
Spanish 
Italian 
Swedish