Module: AbstractController::Rendering

Extended by:
ActiveSupport::Concern
Includes:
ViewPaths
Included in:
Layouts, ActionController::Rendering, ActionController::Streaming, ActionMailer::Base
Defined in:
actionpack/lib/abstract_controller/rendering.rb

Defined Under Namespace

Modules: ClassMethods

Constant Summary collapse

DEFAULT_PROTECTED_INSTANCE_VARIABLES = 
%w(
@_action_name @_response_body @_formats @_prefixes @_config
@_view_context_class @_view_renderer @_lookup_context

Instance Method Summary collapse

Methods included from ActiveSupport::Concern

append_features, extended, included

Methods included from ViewPaths

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

Instance Method Details

#_render_template(options) ⇒ Object

Find and renders a template based on the options given. :api: private



108
109
110
111
 
# File 'actionpack/lib/abstract_controller/rendering.rb', line 108

def _render_template(options) #:nodoc:
  lookup_context.rendered_format = nil if options[:formats]
  view_renderer.render(view_context, options)
end

#process ⇒ Object

Overwrite process to setup I18n proxy.



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

def process(*) #:nodoc:
  old_config, I18n.config = I18n.config, I18nProxy.new(I18n.config, lookup_context)
  super
ensure
  I18n.config = old_config
end

#render(*args, &block) ⇒ Object

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



86
87
88
89
 
# File 'actionpack/lib/abstract_controller/rendering.rb', line 86

def render(*args, &block)
  options = _normalize_render(*args, &block)
  self.response_body = render_to_body(options)
end

#render_to_body(options = {}) ⇒ Object

Raw rendering of a template to a Rack-compatible body. :api: plugin



101
102
103
104
 
# File 'actionpack/lib/abstract_controller/rendering.rb', line 101

def render_to_body(options = {})
  _process_options(options)
  _render_template(options)
end

#render_to_string(*args, &block) ⇒ Object

Raw rendering of a template to a string. Just convert the results of render_response into a String. :api: plugin



94
95
96
97
 
# File 'actionpack/lib/abstract_controller/rendering.rb', line 94

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

#view_assigns ⇒ Object

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



121
122
123
124
125
126
127
128
 
# File 'actionpack/lib/abstract_controller/rendering.rb', line 121

def view_assigns
  hash = {}
  variables  = instance_variable_names
  variables -= protected_instance_variables
  variables -= DEFAULT_PROTECTED_INSTANCE_VARIABLES
  variables.each { |name| hash[name.to_s[1, name.length]] = instance_variable_get(name) }
  hash
end

#view_context ⇒ Object

An instance of a view class. The default view class is ActionView::Base

The view class must have the following methods: View.new[lookup_context, assigns, controller]

Create a new ActionView instance for a controller

View#render

Returns String with the rendered template

Override this method in a module to change the default behavior.



75
76
77
 
# File 'actionpack/lib/abstract_controller/rendering.rb', line 75

def view_context
  view_context_class.new(view_renderer, view_assigns, self)
end

#view_context_class ⇒ Object 



62
63
64
 
# File 'actionpack/lib/abstract_controller/rendering.rb', line 62

def view_context_class
  @_view_context_class ||= self.class.view_context_class
end

#view_renderer ⇒ Object

Returns an object that is able to render templates.



80
81
82
 
# File 'actionpack/lib/abstract_controller/rendering.rb', line 80

def view_renderer
  @_view_renderer ||= ActionView::Renderer.new(lookup_context)
end