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
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:
Klasse BenutzerController < ApplicationController
def Index
@users = Benutzer.Befehl(:Name).page(params[:Seite]).pro(10)
Ende
Ende
In this example, we’re using the 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
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:
<%= paginieren @Benutzer %>
In this example, we’re using the 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 this example, we’re setting the default number of records per page to 10.
- Ä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 this example, we’re setting the pagination parameter to 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
