DevExtreme v24.2 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

Angular Localization - Using Intl

DevExtreme supports localization via Intl API. To apply localization, link or import dictionaries and set the locale with the DevExpress.localization.locale() method. Refer to the Localization article for more information on localization properties.

Backend API
<div id="data-grid-demo"> <dx-data-grid [dataSource]="payments"> <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" [editorOptions]="{ format: 'currency', showClearButton: true, inputAttr: { 'aria-label': 'Filter cell' } }" > </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" [inputAttr]="{ 'aria-label': 'Language' }" 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, loadMessages, formatMessage } from 'devextreme/localization'; import deMessages from 'npm:devextreme/localization/messages/de.json!json'; import ruMessages from 'npm:devextreme/localization/messages/ru.json!json'; import { Locale, Payment, Service } from './app.service'; 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 = formatMessage; constructor(private service: Service) { this.locale = this.getLocale(); this.payments = service.getPayments(); this.locales = service.getLocales(); this.initMessages(); locale(this.locale); } initMessages() { loadMessages(deMessages); loadMessages(ruMessages); loadMessages(this.service.getDictionary()); } changeLocale(data) { this.setLocale(data.value); parent.document.location.reload(); } getLocale() { const locale = sessionStorage.getItem('locale'); return locale != null ? locale : 'en'; } setLocale(locale) { sessionStorage.setItem('locale', locale); } } @NgModule({ imports: [ BrowserModule, DxSelectBoxModule, DxDataGridModule, ], declarations: [AppComponent], bootstrap: [AppComponent], }) export class AppModule { } platformBrowserDynamic().bootstrapModule(AppModule);
.options { padding: 20px; background-color: rgba(191, 191, 191, 0.15); margin-top: 20px; } .option { margin-top: 10px; } .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; } const 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; } const 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; } const 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://js.devexpress.com/Documentation/Guide/Angular_Components/Getting_Started/Create_a_DevExtreme_Application/ const componentNames = [ 'accordion', 'action-sheet', 'autocomplete', 'bar-gauge', 'box', 'bullet', 'button-group', 'button', 'calendar', 'chart', 'chat', 'check-box', 'circular-gauge', 'color-box', 'context-menu', 'data-grid', 'date-box', 'date-range-box', 'defer-rendering', 'diagram', 'draggable', 'drawer', 'drop-down-box', 'drop-down-button', 'file-manager', 'file-uploader', 'filter-builder', 'form', 'funnel', 'gallery', 'gantt', 'html-editor', 'linear-gauge', 'list', 'load-indicator', 'load-panel', 'lookup', 'map', 'menu', 'multi-view', 'nested', 'number-box', 'pagination', 'pie-chart', 'pivot-grid-field-chooser', 'pivot-grid', 'polar-chart', 'popover', 'popup', 'progress-bar', 'radio-group', 'range-selector', 'range-slider', 'recurrence-editor', 'resizable', 'responsive-box', 'sankey', 'scheduler', 'scroll-view', 'select-box', 'slider', 'sortable', 'sparkline', 'speed-dial-action', 'splitter', 'switch', 'tab-panel', 'tabs', 'tag-box', 'text-area', 'text-box', 'tile-view', 'toast', 'toolbar', 'tooltip', 'tree-list', 'tree-map', 'tree-view', 'validation-group', 'validation-summary', 'validator', 'vector-map', ]; window.exports = window.exports || {}; window.config = { transpiler: 'ts', typescriptOptions: { module: 'system', emitDecoratorMetadata: true, experimentalDecorators: true, }, meta: { 'typescript': { 'exports': 'ts', }, 'devextreme/time_zone_utils.js': { 'esModule': true, }, 'devextreme/localization.js': { 'esModule': true, }, 'devextreme/viz/palette.js': { 'esModule': true, }, '@angular/platform-browser-dynamic': { 'esModule': true, }, '@angular/platform-browser': { 'esModule': true, }, '@angular/core': { 'esModule': true, }, '@angular/common': { 'esModule': true, }, '@angular/common/http': { 'esModule': true, }, '@angular/animations': { 'esModule': true, }, '@angular/forms': { 'esModule': true, }, 'openai': { 'esModule': true, }, }, paths: { 'npm:': 'https://unpkg.com/', 'bundles:': '../../../../bundles/', 'externals:': '../../../../bundles/externals/', }, map: { 'ts': 'npm:plugin-typescript@8.0.0/lib/plugin.js', 'typescript': 'npm:typescript@4.2.4/lib/typescript.js', 'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js', /* @angular */ '@angular/compiler': 'bundles:@angular/compiler.umd.js', '@angular/platform-browser-dynamic': 'bundles:@angular/platform-browser-dynamic.umd.js', '@angular/core': 'bundles:@angular/core.umd.js', '@angular/core/primitives/signals': 'bundles:@angular/core.primitives.signals.umd.js', '@angular/common': 'bundles:@angular/common.umd.js', '@angular/common/http': 'bundles:@angular/common-http.umd.js', '@angular/platform-browser': 'bundles:@angular/platform-browser.umd.js', '@angular/platform-browser/animations': 'bundles:@angular/platform-browser.umd.js', '@angular/forms': 'bundles:@angular/forms.umd.js', /* devextreme */ 'devextreme': 'npm:devextreme@link:../../packages/devextreme/artifacts/npm/devextreme/cjs', '@devextreme/runtime': 'npm:@devextreme/runtime@3.0.12', 'devextreme/bundles/dx.all': 'npm:devextreme@link:../../packages/devextreme/artifacts/npm/devextreme/bundles/dx.all.js', 'devextreme-quill': 'npm:devextreme-quill@1.7.1/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.5', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.54', /* devextreme-angular umd maps */ 'devextreme-angular': 'bundles:devextreme-angular/devextreme-angular.umd.js', 'devextreme-angular/core': 'bundles:devextreme-angular/devextreme-angular-core.umd.js', 'devextreme-angular/http': 'bundles:devextreme-angular/devextreme-angular-http.umd.js', ...componentNames.reduce((acc, name) => { acc[`devextreme-angular/ui/${name}`] = `bundles:devextreme-angular/devextreme-angular-ui-${name}.umd.js`; acc[`devextreme-angular/ui/${name}/nested`] = `bundles:devextreme-angular/devextreme-angular-ui-${name}-nested.umd.js`; return acc; }, {}), 'tslib': 'npm:tslib/tslib.js', 'rxjs': 'npm:rxjs@7.5.3/dist/bundles/rxjs.umd.js', 'rxjs/operators': 'npm:rxjs@7.5.3/dist/cjs/operators/index.js', 'json': 'npm:systemjs-plugin-json@0.3.0/json.js', 'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js', 'luxon': 'npm:luxon@3.4.4/build/global/luxon.min.js', 'es6-object-assign': 'npm:es6-object-assign', 'inferno': 'npm:inferno@7.4.11/dist/inferno.min.js', 'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js', 'inferno-create-element': 'npm:inferno-create-element@7.4.11/dist/inferno-create-element.min.js', 'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js', 'inferno-hydrate': 'npm:inferno-hydrate/dist/inferno-hydrate.min.js', 'inferno-clone-vnode': 'npm:inferno-clone-vnode/dist/inferno-clone-vnode.min.js', 'inferno-create-class': 'npm:inferno-create-class/dist/inferno-create-class.min.js', 'inferno-extras': 'npm:inferno-extras/dist/inferno-extras.min.js', // Prettier 'prettier/standalone': 'npm:prettier@2.8.8/standalone.js', 'prettier/parser-html': 'npm:prettier@2.8.8/parser-html.js', }, packages: { 'app': { main: './app.component.ts', defaultExtension: 'ts', }, 'devextreme': { defaultExtension: 'js', }, 'devextreme/events/utils': { main: 'index', }, 'devextreme/events': { main: 'index', }, 'es6-object-assign': { main: './index.js', defaultExtension: 'js', }, 'rxjs': { defaultExtension: 'js', }, 'rxjs/operators': { defaultExtension: 'js', }, }, packageConfigPaths: [ 'npm:@devextreme/*/package.json', 'npm:@devextreme/runtime@3.0.12/inferno/package.json', 'npm:rxjs@7.5.3/package.json', 'npm:rxjs@7.5.3/operators/package.json', 'npm:devexpress-diagram@2.2.5/package.json', 'npm:devexpress-gantt@4.1.54/package.json', ], }; System.config(window.config); // System.import('@angular/compiler').catch(console.error.bind(console));
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <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=5.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/24.2.3/css/dx.light.css" /> <script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script> <script src="https://unpkg.com/zone.js@0.14.10/bundles/zone.umd.js"></script> <script src="https://unpkg.com/reflect-metadata@0.1.13/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>
declare module 'npm:devextreme/localization/messages/de.json!json'{ const json: object; export = json; } declare module 'npm:devextreme/localization/messages/ru.json!json'{ const json: object; export = json; }