Module: AbstractController::Translation

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

Instance Method Summary

#l(*args)

Alias for #localize.
#localize(*args) (also: #l)

Delegates to I18n.localize.
#t(key, options = {})

Alias for #translate.
#translate(key, options = {}) (also: #t)

Delegates to I18n.translate.

Instance Method Details

#l(*args)

Alias for #localize.

[ GitHub ]

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


alias :l :localize

#localize(*args) Also known as: #l

Delegates to I18n.localize. Also aliased as l.

[ GitHub ]

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


def localize(*args)
  I18n.localize(*args)
end

#t(key, options = {})

Alias for #translate.

[ GitHub ]

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


alias :t :translate

#translate(key, options = {}) Also known as: #t

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.

[ GitHub ]

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


def translate(key, options = {})
  if key.to_s.first == "."
    path = controller_path.tr("/", ".")
    defaults = [:"#{path}#{key}"]
    defaults << options[:default] if options[:default]
    options[:default] = defaults.flatten
    key = "#{path}.#{action_name}#{key}"
  end
  I18n.translate(key, options)
end