参考链接：http://guides.rubyonrails.org/layouts_and_rendering.html#structuring-layouts

layout

layout最基本的使用很简单，默认的layout是app/views/layout目录里与controller同名的模板。如果要指定为其它布局，可以在controller里调用layout方法，像这样：

  1. class ProductsController < ApplicationController
  2. layout "inventory"
  3. #....
  4. end

之后，所有的action都将以app/views/layout/inventory.html.erb为布局来渲染模板。layout方法还支持:except和:only两个选项，用来选择layout方法影响到的action，顾名思义吧，不记了。

  1. layout "product", :except => [:index, :rss]

动态布局 
当layout方法的参数为一个symbol的时候，这个controller的布局是动态的，必须在controller里定义一个与symbol对应的方法（一般为private即可），这个方法必须返回一个字符串，用作指定布局的名字：

  1. class ProductsController < ApplicationController
  2. layout :products_layout
  3. def show
  4. @product = Product.find(params[:id])
  5. end
  6. private
  7. def products_layout
  8. @current_user.special? ? "special" : "products"
  9. end
  10. end

也可以这样写：

  1. class ProductsController < ApplicationController
  2. layout proc { |controller| controller.request.xhr? ? 'popup' : 'application' }
  3. # ...
  4. end

结构化布局（Structuring Layouts）

Asset Tags

javascript_include_tag 
在页面中引入js文件：public/javascripts/main.js:

  1. <%= javascript_include_tag "main" %>

引入public/javascripts/main.js 和 public/javascripts/columns.js:

  1. <%= javascript_include_tag "main", "columns" %>

引入public/javascripts/main.js 和 public/photos/columns.js:

  1. <%= javascript_include_tag "main", "/photos/columns" %>

引入http://example.com/main.js:

  1. <%= javascript_include_tag "http://example.com/main.js" %>

:defaults 选项可用于引入Prototype 和 Scriptaculous 库:

  1. <%= javascript_include_tag :defaults %>

:all 选项加载public/javascripts目录下的每个js文件, 以Prototype 和 Scriptaculous开头:

  1. <%= javascript_include_tag :all %>

:recursive 选项用于指定是否包含public/javascripts目录的子目录中的js文件:

  1. <%= javascript_include_tag :all, :recursive => true %>

如果你加载了多个js文件，可以通过设置:catch选项为true来组合多个js文件到一个js文件中，从而增强用户体验。 :

  1. <%= javascript_include_tag "main", "columns", :cache => true %>

默认的，这些js文件将被组合到javascripts/all.js中。你可以手动指定一个缓存文件的位置:

  1. <%= javascript_include_tag "main", "columns", :cache => 'cache/main/display' %>

甚至可以使用动态的路径，像这样：cache/#{current_site}/main/display.

stylesheet_link_tag

stylesheet_link_tag的使用大致和javascript_include_tag相同，只是没有那个:defaults选项。另外，stylesheet_link_tag多了:media、:rel和:type三个选项，用于指定stylesheet link的media、rel和type值，默认值为：media="screen" rel="stylesheet" type="text/css"。

layout中的yield

在layout里面，yield用来标识view应该插入的地方。像这样：

  1. <html>
  2. <head>
  3. </head>
  4. <body>
  5. <%= yield %>
  6. </body>
  7. </html>

带参数的yield一般与content_for一起使用：

  1. <!--layout-->
  2. <html>
  3. <head>
  4. <%= yield :head %>
  5. </head>
  6. <body>
  7. <%= yield %>
  8. </body>
  9. </html>
  10. <!--view-->
  11. <% content_for :head do %>
  12. <title>A simple page</title>
  13. <% end %>
  14. <p>Hello, Rails!</p>
  15. <!--结果-->
  16. <html>
  17. <head>
  18. <title>A simple page</title>
  19. </head>
  20. <body>
  21. <p>Hello, Rails!</p>
  22. </body>
  23. </html>

