Railsレンダリング完全ガイド｜基本の仕組みからパーシャル・コレクション・レイアウトまで徹底解説

Railsにおける「レンダリング」とは何でしょうか？

レンダリングは、Ruby on Railsアプリケーションにおける最終的なゴールです。Railsでは通常、HTMLとRubyのコードが混在した.html.erbファイル（ビューテンプレート）をレンダリングします。

ビューとは、ユーザーが目にするものです。

それは、Railsアプリが行うすべての処理の結果であり、ロジック・データ・ビューテンプレートを組み合わせて、ユーザーのリクエストに応答します。

実は、JSONレスポンスを返すことも一種の「ビュー」と考えることができます。

だからこそ、せっかく書いたコードを無駄にしないためにも、Railsのレンダリングシステムについてできる限り深く学ぶことが重要なのです。

さらに、Railsのレンダリングには意外な挙動が潜んでいることもあります。知れば知るほど、トラブルを避けられるでしょう。

それでは、基本から始めましょう！

ビューレンダリングの基本

実はデフォルトの状態では、Railsに明示的にレンダリングを指示しなくても、他の設定さえ正しくされていればビューは自動的に機能します。

これは「設定より規約（Convention over Configuration）」というRailsの思想によるものです。

どのような仕組みなのでしょうか？

Railsは、開発者が意識していないかもしれない「暗黙の前提」に基づいて動作します。これにより作業量が減るのですが、内部で何が起きているのかを知らないと、まるで魔法のように感じられるかもしれません。

ここが落とし穴になりやすいポイントです！

この場合、Railsが想定しているのは「リクエストを処理するコントローラアクションと同じ名前のテンプレートをレンダリングしたいはずだ」ということです。

つまり、BooksController#indexを呼び出すと…Railsは自動的にbooks/index.erbをレンダリングします。

では、もっと細かく制御したい場合はどうすればいいのでしょうか？

renderを使えば、デフォルトとは別のビューを明示的に指定できます。

具体的には次のように書きます：

class BooksController < ApplicationController
  def index
    render :listing
  end
end

これによりbooks/listing.erbがレンダリングされます（HAMLを使用している場合は.hamlファイルになります）。

シンボルの代わりに文字列を使うことも可能です。

例えば次のように：

render 'shared/buttons'

この場合、Railsはshared/buttons.erbをレンダリングします。

知っておくべき重要なポイント

他のアクションに関連付けられたビューをレンダリングしても、そのアクション自体は実行されません。

言い換えると、createアクション内でrender :indexと呼び出しても、indexメソッドそのものは走らないということです。

なぜこれが重要なのでしょうか？

そのビューが必要とするインスタンス変数がセットされないままになるからです！自分で値を設定する必要があります。

例を見てみましょう：

def index
  @users = User.all
end

# ここで`@users`を設定し忘れると、エラーまたは空のindexビューになります
# 代わりに`redirect_to`を使えば、`index`アクション自体が実行されます
def create
  render :index
end

レンダリングには、まだまだ知るべきことがたくさんあります。続けていきましょう！

さまざまな種類のレンダリング

テンプレートをレンダリングする以外にも、いくつか選択肢があります。

できること：

• HTML文字列をレンダリングする
• プレーンテキストをレンダリングする
• JSONをレンダリングする

文字列のレンダリングは、開発中にエラー用のテンプレートをまだ用意していない場合などに、簡易的なエラーメッセージを表示するのに便利です。特定のコントローラアクション用のビューをまだ書いていない段階でも使えますね。

例：

if @user
  render :show
else
  render plain: "ユーザーが見つかりません。"
end

JSONを直接レンダリングすれば、シンプルなAPIを作ることもできます。本番環境での最善のアプローチではありませんが、プロトタイプを作り始める際には役立ちます。

例：

render json: @user

HTMLのレンダリングを使う機会はあまり多くありませんが、有効な活用法があればぜひ試してみてください。

パーシャル（部分テンプレート）のレンダリング方法

