Was ist Kaminari?
Kaminari ist ein Paginierungsjuwel für Ruby on Rails, das eine einfache und flexible Möglichkeit bietet, Datensätze in Ihrer Anwendung zu paginieren. Mit Kaminari können Sie ganz einfach Paginierung zu Ihren Ansichten und Controllern hinzufügen und die Paginierungsoptionen an Ihre spezifischen Anforderungen anpassen.
Kaminari installieren
Um Kaminari in Ihrem zu verwenden Rails-Anwendung, müssen Sie zuerst das Gem installieren. Sie können dies tun, indem Sie die folgende Zeile zu Ihrer Gemfile hinzufügen:
Juwel 'kaminari'
Nachdem Sie den Edelstein zu Ihrer Gemfile hinzugefügt haben, führen Sie ihn aus Bundle-Installation um das Gem und seine Abhängigkeiten zu installieren.
Verwenden von Kaminari in Ihren Controllern
Sobald Sie Kaminari installiert haben, können Sie es in Ihren Controllern zum Paginieren von Datensätzen verwenden. Hier ist ein Beispiel für die Paginierung einer Benutzerliste in einem UsersController:
Klasse BenutzerController < ApplicationController
def Index
@users = Benutzer.Befehl(:Name).page(params[:Seite]).pro(10)
Ende
Ende
In diesem Beispiel verwenden wir die Seite Methode zur Angabe der aktuellen Seitenzahl und der pro Methode, um die Anzahl der Datensätze pro Seite anzugeben. Der Befehl Die Methode wird verwendet, um die Benutzer nach ihrem Namen zu sortieren.
Verwenden Sie Kaminari in Ihren Ansichten
Sobald Sie Ihre Datensätze in Ihrem Controller paginiert haben, können Sie die Ansichtshelfer von Kaminari verwenden, um die Paginierungslinks in Ihren Ansichten anzuzeigen. Hier ist ein Beispiel für die Anzeige der Paginierungslinks in einer index.html.erb-Ansicht:
<%= paginieren @Benutzer %>
In diesem Beispiel verwenden wir die paginieren Helfer zum Generieren der Paginierungslinks für die @users Sammlung. Kaminari generiert automatisch Links für die vorherige, nächste und nummerierte Seite basierend auf der aktuellen Seite und der Anzahl der Seiten in der Sammlung.
Anpassen der Paginierungsoptionen
Kaminari bietet eine Vielzahl von Anpassungsoptionen, mit denen Sie die Paginierungslinks und das Verhalten konfigurieren können. Hier sind einige Beispiele für gängige Anpassungsoptionen:
- Ändern der Standardanzahl von Datensätzen pro Seite
Standardmäßig zeigt Kaminari 25 Datensätze pro Seite an. Sie können dies ändern, indem Sie Folgendes festlegen default_per_page Konfigurationsoption in einer Initialisierungsdatei:
Kaminari.configure Tun |config|
config.default_per_page = 10
Ende
In diesem Beispiel legen wir die Standardanzahl der Datensätze pro Seite auf 10 fest.
- Ändern der Beschriftungen der Paginierungslinks
Sie können die Beschriftungen der Paginierungslinks anpassen, indem Sie die verwenden param_name Und Parameter Optionen in der paginieren Helfer:
<%= paginieren @users, param_Name: :Seitennummer, Parameter: { foo: 'Bar' } %>
In diesem Beispiel setzen wir den Paginierungsparameter auf Seitennummer anstelle der Standardeinstellung Seite, und vorbei an a foo=bar Parameter für die generierten Paginierungslinks. Sie können auch die Beschriftungen der einzelnen Paginierungslinks anpassen, indem Sie die verwenden Thema Option und Erstellen einer benutzerdefinierten Ansichtsvorlage.
- Anpassen des Paginierungsthemas
Kaminari bietet mehrere integrierte Themen für die Paginierungslinks, darunter Standard, Twitter-Bootstrap, Und materialisieren. Sie können das Thema anpassen, indem Sie Folgendes festlegen Thema Konfigurationsoption in einer Initialisierungsdatei:
#config/initializers/kaminari.rb
Kaminari.konfigurieren Tun |config|
config.default_theme = :twitter-bootstrap
Ende
``
Über den Autor des Beitrags
German 
English 
Japanese 
French 
Spanish 
Italian 
Swedish