レイアウトおよび部分テンプレートはどちらもテンプレート (*.html.erb) に共通の要素をまとめておき、任意のテンプレートから利用できるようにしておくための仕組みです。フッターやヘッダーといった大枠はレイアウト、小さなパーツは部分テンプレートというイメージで使い分けましょう。

レイアウトの使用方法

クラス毎に指定する方法と、アクション毎に指定する方法があります。

app/views/layouts/my_layout.html.erb

[ヘッダー]
<%= yield %>
[フッター]

クラス毎に指定

app/controllers/my_models_controller.rb

class MyModelsController < ApplicationController
  layout 'my_layout'
  #layout false #レイアウトをなしにする場合
  ...

アクション毎に指定

class MyModelsController < ApplicationController
  before_action :set_my_model, only: [:show, :edit, :update, :destroy]

  # GET /my_models
  # GET /my_models.json
  def index
    @my_models = MyModel.all
    render layout: 'my_layout'
    #render layout: false #レイアウトをなしにする場合
  end
  ...

複雑なレイアウトの作成方法

"yield"を複数設置

app/views/layouts/my_layout.html.erb

[ヘッダー]
<%= yield :contentA %>
[共通コンテンツ]
<%= yield :contentB %>
[フッター]

app/views/my_models/index.html.erb

<% content_for :contentA do %>
コンテンツA
<% end %>
<% content_for :contentB do %>
コンテンツB
<% end %>

出力例

[ヘッダー]
コンテンツA

[共通コンテンツ]
コンテンツB

[フッター]

レイアウトのレイアウト

複数のレイアウト間に共通の大枠の要素がある場合、レイアウトのレイアウトにまとめておくと便利です。

app/views/layouts/my_layout.html.erb

<% content_for :normal_layout_content do %>
レイアウトその１
<%= yield %>
<% end %>
<%= render template: 'layouts/layout_of_layout' %>

app/views/layouts/my_layout2.html.erb

<% content_for :normal_layout_content do %>
レイアウトその２
<%= yield %>
<% end %>
<%= render template: 'layouts/layout_of_layout' %>

app/views/layouts/layout_of_layout.html.erb

[ヘッダー]
<%= yield(:normal_layout_content) %>
[フッター]

app/views/my_models/index.html.erb

本文です。

出力例

[ヘッダー]
レイアウトその１
本文です。

[フッター]

部分テンプレートの使用方法

app/views/my_models/_partial_template.html.erb

~~~~~~~~~~~~~~~~~~
小さな共通パーツ
<%= arg1 %>
<%= arg2 %>
~~~~~~~~~~~~~~~~~~

app/views/my_models/index.html.erb

<%= render 'my_models/partial_template', arg1: 'val1', arg2: 'val2' %>

出力例

~~~~~~~~~~~~~~~~~~
小さな共通パーツ
val1
val2
~~~~~~~~~~~~~~~~~~

繰り返しが発生する場合に便利な記法

ページャ等で同じようなアイテムを繰り返し出力する場合、部分テンプレートを使用するとよいのは想像の通りですが、その「繰り返し」をeachで実現する場合と比較して便利な記法が存在しています。

app/views/my_models/_my_model.html.erb (MyModelを表示するのための部分テンプレート)

<tr><td><%= arg1 %>:<%= my_model.id %></td></tr>

app/views/my_models/index.html.erb

<table>
<%= render @my_models, arg1: 'val1' %>
</table>

出力例

<table>
<tr><td>val1:1</td></tr>
<tr><td>val1:2</td></tr>
<tr><td>val1:3</td></tr>
</table>

@my_models に格納されているモデルをもとに自動で部分テンプレートが選択されます。今回の例では"MyModel"のみですので、すべて"my_models/_my_model.html.erb"が選択されました。