Alias for localize
Delegates to I18n.localize with no additional functionality.
[ show source ]
# File actionpack/lib/action_view/helpers/translation_helper.rb, line 37
37: def localize(*args)
38: I18n.localize(*args)
39: end
Alias for translate
Delegates to I18n#translate but also performs two additional functions. First, it‘ll catch MissingTranslationData exceptions and turn them into inline spans that contains the missing key, such that you can see in a view what is missing where.
Second, it‘ll scope the key by the current partial if the key starts with a period. So if you call translate(".foo") from the people/index.html.erb template, you‘ll actually be calling I18n.translate("people.index.foo"). This makes it less repetitive to translate many keys within the same partials and gives you a simple framework for scoping them consistently. If you don‘t prepend the key with a period, nothing is converted.
[ show source ]
# File actionpack/lib/action_view/helpers/translation_helper.rb, line 13
13: def translate(keys, options = {})
14: if multiple_keys = keys.is_a?(Array)
15: ActiveSupport::Deprecation.warn "Giving an array to translate is deprecated, please give a symbol or a string instead", caller
16: end
17:
18: options[:raise] = true
19: keys = scope_keys_by_partial(keys)
20:
21: translations = I18n.translate(keys, options)
22: translations = [translations] if !multiple_keys && translations.size > 1
23: translations = html_safe_translation_keys(keys, translations)
24:
25: if multiple_keys || translations.size > 1
26: translations
27: else
28: translations.first
29: end
30: rescue I18n::MissingTranslationData => e
31: keys = I18n.send(:normalize_translation_keys, e.locale, e.key, e.options[:scope])
32: content_tag('span', keys.join(', '), :class => 'translation_missing')
33: end