安裝

????在gemfile增加一行

????gem 'kaminari', '0.14.1'

常用方法

????在Model對象上使用.page()和.per()兩個方法，就像.where()一樣。

????例如每頁10個，取第二頁數(shù)據(jù)

??? User.page(2).per(10)

????如果是傳參數(shù)的話，可以寫成

??? User.page(params[:page]).per(20)

?

????在View中使用，直接調(diào)用它提供的helper方法即可

??? <%= paginate @users %>

?

參數(shù)配置

????全局參數(shù)設置

????執(zhí)行以下命令，會在config/initializers下生成一個配置文件kaminari_config.rb

????rails g kaminari:config

????這個文件控制著kaminari的全局設置，有以下參數(shù)可以定義

????default_per_page????默認值25

????page_method_name? 分頁方法的名稱

????param_name??分頁參數(shù)的參數(shù)名，默認為param

??? window / outer_window / left / right?這四個參數(shù)都與分頁顯示有關，設定了顯示頁碼標簽的方式和數(shù)量。

分頁界面定制

????執(zhí)行一下命令可以獲取默認模版文件。目錄在app/views/kaminari/下

????rails?g kaminari:views default

????各個文件描述如下

??? _paginator.html.erb 這是總的入口文件，可以通過修改它來調(diào)整顯示的整體結構
? ?? 比如我不需要“首頁”，”末頁“這兩個鏈接，那么我就在這個文件里面將對應的代碼刪除
??? _page.html.erb 對應頁碼鏈接
??? _first_page.html.erb / _last_page.html.erb 對應“首頁”和“末頁”的鏈接
??? _prev_page.html.erb / _next_page.html.erb 對應“上一頁”和“下一頁”的鏈接
??? _gap.html.erb 空隙的顯示，默認是中間的省略號(...)

?

????注意，不要修改文件名。

?

????theme功能

????在app/views/kaminari目錄下創(chuàng)建一個文件夾，例如test，把默認的模版文件拷貝進去，修改模版文件的內(nèi)容，就形成了個性化的樣式。

????view頁面按下方寫法即可調(diào)用個性樣式。

??? <%= paginate @blogs, :theme=>'test' %>

源資源文檔

??? https://github.com/edokeh/klog/tree/master/app/views/kaminari

總結

以上是生活随笔為你收集整理的kaminari 简要文档的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。