модуль ActionView::Helpers::TranslationHelper

Включенные модули:: ActionView::Helpers::TagHelper

Публичные методы экземпляра

l(*args)

Псевдоним для: localize

Делегирует вызов I18n.localize без дополнительной функциональности.

См. rubydoc.info/github/svenfuchs/i18n/master/I18n/Backend/Base:localize для получения дополнительной информации.

# File actionview/lib/action_view/helpers/translation_helper.rb, line 86
def localize(*args)
  I18n.localize(*args)
end

Также является псевдонимом для: l

t(key, options = {})

Псевдоним для: translate

translate(key, options = {}) Показать исходный код

Делегирует вызов I18n#translate, но также выполняет три дополнительных функции.

Во-первых, она гарантирует, что любые сгенерированные сообщения MissingTranslation будут преобразованы во встроенные теги span, которые:

* have a "translation-missing" class set,
* contain the missing key as a title attribute and
* a titleized version of the last key segment as a text.

Например, значение, возвращаемое для отсутствующего ключа перевода «blog.post.title», будет <span class=«translation_missing» title=«translation missing: en.blog.post.title»>Заголовок</span>. Таким образом, ваши представления будут отображать достаточно осмысленные строки, но вы по-прежнему сможете легко найти отсутствующие переводы.

Во-вторых, она будет использовать область ключа текущей части, если ключ начинается с точки. Таким образом, если вы вызовете translate(".foo") из шаблона people/index.html.erb, вы фактически вызовете I18n.translate("people.index.foo"). Это делает перевод многих ключей в одной части менее повторяющимся и предоставляет простую структуру для их согласованного определения области. Если вы не добавляете точку в начало ключа, ничего не преобразуется.

В-третьих, она отметит перевод как безопасный HTML, если ключ имеет суффикс «_html» или последним элементом ключа является слово «html». Например, вызов translate(«footer_html») или translate(«footer.html») вернет безопасную строку HTML, которая не будет экранирована другими методами HTML-помощников. Это соглашение об именовании помогает идентифицировать переводы, содержащие теги HTML, так что вы знаете, какой результат ожидать при вызове translate в шаблоне.

# File actionview/lib/action_view/helpers/translation_helper.rb, line 37
def translate(key, options = {})
  options = options.dup
  has_default = options.has_key?(:default)
  remaining_defaults = Array(options.delete(:default)).compact

  if has_default && !remaining_defaults.first.kind_of?(Symbol)
    options[:default] = remaining_defaults.shift
  end

  # If the user has explicitly decided to NOT raise errors, pass that option to I18n.
  # Otherwise, tell I18n to raise an exception, which we rescue further in this method.
  # Note: `raise_error` refers to us re-raising the error in this method. I18n is forced to raise by default.
  if options[:raise] == false || (options.key?(:rescue_format) && options[:rescue_format].nil?)
    raise_error = false
    i18n_raise = false
  else
    raise_error = options[:raise] || options[:rescue_format] || ActionView::Base.raise_on_missing_translations
    i18n_raise = true
  end

  if html_safe_translation_key?(key)
    html_safe_options = options.dup
    options.except(*I18n::RESERVED_KEYS).each do |name, value|
      unless name == :count && value.is_a?(Numeric)
        html_safe_options[name] = ERB::Util.html_escape(value.to_s)
      end
    end
    translation = I18n.translate(scope_key_by_partial(key), html_safe_options.merge(raise: i18n_raise))

    translation.respond_to?(:html_safe) ? translation.html_safe : translation
  else
    I18n.translate(scope_key_by_partial(key), options.merge(raise: i18n_raise))
  end
rescue I18n::MissingTranslationData => e
  if remaining_defaults.present?
    translate remaining_defaults.shift, options.merge(default: remaining_defaults)
  else
    raise e if raise_error

    keys = I18n.normalize_keys(e.locale, e.key, e.options[:scope])
    content_tag('span', keys.last.to_s.titleize, :class => 'translation_missing', :title => "translation missing: #{keys.join('.')}")
  end
end

Также является псевдонимом для: t