【Rails】ページネーション「kaminari」で用意されているテーマ一覧とスタイルのカスタマイズ

2021年4月6日 12:08

はじめに

Railsアプリにページネーションを簡単に実装できるkaminariというGemには、BootstrapなどのCSSフレームワークのテーマ(テンプレートファイル)が用意されています。わざわざCSSフレームワークのクラスを手動で付与しなくても、専用コマンドを実行するだけで各テーマのテンプレートファイルをRailsアプリにフェッチすることができます。

本記事では、kaminariで使用できるテーマ一覧を画像付きで紹介します。また、CSSフレームワークではなく独自のスタイルにしたい場合に、kaminariで実際に生成されるタグやクラスを紹介します。

CSSフレームワークのテーマ一覧

CSSフレームワークのテーマをフェッチするには、以下のコマンドを実行します。

$ rails generate kaminari:views THEME

THEMEにCSSフレームワークの名称を指定します。THEMEを入力せずにコマンドを実行すると使用できるテーマの一覧が表示されます。

このコマンドはkaminari_themesというリポジトリから指定したテーマのテンプレートファイルをフェッチしています。連続してこのコマンドを実行していると、フェッチ回数がGitHubのレート制限の上限に達してしまい、それ以降コマンドが実行できなくなることがあります。

このコマンドを何度も実行することがあらかじめわかっている場合は、以下のリポジトリをクローンしてからテンプレートファイルをコピーするという方法をおすすめします。

$ git clone https://github.com/amatsuda/kaminari_themes.git
$ cd kaminari_themes/bootstrap4/
$ cp -rp app/views/ /path/to/rails/app/views/

Bootstrap

Bootstrapのテーマは、Bootstrap2、Bootstrap3、Bootstrap4の3種類がありますが、ここではBootstrap4のみを紹介します。

$ rails generate kaminari:views bootstrap4

Bulma

$ rails generate kaminari:views bulma

Foundation

Foundationのテーマは、FoundationとFoundation5の2種類がありますが、ここではFoundation5のみを紹介します。

$ rails generate kaminari:views foundation5

GitHub

GitHubはCSSフレームワークではありませんが、テーマとして用意されています。

$ rails generate kaminari:views github

Google

GoogleはCSSフレームワークではありませんが、テーマとして用意されています(使う人いるのか...?)。

$ rails generate kaminari:views google

Materialize

Materializeは前のページ、次のページのアイコンにGoogleのマテリアルアイコンを使用しています。Materialize CSSフレームワークと一緒にマテリアルアイコンも導入する必要があります。

$ rails generate kaminari:views materialize

Pure CSS

$ rails generate kaminari:views purecss

Semantic UI

$ rails generate kaminari:views semantic_ui

スタイルのカスタマイズ

CSSフレームワークではなく独自のスタイルにカスタマイズしたい場合は、kaminariによって生成されるタグやクラスにスタイルを適用します。以下は、Bootstrapのテーマを適用させた場合に生成されるHTMLです。

<nav>
  <ul class="pagination">
    <li class="page-item">
      <a class="page-link" href="/users">« First</a>
    </li>
    <li class="page-item">
      <a rel="prev" class="page-link" href="/users">‹ Prev</a>
    </li>
    <li class="page-item">
      <a rel="prev" class="page-link" href="/users">1</a>
    </li>
    <li class="page-item active">
      <a data-remote="false" class="page-link">2</a>
    </li>
    <li class="page-item">
      <a rel="next" class="page-link" href="/users?page=3">3</a>
    </li>
    <li class="page-item disabled">
      <a class="page-link" href="#"></a>
    </li>
    <li class="page-item">
      <a rel="next" class="page-link" href="/users?page=3">Next ›</a>
    </li>
    <li class="page-item">
      <a class="page-link" href="/users?page=9">Last »</a>
    </li>
  </ul>
</nav>

クラス一覧とその説明は以下の通りです。

クラス 説明
.pagination リスト全体に適用されるスタイルを設定。リストを横並びにするにはFlexboxを使う。
.page-item リストアイテムに適用されるスタイルを設定。
.active 現在のページ番号のリストアイテムに適用されるスタイルを設定。
.disabled リンクではないリストアイテムに適用されるスタイルを設定。
.page-link リストアイテムの中のリンクに適用されるスタイルを設定。

まとめ

ページネーションを実装するGemの中でkaminariはよく使われており人気があります。CSSフレームワークを使っている人も独自のスタイルを書いている人も本記事を参考にしてkaminariのページネーションをカスタマイズしていただければと思います。

関連記事

【Ruby】Bundlerを使ってRubyGemsを作成/公開する方法
# はじめに Bundlerを使ってRubyGemsを作成および公開する方法について説明します。Bundlerを使わずにRubyGemsを作成/公開する方法については以下の記事を参照してください。 <iframe class="hatena [...]
2022年7月12日 23:18
【Ruby】RubyGemsを作成/公開する方法
# はじめに RubyGemsを作成および公開する方法について説明します。Bundlerを使ってRubyGemsを作成する方法については以下の記事を参照してください。 <iframe class="hatenablogcard" style [...]
2022年7月11日 21:52
【Rails】M1チップ搭載MacでRuby on Railsの開発環境構築
# はじめに M1チップ搭載MacにRuby on Railsの開発環境を構築する手順を記載します。 - MacBook Air (M1, 2020) - macOS Monterey 12.3.1 # Homebrew ## [...]
2022年5月5日 11:56
【Rails】Rakeタスクの基本情報と作成・実行方法
# はじめに Railsには標準でRakeというGemが同梱されています。RakeはRubyで実装されたMake(UNIX系のOSで使用できるコマンド)のようなビルド作業を自動化するツールです。Ruby Make、略してRakeというわけですね。 [...]
2022年3月7日 22:12
【Rails】モデルに外部キーを設定する方法とよく起こるエラー内容について
# はじめに Railsでモデルに外部キーを設定する方法について説明します。 # モデルに外部キーを設定する ## リレーションシップ 今回は1つのブログ記事は複数のコメントを持つ1対多のリレーションシップを例に説明します。現在は` [...]
2022年2月10日 14:18
【Rails】Capybaraのfill_inメソッドを実行すると「既存レコードの内容+指定した内容」がセットされる事象の原因と対処【RSpec】
# はじめに RSpec + Capybaraを使用して、Railsアプリの統合テストを実装しています。とあるモデルの編集画面において、入力フォームの内容を書き換えた上で送信し、レコードが更新されることを確認します。 入力フォームの内容を書 [...]
2022年1月27日 21:22
【Rails】GitHubのセキュリティアラートで発見された脆弱性を解消する方法
# はじめに GitHubにはセキュリティアラートという機能があります。セキュリティアラートはリポジトリに含まれるライブラリやパッケージの脆弱性を定期的にチェックし、脆弱性のあるライブラリやパッケージが発見されたらアラートで知らせてくれるという機 [...]
2022年1月16日 10:36
【Rails】devise-two-factorを使った2段階認証の実装方法【初学者】
# はじめに Railsアプリで2段階認証を実装するには、「rotp」というGemを使う方法の他に、「devise-two-factor」というGemを使う方法があります。「devise-two-factor」はその名の通り、IDとパスワードによ [...]
2021年12月12日 17:58