partial

把partial作为view的一部分来渲染，可以调用render方法：

  1. <%=render :partial=>"menu"%>

上面的代码会把文件名为_menu.html.erb的模板渲染到当前模板中。

  1. <%= render :partial => "shared/menu" %>

渲染app/views/shared/_menu.html.erb到当前模板。 
可以为partial单独指定layout：

  1. <%= render :partial => "link_area", :layout => "graybar" %>

partial的layout文件名必须以下划线开头：_graybar.html.erb，而且必须把layout模板文件和partial放在同一个目录下。

给partial传递局部变量 
:locals选项用于设置partial的局部变量：

  1. <%= render :partial => "form", :locals => { :button_label => "Create zone", :zone => @zone } %>

这样就可以在_form.html.erb中访问button_label和zone这两个变量。

每个partial都有一个和partial名字相同（不带下划线）的局部变量，可以通过:object选项给这个变量传递值：

  1. <%= render :partial => "customer", :object => @new_customer %>

这样就可以在_customer.html.erb中访问customer这个变量，它指向@new_customer。

当然，作为父模板（parent）的一部分，partial可以直接访问父模板的实例变量，例如这里的@new_customer，但是如果这么做的话，partial就跟父模板耦合了，变得不容易重用了。所以建议使用partial的名字来引用实例变量而不是直接访问实例变量。 
之前版本的Rails中，如果不指定:object或者:locals选项，rails会自动在父模板中寻找与partial同名的那个实例变量作为partial的局部变量，如：

  1. <%= render :partial => "customer" %>

如果在_customer.html.erb中访问customer这个变量，rails将会自动在父模板中寻找名为@customer的实例变量。这个特性在Rails2.2中已经不建议使用了（deprecated）。Rails3.0中已经将这个特性移除了。

如果要传递给partial的实例变量名==partial名==model名，可以简写，如：

  1. #当@customer为Customer这个model的实例，并且partial名为customer时
  2. <%= render :partial => @customer %>
  3. #相当于
  4. <%= render :partial => "customer", :object=>@customer %>

渲染集合（Collections） 
:collection选项用于指定被传递给partial的集合对象，假设有books这么个集合，包含了5个Book对象，可以这样使用：

  1. #main.html.erb
  2. <%= render :partial => "book", :collection => books %>
  3. #_book.html.erb
  4. <p><%= book.name%></p>

这样，在main.html.erb中，_book.html.erb的内容会被渲染5次。这时候，partial模板中，与partial同名的那个变量指向了:collection选项传过来的集合中的每一项。如果你不想使用这个与partial同名的变量名，可以通过:as选项来设置你想要的变量名（:as的值只能用symbol，不能是string，否则在partial里会得到nil值）：

  1. <%= render :partial => "product", :collection => @products, :as => :item %>

在设置:collection选项的时候，rails同时提供了一个counter变量给partial模板，变量名以partial名（不带下划线）开头，以_counter结尾，并且经试验，这个变量名不受:as选项影响（也就是说在上面的代码中，这个变量名应该是product_counter而不是item_counter）。其值为collection对象的索引值（从0开始）。 
:spacer_template选项用于指定填充于collection每个member之间的模板：

  1. <%= render :partial => "product", :collection => @products, :spacer_template => "product_ruler" %>

上面的代码中，_product_ruler.html.erb的内容将被填充到每一对_product partial之间。 
和:object一样，:collection也有简写形式：

    1. <%= render :partial => @products %>