レンダリングはコントローラだけの話ではありません。ビューの中から別のビューをレンダリングすることもできます。

これを「パーシャル（部分テンプレート）」と呼びます。

なぜパーシャルを使うのでしょうか？

答えは、コードの見通しを良くすることと、コードの再利用です。

例えば、同じフォームを3つの異なるページで使っているなら、それをパーシャルとして切り出すのが良いアイデアです。そうすれば、変更が必要になったときに修正するのは1箇所だけで済みます。

例：

<%= render :form %>

これを機能させるには、ビューファイル名をアンダースコア始まりにする必要があります（例：_form.erb）。ただし、renderで呼び出すときはアンダースコアは不要です。

パーシャル内からはインスタンス変数にアクセスできますが、ローカル変数を渡したい場合はどうすればいいのでしょうか？

次のように書きます：

<%= render :form, message: "りんごは体に良い" %>

こうすると、パーシャル内でmessageをローカル変数として扱えます。

次は：たった1回のrender呼び出しで複数の要素をレンダリングする方法を学びましょう！

コレクションのレンダリング方法

パーシャルを使うと、ループを明示的に書かずにコレクションをレンダリングできます。

例えば、@booksをレンダリングしたいとしましょう。

次のように書くだけでOKです：

<%= render @books %>

これが機能する条件は、_book.erbというパーシャルが存在し、そのテンプレート内でbookという変数名を使っていることです。

パーシャルの例：

# app/views/books/_book.erb


  <%= image_tag(book.cover) %>

  

    
<%= book.title %>
    <%= book.author %>
  

  <%= link_to "本を読む", book %>

CSSクラスなどで現在の件数（番号）が必要な場合は、book_counterを使えます。book_の部分はモデル名に対応します。

個人的には、このコレクションレンダリングはRailsのお気に入り機能のひとつです！

Railsのレイアウトを理解する

新しいRailsアプリを作成すると、viewsフォルダの下に「layouts」フォルダが用意されています。

そこにはapplication.html.erbというファイルがあります。これがデフォルトのレイアウトです！

レイアウトとは何でしょうか？

レイアウトを使うと、サイト全体に統一感のある見た目を持たせることができます。

具体的には：

• ナビゲーションメニュー
• フッター
• CSSやJavaScriptファイルの読み込み

ほとんどの場合、デフォルトのレイアウトで十分ですが、特定のページだけ別のレイアウトを使いたい場合はどうすればいいのでしょうか？

layoutオプションを使います。

例：

render :index, layout: 'admin'

レイアウトを無効化することもできます：

render :index, layout: false

また、コントローラ単位でレイアウトを指定することも可能です。

次のように書きます：

class AdminsController < ApplicationController
  layout 'admin'
end

レンダリングしてもアクションは終了しない

よくある混乱のひとつが、「コントローラアクション内でレンダリング（やリダイレクト）を行うと、その後のコードは実行されない」と思い込んでしまうことです。

実際には、renderを複数回呼び出してしまうと問題が発生します。

悪い例：

def create
  if yellow_fruit?
    render :bananas
  end

  render :apples
end

これはエラーになります。render :applesが常に実行されてしまい、同じコントローラアクション内で2回レンダリングすることはできないからです。

解決策はこちら：

def create
  if yellow_fruit?
    render :bananas
  else
    render :apples
  end
end

もうひとつの方法として、renderの後にreturnキーワードを使う手もあります。ただし、可読性の観点からは、メソッド途中のreturn文はできるだけ避けるのがベストです。

まとめ

この記事では、Ruby on Railsにおいて非常に重要なテーマである「レンダリング」について学びました。

レンダリングは、アプリケーションのユーザーへコンテンツを返すための仕組みであり、コントローラアクション内の最終ステップのひとつです。レンダリングを正しく理解することで、より質の高いRailsアプリケーションを書けるようになります。

それでは、エディタを開いて、実際にコードを書いて練習してみてください！

最後までお読みいただきありがとうございました！