kaminari gem

カミナリジェム

カミナリとは何ですか?

カミナリ は、アプリケーション内のレコードをページネーションするためのシンプルかつ柔軟な方法を提供する、Ruby on Rails のページネーション gem です。 Kaminari を使用すると、ビューとコントローラーにページネーションを簡単に追加し、特定のニーズに合わせてページネーション オプションをカスタマイズできます。

カミナリのインストール

カミナリを使用するには Railsアプリケーション、まず gem をインストールする必要があります。これを行うには、Gemfile に次の行を追加します。

宝石 「カミナリ」

Gemfile に gem を追加した後、次を実行します。 バンドルインストール gem とその依存関係をインストールします。

コントローラーで Kaminari を使用する

Kaminari をインストールしたら、コントローラーでこれを使用してレコードのページネーションを開始できます。 UsersController でユーザーのリストをページ分割する方法の例を次に示します。

クラス ユーザーコントローラー < アプリケーションコントローラー
確かに 索引
@ユーザー = ユーザー。注文(:名前).page(params[:ページ]).per(10)
終わり
終わり

この例では、 ページ 現在のページ番号を指定するメソッドと、 あたり ページごとのレコード数を指定するメソッド。の 注文 メソッドは、ユーザーを名前で並べ替えるのに使用されます。

あなたの視点で Kaminari を使用する

コントローラーでレコードをページ分割したら、Kaminari のビュー ヘルパーを使用してビューにページ分割リンクを表示できます。以下は、index.html.erb ビューでページネーション リンクを表示する方法の例です。

<%= ページ付け @ユーザー %>

この例では、 ページ付け のページネーションリンクを生成するヘルパー @ユーザー コレクション。 Kaminari は、現在のページとコレクション内のページ数に基づいて、前、次、および番号付きのページへのリンクを自動的に生成します。

ページネーションオプションのカスタマイズ

Kaminari は、ページネーションのリンクと動作を構成するために使用できるさまざまなカスタマイズ オプションを提供します。一般的なカスタマイズ オプションの例をいくつか示します。

  • ページあたりのデフォルトのレコード数の変更

デフォルトでは、Kaminari は 1 ページあたり 25 レコードを表示します。これを変更するには、 ページごとのデフォルト 初期化ファイルの構成オプション:

#config/initializers/カミナリ.rb
Kaminari.configure する |構成|
config.default_per_page = 10
終わり

この例では、ページあたりのデフォルトのレコード数を 10 に設定しています。

  • ページネーションリンクのラベルの変更

ページネーション リンクのラベルをカスタマイズするには、 パラメータ名 そして パラメータ のオプション ページ付け ヘルパー:

<%= ページ付け @ユーザー、パラメータ_名前: :ページ番号、 パラメータ: { foo: 'バー' } %>

この例では、ページネーション パラメータを次のように設定しています。 ページ番号 デフォルトの代わりに ページを渡し、 foo=バー 生成されたページネーション リンクへのパラメータ。を使用して、個々のページネーション リンクのラベルをカスタマイズすることもできます。 テーマ オプションを使用してカスタム ビュー テンプレートを作成します。

  • ページネーションテーマのカスタマイズ

Kaminari は、ページネーション リンク用のいくつかの組み込みテーマを提供します。 デフォルト, ツイッターブートストラップ、 そして 具現化する。テーマをカスタマイズするには、 テーマ 初期化ファイルの構成オプション:

 
#config/initializers/カミナリ.rb
カミナリ。構成、設定 する |構成|
config.default_theme = :twitter-ブートストラップ
終わり
``
関連記事

コメントを残す

メールアドレスが公開されることはありません。 が付いている欄は必須項目です

jaJapanese