Kaminari

問い合わせをスコープの連鎖として組み立てる

User.order(:name).page(params[:page]).per(50)のように、並び順や絞り込みへページ番号と1ページ件数を続けて指定できます。結果は通常のAR::Relationとして扱えるため、ページ分割の前後にも別の条件を連鎖できます。

出典：[1]

表示部品と既定値をアプリに合わせて調整する

paginateヘルパーはHTML5のnav要素を含むページリンクを生成します。リンクはEngine内の部分テンプレートから描画されるため、テンプレートを上書きして見た目や動作を調整できます。既定の1ページ件数、最大件数、窓幅、パラメーター名なども設定できます。

出典：[1]

Railsの一覧画面や管理画面へ段階的に導入しやすい

ActiveRecordを使うRailsアプリで、既存の検索・並び替え条件を保ちながら一覧を分割したい場合に向きます。READMEではSinatra、Grape、Mongoidなどへの対応も案内されており、複数のRuby構成で共通したページ分割の考え方を使いたい場合にも候補になります。

出典：[1]

順序、件数上限、対応版を導入前に確認する

Kaminari自身は問い合わせへ並び順を追加しません。同じ条件でページを移動したときに結果が安定するよう、アプリ側でorderを明示する必要があります。perは既存のlimitを上書きするため、利用者が件数を指定できる画面ではmax_per_pageなどで上限も設けます。

最新READMEはRuby 2.1〜3.3とRails 4.1〜8.0などを対応対象として掲げています。一方、最新のGitHub Releaseはv1.2.2で、Release欄の更新時期と既定ブランチ上の対応表には差があります。採用時は利用中のRuby・Rails版でテストし、変更履歴と依存関係を確認してください。

出典：[1][2]