Using Globalize
Documentation
DevExtreme widgets can be localized by means of Globalize. You need to link Globalize modules, CLDR scripts, and DevExtreme dictionaries for desired locales (see the <head> tag of index.html). Then, load CLDR data for the same locales (see index.js). Using Angular, Vue and React, get all the needed components as imported modules instead (see app.component.ts, App.vue and App.js correspondingly). Finally, set the current locale with the Globalize.locale method.
Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you!
We appreciate your feedback.
We appreciate your feedback.
<div id="data-grid-demo">
<dx-data-grid [dataSource]="payments"
(onInitialized)="onInitialized($event)">
<dxi-column dataField="PaymentId"
[caption]="formatMessage('Number')"
[allowEditing]="false"
width="100">
</dxi-column>
<dxi-column dataField="ContactName"
[caption]="formatMessage('Contact')">
</dxi-column>
<dxi-column dataField="CompanyName"
[caption]="formatMessage('Company')">
</dxi-column>
<dxi-column dataField="Amount"
[caption]="formatMessage('Amount')"
dataType="number"
format="currency">
</dxi-column>
<dxi-column dataField="PaymentDate"
[caption]="formatMessage('PaymentDate')"
dataType="date">
</dxi-column>
<dxo-filter-row [visible]="true"
[applyFilter]="auto">
</dxo-filter-row>
<dxo-editing mode="popup"
[allowUpdating]="true">
<dxo-popup [width]="700"
[height]="345">
</dxo-popup>
</dxo-editing>
</dx-data-grid>
<div class="options">
<div class="caption">Options</div>
<div class="option">
<label for="selectInput">Language</label>
<dx-select-box id="selectBox"
[dataSource]="locales"
displayExpr="Name"
valueExpr="Value"
[value]=locale
(onValueChanged)="changeLocale($event)"
[inputAttr]="{id: 'selectInput'}">
</dx-select-box>
</div>
</div>
</div>
import { NgModule, Component, enableProdMode } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import { DxSelectBoxModule, DxDataGridModule } from 'devextreme-angular';
import { Locale, Payment, Service } from './app.service';
import 'devextreme/localization/globalize/number';
import 'devextreme/localization/globalize/date';
import 'devextreme/localization/globalize/currency';
import 'devextreme/localization/globalize/message';
import deMessages from 'npm:devextreme/localization/messages/de.json!json';
import ruMessages from 'npm:devextreme/localization/messages/ru.json!json';
import deCldrData from 'npm:devextreme-cldr-data/de.json!json';
import ruCldrData from 'npm:devextreme-cldr-data/ru.json!json';
import supplementalCldrData from 'npm:devextreme-cldr-data/supplemental.json!json';
import Globalize from 'globalize';
if(!/localhost/.test(document.location.host)) {
enableProdMode();
}
@Component({
selector: 'demo-app',
templateUrl: 'app/app.component.html',
styleUrls: ['app/app.component.css'],
providers: [Service],
preserveWhitespaces: true
})
export class AppComponent {
locale: string;
locales: Locale[];
payments: Payment[];
formatMessage = Globalize.formatMessage.bind(Globalize);
constructor(private service: Service) {
this.locale = this.getLocale();
this.payments = service.getPayments();
this.locales = service.getLocales();
this.initGlobalize();
Globalize.locale(this.locale);
}
initGlobalize() {
Globalize.load(
deCldrData,
ruCldrData,
supplementalCldrData
);
Globalize.loadMessages(deMessages);
Globalize.loadMessages(ruMessages);
Globalize.loadMessages(this.service.getDictionary());
}
changeLocale(data) {
this.setLocale(data.value);
parent.document.location.reload();
}
getLocale() {
var locale = sessionStorage.getItem("locale");
return locale != null ? locale : "en";
}
setLocale(locale) {
sessionStorage.setItem("locale", locale);
}
onInitialized(e) {
e.component.columnOption("Amount", {
editorOptions: {
format: "currency",
showClearButton: true
}
});
}
}
@NgModule({
imports: [
BrowserModule,
DxSelectBoxModule,
DxDataGridModule
],
declarations: [AppComponent],
bootstrap: [AppComponent]
})
export class AppModule { }
platformBrowserDynamic().bootstrapModule(AppModule);
::ng-deep .options {
padding: 20px;
background-color: rgba(191, 191, 191, 0.15);
margin-top: 20px;
}
::ng-deep .option {
margin-top: 10px;
}
::ng-deep .caption {
font-size: 18px;
font-weight: 500;
}
::ng-deep .option > label {
margin-right: 10px;
}
::ng-deep .option > .dx-selectbox {
display: inline-block;
vertical-align: middle;
}
import { Injectable } from '@angular/core';
export class Locale {
Name: string;
Value: string;
}
let locales: Locale[] = [{
"Name": "English",
"Value": "en"
}, {
"Name": "Deutsch",
"Value": "de"
}, {
"Name": "Русский",
"Value": "ru"
}];
export class Payment {
PaymentId: number;
ContactName: string;
CompanyName: string;
Amount: number;
PaymentDate: string;
}
let payments: Payment[] = [{
"PaymentId": 1,
"ContactName": "Nancy Davolio",
"CompanyName": "Premier Buy",
"Amount": 1740,
"PaymentDate": "2013/01/06"
},
{
"PaymentId": 2,
"ContactName": "Andrew Fuller",
"CompanyName": "ElectrixMax",
"Amount": 850,
"PaymentDate": "2013/01/13"
},
{
"PaymentId": 3,
"ContactName": "Janet Leverling",
"CompanyName": "Video Emporium",
"Amount": 2235,
"PaymentDate": "2013/01/07"
},
{
"PaymentId": 4,
"ContactName": "Margaret Peacock",
"CompanyName": "Screen Shop",
"Amount": 1965,
"PaymentDate": "2013/01/03"
},
{
"PaymentId": 5,
"ContactName": "Steven Buchanan",
"CompanyName": "Braeburn",
"Amount": 880,
"PaymentDate": "2013/01/10"
},
{
"PaymentId": 6,
"ContactName": "Michael Suyama",
"CompanyName": "PriceCo",
"Amount": 5260,
"PaymentDate": "2013/01/17"
},
{
"PaymentId": 7,
"ContactName": "Robert King",
"CompanyName": "Ultimate Gadget",
"Amount": 2790,
"PaymentDate": "2013/01/21"
},
{
"PaymentId": 8,
"ContactName": "Laura Callahan",
"CompanyName": "EZ Stop",
"Amount": 3140,
"PaymentDate": "2013/01/01"
},
{
"PaymentId": 9,
"ContactName": "Anne Dodsworth",
"CompanyName": "Clicker",
"Amount": 6175,
"PaymentDate": "2013/01/24"
},
{
"PaymentId": 10,
"ContactName": "Clark Morgan",
"CompanyName": "Store of America",
"Amount": 4575,
"PaymentDate": "2013/01/11"
}];
export class PaymentView {
Number: string;
Contact: string;
Company: string;
Amount: string;
PaymentDate: string;
}
export class Dictionary {
[key: string]: PaymentView;
}
let dictionary: Dictionary = {
"en": {
"Number": "Number",
"Contact": "Contact",
"Company": "Company",
"Amount": "Amount",
"PaymentDate": "Payment Date"
},
"de": {
"Number": "Nummer",
"Contact": "Ansprechpartner",
"Company": "Firma",
"Amount": "Betrag",
"PaymentDate": "Zahlungsdatum"
},
"ru": {
"Number": "Номер",
"Contact": "Имя",
"Company": "Организация",
"Amount": "Сумма",
"PaymentDate": "Дата оплаты"
}
};
@Injectable()
export class Service {
getPayments() {
return payments;
}
getLocales() {
return locales;
}
getDictionary() {
return dictionary;
}
}
// In real applications, you should not transpile code in the browser. You can see how to create your own application with Angular and DevExtreme here:
// https://github.com/DevExpress/devextreme-angular/blob/master/README.md
System.config({
transpiler: 'ts',
typescriptOptions: {
module: "system",
emitDecoratorMetadata: true,
experimentalDecorators: true
},
meta: {
'typescript': {
"exports": "ts"
}
},
paths: {
'npm:': 'https://unpkg.com/'
},
map: {
'ts': 'npm:plugin-typescript@8.0.0/lib/plugin.js',
'typescript': 'npm:typescript@3.4.5/lib/typescript.js',
'@angular/core': 'npm:@angular/core@8.0.0/bundles/core.umd.js',
'@angular/common': 'npm:@angular/common@8.0.0/bundles/common.umd.js',
'@angular/compiler': 'npm:@angular/compiler@8.0.0/bundles/compiler.umd.js',
'@angular/platform-browser': 'npm:@angular/platform-browser@8.0.0/bundles/platform-browser.umd.js',
'@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic@8.0.0/bundles/platform-browser-dynamic.umd.js',
'@angular/router': 'npm:@angular/router@8.0.0/bundles/router.umd.js',
'@angular/forms': 'npm:@angular/forms@8.0.0/bundles/forms.umd.js',
'@angular/common/http': 'npm:@angular/common@8.0.0/bundles/common-http.umd.js',
'tslib': 'npm:tslib/tslib.js',
'rxjs': 'npm:rxjs@6.3.3',
'rxjs/operators': 'npm:rxjs@6.3.3/operators',
'devextreme': 'npm:devextreme@19.1',
'jszip': 'npm:jszip@3.1.3/dist/jszip.min.js',
'quill': 'npm:quill@1.3.6/dist/quill.js',
'devexpress-diagram': 'npm:devexpress-diagram',
'devextreme-angular': 'npm:devextreme-angular@19.1',
'devextreme-cldr-data': 'npm:devextreme-cldr-data',
'globalize': 'npm:globalize/dist/globalize',
'cldr': 'npm:cldrjs/dist/cldr',
'cldr-data': '../../../../js/cldr',
'json': 'npm:systemjs-plugin-json/json.js'
},
packages: {
'app': {
main: './app.component.ts',
defaultExtension: 'ts'
},
'devextreme': {
defaultExtension: 'js'
},
'rxjs': { main: 'index.js', defaultExtension: 'js' },
'rxjs/operators': { main: 'index.js', defaultExtension: 'js' },
'devextreme-angular': {
main: 'index.js',
defaultExtension: 'js'
},
'globalize': {
main: '../globalize.js',
defaultExtension: 'js'
},
'cldr': {
main: '../cldr.js',
defaultExtension: 'js'
}
}
});
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>DevExtreme Demo</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/19.1.5/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/19.1.5/css/dx.light.css" />
<script src="https://unpkg.com/core-js@2.4.1/client/shim.min.js"></script>
<script src="https://unpkg.com/zone.js@0.6.25/dist/zone.js"></script>
<script src="https://unpkg.com/reflect-metadata@0.1.3/Reflect.js"></script>
<script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script>
<script src="config.js"></script>
<script>
System.import('app').catch(console.error.bind(console));
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<demo-app>Loading...</demo-app>
</div>
</body>
</html>