Referência rápida

Guia de referência de internacionalização do Rails (i18n)

Guia rápido para Rails i18n: traduções, datas localizadas, pluralização, pesquisas com escopo e dicionários YAML.

· Publicado

O framework de Internacionalização (i18n) do Rails fornece localização de textos, números, moedas e datas por meio de catálogos YAML padrão.

Helpers Básicos de Tradução e Data

<!-- Traduzir uma chave -->
<%= t('welcome.title') %>

<!-- Busca com escopo preguiçoso baseada no controller/action atual -->
<!-- Em app/views/articles/index.html.erb: busca articles.index.heading -->
<%= t('.heading') %>

<!-- Localização de datas e horas -->
<%= l(Time.now, format: :short) %>
<%= l(Date.today, format: :long) %>

Interpolação de Variáveis e Pluralização

# config/locales/en.yml
en:
  greetings:
    hello: "Hello, %{name}!"
  inbox:
    unread_messages:
      one: "You have 1 unread message."
      other: "You have %{count} unread messages."
      zero: "You have no unread messages."

No template:

<%= t('greetings.hello', name: current_user.name) %>
<%= t('inbox.unread_messages', count: @unread_count) %>

Definir o Idioma Atual (Locale)

Em ApplicationController:

class ApplicationController < ActionController::Base
  before_action :set_locale

  private

  def set_locale
    I18n.locale = params[:locale] || I18n.default_locale
  end

  def default_url_options
    { locale: I18n.locale }
  end
end

Traduções de Modelos Active Record

en:
  activerecord:
    models:
      user: "Customer"
    attributes:
      user:
        email: "Email Address"
        role: "Account Role"

Nas visualizações:

<%= User.model_name.human %>
<!-- => "Customer" -->

<%= User.human_attribute_name(:email) %>
<!-- => "Email Address" -->

Referências

Temas relacionados