Spec-Zone.ru › Ruby on Rails 4.2

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

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

Открытые методы экземпляра

l(*args)
Псевдоним для: localize
localize(*args) Показать исходный код
# File actionview/lib/action_view/helpers/translation_helper.rb, line 87
def localize(*args)
  I18n.localize(*args)
end

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

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

Также псевдоним для: l
t(key, options = {})
Псевдоним для: translate
translate(key, options = {}) Показать исходный код
# File actionview/lib/action_view/helpers/translation_helper.rb, line 38
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
  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

Делегирует вызов 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 в шаблоне.

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

© 2004–2018 David Heinemeier Hansson
Licensed under the MIT License.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API