Vue HtmlEditor - Getting Started

jQuery
NOTE
Before you start the tutorial, ensure DevExtreme is installed in your application.
Angular
NOTE
Before you start the tutorial, ensure DevExtreme is installed in your application.
Vue
NOTE
Before you start the tutorial, ensure DevExtreme is installed in your application.
React
NOTE
Before you start the tutorial, ensure DevExtreme is installed in your application.

This tutorial explains how to add an HTML Editor to a page and configure its core features. The following control demonstrates the result:

Refer to the following sections for details on each configuration step. You can also find the full code in the GitHub repository.

View on GitHub

Create an HtmlEditor

jQuery

The HTML Editor uses the DevExtreme Quill library. To create an HtmlEditor on your page, add DevExtreme to your application, reference the DevExtreme Quill script before the main DevExtreme script, and use the following code:

index.js
index.html
$(function () {
    $("#html-editor").dxHtmlEditor({
        // Configuration goes here
    });
});
<html>
    <head>
        <!-- ... -->
        <script type="text/javascript" src="https://code.jquery.com/jquery-3.5.1.min.js"></script>

        <link rel="stylesheet" href="https://cdn3.devexpress.com/jslib/24.2.3/css/dx.light.css">
        <link rel="stylesheet" href="index.css">
        <script src="https://cdn3.devexpress.com/jslib/24.2.3/js/dx-quill.min.js"></script>
        <script src="https://cdn3.devexpress.com/jslib/24.2.3/js/dx.all.js"></script>
        <script src="index.js"></script>
    </head>
    <body class="dx-viewport">
        <div id="html-editor">
            <!-- Initial markup goes here -->
        </div>
    </body>
</html>
Angular

The HTML Editor uses the DevExtreme Quill library. This library is installed automatically when you add DevExtreme to your application. To create an HTML Editor on your page, use the following code:

app.component.html
app.component.ts
app.module.ts
<dx-html-editor>
    <!-- Configuration goes here -->
</dx-html-editor>
import { Component } from '@angular/core';

@Component({
    selector: 'app-root',
    templateUrl: './app.component.html',
    styleUrls: ['./app.component.css']
})
export class AppComponent {

}
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';

import { DxHtmlEditorModule } from 'devextreme-angular';

@NgModule({
    declarations: [
        AppComponent
    ],
    imports: [
        BrowserModule,
        DxHtmlEditorModule
    ],
    providers: [ ],
    bootstrap: [AppComponent]
})
export class AppModule { }
Vue

The HTML Editor uses the DevExtreme Quill library. This library is installed automatically when you add DevExtreme to your application. To create an HTML Editor on your page, use the following code:

App.vue
<template>
    <DxHtmlEditor>
        <!-- Configuration goes here -->
    </DxHtmlEditor>
</template>

<script>
import 'devextreme/dist/css/dx.light.css';
import { DxHtmlEditor } from 'devextreme-vue/html-editor';

export default {
    components: {
        DxHtmlEditor
    }
}
</script>
React

The HTML Editor uses the DevExtreme Quill library. This library is installed automatically when you add DevExtreme to your application. To create an HTML Editor on your page, and use the following code:

App.js
import React from 'react';
import './App.css';
import 'devextreme/dist/css/dx.light.css';
import { HtmlEditor } from 'devextreme-react/html-editor';

const App = () => {
    return (
        <HtmlEditor>
            {/* Configuration goes here */}
        </HtmlEditor>
    );
}

export default App;

Set the Initial Value

The control stores the document markup in the value property. You can also declare HTML content inside the HtmlEditor element.

jQuery
index.html
index.css
<html>
    <head>
        <!-- ... -->
    </head>
    <body class="dx-viewport">
        <div id="html-editor">
            <h2>
                <img src="HtmlEditor.svg" alt="HTML Editor">
                Rich 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.</p>
            <p>Supported features:</p>
            <ul>
                <li>Inline formats:
                    <ul>
                        <li><strong>Bold</strong>, <em>italic</em>, <s>strikethrough</s> text formatting</li>
                        <li>Typeface, font size, text color changes (HTML only)</li>
                    </ul>
                </li>
                <li>Block formats:
                    <ul>
                        <li>Headers</li>
                        <li>Lists (ordered and unordered)</li>
                        <li>Code blocks</li>
                        <li>Quotes</li>
                    </ul>
                </li>
                <li>Built-in format customization</li>
                <li>Mail Merge</li>
                <li>Adaptive toolbar for working with images, links, and color formats</li>
                <li>Copy-paste rich content (the control strips unsupported formats)</li>
                <li>Embedded images specified as a link to an image file or as base64-encoded binary data</li>
                <li>Mention (for example, @person)</li>
                <li>Tables</li>
            </ul>
            <br>
            <p>The editor supports the following frameworks and libraries:</p>
            <table>
                <tr>
                    <td><strong>jQuery</strong></td>
                    <td>v2.1 - v2.2 and v3.x</td>
                </tr>
                <tr>
                    <td><strong>Angular</strong></td>
                    <td>v7.0.x - v11.0.x</td>
                </tr>
                <tr>
                    <td><strong>React</strong></td>
                    <td>v16.2+</td>
                </tr>
                <tr>
                    <td><strong>Vue</strong></td>
                    <td>v2.6.3+</td>
                </tr>
            </table>
        </div>
    </body>
