Module: I18n::Backend::Fallbacks

Defined in:
lib/i18n/backend/fallbacks.rb

Instance Method Summary collapse

Instance Method Details

#exists?(locale, key, options = EMPTY_HASH) ⇒ Boolean

Returns:

  • (Boolean) 


106
107
108
109
110
111
112
113
114
115
116
117
 
# File 'lib/i18n/backend/fallbacks.rb', line 106

def exists?(locale, key, options = EMPTY_HASH)
  return super unless options.fetch(:fallback, true)
  I18n.fallbacks[locale].each do |fallback|
    begin
      return true if super(fallback, key, options)
    rescue I18n::InvalidLocale
      # we do nothing when the locale is invalid, as this is a fallback anyways.
    end
  end

  false
end

#extract_non_symbol_default!(options) ⇒ Object 



97
98
99
100
101
102
103
104
 
# File 'lib/i18n/backend/fallbacks.rb', line 97

def extract_non_symbol_default!(options)
  defaults = [options[:default]].flatten
  first_non_symbol_default = defaults.detect{|default| !default.is_a?(Symbol)}
  if first_non_symbol_default
    options[:default] = defaults[0, defaults.index(first_non_symbol_default)]
  end
  return first_non_symbol_default
end

#resolve_entry(locale, object, subject, options = EMPTY_HASH) ⇒ Object 



75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
 
# File 'lib/i18n/backend/fallbacks.rb', line 75

def resolve_entry(locale, object, subject, options = EMPTY_HASH)
  return subject if options[:resolve] == false
  result = catch(:exception) do
    options.delete(:fallback_in_progress) if options.key?(:fallback_in_progress)

    case subject
    when Symbol
      I18n.translate(subject, **options.merge(
        :locale => options[:fallback_original_locale],
        :throw => true,
        :skip_interpolation => true
      ))
    when Proc
      date_or_time = options.delete(:object) || object
      resolve_entry(options[:fallback_original_locale], object, subject.call(date_or_time, **options))
    else
      subject
    end
  end
  result unless result.is_a?(MissingTranslation)
end

#translate(locale, key, options = EMPTY_HASH) ⇒ Object

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, Proc or Hash it is evaluated last after all the fallback locales have been tried.



49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
 
# File 'lib/i18n/backend/fallbacks.rb', line 49

def translate(locale, key, options = EMPTY_HASH)
  return super unless options.fetch(:fallback, true)
  return super if options[:fallback_in_progress]
  default = extract_non_symbol_default!(options) if options[:default]

  fallback_options = options.merge(:fallback_in_progress => true, fallback_original_locale: locale)
  I18n.fallbacks[locale].each do |fallback|
    begin
      catch(:exception) do
        result = super(fallback, key, fallback_options)
        unless result.nil?
          on_fallback(locale, fallback, key, options) if locale.to_s != fallback.to_s
          return result
        end
      end
    rescue I18n::InvalidLocale
      # we do nothing when the locale is invalid, as this is a fallback anyways.
    end
  end

  return if options.key?(:default) && options[:default].nil?

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