Layout in Rails的更多相关文章

  1. rails 杂记 - render and layout

    官方文档:http://guides.rubyonrails.org/layouts_and_rendering.html 渲染 view 渲染 html.rb 与相应的 action control ...

  2. Rails :布局和视图渲染

    原文地址: http://guides.ruby-china.org/layouts_and_rendering.html Rails 布局和视图渲染 本文介绍 Action Controller 和 ...

  3. 在rails中 Rendering Partials through Ajax

    之前做.net的时候,自己做了一个showcontent的插件,用来加载页面的局部partial 之前采用的是ashx的方式 但rails里面不太方面,今天找到一个比较好的方法,试验成功 起初网上找到 ...

  4. Rails中的MIME类型

    layout title date comments categories post rails的中的MIME类型 2014-09-08 21:40 true ruby Rails开发中经常使用不同的 ...

  5. 初始化rails上的compass项目

    compass以外还有一个很实用的scss模块, _media-queries.scss 通过终端下载 curl -O https://raw.github.com/paranoida/sass-me ...

  6. ruby on rails 中render的使用

    最近写ror,因为比较菜,很多东西不知道,只能看一点查一点了 render 先上点搜集的常用方式 render :action => "long_goal", :layout ...

  7. rails跑通第一个demo

    rails -h 查看帮助 Usage: rails new APP_PATH [options] Options: -r, [--ruby=PATH] # Path to the Ruby bina ...

  8. rails总结

    rails总结 注意:本文档以rails3.2版本为基础,并且用RubyMine 4.0.3作为ide 一.rails的结构与重要文件 Rails 是一个MVC库.同时,Rails的特点就是:惯用名优 ...

  9. SummerNote 富文本编辑器 - Rails 集成

    使用官方提供的CDN服务 将下面一段加入layout文件中 <link href="http://netdna.bootstrapcdn.com/bootstrap/3.3.5/css ...

随机推荐

  1. seajs的CMD模式的优势以及使用

    之前有一篇博客非常详细的介绍了sea.js的加载流程,以及源代码实现,链接地址:http://www.cnblogs.com/chaojidan/p/4123980.html 这篇博客我主要讲下sea ...

  2. Perl爬取铁路违章旅客信息

    #! /usr/bin/perl use strict; use Encode qw(encode decode); binmode(STDIN,":encoding(utf8)" ...

  3. java.lang.ClassCastException: android.view.AbsSavedState$1 cannot be cast to android.widget.ProgressBar$SavedState

    java.lang.ClassCastException: android.view.AbsSavedState$1 cannot be cast to android.widget.Progress ...

  4. 安装好oracle后，打开防火墙遇到的问题！

    -A INPUT -p tcp -m state --state NEW -m tcp --dport 1521 -j ACCEPT -A INPUT -j REJECT --reject-with ...

  5. DIOCP之开发流程图之Client

    本次分析开发流程图采用的是DIOCP群里的群友[彩蛋]所给的DEMO,依然是win7的画图作品. 本人分析认为:学习网络开发不同本地开发,首先你应该知道完整的开发流程即网络程序运行的先后顺序,有个整体 ...

  6. 循序渐进Python3（十一） --2-- web之javascript

      JavaScrip                JavaScript是一门编程语言,浏览器内置了JavaScript语言的解释器,所以在浏览器上按照JavaScript语言的规则编写相应代码之后 ...

  7. matlab图

    .6 统计作图 4.6.1 正整数的频率表 命令 正整数的频率表 函数 tabulate 格式 table = tabulate(X) %X为正整数构成的向量,返回3列:第1列中包含X的值第2列为这些 ...

  8. RabbitMq 集群配置

    1. RabbitMQ 所需的附属安装包 1.1  openGL安装 执行命令: [root@localhost local]# yum install mesa-libGL-devel mesa-l ...

  9. mysql 常用基础

    登录命令 -h远程IP地址 -u用户名 -p密码 -P端口 mysql -h127.0.0.1 -uroot -p21313 -P3306 新建用户 insert into mysql.user(Ho ...

  10. PowerDesigner使用教程

    PowerDesigner是一款功能非常强大的建模工具软件,足以与Rose比肩,同样是当今最著名的建模软件之一.Rose是专攻UML对象模型的建模工具,之后才向数据库建模发展,而PowerDesign ...