</html>
.dx-htmleditor-content img {
    vertical-align: middle;
}

.dx-htmleditor-content table {
    width: 50%;
}

.dx-htmleditor-content table td:last-child {
    text-align: right;
}
NOTE

To update the value at the runtime, call the option(optionName, optionValue) method:

index.js
$(function () {
    const editor = $("#html-editor").dxHtmlEditor({
        valueType: "html" 
    }).dxHtmlEditor('instance');

    editor.option("value", "<h4>This is the new html formatted content</h4>");
});
Angular
app.component.html
app.component.css
<dx-html-editor>
    <h2>
        <img src="assets/images/HtmlEditor.svg" alt="HTML Editor">
        Rich Text Editor (HTML Editor)
    </h2>
    <br>
    <p>DevExtreme JavaScript HTML Editor is a client-side WYSIWYG editor that allows its users to format textual and visual content and output it as HTML.</p>
    <p>Supported features:</p>
    <ul>
        <li>Inline formats:
            <ul>
                <li><strong>Bold</strong>, <em>italic</em>, <s>strikethrough</s> text formatting</li>
                <li>Typeface, font size, text color changes (HTML only)</li>
            </ul>
        </li>
        <li>Block formats:
            <ul>
                <li>Headers</li>
                <li>Lists (ordered and unordered)</li>
                <li>Code blocks</li>
                <li>Quotes</li>
            </ul>
        </li>
        <li>Built-in format customization</li>
        <li>Mail Merge</li>
        <li>Adaptive toolbar for working with images, links, and color formats</li>
        <li>Copy-paste rich content (the control strips unsupported formats)</li>
        <li>Embedded images specified as a link to an image file or as base64-encoded binary data</li>
        <li>Mention (for example, @person)</li>
        <li>Tables</li>
    </ul>
    <br>
    <p>The editor supports the following frameworks and libraries:</p>
    <table>
        <tr>
            <td><strong>jQuery</strong></td>
            <td>v2.1 - v2.2 and v3.x</td>
        </tr>
        <tr>
            <td><strong>Angular</strong></td>
            <td>v7.0.x - v11.0.x</td>
        </tr>
        <tr>
            <td><strong>React</strong></td>
            <td>v16.2+</td>
        </tr>
        <tr>
            <td><strong>Vue</strong></td>
            <td>v2.6.3+</td>
        </tr>
    </table>
</dx-html-editor>
::ng-deep .dx-htmleditor-content img {
    vertical-align: middle;
}

::ng-deep .dx-htmleditor-content table {
    width: 50%;
}

::ng-deep .dx-htmleditor-content table td:last-child {
    text-align: right;
}
Vue
App.vue
<template>
    <DxHtmlEditor>
        <div>
            <h2>
                <img src="./HtmlEditor.svg" alt="HTML Editor">
                Rich 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.</p>
            <p>Supported features:</p>
            <ul>
                <li>Inline formats:
                    <ul>
                        <li><strong>Bold</strong>, <em>italic</em>, <s>strikethrough</s> text formatting</li>
                        <li>Typeface, font size, text color changes (HTML only)</li>
                    </ul>
                </li>
                <li>Block formats:
                    <ul>
                        <li>Headers</li>
                        <li>Lists (ordered and unordered)</li>
                        <li>Code blocks</li>
                        <li>Quotes</li>
                    </ul>
                </li>
                <li>Built-in format customization</li>
                <li>Mail Merge</li>
                <li>Adaptive toolbar for working with images, links, and color formats</li>
                <li>Copy-paste rich content (the control strips unsupported formats)</li>
                <li>Embedded images specified as a link to an image file or as base64-encoded binary data</li>
                <li>Mention (for example, @person)</li>
                <li>Tables</li>
            </ul>
            <br>
            <p>The editor supports the following frameworks and libraries:</p>
            <table>
                <tr>
                    <td><strong>jQuery</strong></td>
                    <td>v2.1 - v2.2 and v3.x</td>
                </tr>
                <tr>
                    <td><strong>Angular</strong></td>
                    <td>v7.0.x - v11.0.x</td>
                </tr>
                <tr>
                    <td><strong>React</strong></td>
                    <td>v16.2+</td>
                </tr>
                <tr>
                    <td><strong>Vue</strong></td>
                    <td>v2.6.3+</td>
                </tr>
            </table>
        </div>
    </DxHtmlEditor>
