ForgeComponents
en

Components

j-Locale

jComponent 20 · jcomponent@20 component Example loaded with jComponent 20

This component sets current browser locale (number format, date format and time format) according to the navigatior.language.

  • singleton
  • path will contain current's browser locale
  • sets DEF.dateformat and it creates environment value called [ts]

Configuration:

  • language {String} optional, a custom language (default: navigator.language)
  • requests {Boolean} optional, adds a language to the every request (it affects DEF.languagehtml, default: false)

Environments:

  • [ts] full timestamp
  • [date] only date
  • [time] only time

Output:

{
	dt: 'yyyy–MM–dd', // date format
	nf: 1,  // number format: 1 = 100 000.123, 2 = 100 000,123, 3 = 100.000,123, 4 = 100,000.123
	fdw: 0, // first day of week
	tf: 24  // time format: 12, 24
}

Methods:

  • component.use(language)

Supported special languages:

  • eu with the dd.MM.yyyy with a 24 hour system
  • us with the MM-dd-yyyy with a 12 hour system

Use it with <ui-component name="locale">. When the component is not loaded yet, jComponent downloads it on first use from the address in DEF.fallback (the Componentator CDN by default). Author: Peter Širka. Source: the Componentator components repository, MIT license.

example.html
<ui-component name="locale" path="mylocale"></ui-component>
<hr />
<pre><ui-bind path="mylocale" config="text:JSON.stringify(value, null, '  ')"></ui-bind></pre>
<ui-bind path="testvalue" config="template" class="mt10 block">
	<script type="text/html">
		<div>{{ value.date | format }}</div>
		<div>{{ value.date | format('[ts]') }}</div>
		<div>{{ value.number | format(2) }}</div>
	</script>
</ui-bind>

<script>
	var testvalue = { date: new Date(), number: 1234567.89 };
</script>