I18n::Backend::Fallbacks

Public Instance Methods

extract_string_or_lambda_default!(options) click to toggle source
# File lib/i18n/backend/fallbacks.rb, line 54
def extract_string_or_lambda_default!(options)
  defaults = [options[:default]].flatten
  if index = find_first_string_or_lambda_default(defaults)
    options[:default] = defaults[0, index]
    defaults[index]
  end
end
find_first_string_or_lambda_default(defaults) click to toggle source
# File lib/i18n/backend/fallbacks.rb, line 62
def find_first_string_or_lambda_default(defaults)
  defaults.each_with_index { |default, ix| return ix if String === default || Proc === default }
  nil
end
translate(locale, key, options = {}) click to toggle source

Overwrites the Base backend translate method so that it will try each locale given by I18n.fallbacks for the given locale. E.g. for the locale :"de-DE" it might try the locales :"de-DE", :de and :en (depends on the fallbacks implementation) until it finds a result with the given options. If it does not find any result for any of the locales it will then throw MissingTranslation as usual.

The default option takes precedence over fallback locales only when it's a Symbol. When the default contains a String or a Proc it is evaluated last after all the fallback locales have been tried.

# File lib/i18n/backend/fallbacks.rb, line 37
def translate(locale, key, options = {})
  return super if options[:fallback]
  default = extract_string_or_lambda_default!(options) if options[:default]

  options[:fallback] = true
  I18n.fallbacks[locale].each do |fallback|
    catch(:exception) do
      result = super(fallback, key, options)
      return result unless result.nil?
    end
  end
  options.delete(:fallback)

  return super(locale, nil, options.merge(:default => default)) if default
  throw(:exception, I18n::MissingTranslation.new(locale, key, options))
end

[Validate]

Generated with the Darkfish Rdoc Generator 2.