<template>

<script>
    // ...
</script>

<style>
.dx-htmleditor-content img {
    vertical-align: middle;
}

.dx-htmleditor-content table {
    width: 50%;
}

.dx-htmleditor-content table td:last-child {
    text-align: right;
}
</style>
React
App.js
App.css
// ...
const markup = `
    <div>
        <h2>
            <img src="HtmlEditor.svg" alt="HTML Editor"/>
            Rich 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.</p>
        <p>Supported features:</p>
        <ul>
            <li>Inline formats:
                <ul>
                    <li><strong>Bold</strong>, <em>italic</em>, <s>strikethrough</s> text formatting</li>
                    <li>Typeface, font size, text color changes (HTML only)</li>
                </ul>
            </li>
            <li>Block formats:
                <ul>
                    <li>Headers</li>
                    <li>Lists (ordered and unordered)</li>
                    <li>Code blocks</li>
                    <li>Quotes</li>
                </ul>
            </li>
            <li>Built-in format customization</li>
            <li>Mail Merge</li>
            <li>Adaptive toolbar for working with images, links, and color formats</li>
            <li>Copy-paste rich content (the control strips unsupported formats)</li>
            <li>Embedded images specified as a link to an image file or as base64-encoded binary data</li>
            <li>Mention (for example, @person)</li>
            <li>Tables</li>
        </ul>
        <br>
        <p>The editor supports the following frameworks and libraries:</p>
        <table>
            <tr>
                <td><strong>jQuery</strong></td>
                <td>v2.1 - v2.2 and v3.x</td>
            </tr>
            <tr>
                <td><strong>Angular</strong></td>
                <td>v7.0.x - v11.0.x</td>
            </tr>
            <tr>
                <td><strong>React</strong></td>
                <td>v16.2+</td>
            </tr>
            <tr>
                <td><strong>Vue</strong></td>
                <td>v2.6.3+</td>
            </tr>
        </table>
    </div>
`;

const App = () => {
    return (
        <HtmlEditor defaultValue={markup}>
        </HtmlEditor>
    );
};

export default App;
.dx-htmleditor-content img {
    vertical-align: middle;
}

.dx-htmleditor-content table {
    width: 50%;
}

.dx-htmleditor-content table td:last-child {
    text-align: right;
}

Configure the Toolbar

The HTML Editor's toolbar contains buttons and drop-down menus that allow users to edit and format content. To configure the toolbar, specify an array of items in the toolbar object. You can use predefined items or create custom items. You can specify a list of accepted values for certain predefined items, such as font size. To do so, use the name property to define the item and the acceptedValues property to assign an array of available values.

If toolbar items overflow the length of the toolbar, enable the multiline property to arrange the items in multiple lines.

jQuery
index.js
$(function () {
    $("#html-editor").dxHtmlEditor({
        // ...
        toolbar: {
            items: [
                "undo",
                "redo",
                "separator",
                {
                    name: "size",
                    acceptedValues: [ "8pt", "10pt", "12pt", "14pt", "18pt", "24pt", "36pt" ]
                },
                {
                    name: "font",
                    acceptedValues: [ "Arial", "Georgia", "Tahoma", "Times New Roman", "Verdana" ]
                },
                "separator",
                "bold",
                "italic",
                "strike",
                "underline",
                "separator",
                "alignLeft",
                "alignCenter",
                "alignRight",
                "alignJustify",
                "separator",
                "orderedList",
                "bulletList",
                "separator",
                {
                    name: "header",
                    acceptedValues: [false, 1, 2, 3, 4, 5]
                },
                "separator",
                "color",
                "background",
                "separator",
                "link",
                "image",
                "separator",
                "clear",
                "codeBlock",
                "blockquote",
                "separator",
            ],
            multiline: true
        },
    });
});
Angular
app.component.html
<dx-html-editor ... >
    <dxo-toolbar [multiline]="true">
        <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']"></dxi-item>
        <dxi-item name="font" [acceptedValues]="['Arial', 'Georgia', 'Tahoma', 'Times New Roman', 'Verdana']"></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]"></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>
    </dxo-toolbar>
