Editor modes in Vue Rich text editor component
11 Jun 202422 minutes to read
The Rich Text Editor component used to create and edit the content and return valid HTML markup or markdown (MD) of the content. It supports the following two editing formation.
- HTML editor
- Markdown editor
HTML editor
Rich Text Editor is a WYSIWYG editing control for formatting the word content as HTML.
The HTML editing mode is the default mode in Rich Text Editor to format the content through the available toolbar items to return the valid HTML markup. Set the editorMode property as HTML.
To create Rich Text Editor with HTML editing feature, inject the
HtmlEditor
module to the Rich Text Editor using theRichTextEditor.Inject(HtmlEditor)
method.
<template>
<ejs-richtexteditor ref="defaultRTE" :height="340">
<p>The Rich Text Editor component is WYSIWYG ("what you see is what you get") editor that provides the best user experience to create and update the content. Users can format their content using standard toolbar commands.</p>
<p><b>Key features:</b></p>
<ul>
<li>
<p>Provides IFRAME and DIV modes</p>
</li>
<li>
<p>Capable of handling markdown editing.</p>
</li>
<li>
<p>Contains a modular library to load the necessary functionality on demand.</p>
</li>
<li>
<p>Provides a fully customizable toolbar.</p>
</li>
<li>
<p>Provides HTML view to edit the source directly for developers.</p>
</li>
<li>
<p>Supports third-party library integration.</p>
</li>
<li>
<p>Allows preview of modified content before saving it.</p>
</li>
<li>
<p>Handles images, hyperlinks, video, hyperlinks, uploads, etc.</p>
</li>
</ul>
</ejs-richtexteditor>
</template>
<script setup>
import { provide } from "vue";
import { RichTextEditorComponent as EjsRichtexteditor, Toolbar, Link, Image, HtmlEditor, QuickToolbar } from '@syncfusion/ej2-vue-richtexteditor';
provide('richtexteditor', [Toolbar, Link, Image, HtmlEditor, QuickToolbar]);
</script>
<style>
@import "https://ej2.syncfusion.com/vue/documentation/../node_modules/@syncfusion/ej2-base/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-inputs/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-lists/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-popups/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-buttons/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-navigations/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-splitbuttons/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-vue-richtexteditor/styles/material.css";
</style>
<template>
<ejs-richtexteditor ref="defaultRTE" :height="340">
<p>The Rich Text Editor component is WYSIWYG ("what you see is what you get") editor that provides the best user experience to create and update the content. Users can format their content using standard toolbar commands.</p>
<p><b>Key features:</b></p>
<ul>
<li>
<p>Provides IFRAME and DIV modes</p>
</li>
<li>
<p>Capable of handling markdown editing.</p>
</li>
<li>
<p>Contains a modular library to load the necessary functionality on demand.</p>
</li>
<li>
<p>Provides a fully customizable toolbar.</p>
</li>
<li>
<p>Provides HTML view to edit the source directly for developers.</p>
</li>
<li>
<p>Supports third-party library integration.</p>
</li>
<li>
<p>Allows preview of modified content before saving it.</p>
</li>
<li>
<p>Handles images, hyperlinks, video, hyperlinks, uploads, etc.</p>
</li>
</ul>
</ejs-richtexteditor>
</template>
<script>
import { RichTextEditorComponent, Toolbar, Link, Image, HtmlEditor, QuickToolbar } from '@syncfusion/ej2-vue-richtexteditor';
export default {
name: "App",
components: {
"ejs-richtexteditor":RichTextEditorComponent
},
provide: {
richtexteditor: [Toolbar, Link, Image, HtmlEditor, QuickToolbar]
}
}
</script>
<style>
@import "https://ej2.syncfusion.com/vue/documentation/../node_modules/@syncfusion/ej2-base/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-inputs/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-lists/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-popups/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-buttons/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-navigations/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-splitbuttons/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-vue-richtexteditor/styles/material.css";
</style>
Markdown editor
Set the editorMode property as Markdown, to create or edit the content and apply formatting to view markdown formatted content.
The third-party library such as Marked
or any other library is used to convert markdown into HTML content.
- Supported tags are
h6
,h5
,h4
,h3
,h2
,h1
,blockquote
,pre
,p
,OL
, andUL
. - Supported selection tags are
Bold
,Italic
,StrikeThrough
,InlineCode
,SubScript
,SuperScript
,UpperCase
, andLowerCase
.
<template>
<ejs-richtexteditor ref="rteInstance" :height="350" editorMode="Markdown" :value="value"
:toolbarSettings="toolbarConfig" :created="created">
</ejs-richtexteditor>
</template>
<style>
.e-richtexteditor .e-rte-content .e-content {
min-height: 150px;
}
.e-richtexteditor .e-rte-content textarea.e-content {
float: left;
border-right: 1px solid rgba(0, 0, 0, 0.12);
}
.e-richtexteditor .e-rte-content {
overflow: hidden;
}
.e-md-preview::before {
content: '\e345';
}
.e-rte-content .e-content.e-pre-source {
width: 100%;
}
.e-icon-btn.e-active .e-md-preview.e-icons::before {
content: '\e350';
}
</style>
<script setup>
import { provide, ref } from "vue";
import { createElement, KeyboardEventArgs } from "@syncfusion/ej2-base";
import { RichTextEditorComponent as EjsRichtexteditor, Toolbar, Link, Image, MarkdownEditor } from '@syncfusion/ej2-vue-richtexteditor';
const rteInstance = ref(null);
const value = `***Overview***
The Rich Text Editor component is WYSIWYG ("what you see is what you get") editor used to create and edit the content and return valid HTML markup or markdown (MD) of the content. The editor provides a standard toolbar to format content using its commands. Modular library features to load the necessary functionality on demand. The toolbar contains commands to align the text, insert link, insert image, insert list, undo/redo operation, HTML view, and more.
***Key features***
- *Mode*: Provides IFRAME and DIV mode.
- *Module*: Modular library to load the necessary functionality on demand.
- *Toolbar*: Provide a fully customizable toolbar.
- *Editing*: HTML view to edit the source directly for developers.
- *Third-party Integration*: Supports to integrate third-party library.
- *Preview*: Preview the modified content before saving it.
- *Tools*: Handling images, hyperlinks, video, uploads and more.
- *Undo and Redo*: Undo/redo manager.
- *Lists*:Creates bulleted and numbered list.`;
const toolbarConfig = {
items: [
'Bold', 'Italic', 'StrikeThrough', '|',
'Formats', 'OrderedList', 'UnorderedList', '|',
'CreateLink', 'Image', '|',
{
tooltipText: 'Preview',
template: '<button id="preview-code" class="e-tbar-btn e-control e-btn e-icon-btn">' +
'<span class="e-btn-icon e-md-preview e-icons"></span></button>'
},
'|', 'Undo', 'Redo'
]
};
const created = function () {
const textArea = rteInstance.value.ej2Instances.element.querySelector('.e-content');
textArea.onkeyup = (Event) => {
markDownConversion();
};
document.getElementById('preview-code').onclick = () => {
fullPreview({ mode: true, type: 'preview' });
if (event.target.parentElement.classList.contains('e-active')) {
rteInstance.value.ej2Instances.disableToolbarItem([
'Bold', 'Italic', 'StrikeThrough', 'Formats', 'OrderedList',
'UnorderedList', 'CreateLink', 'Image'
]);
event.target.parentElement.parentElement.nextElementSibling.classList.add('e-overlay');
} else {
rteInstance.value.ej2Instances.enableToolbarItem([
'Bold', 'Italic', 'StrikeThrough', 'Formats', 'OrderedList',
'UnorderedList', 'CreateLink', 'Image'
]);
event.target.parentElement.parentElement.nextElementSibling.classList.remove('e-overlay');
}
};
};
const markDownConversion = function () {
if (document.getElementById('preview-code').classList.contains('e-active')) {
const id = rteInstance.value.ej2Instance.getID() + 'html-view';
const htmlPreview = rteInstance.value.ej2Instances.element.querySelector('#' + id);
htmlPreview.innerHTML = marked.parse(textArea.value);
}
};
const fullPreview = function (event) {
const mdSource = document.getElementById('preview-code');
const id = rteInstance.value.ej2Instance.getID() + 'html-view';
const htmlPreview = rteInstance.value.ej2Instances.element.querySelector('#' + id);
if ((mdSource.classList.contains('e-active')) && event.mode) {
mdSource.classList.remove('e-active');
textArea.style.display = 'block';
textArea.style.width = '100%';
htmlPreview.style.display = 'none';
} else {
mdSource.classList.add('e-active');
if (!htmlPreview) {
htmlPreview = document.createElement('div');
htmlPreview.id = id;
htmlPreview.setAttribute('class', 'e-content');
textArea.parentNode.appendChild(htmlPreview);
}
if (event.type === 'preview') {
textArea.style.display = 'none';
htmlPreview.classList.add('e-pre-source');
} else {
htmlPreview.classList.remove('e-pre-source');
textArea.style.width = '50%';
}
htmlPreview.style.display = 'block';
htmlPreview.innerHTML = marked.parse(rteInstance.value.ej2Instances.contentModule.getEditPanel().value);
mdSource.parentElement.title = 'Code View';
}
};
provide('richtexteditor', [Toolbar, Link, Image, MarkdownEditor]);
</script>
<style>
@import "../../node_modules/@syncfusion/ej2-base/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-inputs/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-lists/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-popups/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-buttons/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-navigations/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-splitbuttons/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-vue-richtexteditor/styles/material.css";
</style>
<template>
<ejs-richtexteditor ref="rteInstance" :height="350" editorMode="Markdown" :value="value"
:toolbarSettings="toolbarConfig" :created="created">
</ejs-richtexteditor>
</template>
<style>
.e-richtexteditor .e-rte-content .e-content {
min-height: 150px;
}
.e-richtexteditor .e-rte-content textarea.e-content {
float: left;
border-right: 1px solid rgba(0, 0, 0, 0.12);
}
.e-richtexteditor .e-rte-content {
overflow: hidden;
}
.e-md-preview::before {
content: '\e345';
}
.e-rte-content .e-content.e-pre-source {
width: 100%;
}
.e-icon-btn.e-active .e-md-preview.e-icons::before {
content: '\e350';
}
</style>
<script>
import { createElement, KeyboardEventArgs } from "@syncfusion/ej2-base";
import { RichTextEditorComponent, Toolbar, Link, Image, MarkdownEditor } from '@syncfusion/ej2-vue-richtexteditor';
export default {
name: "App",
components: {
"ejs-richtexteditor": RichTextEditorComponent
},
data() {
return {
value: `***Overview***
The Rich Text Editor component is WYSIWYG ("what you see is what you get") editor used to create and edit the content and return valid HTML markup or markdown (MD) of the content. The editor provides a standard toolbar to format content using its commands. Modular library features to load the necessary functionality on demand. The toolbar contains commands to align the text, insert link, insert image, insert list, undo/redo operation, HTML view, and more.
***Key features***
- *Mode*: Provides IFRAME and DIV mode.
- *Module*: Modular library to load the necessary functionality on demand.
- *Toolbar*: Provide a fully customizable toolbar.
- *Editing*: HTML view to edit the source directly for developers.
- *Third-party Integration*: Supports to integrate third-party library.
- *Preview*: Preview the modified content before saving it.
- *Tools*: Handling images, hyperlinks, video, uploads and more.
- *Undo and Redo*: Undo/redo manager.
- *Lists*:Creates bulleted and numbered list.`,
toolbarConfig: {
items: [
'Bold', 'Italic', 'StrikeThrough', '|',
'Formats', 'OrderedList', 'UnorderedList', '|',
'CreateLink', 'Image', '|',
{
tooltipText: 'Preview',
template: '<button id="preview-code" class="e-tbar-btn e-control e-btn e-icon-btn">' +
'<span class="e-btn-icon e-md-preview e-icons"></span></button>'
},
'|', 'Undo', 'Redo'
]
}
}
},
methods: {
created: function () {
this.textArea = this.$refs.rteInstance.$el.ej2_instances[0].element.querySelector('.e-content');
this.textArea.onkeyup = (Event) => {
this.markDownConversion();
};
document.getElementById('preview-code').onclick = () => {
this.fullPreview({ mode: true, type: 'preview' });
if (event.target.parentElement.classList.contains('e-active')) {
this.$refs.rteInstance.ej2Instances.disableToolbarItem([
'Bold', 'Italic', 'StrikeThrough', 'Formats', 'OrderedList',
'UnorderedList', 'CreateLink', 'Image'
]);
event.target.parentElement.parentElement.nextElementSibling.classList.add('e-overlay');
} else {
this.$refs.rteInstance.ej2Instances.enableToolbarItem([
'Bold', 'Italic', 'StrikeThrough', 'Formats', 'OrderedList',
'UnorderedList', 'CreateLink', 'Image'
]);
event.target.parentElement.parentElement.nextElementSibling.classList.remove('e-overlay');
}
};
},
markDownConversion: function () {
if (document.getElementById('preview-code').classList.contains('e-active')) {
var id = this.$refs.rteInstance.ej2Instance.getID() + 'html-view';
var htmlPreview = this.$refs.rteInstance.$el.ej2_instances[0].element.querySelector('#' + id);
htmlPreview.innerHTML = marked.parse(this.textArea.value);
}
},
fullPreview: function (event) {
var mdSource = document.getElementById('preview-code');
var id = this.$refs.rteInstance.ej2Instance.getID() + 'html-view';
var htmlPreview = this.$refs.rteInstance.$el.ej2_instances[0].element.querySelector('#' + id);
if ((mdSource.classList.contains('e-active')) && event.mode) {
mdSource.classList.remove('e-active');
this.textArea.style.display = 'block';
this.textArea.style.width = '100%';
htmlPreview.style.display = 'none';
} else {
mdSource.classList.add('e-active');
if (!htmlPreview) {
htmlPreview = document.createElement('div');
htmlPreview.id = id;
htmlPreview.setAttribute('class', 'e-content');
this.textArea.parentNode.appendChild(htmlPreview);
}
if (event.type === 'preview') {
this.textArea.style.display = 'none';
htmlPreview.classList.add('e-pre-source');
} else {
htmlPreview.classList.remove('e-pre-source');
this.textArea.style.width = '50%';
}
htmlPreview.style.display = 'block';
htmlPreview.innerHTML = marked.parse(this.$refs.rteInstance.ej2Instances.contentModule.getEditPanel().value);
mdSource.parentElement.title = 'Code View';
}
}
},
provide: {
richtexteditor: [Toolbar, Link, Image, MarkdownEditor]
}
}
</script>
<style>
@import "../../node_modules/@syncfusion/ej2-base/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-inputs/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-lists/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-popups/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-buttons/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-navigations/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-splitbuttons/styles/material.css";
@import "../../node_modules/@syncfusion/ej2-vue-richtexteditor/styles/material.css";
</style>
To create Rich Text Editor with Markdown editing feature, inject the
MarkdownEditor
module to the Rich Text Editor using theRichTextEditor.Inject(MarkdownEditor)
method.
For further details on Markdown editing, refer to the Markdown
section.