Relocate an Item

Toolbar items are aligned to the left (right if rtlEnabled is true) and preserve the order they have in the items array. Use the location property to override the order.

This property accepts the "before", "center", and "after" values that specify a toolbar item's location relative to that of other items. In the code below, it is used to order items as follows: alignLeft, alignRight, color, background, undo, and redo. Note that alignLeft and alignRight assume the default value, "before".

jQuery
JavaScript
$(function() {
    $("#htmlEditorContainer").dxHtmlEditor({
        toolbar: {
            items: [
                { name: "undo", location: "after" }, 
                { name: "redo", location: "after" },
                "alignLeft", "alignRight",
                { name: "color", location: "center" }, 
                { name: "background", location: "center" }
            ]
        }
    });
});
Angular
HTML
TypeScript
<dx-html-editor>
    <dxo-toolbar>
        <dxi-item name="undo" location="after"></dxi-item>
        <dxi-item name="redo" location="after"></dxi-item>
        <dxi-item name="alignLeft"></dxi-item>
        <dxi-item name="alignRight"></dxi-item>
        <dxi-item name="color" location="center"></dxi-item>
        <dxi-item name="background" location="center"></dxi-item>
    </dxo-toolbar>
</dx-html-editor>
import { DxHtmlEditorModule } from "devextreme-angular";
// ...
export class AppComponent {
    // ...
}
@NgModule({
    imports: [
        // ...
        DxHtmlEditorModule
    ],
    // ...
})
Vue
<template>
    <DxHtmlEditor>
        <DxToolbar>
            <DxItem
                name="undo"
                location="after"
            />
            <DxItem
                name="redo"
                location="after"
            />
            <DxItem name="alignLeft"/>
            <DxItem name="alignRight"/>
            <DxItem
                name="color"
                location="center"
            />
            <DxItem
                name="background"
                location="center"
            />
        </DxToolbar>
    </DxHtmlEditor>
</template>

<script>
import 'devextreme/dist/css/dx.light.css';

import {
    DxHtmlEditor,
    DxToolbar,
    DxItem
} from 'devextreme-vue/html-editor';

export default {
    components: {
        DxHtmlEditor,
        DxToolbar,
        DxItem
    }
}
</script>
React
import React from 'react';
import 'devextreme/dist/css/dx.light.css';

import { HtmlEditor, Toolbar, Item } from 'devextreme-react/html-editor';

class App extends React.Component {
    render() {
        return (
            <HtmlEditor>
                <Toolbar>
                    <Item
                        name="undo"
                        location="after"
                    />
                    <Item
                        name="redo"
                        location="after"
                    />
                    <Item name="alignLeft"/>
                    <Item name="alignRight"/>
                    <Item
                        name="color"
                        location="center"
                    />
                    <Item
                        name="background"
                        location="center"
                    />
                </Toolbar>
            </HtmlEditor>
        );
    }
}

export default App;

If the toolbar cannot fit all the items, some of them are collected in the overflow menu. Use the locateInMenu property to change this behavior:

jQuery
JavaScript
$(function() {
    $("#htmlEditorContainer").dxHtmlEditor({
        toolbar: {
            items: [
                // ...
                { name: "undo", locateInMenu: "always" }, 
                { name: "color", locateInMenu: "never" }
            ]
        }
    });
});
Angular
HTML
TypeScript
<dx-html-editor>
    <dxo-toolbar>
        <!-- ... -->
        <dxi-item name="undo" locateInMenu="always"></dxi-item>
        <dxi-item name="color" locateInMenu="never"></dxi-item>
    </dxo-toolbar>
</dx-html-editor>
import { DxHtmlEditorModule } from "devextreme-angular";
// ...
export class AppComponent {
    // ...
}
@NgModule({
    imports: [
        // ...
        DxHtmlEditorModule
    ],
    // ...
})
Vue
<template>
    <DxHtmlEditor>
        <DxToolbar>
            <DxItem
                name="undo"
                locate-in-menu="always"
            />
            <DxItem
                name="color"
                locate-in-menu="never"
            />
        </DxToolbar>
    </DxHtmlEditor>
</template>

<script>
import 'devextreme/dist/css/dx.light.css';

import {
    DxHtmlEditor,
    DxToolbar,
    DxItem
} from 'devextreme-vue/html-editor';

export default {
    components: {
        DxHtmlEditor,
        DxToolbar,
        DxItem
    }
}
</script>
React
import React from 'react';
import 'devextreme/dist/css/dx.light.css';

import { HtmlEditor, Toolbar, Item } from 'devextreme-react/html-editor';

class App extends React.Component {
    render() {
        return (
            <HtmlEditor>
                <Toolbar>
                    <Item
                        name="undo"
                        locateInMenu="always"
                    />
                    <Item
                        name="color"
                        locateInMenu="never"
                    />
                </Toolbar>
            </HtmlEditor>
        );
    }
}

export default App;