DevExtreme v23.2 is now available.

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

Your search did not match any results.

Overview

Documentation

The HtmlEditor component is a client-side WYSIWYG text editor. The editor allows users to format text and integrate media elements into documents. The result can be exported to HTML or Markdown.

Users can edit and customize content using the toolbar that can contain predefined and custom controls. To specify the available controls, use the items array. In this demo, the toolbar contains predefined controls.

You can use the toolbar.multiline property to arrange the toolbar controls into multiple rows.

Users can resize media files when the mediaResizing is enabled. Currently, only images are supported.

To get started with the DevExtreme HtmlEditor component, refer to the following tutorial for step-by-step instructions: Getting Started with HtmlEditor.

Backend API
<dx-html-editor height="725px" [value]="valueContent"> <dxo-toolbar [multiline]="isMultiline"> <dxi-item name="undo"></dxi-item> <dxi-item name="redo"></dxi-item> <dxi-item name="separator"></dxi-item> <dxi-item name="size" [acceptedValues]="['8pt', '10pt', '12pt', '14pt', '18pt', '24pt', '36pt']" [options]="{ inputAttr: { 'aria-label': 'Font size' } }" ></dxi-item> <dxi-item name="font" [acceptedValues]="[ 'Arial', 'Courier New', 'Georgia', 'Impact', 'Lucida Console', 'Tahoma', 'Times New Roman', 'Verdana' ]" [options]="{ inputAttr: { 'aria-label': 'Font family' } }" ></dxi-item> <dxi-item name="separator"></dxi-item> <dxi-item name="bold"></dxi-item> <dxi-item name="italic"></dxi-item> <dxi-item name="strike"></dxi-item> <dxi-item name="underline"></dxi-item> <dxi-item name="separator"></dxi-item> <dxi-item name="alignLeft"></dxi-item> <dxi-item name="alignCenter"></dxi-item> <dxi-item name="alignRight"></dxi-item> <dxi-item name="alignJustify"></dxi-item> <dxi-item name="separator"></dxi-item> <dxi-item name="orderedList"></dxi-item> <dxi-item name="bulletList"></dxi-item> <dxi-item name="separator"></dxi-item> <dxi-item name="header" [acceptedValues]="[false, 1, 2, 3, 4, 5]" [options]="{ inputAttr: { 'aria-label': 'Header' } }" ></dxi-item> <dxi-item name="separator"></dxi-item> <dxi-item name="color"></dxi-item> <dxi-item name="background"></dxi-item> <dxi-item name="separator"></dxi-item> <dxi-item name="link"></dxi-item> <dxi-item name="image"></dxi-item> <dxi-item name="separator"></dxi-item> <dxi-item name="clear"></dxi-item> <dxi-item name="codeBlock"></dxi-item> <dxi-item name="blockquote"></dxi-item> <dxi-item name="separator"></dxi-item> <dxi-item name="insertTable"></dxi-item> <dxi-item name="deleteTable"></dxi-item> <dxi-item name="insertRowAbove"></dxi-item> <dxi-item name="insertRowBelow"></dxi-item> <dxi-item name="deleteRow"></dxi-item> <dxi-item name="insertColumnLeft"></dxi-item> <dxi-item name="insertColumnRight"></dxi-item> <dxi-item name="deleteColumn"></dxi-item> </dxo-toolbar> <dxo-media-resizing [enabled]="true"> </dxo-media-resizing> <dxo-image-upload [tabs]="currentTab" fileUploadMode="base64"> </dxo-image-upload> </dx-html-editor> <div class="options"> <div class="caption">Options</div> <div class="option"> <dx-check-box text="Multiline toolbar" [(value)]="isMultiline" ></dx-check-box> </div> <div class="option"> <div class="label">Image upload tabs:</div> <dx-select-box [items]="tabs" [inputAttr]="{ 'aria-label': 'Tab' }" [(value)]="currentTab" valueExpr="value" displayExpr="name" > </dx-select-box> </div> </div>
import { NgModule, Component, enableProdMode } from '@angular/core'; import { BrowserModule, BrowserTransferStateModule } from '@angular/platform-browser'; import { platformBrowserDynamic } from '@angular/platform-browser-dynamic'; import { DxHtmlEditorModule, DxCheckBoxModule, DxSelectBoxModule } from 'devextreme-angular'; import { Service, TabConfig } 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], }) export class AppComponent { isMultiline = true; valueContent: string; tabs: TabConfig[]; currentTab: string[]; constructor(service: Service) { this.valueContent = service.getMarkup(); this.tabs = service.getTabsData(); this.currentTab = this.tabs[2].value; } } @NgModule({ imports: [ BrowserModule, BrowserTransferStateModule, DxHtmlEditorModule, DxCheckBoxModule, DxSelectBoxModule, ], declarations: [AppComponent], bootstrap: [AppComponent], }) export class AppModule { } platformBrowserDynamic().bootstrapModule(AppModule);
::ng-deep .dx-htmleditor-content img { vertical-align: middle; padding-right: 10px; } ::ng-deep .dx-htmleditor-content table { width: 50%; } ::ng-deep .options { padding: 20px; background-color: rgba(191, 191, 191, 0.15); margin-top: 20px; } ::ng-deep .caption { font-size: 18px; font-weight: 500; } ::ng-deep .option { margin-top: 10px; display: inline-block; margin-right: 40px; } ::ng-deep .option > .dx-selectbox, ::ng-deep .option > .label { display: inline-block; vertical-align: middle; } ::ng-deep .option > .label { margin-right: 10px; }
import { Injectable } from '@angular/core'; export class TabConfig { name: string; value: string[]; } const markup = ` <h2> <img src="../../../../images/widgets/HtmlEditor.svg" alt="HtmlEditor"> Formatted Text Editor (HTML Editor) </h2> <br> <p>DevExtreme JavaScript HTML Editor is a client-side WYSIWYG text editor that allows its users to format textual and visual content and store it as HTML or Markdown.</p> <p>Supported features:</p> <ul> <li>Inline formats: <ul> <li><strong>Bold</strong>, <em>italic</em>, <s>strikethrough</s> text formatting</li> <li>Font, size, color changes (HTML only)</li> </ul> </li> <li>Block formats: <ul> <li>Headers</li> <li>Text alignment</li> <li>Lists (ordered and unordered)</li> <li>Code blocks</li> <li>Quotes</li> </ul> </li> <li>Custom formats</li> <li>HTML and Markdown support</li> <li>Mail-merge placeholders (for example, %username%)</li> <li>Adaptive toolbar for working images, links, and color formats</li> <li>Image upload: drag-and-drop images onto the form, select files from the file system, or specify a URL.</li> <li>Copy-paste rich content (unsupported formats are removed)</li> <li>Tables support</li> </ul> <br> <p>Supported frameworks and libraries</p> <table> <tr> <td><strong>jQuery</strong></td> <td style="text-align: right;">v2.1 - v2.2 and v3.x</td> </tr> <tr> <td><strong>Angular</strong></td> <td style="text-align: right;">v7.0+</td> </tr> <tr> <td><strong>React</strong></td> <td style="text-align: right;">v16.2+</td> </tr> <tr> <td><strong>Vue</strong></td> <td style="text-align: right;">v2.6.3+</td> </tr> </table> `; const tabsData: TabConfig[] = [ { name: 'From This Device', value: ['file'] }, { name: 'From the Web', value: ['url'] }, { name: 'Both', value: ['file', 'url'] }, ]; @Injectable() export class Service { getMarkup(): string { return markup; } getTabsData(): TabConfig[] { return tabsData; } }
// 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>