cbi18n
Search…
Coding for i18n
Now that you have completed the initialization of the i18n settings in the configuration file, you are ready to code for them. There are several methods that are available to all handlers, interceptors, layouts and views that deal with i18n via runtime mixins. You can use these methods directly or go to the services directly if you inject them.
Mapped Models
This module registers the following models in WireBox:
[email protected]: Helper with all kinds of methods for localization[email protected]: Service to interact with language resource bundles
Mixin Helpers
The module registers the following methods for handlers/layouts/views/interceptors:
1
/**
2
* Get the user's currently set locale or default locale according to settings
3
*/
4
function getFWLocale()
5
​
6
/**
7
* Set the locale for a specific user
8
* @locale The locale to set. Must be Java Style Standard: en_US, if empty it will default to the default locale
9
* @dontLoadRBFlag Flag to load the resource bundle for the specified locale (If not already loaded)
10
*
11
* @return i18n Service
12
*/
13
function setFWLocale( string locale="", boolean dontloadRBFlag=false )
14
​
15
/**
16
* Retrieve a resource from a resource bundle with replacements or auto-loading
17
* @resource The resource (key) to retrieve from the main loaded bundle.
18
* @defaultValue A default value to send back if the resource (key) not found
19
* @locale Pass in which locale to take the resource from. By default it uses the user's current set locale
20
* @values An array, struct or simple string of value replacements to use on the resource string
21
* @bundle The bundle alias to use to get the resource from when using multiple resource bundles. By default the bundle name used is 'default'
22
*/
23
function getResource(
24
required resource,
25
defaultValue,
26
locale,
27
values,
28
bundle,
29
)
30
​
31
// Alias to getResource
32
function $r()
33
​
34
/**
35
* Get Access to the i18n Model
36
*/
37
function i18n()
38
​
39
/**
40
* Get the resource service model
41
*/
42
function resourceService()
Copied!
Bundle Aliases
You can leverage the
getResource() or $r() method to retrieve resources from specific bundles by using the bundle argument or the @bundle convention.1
// Direct
2
#getResource( resource="common.ok", bundle="cbcore" )#
3
​
4
// Convention
5
#getResource( "[email protected]")#
Copied!
We do like our
@bundle convention as it looks prettier and you type a lot less.all bundles, including the default one, have names (aliases). If you want you can specify a resource in your default bundle as
Copied!
Examples
Here are some examples of usage
1
Your locale is #getFwLocale()#!
2
​
3
// localized button
4
#html.submitButton( value=getResource( 'btn.submit' ) )#
5
​
6
// Localized string with replacements via arrays
7
#html.h2( $r(resource="txt.hello", values=[ "Luis", "Majano" ] ) )#
8
​
9
// txt.hello resource
10
txt.hello="Hello Mr {1} {2}! I hope you have an awesome day Mr. {2}!"
11
​
12
// Localized string with replacements via structs
13
#html.h2( getResource(resource="txt.hello", values={ name="Luis", age="35" } ) )#
14
​
15
// txt.hello resource
16
txt.hello="Hello Mr {name}! You are {age} years old today!"
17
​
18
// Localized string from a bundle, notice the @cbcore alias
19
#getResource( '[email protected]' )#
20
​
21
// function change a user's locale
22
function changeLocale(event,rc,prc){
23
setFwlocale( rc.locale );
24
setNextEvent( 'home' );
25
}
Copied!
INFO Please note that the i18N services are singleton objects and lives throughout your entire application span.
You can place the
[email protected] service in the prc scope and then use this utility for i18n specific methods anywhere in your layouts and views, below is a simple example:1
<cfoutput >
2
<strong>Locale:</strong> <br />#prc.i18n.getFWLocale()#<br />
3
<strong>Language:</strong> <br />#prc.i18n.getFWLanguage()#<br />
4
<strong>Language Code:</strong> <br />#prc.i18n.getFWLanguageCode()#<br />
5
<strong>Language ISO3 Code:</strong> <br />#prc.i18n.getFWISO3LanguageCode()#<br />
6
​
7
​
8
<strong>Country:</strong> <br />#prc.i18n.getFWCountry()#<br />
9
<strong>Country Code:</strong> <br />#prc.i18n.getFWCountryCode()#<br />
10
<strong>Country ISO3 Code3:</strong> <br />#prc.i18n.getFWISO3CountryCode()#<br />
11
​
12
​
13
<strong>TimeZone:</strong> <br />#prc.i18n.getServerTZ()#<br />
14
<strong>i18nDateFormat:</strong> <br />#prc.i18n.i18nDateFormat(prc.i18n.toEpoch(now()),1)#<br />
15
<strong>i18nTimeFormat:</strong> <br />#prc.i18n.i18nTimeFormat(prc.i18n.toEpoch(now()),2)#<br />
16
<hr>
17
<strong>I18NUtilVersion:</strong> <br />#prc.i18n.getVersion().I18NUtilVersion#<br>
18
<strong>I18NUtilDate:</strong> <br />#prc.i18n.dateLocaleFormat(prc.i18n.getVersion().I18NUtilDate)#<br>
19
<strong>Java version:</strong> <br />#prc.i18n.getVersion().javaVersion#<br>
20
</cfoutput>
Copied!
INFO There are tons of great utility methods in the i18n service that will allow you to work with localization and internationalization. Please view them via the API Docs for the latest methods and arguments.
Last modified 10mo ago
Copy link
Edit on GitHub