jQuery HtmlEditor - 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: [
{ formatName: "undo", location: "after" },
{ formatName: "redo", location: "after" },
"alignLeft", "alignRight",
{ formatName: "color", location: "center" },
{ formatName: "background", location: "center" }
]
}
});
});Angular
HTML
TypeScript
<dx-html-editor>
<dxo-toolbar>
<dxi-item formatName="undo" location="after"></dxi-item>
<dxi-item formatName="redo" location="after"></dxi-item>
<dxi-item formatName="alignLeft"></dxi-item>
<dxi-item formatName="alignRight"></dxi-item>
<dxi-item formatName="color" location="center"></dxi-item>
<dxi-item formatName="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
format-name="undo"
location="after"
/>
<DxItem
format-name="redo"
location="after"
/>
<DxItem format-name="alignLeft"/>
<DxItem format-name="alignRight"/>
<DxItem
format-name="color"
location="center"
/>
<DxItem
format-name="background"
location="center"
/>
</DxToolbar>
</DxHtmlEditor>
</template>
<script>
import 'devextreme/dist/css/dx.common.css';
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.common.css';
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
formatName="undo"
location="after"
/>
<Item
formatName="redo"
location="after"
/>
<Item formatName="alignLeft"/>
<Item formatName="alignRight"/>
<Item
formatName="color"
location="center"
/>
<Item
formatName="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: [
// ...
{ formatName: "undo", locateInMenu: "always" },
{ formatName: "color", locateInMenu: "never" }
]
}
});
});Angular
HTML
TypeScript
<dx-html-editor>
<dxo-toolbar>
<!-- ... -->
<dxi-item formatName="undo" locateInMenu="always"></dxi-item>
<dxi-item formatName="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
format-name="undo"
locate-in-menu="always"
/>
<DxItem
format-name="color"
locate-in-menu="never"
/>
</DxToolbar>
</DxHtmlEditor>
</template>
<script>
import 'devextreme/dist/css/dx.common.css';
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.common.css';
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
formatName="undo"
locateInMenu="always"
/>
<Item
formatName="color"
locateInMenu="never"
/>
</Toolbar>
</HtmlEditor>
);
}
}
export default App;Feedback