</dx-html-editor>
Vue
App.vue
<template>
    <DxHtmlEditor... >
        <DxToolbar :multiline="true">
            <DxItem name="undo" />
            <DxItem name="redo" />
            <DxItem name="separator" />
            <DxItem
                name="size"
                :accepted-values="sizeValues"
            />
            <DxItem
                name="font"
                :accepted-values="fontValues"
            />
            <DxItem name="separator" />
            <DxItem name="bold" />
            <DxItem name="italic" />
            <DxItem name="strike" />
            <DxItem name="underline" />
            <DxItem name="separator" />
            <DxItem name="alignLeft" />
            <DxItem name="alignCenter" />
            <DxItem name="alignRight" />
            <DxItem name="alignJustify" />
            <DxItem name="separator" />
            <DxItem name="orderedList" />
            <DxItem name="bulletList" />
            <DxItem name="separator" />
            <DxItem
                name="header"
                :accepted-values="headerValues"
            />
            <DxItem name="separator" />
            <DxItem name="color" />
            <DxItem name="background" />
            <DxItem name="separator" />
            <DxItem name="link" />
            <DxItem name="image" />
            <DxItem name="separator" />
            <DxItem name="clear" />
            <DxItem name="codeBlock" />
            <DxItem name="blockquote" />
            <DxItem name="separator" />
        </DxToolbar>
    </DxHtmlEditor>
</template>

<script>
import {
    // ...
    DxToolbar,
    DxItem,
} from 'devextreme-vue/html-editor';

export default {
    components: {
        // ...
        DxToolbar,
        DxItem,
    },
    data() {
        return {
            sizeValues: ['8pt', '10pt', '12pt', '14pt', '18pt', '24pt', '36pt'],
            fontValues: ['Arial', 'Georgia', 'Tahoma', 'Times New Roman', 'Verdana'],
            headerValues: [false, 1, 2, 3, 4, 5]
        };
    }
};
</script>
React
App.js
// ...
import {
    // ...
    Toolbar,
    Item,
} from "devextreme-react/html-editor";

// ...

const sizeValues = [ "8pt", "10pt", "12pt", "14pt", "18pt", "24pt", "36pt" ];
const fontValues = [ "Arial", "Georgia", "Tahoma", "Times New Roman", "Verdana" ];
const headerValues = [ false, 1, 2, 3, 4, 5 ];

const App = () => {
    return (
        <HtmlEditor ... >
            <Toolbar multiline={true}>
                <Item name="undo" />
                <Item name="redo" />
                <Item name="separator" />
                <Item name="size" acceptedValues={sizeValues} />
                <Item name="font" acceptedValues={fontValues} />
                <Item name="separator" />
                <Item name="bold" />
                <Item name="italic" />
                <Item name="strike" />
                <Item name="underline" />
                <Item name="separator" />
                <Item name="alignLeft" />
                <Item name="alignCenter" />
                <Item name="alignRight" />
                <Item name="alignJustify" />
                <Item name="separator" />
                <Item name="orderedList" />
                <Item name="bulletList" />
                <Item name="separator" />
                <Item name="header" acceptedValues={headerValues} />
                <Item name="separator" />
                <Item name="color" />
                <Item name="background" />
                <Item name="separator" />
                <Item name="link" />
                <Item name="image" />
                <Item name="separator" />
                <Item name="clear" />
                <Item name="codeBlock" />
                <Item name="blockquote" />
                <Item name="separator" />
            </Toolbar>
        </HtmlEditor>
    );
};

export default App;

Work with Tables

Users can insert and modify tables if you add the following items to the toolbar:

jQuery
index.js
$(function () {
    $("#html-editor").dxHtmlEditor({
        // ...
        toolbar: {
            items: [
                // ...
                "insertTable",
                "deleteTable",
                "insertRowAbove",
                "insertRowBelow",
                "deleteRow",
                "insertColumnLeft",
                "insertColumnRight",
                "deleteColumn",
                "cellProperties",
                "tableProperties"
            ]
        }
    });
});
Angular
app.component.html
<dx-html-editor ... >
    <dxo-toolbar ... >
        <!-- ... -->
        <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>
        <dxi-item name="cellProperties"></dxi-item>
        <dxi-item name="tableProperties"></dxi-item>
    </dxo-toolbar>
