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 for holding all information required for looking up templates, i.e. view paths and details. LookupContext is also responsible for generating a key, given to view paths, used in the resolver cache lookup. Since this key is generated only 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

Constants included from Accessors

Accessors::DEFAULT_PROCS

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

#any?, #exists?, #find, #find_all, #find_file, #with_fallbacks

Methods included from DetailsCache

#details_key, #disable_cache

Constructor Details

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

Returns a new instance of LookupContext.


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

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

  @details = initialize_details({}, details)
  self.view_paths = view_paths
end

Instance Attribute Details

#prefixesObject

Returns the value of attribute prefixes


15
16
17
# File 'actionview/lib/action_view/lookup_context.rb', line 15

def prefixes
  @prefixes
end

#rendered_formatObject

Returns the value of attribute rendered_format


15
16
17
# File 'actionview/lib/action_view/lookup_context.rb', line 15

def rendered_format
  @rendered_format
end

Class Method Details

.register_detail(name, &block) ⇒ Object


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

def self.register_detail(name, &block)
  self.registered_details << name
  Accessors::DEFAULT_PROCS[name] = block

  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
  METHOD
end

Instance Method Details

#digest_cacheObject


238
239
240
# File 'actionview/lib/action_view/lookup_context.rb', line 238

def digest_cache
  details_key.digest_cache
end

#formats=(values) ⇒ Object

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


252
253
254
255
256
257
258
259
260
261
# File 'actionview/lib/action_view/lookup_context.rb', line 252

def formats=(values)
  if values
    values.concat(default_formats) if values.delete "*/*".freeze
    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.


264
265
266
# File 'actionview/lib/action_view/lookup_context.rb', line 264

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 has a copy of the original I18n configuration and it's acting as proxy, which we need to skip.


271
272
273
274
275
276
277
278
# File 'actionview/lib/action_view/lookup_context.rb', line 271

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

  super(default_locale)
end