Cos'è Kaminari?
Kaminari è un gioiello di impaginazione per Ruby on Rails che fornisce un modo semplice e flessibile per impaginare i record nella tua applicazione. Con Kaminari puoi aggiungere facilmente l'impaginazione alle tue visualizzazioni e ai tuoi controller e personalizzare le opzioni di impaginazione per adattarle alle tue esigenze specifiche.
Installazione di Kaminari
Per utilizzare Kaminari nel tuo Applicazione delle rotaie, devi prima installare la gemma. Puoi farlo aggiungendo la seguente riga al tuo Gemfile:
gemma 'kaminari'
Dopo aver aggiunto la gemma al tuo Gemfile, esegui installazione del pacchetto per installare il gem e le sue dipendenze.
Utilizzo di Kaminari nei controller
Una volta installato Kaminari, puoi iniziare a utilizzarlo nei tuoi controller per impaginare i record. Ecco un esempio di come impaginare un elenco di utenti in un UsersController:
classe UsersController < Controllore dell'applicazione
def indice
@utenti = Utente.ordine(:nome).page(parametri[:pagina]).per(10)
FINE
FINE
In questo esempio, stiamo utilizzando il file pagina metodo per specificare il numero di pagina corrente e il file per metodo per specificare il numero di record per pagina. IL ordine viene utilizzato per ordinare gli utenti in base al nome.
Usare Kaminari nelle tue visualizzazioni
Dopo aver impaginato i record nel controller, puoi utilizzare gli helper di visualizzazione di Kaminari per visualizzare i collegamenti di impaginazione nelle tue visualizzazioni. Ecco un esempio di come visualizzare i collegamenti di impaginazione in una vista index.html.erb:
<%= impagina @utenti %>
In questo esempio, stiamo utilizzando il file impaginare helper per generare i collegamenti di impaginazione per il file @utenti collezione. Kaminari genererà automaticamente collegamenti per le pagine precedenti, successive e numerate in base alla pagina corrente e al numero di pagine nella raccolta.
Personalizzazione delle opzioni di impaginazione
Kaminari fornisce una varietà di opzioni di personalizzazione che puoi utilizzare per configurare i collegamenti e il comportamento dell'impaginazione. Ecco alcuni esempi di opzioni di personalizzazione comuni:
- Modifica del numero predefinito di record per pagina
Per impostazione predefinita, Kaminari visualizza 25 record per pagina. Puoi modificarlo impostando il file default_per_pagina opzione di configurazione in un file inizializzatore:
Kaminari.configure Fare |config|
config.default_per_pagina = 10
FINE
In questo esempio, impostiamo il numero predefinito di record per pagina su 10.
- Modifica delle etichette dei collegamenti di impaginazione
È possibile personalizzare le etichette dei collegamenti di impaginazione utilizzando il file nome_parametro E parametri opzioni in impaginare aiutante:
<%= impaginare @utenti, param_nome: :numero di pagina, parametri: { pippo: 'sbarra' }%>
In questo esempio, stiamo impostando il parametro di impaginazione su numero di pagina invece di quello predefinito pagina, e passando a foo=barra parametro ai collegamenti di impaginazione generati. È inoltre possibile personalizzare le etichette dei singoli collegamenti di impaginazione utilizzando il file tema opzione e creando un modello di visualizzazione personalizzato.
- Personalizzazione del tema dell'impaginazione
Kaminari fornisce diversi temi integrati per i collegamenti di impaginazione, inclusi predefinito, bootstrap di Twitter, E materializzarsi. È possibile personalizzare il tema impostando il file tema opzione di configurazione in un file inizializzatore:
#config/initializers/kaminari.rb
Kaminari.configura Fare |config|
config.default_theme = :twitter-bootstrap
FINE
``
Informazioni sull'autore del post
Italian 
English 
Japanese 
German 
French 
Spanish 
Swedish