</dx-html-editor>
Vue
App.vue
<template>
    <DxHtmlEditor ... >
        <DxToolbar ... >
            <!-- ... -->
            <DxItem name="insertTable" />
            <DxItem name="deleteTable" />
            <DxItem name="insertRowAbove" />
            <DxItem name="insertRowBelow" />
            <DxItem name="deleteRow" />
            <DxItem name="insertColumnLeft" />
            <DxItem name="insertColumnRight" />
            <DxItem name="deleteColumn" />
            <DxItem name="cellProperties" />
            <DxItem name="tableProperties" />
        </DxToolbar>
    </DxHtmlEditor>
</template>
React
App.js
// ...

const App = () => {
    return (
        <HtmlEditor ... >
            <Toolbar ... >
                {/* ... */}
                <Item name="insertTable" />
                <Item name="deleteTable" />
                <Item name="insertRowAbove" />
                <Item name="insertRowBelow" />
                <Item name="deleteRow" />
                <Item name="insertColumnLeft" />
                <Item name="insertColumnRight" />
                <Item name="deleteColumn" />
                <Item name="cellProperties" />
                <Item name="tableProperties" />
            </Toolbar>
        </HtmlEditor>
    );
}

export default App;

Users can also modify tables with the context menu if you set the tableContextMenu.enabled property to true. Note that the context menu cannot be used to create new tables because the menu is only available within table boundaries. If you want users to create tables, add an "insertTable" item to the toolbar.

jQuery
index.js
$(function () {
    $("#html-editor").dxHtmlEditor({
        // ...
        toolbar: {
            items: [
                // ...
                "insertTable"
            ]
        },
        tableContextMenu: {
            enabled: true
        }
    });
});
Angular
app.component.html
<dx-html-editor ... >
    <dxo-toolbar ... >
        <!-- ... -->
        <dxi-item name="insertTable"></dxi-item>
    </dxo-toolbar>
    <dxo-table-context-menu
        [enabled]="true">
    </dxo-table-context-menu>
</dx-html-editor>
Vue
App.vue
<template>
    <DxHtmlEditor ... >
        <DxToolbar ... >
            <!-- ... -->
            <DxItem name="insertTable" />
        </DxToolbar>
        <DxTableContextMenu :enabled="true" />
    </DxHtmlEditor>
</template>

<script>
import {
    // ...
    DxTableContextMenu
} from 'devextreme-vue/html-editor';

export default {
    components: {
        DxTableContextMenu
    },
    // ...
}
</script>
React
App.js
import HtmlEditor, {
    // ...
    TableContextMenu
} from "devextreme-react/html-editor";

// ...

const App = () => {
    return (
        <HtmlEditor ... >
            <Toolbar ... >
                {/* ... */}
                <Item name="insertTable" />
            </Toolbar>
            <TableContextMenu enabled={true} />
        </HtmlEditor>
    );
}

export default App;
NOTE

  • The HtmlEditor tables are native HTML tables that use native features; therefore, the same limitations apply. For example, users cannot paste multiline text in separate cells.

  • The HtmlEditor tables do not support complex elements in cells, such as block elements, lists, nested tables, etc.

View Demo

Configure Mentions

Mentions allow users to reference others within text or conversation threads. This functionality is not used in this tutorial. For information about it, refer to the following demo: Mentions.

Resize Images

Users can resize images embedded within the content. To enable this functionality, set the mediaResizing.enabled property to true:

jQuery
index.js
$(function () {
    $("#html-editor").dxHtmlEditor({
        // ...
        mediaResizing: {
            enabled: true
        }
    });
});
Angular
app.component.html
<dx-html-editor ... >
    <!-- ... -->
    <dxo-media-resizing
        [enabled]="true">
    </dxo-media-resizing>
</dx-html-editor>
Vue
App.vue
<template>
    <DxHtmlEditor ... >
        <!-- ... -->
        <DxMediaResizing :enabled="true" />
    </DxHtmlEditor>
</template>
<script>
import {
    // ...
    DxMediaResizing
} from 'devextreme-vue/html-editor';

export default {
    components: {
        // ...
        DxMediaResizing
    },
    // ...
};
</script>
React
App.js
// ...
import {
    // ...
    MediaResizing
} from "devextreme-react/html-editor";

const App = () => {
    return (
        <HtmlEditor ... >
            {/* ... */}
            <MediaResizing enabled={true} />
        </HtmlEditor>
    );
}

export default App;

For further information on the HTML Editor component, refer to the following resources: