http://guides.rubyonrails.org/layouts_and_rendering.html
This guide covers the basic layout features of Action Controller and Action View
After reading the guide, i will know:
1.How to use the various rendering methods bulit into Rails.
2.How to create layouts with multiple content sections.(如何创建出具有多个内容区域的布局)
3.How to use partials to Dry up your views. (如何弄干你的可视页面,优化得更简洁清晰)
4.How to use nested layouts (sub-templates)
一 overview:How the Pieces fit together
model-controller-view triangle,mvc三角,通过controller 让model干重活,让view干response响应用户的工作,如页面布局。本章讲的就是controller与views的互动设计interaction design.
总体说,当收到用户request,如何根据request,调用method来创建相应的response ,并送回信息过去。如果response是一个完整的view,rails需要做layout ,包括partial view的嵌套。
二,Creating Responses :three ways to create an HTTP response
1. render ;
2 redirect_to;
3 head
2.1 Rendering by Default: convention(习俗,约定) over configration in Action(多约定,少配置)
原则:convention over configration principle
controller根据routes来自动调用view,然后render渲染。
真正处理渲染的过程是 ActionView::TemplateHandlers
的子类。
This guide does not dig into that process, but it‘s important to know that the file extension on your view (视图文件扩展名)controls the choice of template handler. 现在用的是.erb(HTML with embedded Ruby)
2.2 Using render.
ActionController::Base#render
方法都能担起重则,负责渲染应用的内容,供浏览器使用。render方法可以customize客制化
1.render同一个controller中的其他template: render "name"
2.render其他ccontroller的某个template: render "products/name" //早期版本render template: "p/n"
3.render 应用之外的视图: render file:"u/apps/warehouse_app/..."需要绝对路径。微软系统值支持这种绝对路径。
4.render文本:render plain: "ok任意文本" (渲染纯文本主要用于响应 Ajax 或无需使用 HTML 的网络服务
5.render HTML:You can send an html_string back to the browser by using the :html option to render
例子render html:
"<strong>Not Found</strong>"
.html_safe
用途:只渲染一个小html片段。
6.Render JSON: render json: @product (JSON 是一种 JavaScript 数据格式,很多 Ajax 库都用这种格式。Rails 内建支持把对象转换成 JSON,经渲染后再发送给浏览器
7.还可以渲染xml,普通的javascript.
2.2 render 方法的选择:5个
:content_type //用于修改返回的渲染结果的格式类型,默认render返回的是text/html格式,可以设置格式为 application/json或者application/xml.
:layout //可以告诉rails,在在当前动作中使用指定的文件作为布局,详细的见后面。
|
:location //不太明白,以后再会看。
:status //Rails will automatically generate a response with the correct HTTP status code. You can use the :status option to change this;
|
:formats //
2.2.13Finding Layouts
Rails 首先找app/views/layouts 内与controller同名的文件,如果没有则使用默认的application.html.erb or .builder.
Rails 提供了多种方法指定individual controllers and actions.
1.Specifying Layouts for Controllers: layout "name"
2.没细看:可以客制化布局,比如根据用户的选择,来使用特殊的布局渲染产品视图。见原文2.2.13.2
3.根据 条件设定布局: :only和:except选项,限制用到的方法。
例子:
|
4 布局可以继承。layout inheritance.如果在contoller中指定布局,则优先用指定布局。
?? :不要在一个action中双重渲染: Can only render or redirect once per action(一个动作只能渲染或重定向一次)
2 Using redirect_to
发起新的request,执行新的代码,有些经验不足的开发者会认为 redirect_to
方法是一种 goto
命令,把代码从一处转到别处。这么理解是不对的。执行到 redirect_to
方法时,代码会停止运行,等待浏览器发起新请求。你需要告诉浏览器下一个请求是什么,并返回 302 状态码。
这个代码不适合大型应用,会增加响应的时间,影响效能。
3 Structuring Layouts 组织页面的布局
三种工具:
1.asset tag
2.yield and content_for(设定指定的yield的时候,需要用content_for,具体见??例子)
3.partial 局部视图
Yield: with the context of a layout, yield identifies a section where content from the view should be inserted.
pasting
|
The main body of the view will always render into the unnamed yield
. To render content into a named yield
, you use the content_for
method.
For example,this view would work the layout that you just saw:
|
The result of rendering this page into the supplied layout would be this HTML:
<
html
>
<
head
>
<
title
>A simple page</
title
>
</
head
>
<
body
>
<
p
>Hello, Rails!</
p
>
</
body
>
</
html
>
侧边栏,页脚都可以用这个content_for 方法。
Partials:partial templates
在views中渲染局部view可以render 方法
例子:<%=
render
"shared/menu"
%>
Using Partials to Simplify Views: dry up the view 简化视图。
|
pasting
3.4.3
Partial layouts:
A partial can use its own layout file, just as a view can use a layout. For example:
|
这行code将寻找文件_link_area.html.erb,并且使用layout文件_graybar.html.erb渲染(render)它.layout文件也有下划线并在partial的同一folder中,而不是在the master layouts folder中。
3.44
Passing Local Variables
3.45
Rendering Collections 渲染集合,使用局部视图特别方便。
全栈课程里 有用过。使用:collection选项。例子:
<%= render partial: "product", collection:"@products" %>
handshort方式:<%= render @products %>
Rails根据集合中的各个元素的model的名字来使用partial的名字。 集合中的元素可以来自不同的模型,Rails会选择正确的局部视图进行渲染。
:as 可以自定义局部变量的名字用在partial中。
:locals:{}选项可以把任意局部变量传人局部view
<%=
render partial:
"product"
, collection:
@products
,
as:
:item
, locals: {title:
"Products Page"
}
%>
3.48
Collection Partial Layouts
见上面Partial layouts.
|
pasting
3.5 nested Layout
You may find that your application requires a layout that differs slightly from your regular application layout to support one particular controller. Rather than repeating the main layout and editing it, you can accomplish(努力完成) this by using nested layouts(sometimes called sub-templates).