Tips: Paginazione multipla con will

Will Paginate è la gemma più utilizzata per la paginazione in Ruby on Rails.

Succede a volte di dover paginare più liste diverse su una stessa pagina.

Ma cos'è un'impaginazione?

Con l'impaginazione possiamo limitare il numero di elementi che vengono recuperati dal database e visualizzati in un dato punto. Sbaglio se dico che guardare un pagina con migliaia di elementi ci fa scappare subito dal sito? Non sarebbe meglio mostrare una selezione di elementi per volta?

L'impaginazione fa esattamente questo, suddivide un elenco corposo di elementi in sequenze più contenute in base alle specifiche che gli diamo.

Questo tip mostra come è possibile visualizzare una lista paginata di prodotti ed una lista paginata di servizi su una stessa pagina utilizzando will_paginate.

Per cominciare bisognerà installare la gemma di impaginazione, con il codice seguente:

// in the Gemfile

gem 'will_paginate', '~> 3.1.0'

Giunti a questo punto, il focus verte nell’utilizzo di un parametro param_name personalizzato, sia nella view che nel controller.

Il codice della view sarà simile a questo:

1
2
3
4
5
6
7

# ... 
# la lista di prodotti va qui 
<%= will_paginate @products, :param_name => 'products_page', :prev_label => t('helpers.labels.previous'), :next_label => t('helpers.labels.next') %>
# la lista di servizi va qui 
<%= will_paginate @services, :param_name => 'services_page', :prev_label => t('helpers.labels.previous'), :next_label => t('helpers.labels.next') %> 
# ...

Mentre quest'altro sarà, invece, il codice del controller:

1
2
3
4
5
6
7

# ... 
def index 
@products = current_company.products.paginate(:page => params[:products_page], :per_page => 10) 
@services = current_company.products.paginate(:page => params[:services_page], :per_page => 10) 
end 
# ...