Module: AbstractController::Rendering

Extended by:
ActiveSupport::Concern
Includes:
ActionView::ViewPaths
Included in:
ActionMailer::Base
Defined in:
actionpack/lib/abstract_controller/rendering.rb

Constant Summary collapse

DEFAULT_PROTECTED_INSTANCE_VARIABLES =
%i(@_action_name @_response_body @_formats @_prefixes)

Instance Method Summary collapse

Methods included from ActiveSupport::Concern

append_features, class_methods, extended, included, prepend_features, prepended

Methods included from ActionView::ViewPaths

#_prefixes, #append_view_path, #details_for_lookup, #lookup_context, #prepend_view_path

Instance Method Details

#render(*args, &block) ⇒ Object

Normalizes arguments and options, and then delegates to render_to_body and sticks the result in self.response_body.

Supported options depend on the underlying render_to_body implementation.



25
26
27
28
29
30
31
32
33
34
35
# File 'actionpack/lib/abstract_controller/rendering.rb', line 25

def render(*args, &block)
  options = _normalize_render(*args, &block)
  rendered_body = render_to_body(options)
  if options[:html]
    _set_html_content_type
  else
    _set_rendered_content_type rendered_format
  end
  _set_vary_header
  self.response_body = rendered_body
end

#render_to_body(options = {}) ⇒ Object

Performs the actual template rendering.



49
50
# File 'actionpack/lib/abstract_controller/rendering.rb', line 49

def render_to_body(options = {})
end

#render_to_string(*args, &block) ⇒ Object

Similar to #render, but only returns the rendered template as a string, instead of setting self.response_body.

If a component extends the semantics of response_body (as ActionController extends it to be anything that responds to the method each), this method needs to be overridden in order to still return a string.



43
44
45
46
# File 'actionpack/lib/abstract_controller/rendering.rb', line 43

def render_to_string(*args, &block)
  options = _normalize_render(*args, &block)
  render_to_body(options)
end

#rendered_formatObject

Returns Content-Type of rendered content.



53
54
55
# File 'actionpack/lib/abstract_controller/rendering.rb', line 53

def rendered_format
  Mime[:text]
end

#view_assignsObject

This method should return a hash with assigns. You can overwrite this configuration per controller.



61
62
63
64
65
66
67
# File 'actionpack/lib/abstract_controller/rendering.rb', line 61

def view_assigns
  variables = instance_variables - _protected_ivars

  variables.each_with_object({}) do |name, hash|
    hash[name.slice(1, name.length)] = instance_variable_get(name)
  end
end