actionpack/lib/abstract_controller/translation.rb
# frozen_string_literal: true
# :markup: markdown
require "active_support/html_safe_translation"
module AbstractController
module Translation
# 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.
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 options[:default] && ActiveSupport::HtmlSafeTranslation.html_safe_translation_key?(key)
options[:default] = Array(options[:default]).map do |value|
value.is_a?(String) ? ERB::Util.html_escape(value) : value
end
end
ActiveSupport::HtmlSafeTranslation.translate(key, **options)
end
alias :t :translate
# Delegates to `I18n.localize`.
def localize(object, **options)
I18n.localize(object, **options)
end
alias :l :localize
end
end