← 全部文章

渲染视图

文章目录

默认渲染

访问 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 表示请求成功。