RichTextEditorComponent

RichTextEditor represents the react RichTextEditor.

<RichTextEditor/>

Properties

backgroundColor

BackgroundColorModel

Predefine the color palette that can be rendered for background color (text highlighted color) toolbar command.

Defaults to { columns: 5, colorCode: { ‘Custom’: [‘#ffff00’, ‘#00ff00’, ‘#00ffff’, ‘#ff00ff’, ‘#0000ff’, ‘#ff0000’, ‘#000080’, ‘#008080’, ‘#008000’, ‘#800080’, ‘#800000’, ‘#808000’, ‘#c0c0c0’, ‘#000000’, ”] }}

cssClass

string

Specifies the CSS class name appended with the root element of the RichTextEditor. One or more custom CSS classes can be added to a RichTextEditor.

Defaults to null

editorMode

string

Specifies the editing mode of the RichTextEditor.

• HTML - Render RichTextEditor as HTML editor using <IFRAME> element or content editable <div> element or <textarea> element.

• Markdown - Render RichTextEditor as markdown editor using <textarea>.

Defaults to ‘HTML’

enableHtmlEncode

boolean

specifies the value whether the source code is displayed with encoded format.

Defaults to false.

enablePersistence

boolean

Enables or disables the persisting component’s state between page reloads. If enabled, the value of RichTextEditor is persisted

Defaults to false.

enableRtl

boolean

Enable or disable rendering component in right to left direction.

Defaults to false

enableTabKey

boolean

Allows the tab key action in the RichTextEditor content.

Defaults to false

enabled

boolean

Specifies a value that indicates whether the component is enabled or not.

Defaults to true.

floatingToolbarOffset

number

Preserves the toolbar at the top of the RichTextEditor on scrolling and specifies the offset of the floating toolbar from documents top position

Defaults to 0

fontColor

FontColorModel

Predefine the color palette that can be rendered for font color toolbar command .

Defaults to { columns: 10, colorCode: { ‘Custom’: [ ”, ‘#000000’, ‘#e7e6e6’, ‘#44546a’, ‘#4472c4’, ‘#ed7d31’, ‘#a5a5a5’, ‘#ffc000’, ‘#70ad47’, ‘#ff0000’, ‘#f2f2f2’, ‘#808080’, ‘#cfcdcd’, ‘#d5dce4’, ‘#d9e2f3’, ‘#fbe4d5’, ‘#ededed’, ‘#fff2cc’, ‘#e2efd9’, ‘#ffcccc’, ‘#d9d9d9’, ‘#595959’, ‘#aeaaaa’, ‘#acb9ca’, ‘#b4c6e7’, ‘#f7caac’, ‘#dbdbdb’, ‘#ffe599’, ‘#c5e0b3’, ‘#ff8080’, ‘#bfbfbf’, ‘#404040’, ‘#747070’, ‘#8496b0’, ‘#8eaadb’, ‘#f4b083’, ‘#c9c9c9’, ‘#ffd966’, ‘#a8d08d’, ‘#ff3333’, ‘#a6a6a6’, ‘#262626’, ‘#3b3838’, ‘#323e4f’, ‘#2f5496’, ‘#c45911’, ‘#7b7b7b’, ‘#bf8f00’, ‘#538135’, ‘#b30000’, ‘#7f7f7f’, ‘#0d0d0d’, ‘#161616’, ‘#212934’, ‘#1f3763’, ‘#823b0b’, ‘#525252’, ‘#7f5f00’, ‘#375623’, ‘#660000’] } }

fontFamily

FontFamilyModel

Predefine the font families that populate in font family dropdown list from the toolbar.

Defaults to { default: ‘Segoe UI’, width: ‘65px’, items: [ { text: ‘Segoe UI’, value: ‘Segoe UI’ }, { text: ‘Arial’, value: ‘Arial,Helvetica,sans-serif’ }, { text: ‘Courier New’, value: ‘Courier New,Courier,monospace’ }, { text: ‘Georgia’, value: ‘Georgia,serif’ }, { text: ‘Impact’, value: ‘Impact,Charcoal,sans-serif’ }, { text: ‘Lucida Console’, value: ‘Lucida Console,Monaco,monospace’ }, { text: ‘Tahoma’, value: ‘Tahoma,Geneva,sans-serif’ }, { text: ‘Times New Roman’, value: ‘Times New Roman,Times,serif’ }, { text: ‘Trebuchet MS’, value: ‘Trebuchet MS,Helvetica,sans-serif’ }, { text: ‘Verdana’, value: ‘Verdana,Geneva,sans-serif’ } ]}

fontSize

FontSizeModel

Predefine the font sizes that populate in font size dropdown list from the toolbar.

Defaults to { default: ‘10’, width: ‘35px’, items: [ { text: ‘8’, value: ‘8pt’ }, { text: ‘10’, value: ‘10pt’ }, { text: ‘12’, value: ‘12pt’ }, { text: ‘14’, value: ‘14pt’ }, { text: ‘18’, value: ‘18pt’ }, { text: ‘24’, value: ‘24pt’ }, { text: ‘36’, value: ‘36pt’ } ]}

format

FormatModel

Predefine the collection of paragraph styles along with quote and code style that populate in format dropdown from the toolbar.

Defaults to { default: ‘Paragraph’, width: ‘65px’, types: [ { text: ‘Paragraph’ }, { text: ‘Code’ }, { text: ‘Quotation’ }, { text: ‘Heading 1’ }, { text: ‘Heading 2’ }, { text: ‘Heading 3’ }, { text: ‘Heading 4’ }, { text: ‘Heading 5’ }, { text: ‘Heading 6’ } ]}

formatter

IFormatter

Customize keyCode to change the key value.

Defaults to null

height

string | number

Specifies the height of the RichTextEditor component.

Defaults to “auto”

htmlAttributes

Object

Allows additional HTML attributes such as title, name, etc., and It will be accepts n number of attributes in a key-value pair format.

Defaults to {}.

iframeSettings

IFrameSettingsModel

Specifies the items to be rendered in an iframe mode, and it has the following properties.

• enable - Set Boolean value to enable, the editors content is placed in an iframe and isolated from the rest of the page.
• attributes - Custom style to be used inside the iframe to display content. This style is added to the iframe body.

• resources - we can add both styles and scripts to the iframe.

  1. styles[] - An array of CSS style files to inject inside the iframe to display content
  2. scripts[] - An array of JS script files to inject inside the iframe

Defaults to { enable: false, attributes: null, resources: { styles: [], scripts: [] }}

inlineMode

InlineModeModel

Enable or disable the inline edit mode.

• enable - set boolean value to enable or disable the inline edit mode.
• onSelection - If its set to true, upon selecting the text, the toolbar is opened in inline. If its set to false, upon clicking to the target element, the toolbar is opened.

Defaults to { enable: false, onSelection: true}

insertImageSettings

ImageSettingsModel

Specifies the image insert options in RichTextEditor component and control with the following properties.

• allowedTypes - Specifies the extensions of the image types allowed to insert on bowering and passing the extensions with comma separators. For example, pass allowedTypes as .jpg and .png.
• display - Sets the default display for an image when it is inserted in to the RichTextEditor. Possible options are: ‘inline’ and ‘block’.
• width - Sets the default width of the image when it is inserted in the RichTextEditor.
• height - Sets the default height of the image when it is inserted in the RichTextEditor.
• saveUrl - Provides URL to map the action result method to save the image.
• path - Specifies the location to store the image.

Defaults to { allowedTypes: [‘.jpeg’, ‘.jpg’, ‘.png’], display: ‘inline’, width: ‘auto’, height: ‘auto’, saveUrl: null, path: null,}

keyConfig

Object

Customizes the key actions in RichTextEditor. For example, when using German keyboard, the key actions can be customized using these shortcuts.

Defaults to null

locale

string

Overrides the global culture and localization value for this component. Default global culture is ‘en-US’.

Defaults to ”

maxLength

number

Specifies the maximum number of characters allowed in the RichTextEditor component.

Defaults to -1

pasteCleanupSettings

PasteCleanupSettingsModel

Specifies the pasting options in RichTextEditor component and control with the following properties.

• prompt - Set boolean value to enable or disable the prompt when pasting.
• deniedAttrs - Specifies the attributes to restrict when pasting in RTE.
• allowedStyleProps - Specifies the allowed style properties when pasting in RTE.
• deniedTags - Specifies the tags to restrict when pasting in RTE.
• keepFormat - Set boolean value to keep or remove the from when pasting.
• plainText - Set boolean value to paste as plain text or not.

Defaults to { prompt: false, deniedAttrs: null, allowedStyleProps: [‘background’, ‘background-color’, ‘border’, ‘border-bottom’, ‘border-left’, ‘border-radius’, ‘border-right’, ‘border-style’, ‘border-top’, ‘border-width’, ‘clear’, ‘color’, ‘cursor’, ‘direction’, ‘display’, ‘float’, ‘font’, ‘font-family’, ‘font-size’, ‘font-weight’, ‘font-style’, ‘height’, ‘left’, ‘line-height’, ‘margin’, ‘margin-top’, ‘margin-left’, ‘margin-right’, ‘margin-bottom’, ‘max-height’, ‘max-width’, ‘min-height’, ‘min-width’, ‘overflow’, ‘overflow-x’, ‘overflow-y’, ‘padding’, ‘padding-bottom’, ‘padding-left’, ‘padding-right’, ‘padding-top’, ‘position’, ‘right’, ‘table-layout’, ‘text-align’, ‘text-decoration’, ‘text-indent’, ‘top’, ‘vertical-align’, ‘visibility’, ‘white-space’, ‘width’], deniedTags: null, keepFormat: true, plainText: false}

placeholder

string

Specifies the placeholder for the RichTextEditor’s content used when the RichTextEditor body is empty.

Defaults to null.

quickToolbarSettings

QuickToolbarSettingsModel

Specifies the items to be rendered in quick toolbar based on the target element.

• It has following fields:
• enable - set boolean value to show or hide the quick toolbar

• actionOnScroll - it has two possible options

  1. hide: The quickToolbar is closed when the parent element is scrolled.
  2. none: The quickToolbar cannot be closed even the parent element is scrolled.
• link - Specifies the items to be rendered in quick toolbar based on link element such as Open, Edit, and UnLink.
• image - Specifies the items to be rendered in quick toolbar based on image element such as ‘Replace’, ‘Align’, ‘Caption’, ‘Remove’, ‘InsertLink’, ‘Display’, ‘AltText’, ‘Dimension’.
• text - Specifies the items to be rendered in quick toolbar based on text element such as ‘Cut’, ‘Copy’, ‘Paste’.

Defaults to { enable: true, actionOnScroll: ‘hide’, link: [‘Open’, ‘Edit’, ‘UnLink’], image: [‘Replace’, ‘Align’, ‘Caption’, ‘Remove’, ’-’, ‘InsertLink’, ‘Display’, ‘AltText’, ‘Dimension’], text: [‘Cut’, ‘Copy’, ‘Paste’]}

readonly

boolean

The user interactions on the component are disabled, when set to true.

Defaults to false.

saveInterval

number

Specifies the saveInterval in milliseconds for autosave the value. The change event will be triggered if the content was changed from the last saved interval.

Defaults to 10000

showCharCount

boolean

Sets Boolean value to enable or disable the display of the character counter.

Defaults to false

tableSettings

TableSettingsModel

Specifies the table insert options in RichTextEditor component and control with the following properties.

• styles - Class name should be appended by default in table element. It helps to design the table in specific CSS styles always when inserting in editor.
• width - Sets the default width of the table when it is inserted in the RichTextEditor.
• minWidth - Sets the default minWidth of the table when it is inserted in the RichTextEditor.
• maxWidth - Sets the default maxWidth of the table when it is inserted in the RichTextEditor.
• resize - To enable resize the table.

Defaults to { width: ‘100%’, styles: [{ text: ‘Dashed Borders’, class: ‘e-dashed-borders’, command: ‘Table’, subCommand: ‘Dashed’ },{ text: ‘Alternate Rows’, class: ‘e-alternate-rows’, command: ‘Table’, subCommand: ‘Alternate’ }],resize: true, minWidth: 0, maxWidth: null,}

toolbarSettings

ToolbarSettingsModel

Specifies the group of items aligned horizontally in the toolbar as well as defined the toolbar rendering type. By default, toolbar is float at the top of the RichTextEditor. When you scroll down, the toolbar will scroll along with the page on RichTextEditor with the specified offset value.

• enable: set boolean value to show or hide the toolbar.
• enableFloating: Set Boolean value to enable or disable the floating toolbar. Preserves the toolbar at top of the RichTextEditor on scrolling.

• type: it has two possible options

  1. Expand: Hide the overflowing toolbar items in the next row. Click the expand arrow to view overflowing toolbar items
  2. MultiRow: The toolbar overflowing items wrapped in the next row.

• items: Specifies the array of items aligned horizontally in the toolbar.

  | and - can insert a vertical and horizontal separator lines in the toolbar.

• itemConfigs: Modify the default toolbar item configuration like icon class.

Defaults to { enable: true, enableFloating: true, type: ToolbarType.Expand, items: [‘Bold’, ‘Italic’, ‘Underline’, ’|’, ‘Formats’, ‘Alignments’, ‘OrderedList’, ‘UnorderedList’, ’|’, ‘CreateLink’, ‘Image’, ’|’, ‘SourceCode’, ‘Undo’, ‘Redo’], itemConfigs: {}}

undoRedoSteps

number

Specifies the count of undo history which is stored in undoRedoManager.

Defaults to 30

undoRedoTimer

number

Specifies the interval value in milliseconds that store actions in undoRedoManager. The minimum value is 300 milliseconds.

Defaults to 300

value

string

Specifies the value displayed in the RichTextEditor’s content area and it should be string. The content of RichTextEditor can be loaded with dynamic data such as database, AJAX content, and more.

Defaults to null

valueTemplate

string

Accepts the template design and assigns it as RichTextEditor’s content. The built-in template engine which provides options to compile template string into a executable function. For EX: We have expression evolution as like ES6 expression string literals

Defaults to null

width

string | number

Specifies the width of the RichTextEditor.

Defaults to ‘100%’

Methods

destroy

Destroys the component (detaches/removes all event handlers, attributes, classes, and empties the component element).

Returns void

disableToolbarItem

Disables the given toolbar items in the RichTextEditor component.

Returns void

enableToolbarItem

Enables the give toolbar items in the RichTextEditor component.

Returns void

executeCommand

Executes the commands

Returns void

focusIn

Focuses the RichTextEditor component

Returns void

focusOut

Blurs the RichTextEditor component

Returns void

getContent

Returns the HTML or Text inside the RichTextEditor.

Returns Element

getHtml

Retrieves the HTML from RichTextEditor.

Returns string

getRange

Get the selected range from the RichTextEditor’s content.

Returns Range

getSelection

Retrieves the HTML markup content from currently selected content of RichTextEditor.

Returns string

getText

Returns the text content as string.

Returns string

print

By default, prints all the pages of the RichTextEditor.

Returns void

refresh

Applies all the pending property changes and render the component again.

Returns void

removeToolbarItem

Removes the give toolbar items from the RichTextEditor component.

Returns void

sanitizeHtml

This method will clean up the HTML against cross-site scripting attack and return the HTML as string. It’s only applicable to editorMode as HTML.

Returns string

selectAll

Selects all the content in RichTextEditor

Returns void

selectRange

Selects a content range or an element

Returns void

showFullScreen

Shows the RichTextEditor component in full-screen mode.

Returns void

showSourceCode

Shows the source HTML/MD markup.

Returns void

Events

actionBegin

EmitType<ActionBeginEventArgs>

Triggers before command execution using toolbar items or executeCommand method. If you cancel this event, the command cannot be executed. Set the cancel argument to true to cancel the command execution.

actionComplete

EmitType<ActionCompleteEventArgs>

Triggers after command execution using toolbar items or executeCommand method.

beforeDialogOpen

EmitType<BeforeOpenEventArgs>

Event triggers when the dialog is being opened. If you cancel this event, the dialog remains closed. Set the cancel argument to true to cancel the open of a dialog.

beforeQuickToolbarOpen

EmitType<BeforeQuickToolbarOpenArgs>

Event triggers when the quick toolbar is being opened.

beforeSanitizeHtml

EmitType<BeforeSanitizeHtmlArgs>

Event triggers before sanitize the value. It’s only applicable to editorMode as HTML.

blur

EmitType<Object>

Triggers when RichTextEditor is focused out.

change

EmitType<ChangeEventArgs>

Triggers only when RichTextEditor is blurred and changes are done to the content.

created

EmitType<Object>

Triggers when the RichTextEditor is rendered.

destroyed

EmitType<Object>

Triggers when the RichTextEditor is destroyed.

dialogClose

EmitType<Object>

Event triggers after the dialog has been closed.

dialogOpen

EmitType<Object>

Event triggers when a dialog is opened.

focus

EmitType<Object>

Triggers when RichTextEditor is focused in

quickToolbarClose

EmitType<Object>

Event triggers after the quick toolbar has been closed.

quickToolbarOpen

EmitType<Object>

Event triggers when a quick toolbar is opened.

resizeStart

EmitType<ResizeArgs>

Triggers only when start resize the image.

resizeStop

EmitType<ResizeArgs>

Triggers only when stop resize the image.

resizing

EmitType<ResizeArgs>

Triggers only when resizing the image.

toolbarClick

EmitType<Object>

Triggers when RichTextEditor Toolbar items is clicked.