Class: ActionView::LookupContext

Inherits:
Object
  • Object
show all
Includes:
Accessors, DetailsCache, ViewPaths
Defined in:
actionview/lib/action_view/lookup_context.rb

Overview

Action View Lookup Context

LookupContext is the object responsible to hold all information required to lookup templates, i.e. view paths and details. The LookupContext is also responsible to generate a key, given to view paths, used in the resolver cache lookup. Since this key is generated just once during the request, it speeds up all cache accesses.

Defined Under Namespace

Modules: Accessors, DetailsCache, ViewPaths Classes: DetailsKey

Constant Summary collapse

@@fallbacks =
FallbackFileSystemResolver.instances

Instance Attribute Summary collapse

Attributes included from ViewPaths

#html_fallback_for_js, #view_paths

Attributes included from DetailsCache

#cache

Class Method Summary collapse

Instance Method Summary collapse

Methods included from ViewPaths

#exists?, #find, #find_all, #with_fallbacks

Methods included from DetailsCache

#details_key, #disable_cache

Constructor Details

#initialize(view_paths, details = {}, prefixes = []) ⇒ LookupContext

Returns a new instance of LookupContext


178
179
180
181
182
183
184
185
186
187
# File 'actionview/lib/action_view/lookup_context.rb', line 178

def initialize(view_paths, details = {}, prefixes = [])
  @details, @details_key = {}, nil
  @skip_default_locale = false
  @cache = true
  @prefixes = prefixes
  @rendered_format = nil

  self.view_paths = view_paths
  initialize_details(details)
end

Instance Attribute Details

#prefixesObject

Returns the value of attribute prefixes


13
14
15
# File 'actionview/lib/action_view/lookup_context.rb', line 13

def prefixes
  @prefixes
end

#rendered_formatObject

Returns the value of attribute rendered_format


13
14
15
# File 'actionview/lib/action_view/lookup_context.rb', line 13

def rendered_format
  @rendered_format
end

Class Method Details

.register_detail(name, options = {}, &block) ⇒ Object


21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# File 'actionview/lib/action_view/lookup_context.rb', line 21

def self.register_detail(name, options = {}, &block)
  self.registered_details << name
  initialize = registered_details.map { |n| "@details[:#{n}] = details[:#{n}] || default_#{n}" }

  Accessors.send :define_method, :"default_#{name}", &block
  Accessors.module_eval <<-METHOD, __FILE__, __LINE__ + 1
    def #{name}
      @details.fetch(:#{name}, [])
    end

    def #{name}=(value)
      value = value.present? ? Array(value) : default_#{name}
      _set_detail(:#{name}, value) if value != @details[:#{name}]
    end

    remove_possible_method :initialize_details
    def initialize_details(details)
      #{initialize.join("\n")}
    end
  METHOD
end

Instance Method Details

#formats=(values) ⇒ Object

Override formats= to expand [“/”] values and automatically add :html as fallback to :js.


191
192
193
194
195
196
197
198
199
200
# File 'actionview/lib/action_view/lookup_context.rb', line 191

def formats=(values)
  if values
    values.concat(default_formats) if values.delete "*/*"
    if values == [:js]
      values << :html
      @html_fallback_for_js = true
    end
  end
  super(values)
end

#localeObject

Override locale to return a symbol instead of array.


209
210
211
# File 'actionview/lib/action_view/lookup_context.rb', line 209

def locale
  @details[:locale].first
end

#locale=(value) ⇒ Object

Overload locale= to also set the I18n.locale. If the current I18n.config object responds to original_config, it means that it's has a copy of the original I18n configuration and it's acting as proxy, which we need to skip.


216
217
218
219
220
221
222
223
# File 'actionview/lib/action_view/lookup_context.rb', line 216

def locale=(value)
  if value
    config = I18n.config.respond_to?(:original_config) ? I18n.config.original_config : I18n.config
    config.locale = value
  end

  super(@skip_default_locale ? I18n.locale : default_locale)
end

#skip_default_locale!Object

Do not use the default locale on template lookup.


203
204
205
206
# File 'actionview/lib/action_view/lookup_context.rb', line 203

def skip_default_locale!
  @skip_default_locale = true
  self.locale = nil
end

#with_layout_formatObject

A method which only uses the first format in the formats array for layout lookup.


226
227
228
229
230
231
232
233
234
235
236
237
238
239
# File 'actionview/lib/action_view/lookup_context.rb', line 226

def with_layout_format
  if formats.size == 1
    yield
  else
    old_formats = formats
    _set_detail(:formats, formats[0,1])

    begin
      yield
    ensure
      _set_detail(:formats, old_formats)
    end
  end
end