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.
Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
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.
<template>
<div>
<DxHtmlEditor height="725px">
<DxMediaResizing :enabled="true"/>
<DxToolbar :multiline="isMultiline">
<DxItem format-name="undo"/>
<DxItem format-name="redo"/>
<DxItem format-name="separator"/>
<DxItem
:format-values="sizeValues"
format-name="size"
/>
<DxItem
:format-values="fontValues"
format-name="font"
/>
<DxItem format-name="separator"/>
<DxItem format-name="bold"/>
<DxItem format-name="italic"/>
<DxItem format-name="strike"/>
<DxItem format-name="underline"/>
<DxItem format-name="separator"/>
<DxItem format-name="alignLeft"/>
<DxItem format-name="alignCenter"/>
<DxItem format-name="alignRight"/>
<DxItem format-name="alignJustify"/>
<DxItem format-name="separator"/>
<DxItem format-name="orderedList"/>
<DxItem format-name="bulletList"/>
<DxItem format-name="separator"/>
<DxItem
:format-values="headerValues"
format-name="header"
/>
<DxItem format-name="separator"/>
<DxItem format-name="color"/>
<DxItem format-name="background"/>
<DxItem format-name="separator"/>
<DxItem format-name="link"/>
<DxItem format-name="image"/>
<DxItem format-name="separator"/>
<DxItem format-name="clear"/>
<DxItem format-name="codeBlock"/>
<DxItem format-name="blockquote"/>
<DxItem format-name="separator"/>
<DxItem format-name="insertTable"/>
<DxItem format-name="deleteTable"/>
<DxItem format-name="insertRowAbove"/>
<DxItem format-name="insertRowBelow"/>
<DxItem format-name="deleteRow"/>
<DxItem format-name="insertColumnLeft"/>
<DxItem format-name="insertColumnRight"/>
<DxItem format-name="deleteColumn"/>
</DxToolbar>
<div v-html="markup"/>
</DxHtmlEditor>
<div class="options">
<div class="caption">Options</div>
<div class="option">
<DxCheckBox
v-model:value="isMultiline"
text="Multiline toolbar"
/>
</div>
</div>
</div>
</template>
<script>
import {
DxHtmlEditor,
DxToolbar,
DxMediaResizing,
DxItem
} from 'devextreme-vue/html-editor';
import {
DxCheckBox
} from 'devextreme-vue/check-box';
import { markup } from './data.js';
export default {
components: {
DxHtmlEditor,
DxMediaResizing,
DxToolbar,
DxItem,
DxCheckBox
},
data() {
return {
markup,
sizeValues: ['8pt', '10pt', '12pt', '14pt', '18pt', '24pt', '36pt'],
fontValues: ['Arial', 'Courier New', 'Georgia', 'Impact', 'Lucida Console', 'Tahoma', 'Times New Roman', 'Verdana'],
headerValues: [false, 1, 2, 3, 4, 5],
isMultiline: true
};
}
};
</script>
<style>
.dx-htmleditor-content img {
vertical-align: middle;
padding-right: 10px;
}
.dx-htmleditor-content table {
width: 50%;
}
.options {
padding: 20px;
background-color: rgba(191, 191, 191, 0.15);
margin-top: 20px;
}
.caption {
font-size: 18px;
font-weight: 500;
}
.option {
margin-top: 10px;
}
</style>
import { createApp } from 'vue';
import App from './App.vue';
createApp(App).mount('#app');
<!DOCTYPE html>
<html>
<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/20.2.6/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/20.2.6/css/dx.light.css" />
<script src="https://unpkg.com/core-js@2.4.1/client/shim.min.js"></script>
<script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script>
<script type="text/javascript" src="config.js"></script>
<script type="text/javascript">
System.import('./index.js');
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<div id="app">
</div>
</div>
</body>
</html>
export 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>Insert images as a link or base64 (drag and drop images to convert them to base64)</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.x - v10.0.x</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>
`;
System.config({
transpiler: 'plugin-babel',
meta: {
'*.vue': {
loader: 'vue-loader'
},
'devextreme/localization.js': {
"esModule": true
},
},
paths: {
'npm:': 'https://unpkg.com/'
},
map: {
'vue': 'npm:vue@3.0.0/dist/vue.esm-browser.js',
'vue-loader': 'npm:dx-systemjs-vue-browser@1.0.15/index.js',
'mitt': 'npm:mitt/dist/mitt.umd.js',
'rrule': 'npm:rrule@2.6.6/dist/es5/rrule.js',
'luxon': 'npm:luxon@1.26.0/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign@1.1.0',
'devextreme': 'npm:devextreme@20.2.6',
'devextreme-vue': 'npm:devextreme-vue@20.2.6',
'jszip': 'npm:jszip@3.6.0/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@0.10.3/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.0.18/dist/dx-diagram.js',
'devexpress-gantt': 'npm:devexpress-gantt@2.0.24/dist/dx-gantt.js',
'preact': 'npm:preact@10.5.13/dist/preact.js',
'preact/hooks': 'npm:preact@10.5.13/hooks/dist/hooks.js',
'plugin-babel': 'npm:systemjs-plugin-babel@0.0.25/plugin-babel.js',
'systemjs-babel-build': 'npm:systemjs-plugin-babel@0.0.25/systemjs-babel-browser.js'
},
packages: {
'devextreme-vue': {
main: 'index.js'
},
'devextreme': {
defaultExtension: 'js'
},
'devextreme/events/utils': {
main: 'index'
},
'devextreme/events': {
main: 'index'
},
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js'
}
},
babelOptions: {
sourceMaps: false,
stage0: true
}
});