#8 Layouts and content_for

Mar 21, 2007 | 3 minutes | Views

If you want to change something in the layout on a per-template basis, content_for is your answer! This allows templates to specify view code that can be placed anywhere in a layout.

Click to Play Video ▶

Download:
mp4Full Size H.264 Video (5.9 MB)
m4vSmaller H.264 Video (3.9 MB)
webmFull Size VP8 Video (10.8 MB)
ogvFull Size Theora Video (6.63 MB)

下面分别是全局的布局文件application.rhtml及index Action页面定义：

          ruby
        
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" 
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
  <head>
    <title>Todo List</title>
    <%= stylesheet_link_tag 'application' %>
  </head>
  <body>
    <div id="container">
      <h1>Todo List</h1>
      <%= yield %>
    </div>
  </body>
</html>

application.rhtml^[1]

          ruby
        
<h2>Projects</h2>
<ul>
<% for project in @projects %>
  <li><%= project.name %></li>
<% end %>
</ul>

index.rhtml ^[1]

当请求indexaction的时候，页面的绘制会基于全局布局文件。 (不清楚布局文件概念的请移步 #7 页面布局文件). 如果需要对当前关联的布局文件进行更加细节上的调整应该怎么做呢？比如说，想在index页面上使用不同于全局页面布局文件的CSS定义等。在页面中使用content_for方法可以实现想要的效果。content_for接受一个名称参数及代码块定义。代码块逻辑生成的内容将会被加载到布局文件中。

          ruby
        
<% content_for :head do %>
  <%= stylesheet_link_tag 'projects' %>
<% end %>
<h2>Projects</h2>
<ul>
<% for project in @projects %>
  <li><%= project.name %></li>
<% end %>
</ul>

index.rhtml^[1]

下面对布局文件进行修改。将需要输出定制内容的地方增加yield方法，接受之前定义的名字作为参数。如此一来，加载布局文件时候看到了yield :head就会执行之前定义的代码块并将返回结果加入到布局文件中。

          ruby
        
...
  <head>
    <title>Todo List</title>
    <%= stylesheet_link_tag 'project' %>
    <%= yield :head %>
  </head>
...

刷新之后从源代码可以看出，在index中定义的CSS文件已经生效了。

content_for为我们提供在Action中定制布局文件定义的能力。诸如为某些指定的Action中增加用于显示菜单，滚动条等效果的CSS引用等。

注：

Rails 2及以上版本，布局文件不再使用.rhtml后缀，而是.html.erb。