123456789_123456789_123456789_123456789_123456789_

Module: AbstractController::Translation

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Included In:
::ActionController::Base, ::ActionMailer::Base, ::ActionView::TestCase::TestController, Rails::ApplicationController, ::Rails::HealthController, Rails::InfoController, Rails::MailersController, Rails::WelcomeController
Defined in: actionpack/lib/abstract_controller/translation.rb

Instance Method Summary

Instance Method Details

#l(object, **options)

Alias for #localize.

[ GitHub ]

  
# File 'actionpack/lib/abstract_controller/translation.rb', line 41

alias :l :localize

#localize(object, **options) Also known as: #l

Delegates to I18n.localize.

[ GitHub ]

  
# File 'actionpack/lib/abstract_controller/translation.rb', line 38

def localize(object, **options)
  I18n.localize(object, **options)
end

#t(key, **options)

Alias for #translate.

[ GitHub ]

  
# File 'actionpack/lib/abstract_controller/translation.rb', line 35

alias :t :translate

#translate(key, **options) Also known as: #t

Delegates to I18n.translate.

When the given key starts with a period, it will be scoped by the current controller and action. So if you call translate(".foo") from PeopleController#index, it will convert the call to I18n.translate("people.index.foo"). This makes it less repetitive to translate many keys within the same controller / action and gives you a simple framework for scoping them consistently.

[ GitHub ]

  
# File 'actionpack/lib/abstract_controller/translation.rb', line 15

def translate(key, **options)
  if key&.start_with?(".")
    path = controller_path.tr("/", ".")
    defaults = [:"#{path}#{key}"]
    defaults << options[:default] if options[:default]
    options[:default] = defaults.flatten
    key = "#{path}.#{action_name}#{key}"
  end

  if ActiveSupport::HtmlSafeTranslation.html_safe_translation_key?(key)
    if options[:default]
      options[:default] = [options[:default]] unless options[:default].is_a?(Array)
      options[:default] = options[:default].map do |value|
        value.is_a?(String) ? ERB::Util.html_escape(value) : value
      end
    end
  end

  ActiveSupport::HtmlSafeTranslation.translate(key, **options)
end