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
-
#l(object, **options)
Alias for #localize.
-
#localize(object, **options)
(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(object, **options)
Alias for #localize.
# File 'actionpack/lib/abstract_controller/translation.rb', line 41
alias :l :localize
#localize(object, **options) Also known as: #l
Delegates to I18n.localize
.
# File 'actionpack/lib/abstract_controller/translation.rb', line 38
def localize(object, ** ) I18n.localize(object, ** ) end
#t(key, **options)
Alias for #translate.
# 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.
# File 'actionpack/lib/abstract_controller/translation.rb', line 15
def translate(key, ** ) if key&.start_with?(".") path = controller_path.tr("/", ".") defaults = [:"#{path}#{key}"] defaults << [:default] if [:default] [:default] = defaults.flatten key = "#{path}.#{action_name}#{key}" end if ActiveSupport::HtmlSafeTranslation.html_safe_translation_key?(key) if [:default] [:default] = [ [:default]] unless [:default].is_a?(Array) [:default] = [:default].map do |value| value.is_a?(String) ? ERB::Util.html_escape(value) : value end end end ActiveSupport::HtmlSafeTranslation.translate(key, ** ) end