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.

Prev Demo

Next Demo

Was this demo helpful?

Thank you!

Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.

Thank you for the feedback!

Backend API

import React from 'react'; import HtmlEditor, { Toolbar, Item } from 'devextreme-react/html-editor'; import Popup from 'devextreme-react/popup'; import { markup } from './data.js'; const headerValues = [false, 1, 2, 3, 4, 5]; const headerOptions = { inputAttr: { 'aria-label': 'Header' } }; class App extends React.Component { constructor() { super(); this.state = { value: markup, popupVisible: false, }; 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() { const { value, popupVisible } = this.state; return ( <div className="widget-container"> <HtmlEditor value={value} onValueChanged={this.valueChanged} > <Toolbar> <Item name="undo" /> <Item name="redo" /> <Item name="separator" /> <Item name="header" acceptedValues={headerValues} options={headerOptions} /> <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 widget="dxButton" options={this.toolbarButtonOptions} /> </Toolbar> </HtmlEditor> <Popup showTitle={true} title="Markup" visible={popupVisible} onHiding={this.popupHiding} > {value} </Popup> </div> ); } 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/23.1.5/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://unpkg.com/core-js@2.6.12/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 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> `;