Class: ActionView::Renderer

Inherits:
Object
  • Object
show all
Defined in:
lib/action_view/renderer/renderer.rb

Overview

This is the main entry point for rendering. It basically delegates to other objects like TemplateRenderer and PartialRenderer which actually renders the template.

The Renderer will parse the options from the render or render_body method and render a partial or a template based on the options. The TemplateRenderer and PartialRenderer objects are wrappers which do all the setup and logic necessary to render a view and a new object is created each time render is called.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(lookup_context) ⇒ Renderer

Returns a new instance of Renderer.



14
15
16
 
# File 'lib/action_view/renderer/renderer.rb', line 14

def initialize(lookup_context)
  @lookup_context = lookup_context
end

Instance Attribute Details

#lookup_context ⇒ Object

Returns the value of attribute lookup_context.



12
13
14
 
# File 'lib/action_view/renderer/renderer.rb', line 12

def lookup_context
  @lookup_context
end

Instance Method Details

#render(context, options) ⇒ Object

Main render entry point shared by AV and AC.



19
20
21
22
23
24
25
26
27
28
29
 
# File 'lib/action_view/renderer/renderer.rb', line 19

def render(context, options)
  if options.respond_to?(:permitted?) && !options.permitted?
    raise ArgumentError, "render parameters are not permitted"
  end

  if options.key?(:partial)
    render_partial(context, options)
  else
    render_template(context, options)
  end
end

#render_body(context, options) ⇒ Object

Render but returns a valid Rack body. If fibers are defined, we return a streaming body that renders the template piece by piece.

Note that partials are not supported to be rendered with streaming, so in such cases, we just wrap them in an array.



36
37
38
39
40
41
42
 
# File 'lib/action_view/renderer/renderer.rb', line 36

def render_body(context, options)
  if options.key?(:partial)
    [render_partial(context, options)]
  else
    StreamingTemplateRenderer.new(@lookup_context).render(context, options)
  end
end

#render_partial(context, options, &block) ⇒ Object

Direct access to partial rendering.



50
51
52
 
# File 'lib/action_view/renderer/renderer.rb', line 50

def render_partial(context, options, &block) #:nodoc:
  PartialRenderer.new(@lookup_context).render(context, options, block)
end

#render_template(context, options) ⇒ Object

Direct accessor to template rendering.



45
46
47
 
# File 'lib/action_view/renderer/renderer.rb', line 45

def render_template(context, options) #:nodoc:
  TemplateRenderer.new(@lookup_context).render(context, options)
end