Toolbar Customization
Documentation
This demo shows how to add a custom control to the toolbar. The Show markup button opens a popup that displays the HtmlEditor’s output markup.
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.
import React from 'react';
import { markup } from './data.js';
import HtmlEditor, { Toolbar, Item } from 'devextreme-react/html-editor';
import Popup from 'devextreme-react/popup';
class App extends React.Component {
constructor() {
super();
this.state = {
value: markup,
popupVisible: false
};
this.headerValues = [false, 1, 2, 3, 4, 5];
this.toolbarButtonOptions = {
text: 'Show markup',
stylingMode: 'text',
onClick: this.customButtonClick.bind(this)
};
this.valueChanged = this.valueChanged.bind(this);
this.popupHiding = this.popupHiding.bind(this);
}
render() {
let { value, popupVisible } = this.state;
return (
<React.Fragment>
<div className={'widget-container'}>
<HtmlEditor
value={value}
onValueChanged={this.valueChanged}
>
<Toolbar>
<Item formatName={'undo'} />
<Item formatName={'redo'} />
<Item formatName={'separator'} />
<Item
formatName={'header'}
formatValues={this.headerValues}
/>
<Item formatName={'separator'} />
<Item formatName={'bold'} />
<Item formatName={'italic'} />
<Item formatName={'strike'} />
<Item formatName={'underline'} />
<Item formatName={'separator'} />
<Item formatName={'alignLeft'} />
<Item formatName={'alignCenter'} />
<Item formatName={'alignRight'} />
<Item formatName={'alignJustify'} />
<Item formatName={'separator'} />
<Item
widget={'dxButton'}
options={this.toolbarButtonOptions}
/>
</Toolbar>
</HtmlEditor>
<Popup
showTitle={true}
title={'Markup'}
visible={popupVisible}
onHiding={this.popupHiding}
>
{value}
</Popup>
</div>
</React.Fragment>
);
}
valueChanged(e) {
this.setState({
value: e.value
});
}
popupHiding() {
this.setState({
popupVisible: false
});
}
customButtonClick() {
this.setState({
popupVisible: true
});
}
}
export default App;
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.js';
ReactDOM.render(
<App />,
document.getElementById('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/19.2.3/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/19.2.3/css/dx.light.css" />
<link rel="stylesheet" type="text/css" href="styles.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>
.dx-htmleditor-content img {
vertical-align: middle;
padding-right: 10px;
}
export const markup = `
<h2>
<img src="../../../../images/widgets/HtmlEditor.svg" alt="HtmlEditor">
Formatted Text Editor (HTML Editor)
</h2>
<br>
<p>DevExtreme HTML5 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>underlined</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>
</ul>
`;
System.config({
transpiler: 'plugin-babel',
paths: {
'npm:': 'https://unpkg.com/'
},
defaultExtension: 'js',
map: {
'react': 'npm:react@16/umd/react.development.js',
'react-dom': 'npm:react-dom@16/umd/react-dom.development.js',
'prop-types': 'npm:prop-types/prop-types.js',
'devextreme': 'npm:devextreme@19.2',
'devextreme-react': 'npm:devextreme-react@19.2',
'jszip': 'npm:jszip@3.1.3/dist/jszip.min.js',
'quill': 'npm:quill@1.3.7/dist/quill.js',
'devexpress-diagram': 'npm:devexpress-diagram',
'devexpress-gantt': 'npm:devexpress-gantt',
// SystemJS plugins
'plugin-babel': 'npm:systemjs-plugin-babel@0/plugin-babel.js',
'systemjs-babel-build':
'npm:systemjs-plugin-babel@0/systemjs-babel-browser.js'
},
packages: {
'devextreme': {
defaultExtension: 'js'
},
'devextreme-react': {
main: 'index.js'
}
},
babelOptions: {
sourceMaps: false,
stage0: true,
react: true
}
});