/Ruby on Rails 7.0

module AbstractController::Translation

Public Instance Methods

l(object, **options)
Alias for: localize
localize(object, **options) Show source
# File actionpack/lib/abstract_controller/translation.rb, line 33
def localize(object, **options)
  I18n.localize(object, **options)

Delegates to I18n.localize. Also aliased as l.

Also aliased as: l
t(key, **options)
Alias for: translate
translate(key, **options) Show source
# File actionpack/lib/abstract_controller/translation.rb, line 17
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}"

  i18n_raise = options.fetch(:raise, self.raise_on_missing_translations)

  ActiveSupport::HtmlSafeTranslation.translate(key, **options, raise: i18n_raise)

Delegates to I18n.translate. Also aliased as t.

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.

Also aliased as: t

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