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::InfoController, Rails::MailersController, Rails::WelcomeController
Defined in: actionpack/lib/abstract_controller/translation.rb

Class Attribute Summary

Instance Attribute Summary

Instance Method Summary

Class Attribute Details

.raise_on_missing_translations (rw) Also known as: #raise_on_missing_translations

[ GitHub ] 

  


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



mattr_accessor :raise_on_missing_translations, default: false


  







Instance Attribute Details



  

    #raise_on_missing_translations   (rw)
  

  [ GitHub ]


  

  


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



mattr_accessor :raise_on_missing_translations, default: false


  







Instance Method Details



  

    #l(object, **options)  
  



  

    

Alias for #localize.


  



  [ GitHub ]


  

  


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



alias :l :localize


  








  

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



  

    

Delegates to I18n.localize. Also aliased as l.


  



  [ GitHub ]


  

  


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



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


  








  

    #t(key, **options)  
  



  

    

Alias for #translate.


  



  [ GitHub ]


  

  


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



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 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}"
  end

  i18n_raise = options.fetch(:raise, self.raise_on_missing_translations)
  I18n.translate(key, **options, raise: i18n_raise)
end