iT邦幫忙

DAY 9
13

Rails 的簡單任務系列 第 10

[RoR] 簡單完成分頁功能

多筆資料的分頁是網站建置常見的需要,RoR 的分頁真的是異常的簡單,只要透過 will_paginate 的 plugin 或 gem,再加個兩行就完成了。
安裝及使用 will_paginate
在 rails 2.x 版前未納入 gems 中,所以有些教學的資料只說明以 plugin 的方式安裝

# 不建議此法安裝
./script/plugin install svn://errtheblog.com/svn/plugins/will_paginate

然而要能看得懂上述的 svn 的網址,則系統要裝上 subversion 才抓得到安裝;限制是每做一個 project,就要再裝一次,從 gems 安裝就不需如此。
rails 2.x 版發行後,will_paginate就納入到 gems 的官方發佈中,只要執行

gem install will_paginate

然後在該 project 的 config/environment.rb 的最後一行加入 require 'will_paginate' 即可運作。

為了可以較多的資料來操作,此例利用聖經的經文來匯入資料庫之中,首先製作 bible 的scaffold,而下述的欄位中 chap 為第幾章,sec為第幾節,而聖經的書卷可以有中英文或者全名(f)簡稱(s)等欄位;從所要匯入的檔案中,其實會發現,並未達第一正規化;雖然可以把所有的書卷名稱的中英文全簡稱,通通放在另一個 table 上,但會發現反而每叫出一節,就又要再 query 及關聯的名稱出來;然而,所放上去的聖經內容是不會去更動的,所以並不會因未第一正規化而造成不一致的問題,所以就把各書卷的各名稱也寫到同一 table 中:

./script/generate scaffold bible engs:string chap:integer sec:integer txt:text engf:string chinesef:string chineses:string sengs:string

編輯一下:db/migrate/20080922004143_create_bibles.rb ,將 t.timestamps 刪掉,是因為不會更動 table 內容,所以不需要將新增、更新時間的欄位放上去,

class CreateBibles < ActiveRecord::Migration
  def self.up
    create_table :bibles do |t|
      t.string :engs,           :limit => 8
      t.integer :chap
      t.integer :sec
      t.text :txt
      t.string :engf,           :limit => 20
      t.string :chinesef,       :limit => 32
      t.string :chineses,       :limit => 10
      t.string :sengs,          :limit => 4
    end
  end

  def self.down
    drop_table :bibles
  end
end

檔案內容匯入資料庫
提供下載的檔案原是從 http://bible.fhl.net/public/獲得,但其資料檔是 Big5,又一些格式不符匯入所需,所以將檔案修改格式並轉成UTF-8,請下載 bible.csv.gz 並解開後,執行下列指令就將資料 import 到 bibles 的 table 中。

sqlite3 db/development.sqlite3
SQLite version 3.5.9
Enter ".help" for instructions
sqlite> .import bible.csv bibles
sqlite>

分頁的設定
如果這時候直接 http://SITENAME/bibles 的話,就會造成這三萬多行的資料出現在同一頁,這時只要編輯 app/controllers/bibles_controller.rb 此檔

  def index
    #@bibles = Bible.find(:all)
	@bibles = Bible.paginate :page => params[:page], :per_page => 10
...

再把 app/views/bibles/index.html.erb 這個 view 加上這一行:

<%= will_paginate @records %>

就會自動把每10筆資料分成一頁了。

因為 bibles 這個 table 不需要做增減編修的動作,那就把有關new, update, destroy等actions 及 views 對應相關的區塊及檔案刪除掉,就不會被更動資料了。

頁碼連結的美化
自己常用這個 CSS 做為分頁選擇用

# vi public/stylesheets/page.css 貼上這內容
  .pagination {
    padding: 3px;
    margin: 3px;
  }
  .pagination a {
    padding: 2px 5px 2px 5px;
    margin: 2px;
    border: 1px solid #aaaadd;
    text-decoration: none;
    color: #000099;
  }
  .pagination a:hover, .pagination a:active {
    border: 1px solid #000099;
    color: #000;
  }
  .pagination span.current {
    padding: 2px 5px 2px 5px;
    margin: 2px;
    border: 1px solid #000099;
    font-weight: bold;
    background-color: #000099;
    color: #FFF;
  }
  .pagination span.disabled {
    padding: 2px 5px 2px 5px;
    margin: 2px;
    border: 1px solid #eee;
    color: #ddd;
  }

再編輯 vi app/views/layouts/bibles.html.erb 加入

<%= stylesheet_link_tag 'page' %>

讓整個 bibles 的 template 可以讀入這新加的 css。

若覺得這pagination太平常太常見,而要不一樣的話,可參考 pagination 的蒐集,將所喜歡的CSS給抄過來用:
Pagination 101:可惜這個連結無效了。
Pagination Gallery


上一篇
[RoR] 多人用虛擬轉址信箱的建置(3)
下一篇
[RoR] 簡單做出搜尋功能
系列文
Rails 的簡單任務33
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

2 則留言

0

謝謝分享咯!

我要留言

立即登入留言