Railsドキュメント

表示させるviewファイルを指定して表示

適応バージョン

• 1.0.0
• 1.1.0
• 1.1.1
• 1.1.6
• 1.2.0
• 1.2.6
• 2.0.0
• 2.0.1
• 2.0.3
• 2.1.0
• 2.2.1
• 2.3.2
• 2.3.8
• 3.0.0
• 3.0.5
• 3.0.7
• 3.0.9
• 3.1.0
• 3.2.3
• 3.2.8
• 3.2.13
• 4.0.2
• 4.1.8
• 4.2.1
• 4.2.7
• 4.2.9
• 5.0.0.1
• 5.1.7
• 5.2.3
• 6.0.2.1
• 7.0.0

説明

表示させるviewファイルを指定して表示

使い方

render(表示方法 [, オプション])

表示方法

オプション

注意点

• 同じアクション内でrenderメソッドを複数呼び出すと、エラーになるので、and returnを付ける

render :action

説明

他のアクションのテンプレートを表示

使い方

render(action: "アクション名" [, layout: レイアウト名])

例

「_new.html.erb」を表示

render action: "new"

他のレイアウトを使用

render action: "new", layout: "user"

レイアウトは使用しない

render action: "new", layout: false

render :template

説明

他のコントローラのテンプレートを表示

使い方

render template: コントローラ名/アクション名

例

他のコントローラのテンプレートを表示

render template: "user/show"

templateを省略

render "user/show"

render :file

説明

アプリケーション外のテンプレートを表示
「/」で始まる場合はファイル出力と認識するので、fileオプションは省略可能

使い方

render file: ファイルパス

例

「/common/template/index」を表示

render file: "/common/template/index"

fileを省略

render file: "/common/template/index"

render :text

説明

文字列を直接表示

使い方

render text: "文字列"

例

レイアウトを適用

render text: "文字例", layout: true

エラーメッセージの表示

render text: "文字例", status: 500

「hello world!」を表示

render text: "hello world!"

文字列とstatusコード500を返す

render text: "Explosion!", status: 500

レイアウトを使用して文字列を表示

render text: "Hi there!", layout: true

render :partial

説明

部分テンプレート

使い方

render partial: "部分テンプレート名"

例

_page.rhtmnlを使って表示

render partial: "page"

部分テンプレートを繰り返し表示

render partial: "user", collections: @users

部分テンプレートにローカル変数を渡す

render partial: "user", locals: { val1: xxx, val2: xxx }

render :inline

説明

アプリケーション外のテンプレートを表示

使い方

render inline: テンプレート文字列

例

現在の時刻を表示

render inline: "<%= Time.now %>"

render :xml

説明

指定されたテキストを表示し、コンテンツタイプをapplication/xmlに設定

使い方

render xml: モデル or 文字列

例

pagesテーブルの内容をXML形式で出力

@pages = Page.all
render xml: @pages

render :json

説明

指定されたテキストを表示し、コンテンツタイプをapplication/xmlに設定

使い方

render json: モデル or 文字列

例

pagesテーブルの内容をJSON形式で出力

@pages = Page.all
render json: @pages

例

404コード

render nothing: true, status: 404

render :plain

説明

平文テキストを表示

使い方

render plain: 文字列

例

OK

render plain: "OK

render :html

説明

平文テキストを表示

使い方

render html: 文字列

例

Not Found

render html: helpers.tag.strong('Not Found')

render :js

説明

JavaScriptを表示

使い方

render js: 文字列

例

JavaScriptを表示

render js: "alert('Hello Rails');"

render :body

説明

生のコンテンツを表示

使い方

render body: 文字列

例

JavaScriptを表示

render body: "raw"

その他

renderを複数使用

説明

renderを複数回呼び出すとエラーになるため、条件分岐した後「and return」で明示的に終了させる

使い方

render オプション and return

ソースコード

• GitHub