Ruby On Rails框架下的翻页/排序插件

1. kaminari

官方主页：https://github.com/amatsuda/kaminari

首先在Gemfile文件中加入：gem 'kaminari'

然后通过bundle install命令激活该插件。

演示代码：

home_controller.rb

class HomeController < ApplicationController
  
  def index
    @users = User.order(sort).page(params[:page]).per(20)
    respond_to do |format|
      format.html
      format.js
      format.xml { render :xml => @users }
    end
  end

  private
    def sort
      params[:sort].to_s == '' ? "" : params[:sort] + ' ' + params[:direction]
    end

end

home_helper.rb

module HomeHelper
  
  def sortable(title = nil, column)
    title ||= column.titleize
    direction = column == sort_column && sort_direction == "asc" ? "desc" : "asc"
    link_to title, params.merge(:sort => column, :direction => direction), :remote => false, :method => :get
  end

  private
    def sort_column
      User.column_names.include?(params[:sort]) ? params[:sort] :  "created"
    end
  
    def sort_direction
      %w[asc desc].include?(params[:direction]) ? params[:direction] : "desc"
    end

end

index.html.erb

<table>
	<tr>
		<th><%= sortable 'Email', 'email' %></th>
		<th><%= sortable 'Password', 'password' %></th>
		<th><%= sortable 'Publisher ID', 'publisher_id' %></th>
	</tr>
	<% @users.each do |user| %>
	<tr>
		<td><%= user.email %></td>
		<td><%= user.password %></td>
		<td><%= user.publisher_id %></td>
	</tr>
	<% end %>
</table>
<%= paginate @users, :remote => false %> 

新建model如下：user.rb

class User < ActiveRecord::Base
end

测试用的数据库中，users表有id, emai, password, publisher_id, created等字段，可自行修改。

注意：

我们可以在通过model中添加paginates_per来设定每页显示的行数，这样在controller里就不需要每次都设定了。

例如：

class User < ActiveRecord::Base
  
  paginates_per 10
  
end

在controller里直接：@users = User.order(sort).page(params[:page])  即可。

如果想要使用Ajax，可以参考这里：https://github.com/amatsuda/kaminari_example/tree/ajax

这里简单叙述一下修改步骤：

1. index.html.erb，home_helper.rb等文件中出现:remote => false的全部修改为:remote => true

2. 需要添加几个文件：

index.js.erb

$('#users').html('<%= escape_javascript render(@users) %>');
$('#paginator').html('<%= escape_javascript(paginate(@users, :remote => true).to_s) %>');

在views目录下新建users文件夹，增加_user.html.erb文件：

<tr>
	<td><%= user.email %></td>
	<td><%= user.password %></td>
	<td><%= user.publisher_id %></td>
</tr>

3. 修改文件：

index.html.erb

<table>
	<thead>
		<tr>
			<th><%= sortable 'Email', 'email' %></th>
			<th><%= sortable 'Password', 'password' %></th>
			<th><%= sortable 'Publisher ID', 'publisher_id' %></th>
		</tr>
	</thead>
	<tbody id="users">
		<%= render @users %>
	<tbody>
</table>
<%= paginate @users, :remote => true %> 

这样翻页的功能就完成了。但是排序还有点问题，因为目前还无法记住上一次排序是按照升序还是降序[可使用session来记录]，修改修改home_helper.rb，这里略过。

2. will_paginate

官方主页：https://github.com/mislav/will_paginate/wiki

will_paginate和kaminari非常的相似，这里就简单讲述一下了。

页面 index.html.erb上只需把 <%= paginate @users, :remote => true %> 替换为 <%= will_paginate @users %> 即可。

controller里也只需把

@users = User.order(sort).page(params[:page]).per(10)

替换为：

@users = User.paginate(:page => params[:page], :per_page => 10).order(sort)

其他都可以不更改。

另外，和kaminari一样，我们也可以在model里面定义页面显示的行数：

self.per_page = 10

更多信息可参阅其官方主页。

另外，will_paginate自带很多css可以使用：http://mislav.uniqpath.com/will_paginate/

更多资料：http://railscasts.com/episodes/240-search-sort-paginate-with-ajax?autoplay=true