Module: Undercarriage::Controllers::LocaleConcern

Extended by:
ActiveSupport::Concern
Defined in:
lib/undercarriage/controllers/locale_concern.rb

Overview

Identify locale for translations

Identify locale based on ‘HTTP_ACCEPT_LANGUAGE`. Browser preferred language is passed with the request as `en-US, en;q=0.9` where `en-US` (English with US dialect) is the preferred language with `en` (generic English) as an acceptable language.

When preferred language cannot be identified or no translation is available, fall back to ‘I18n.default_locale` (typically `en`).

Usage

class ExamplesController < ApplicationController
  include Undercarriage::Controllers::LocaleConcern
end

Instance Method Summary collapse

Instance Method Details

#html_dir ⇒ Object

Text direction

Helper for Views to return text direction based on locale. Display text left-to-right for all languages but a few languages which should display as right-to-left. Returns ‘rtl` for the following languages:

  • Arabic

  • Aramaic

  • Azeri

  • Divehi

  • Hebrew

  • Persian/Farsi

  • Urdu

Usage

<html dir="<%= html_dir %>"> #=> <html dir="ltr">
<html dir="<%= html_dir %>"> #=> <html dir="rtl">



61
62
63
64
65
 
# File 'lib/undercarriage/controllers/locale_concern.rb', line 61

def html_dir
  rtl_languages = %w[am ar az dv fa he ur]

  html_lang.start_with?(*rtl_languages) ? 'rtl' : 'ltr'
end

#html_lang ⇒ Object

Lang

Helper for Views to return the identified language.

Usage

<html lang="<%= html_lang %>"> #=> '<html lang="de">'
<html lang="<%= html_lang %>"> #=> '<html lang="de-at">'



39
40
41
 
# File 'lib/undercarriage/controllers/locale_concern.rb', line 39

def html_lang
  I18n.locale.to_s
end