DevExtreme v23.2 is now available.

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

Your search did not match any results.

Right-to-Left Support

The DevExtreme Editor components support right-to-left (RTL) languages. The components can display content in a right-to-left direction and mirror associated UI elements.

To enable RTL language support in the application, you can either set the globalConfig object's rtlEnabled property to true or specify each component's rtlEnabled property individually. Note that individual RTL parameters have higher priority than general parameters.

In this demo, you can use the language drop-down menu (for example, change the language from English to Arabic) to explore the differences between default and RTL modes.

Backend API
<div [ngClass]="{ 'dx-rtl': rtlEnabled }"> <div class="options"> <div class="caption">Options</div> <div class="dx-fieldset"> <div class="dx-field"> <div class="dx-field-label">Language</div> <div class="dx-field-value"> <dx-select-box [items]="languages" [inputAttr]="{ 'aria-label': 'Language' }" [value]="languages[1]" [rtlEnabled]="rtlEnabled" (onValueChanged)="onLanguageChanged($event)" ></dx-select-box> </div> </div> </div> </div> <div class="dx-fieldset"> <div class="dx-field"> <div class="dx-field-label">Text Box</div> <div class="dx-field-value"> <dx-text-box [showClearButton]="true" [inputAttr]="{ 'aria-label': 'Text Box' }" [value]="textValue" [rtlEnabled]="rtlEnabled" > </dx-text-box> </div> </div> <div class="dx-field"> <div class="dx-field-label">Number Box</div> <div class="dx-field-value"> <dx-number-box [showSpinButtons]="true" [value]="123" [rtlEnabled]="rtlEnabled" [inputAttr]="{ 'aria-label': 'Number Box' }" > </dx-number-box> </div> </div> <div class="dx-field"> <div class="dx-field-label">Select Box</div> <div class="dx-field-value"> <dx-select-box [items]="europeanUnion" [inputAttr]="{ 'aria-label': 'European Union Data' }" [value]="europeanUnion[0]" [displayExpr]="displayExpr" [rtlEnabled]="rtlEnabled" > </dx-select-box> </div> </div> <div class="dx-field"> <div class="dx-field-label">Tag Box</div> <div class="dx-field-value"> <dx-tag-box [items]="europeanUnion" [value]="[europeanUnion[0].id]" placeholder="..." valueExpr="id" [inputAttr]="{ 'aria-label': 'Name' }" [displayExpr]="displayExpr" [rtlEnabled]="rtlEnabled" ></dx-tag-box> </div> </div> <div class="dx-field"> <div class="dx-field-label">Text Area</div> <div class="dx-field-value"> <dx-text-area [value]="textValue" [rtlEnabled]="rtlEnabled" [inputAttr]="{ 'aria-label': 'Notes' }" > </dx-text-area> </div> </div> <div class="dx-field"> <div class="dx-field-label">Autocomplete</div> <div class="dx-field-value"> <dx-autocomplete [items]="europeanUnion" [valueExpr]="displayExpr" [rtlEnabled]="rtlEnabled" [inputAttr]="{ 'aria-label': 'Autocomplete' }" > </dx-autocomplete> </div> </div> <div class="dx-field"> <div class="dx-field-label">Check Box</div> <div class="dx-field-value"> <dx-check-box [value]="true" [text]="textValue" [rtlEnabled]="rtlEnabled" > </dx-check-box> </div> </div> <div class="dx-field"> <div class="dx-field-label">Switch</div> <div class="dx-field-value"> <dx-switch [rtlEnabled]="rtlEnabled"></dx-switch> </div> </div> </div> </div>
import { Component, NgModule, enableProdMode } from '@angular/core'; import { BrowserModule, BrowserTransferStateModule } from '@angular/platform-browser'; import { platformBrowserDynamic } from '@angular/platform-browser-dynamic'; import { DxSelectBoxModule, DxCheckBoxModule, DxTextBoxModule, DxTextAreaModule, DxNumberBoxModule, DxTagBoxModule, DxSwitchModule, DxAutocompleteModule, } from 'devextreme-angular'; import { Service, Country } from './app.service'; if (!/localhost/.test(document.location.host)) { enableProdMode(); } @Component({ selector: 'demo-app', providers: [Service], templateUrl: 'app/app.component.html', styleUrls: ['app/app.component.css'], }) export class AppComponent { languages: string[] = [ 'Arabic: Right-to-Left direction', 'English: Left-to-Right direction', ]; displayExpr = 'nameEn'; rtlEnabled = false; textValue = 'text'; europeanUnion: Country[]; constructor(service: Service) { this.europeanUnion = service.getCountries(); } onLanguageChanged(data) { const isRTL = data.value === this.languages[0]; this.displayExpr = isRTL ? 'nameAr' : 'nameEn'; this.rtlEnabled = isRTL; this.textValue = isRTL ? 'نص' : 'text'; } } @NgModule({ imports: [ BrowserModule, BrowserTransferStateModule, DxSelectBoxModule, DxAutocompleteModule, DxCheckBoxModule, DxSwitchModule, DxTextAreaModule, DxTextBoxModule, DxNumberBoxModule, DxTagBoxModule, ], declarations: [AppComponent], bootstrap: [AppComponent], }) export class AppModule { } platformBrowserDynamic().bootstrapModule(AppModule);
::ng-deep .options { padding: 20px; background-color: rgba(191, 191, 191, 0.15); } ::ng-deep .options .dx-fieldset { margin: 0; } ::ng-deep .option { margin-top: 10px; } ::ng-deep .caption { font-size: 18px; font-weight: 500; padding-right: 15px; } ::ng-deep .option > span { margin-right: 10px; } ::ng-deep .option > .dx-widget { display: inline-block; vertical-align: middle; }
import { Injectable } from '@angular/core'; export class Country { id: number; nameAr: string; nameEn: string; } const europeanUnion: Country[] = [{ id: 1, nameAr: 'النمسا', nameEn: 'Austria', }, { id: 2, nameAr: 'بلجيكا', nameEn: 'Belgium', }, { id: 3, nameAr: 'بلغاريا', nameEn: 'Bulgaria', }, { id: 4, nameAr: 'كرواتيا', nameEn: 'Croatia', }, { id: 5, nameAr: 'قبرص', nameEn: 'Cyprus', }, { id: 6, nameAr: 'الجمهورية التشيكية', nameEn: 'Czech Republic', }, { id: 7, nameAr: 'الدنمارك', nameEn: 'Denmark', }, { id: 8, nameAr: 'استونيا', nameEn: 'Estonia', }, { id: 9, nameAr: 'فنلندا', nameEn: 'Finland', }, { id: 10, nameAr: 'فرنسا', nameEn: 'France', }, { id: 11, nameAr: 'ألمانيا', nameEn: 'Germany', }, { id: 12, nameAr: 'يونان', nameEn: 'Greece', }, { id: 13, nameAr: 'هنغاريا', nameEn: 'Hungary', }, { id: 14, nameAr: 'أيرلندا', nameEn: 'Ireland', }, { id: 15, nameAr: 'إيطاليا', nameEn: 'Italy', }, { id: 16, nameAr: 'لاتفيا', nameEn: 'Latvia', }, { id: 17, nameAr: 'ليتوانيا', nameEn: 'Lithuania', }, { id: 18, nameAr: 'لوكسمبورغ', nameEn: 'Luxembourg', }, { id: 19, nameAr: 'مالطا', nameEn: 'Malta', }, { id: 20, nameAr: 'هولندا', nameEn: 'Netherlands', }, { id: 21, nameAr: 'بولندا', nameEn: 'Poland', }, { id: 22, nameAr: 'البرتغال', nameEn: 'Portugal', }, { id: 23, nameAr: 'رومانيا', nameEn: 'Romania', }, { id: 24, nameAr: 'سلوفاكيا', nameEn: 'Slovakia', }, { id: 25, nameAr: 'سلوفينيا', nameEn: 'Slovenia', }, { id: 26, nameAr: 'إسبانيا', nameEn: 'Spain', }, { id: 27, nameAr: 'السويد', nameEn: 'Sweden', }, { id: 28, nameAr: 'المملكة المتحدة', nameEn: 'United Kingdom', }, ]; @Injectable() export class Service { getCountries(): Country[] { return europeanUnion; } }
// 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/ 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, }, }, paths: { 'npm:': 'https://unpkg.com/', }, map: { 'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js', 'typescript': 'npm:typescript@4.2.4/lib/typescript.js', '@angular/core': 'npm:@angular/core@12.2.17', '@angular/platform-browser': 'npm:@angular/platform-browser@12.2.17', '@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic@12.2.17', '@angular/forms': 'npm:@angular/forms@12.2.17', '@angular/common': 'npm:@angular/common@12.2.17', '@angular/compiler': 'npm:@angular/compiler@12.2.17', 'tslib': 'npm:tslib@2.6.2/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', 'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js', 'luxon': 'npm:luxon@1.28.1/build/global/luxon.min.js', 'es6-object-assign': 'npm:es6-object-assign@1.1.0', 'devextreme': 'npm:devextreme@23.2.5/cjs', 'devextreme/bundles/dx.all': 'npm:devextreme@23.2.5/bundles/dx.all.js', 'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js', 'devextreme-quill': 'npm:devextreme-quill@1.6.4/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.5', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.51', 'devextreme-angular': 'npm:devextreme-angular@23.2.5', '@devextreme/runtime': 'npm:@devextreme/runtime@3.0.12', '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@7.4.11/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.4/standalone.js', 'prettier/parser-html': 'npm:prettier@2.8.4/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:@angular/*/package.json', 'npm:@angular/common@12.2.17/*/package.json', 'npm:rxjs@7.5.3/package.json', 'npm:rxjs@7.5.3/operators/package.json', 'npm:devextreme-angular@23.2.5/*/package.json', 'npm:devextreme-angular@23.2.5/ui/*/package.json', 'npm:devextreme-angular@23.2.5/package.json', 'npm:devexpress-diagram@2.2.5/package.json', 'npm:devexpress-gantt@4.1.51/package.json', ], }; System.config(window.config);
<!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/23.2.5/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.12.0/dist/zone.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>