渲染视图
文章目录
默认渲染
访问 http://localhost:3000/demo/index 时,通常会执行 demo 控制器的 index 动作,渲染 app/views/demo/index.rhtml,将数据填入模板,再将生成的 HTML 返回给浏览器。
在本文记录的 Rails 版本中,即使控制器没有定义 index 动作,也会假设存在一个空动作来渲染同名模板。每个控制器动作都隐含了一次 render,也可以显式调用:
def index
render :template => "demo/index"
end
渲染其他动作的模板
如果不想渲染默认模板,可以使用 render 指定其他模板。例如,创建记录时验证失败,需要重新展示表单,保留用户输入并提示错误:
class ArticlesController < ApplicationController
def index
@articles = Article.all
end
def new
@article = Article.new
end
def create
@article = Article.new(params[:article])
if @article.save
redirect_to articles_path
else
render :new
end
end
end
显示表单与处理表单通常是两个动作,因此处理失败时,需要显式渲染原表单。
渲染指定文件
:template 接收相对于模板根目录的路径,默认根目录是 app/views,也可以修改:
render :template => "abuse/report"
对应模板为 app/views/abuse/report.rhtml。
:file 接收模板文件的绝对路径:
render :file => "/railsapps/myweb/app/views/templates/common.rhtml"
渲染局部模板
局部模板可以将视图拆成更小、可复用的文件。既可以在控制器中响应 AJAX 请求,也可以在其他视图中嵌入:
render :partial => "location"
局部模板的文件名以 _ 开头,引用时省略下划线。
渲染内联模板
不建议使用内联模板。原文示例为:
render :inline => "<%= auto_complate_result(@headings, ''name'') %>"
Rails 处理内联模板的方式与视图模板一致。
渲染其他数据类型
返回纯文本:
render :text => "Submission accepted"
返回 JSON,常用于 AJAX 响应:
render :json => @record.to_json
返回 XML:
render :xml => @record.to_xml
不渲染内容
少数情况下,动作不需要渲染任何内容。原文记录的写法为:
render :nothing => true, :status => 401
这里返回空内容,并将状态码设置为 401(未授权)。
渲染选项
| 选项 | 作用 |
|---|---|
:content_type |
指定 MIME 类型。Rails 不验证实际内容是否与声明的类型一致,需要调用方保证。 |
:layout |
指定是否使用布局模板,以及使用哪个布局。 |
:status |
指定 HTTP 状态码,例如 200 OK 表示请求成功。 |