kaminari gem

Gemme de Kaminari

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 :

#config/initialiseurs/kaminari.rb
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
``
Articles Similaires

Laissez un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *

fr_FRFrench