Action View Rendering

Methods
R
Instance Public methods
render(options = {}, locals = {}, &block)

Returns the result of a render that’s dictated by the options hash. The primary options are:

  • :partial - See ActionView::Partials.
  • :update - Calls update_page with the block given.
  • :file - Renders an explicit template file (this used to be the old default), add :locals to pass in those.
  • :inline - Renders an inline template similar to how it’s done in the controller.
  • :text - Renders the text passed in out.

If no options hash is passed or :update specified, the default is to render a partial and use the second parameter as the locals hash.

    # File actionpack/lib/action_view/render/rendering.rb, line 16
16:     def render(options = {}, locals = {}, &block)
17:       case options
18:       when Hash
19:         if block_given?
20:           _render_partial(options.merge(:partial => options.delete(:layout)), &block)
21:         elsif options.key?(:partial)
22:           _render_partial(options)
23:         else
24:           template = _determine_template(options)
25:           lookup_context.freeze_formats(template.formats, true)
26:           _render_template(template, options[:layout], options)
27:         end
28:       when :update
29:         update_page(&block)
30:       else
31:         _render_partial(:partial => options, :locals => locals)
32:       end
33:     end