A rich text editor that is designed to accept limited set of inline HTML tags only.
Branch: master
Clone or download
Latest commit 14d560a Jan 17, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE LAUNCH! May 17, 2017
README.md Reduce Function Argument(s) Dec 2, 2018
favicon.ico LAUNCH! May 17, 2017
index.html Reduce Function Argument(s) Dec 2, 2018
package.json Update Jun 27, 2018
rich-text-editor.css Reduce Function Argument(s) Dec 2, 2018
rich-text-editor.enter-x.html Updates May 20, 2017
rich-text-editor.html ditto May 17, 2017
rich-text-editor.js Small Bug Fix Jan 17, 2019
rich-text-editor.min.css Reduce Function Argument(s) Dec 2, 2018
rich-text-editor.min.js Small Bug Fix Jan 17, 2019
rich-text-editor.source-b-b-code.html Update May 22, 2017
rich-text-editor.source-markdown.html Update May 22, 2017
rich-text-editor.source-markdown.view-markdown.html Update May 22, 2017
rich-text-editor.t-custom.html Update May 22, 2017
rich-text-editor.t.abbr.html Reduce Function Argument(s) Dec 2, 2018
rich-text-editor.t.code.html Reduce Function Argument(s) Dec 2, 2018
rich-text-editor.t.color.html Reduce Function Argument(s) Dec 2, 2018
rich-text-editor.t.font.html Reduce Function Argument(s) Dec 2, 2018
rich-text-editor.t.img.html Reduce Function Argument(s) Dec 2, 2018
rich-text-editor.test.d.html Reduce Function Argument(s) Dec 2, 2018
rich-text-editor.test.destroy.html Updates May 20, 2017
rich-text-editor.test.focus.html Use SVG May 19, 2017
rich-text-editor.test.i.html Updates May 20, 2017
rich-text-editor.test.is.html Reduce Function Argument(s) Dec 2, 2018
rich-text-editor.test.paste.html Use SVG May 19, 2017
rich-text-editor.test.required.html Add Error State if Text Area is Required Aug 13, 2017
rich-text-editor.test.t-i.html Updates May 20, 2017
rich-text-editor.test.t.a.html Use SVG May 19, 2017
rich-text-editor.test.t.html Reduce Function Argument(s) Dec 2, 2018
rich-text-editor.test.v.html Use SVG May 19, 2017
rich-text-editor.test.view-key.html Reduce Function Argument(s) Dec 2, 2018
rich-text-editor.test.w.html Use SVG May 19, 2017
rich-text-editor.tool-custom.html Updates May 18, 2017
rich-text-editor.tool-position.html Update Jun 27, 2018
rich-text-editor.tool-state.html Bug Fix? Apr 27, 2018
rich-text-editor.tool-t.html Updates May 20, 2017
rich-text-editor.tool-v.html Updates May 20, 2017
rich-text-editor.tool-x.html Updates May 20, 2017
rich-text-editor.x-x.html Updates May 20, 2017

README.md

Rich Text Editor

A rich text editor that is designed to accept limited set of inline HTML tags only.

This rich text editor works best on any form that are accessible in the public such as comment form in a blog, chat form in a social media and question or answer form in a forum.

Rich Text Editor

Demo

Usage

<!DOCTYPE html>
<html dir="ltr">
  <head>
    <meta charset="utf-8">
    <title>Demo</title>
    <link href="rich-text-editor.min.css" rel="stylesheet">
  </head>
  <body>
    <textarea></textarea>
    <script src="rich-text-editor.min.js"></script>
    <script>
    var editor = new RTE(document.querySelector('textarea'));
    </script>
  </body>
</html>

Options

var editor = new RTE(source, config);
Variable Description
source The text area element.
config The configuration data. See below!
config = {
    classes: ['rich-text-editor'],
    tools: ['b', 'i', 'u', 'a', 'x'], // visible tool(s)
    tags: [ // allowed HTML tag(s)
        'a',
        'abbr',
        'b',
        'br',
        'code',
        'dfn',
        'del',
        'em',
        'i',
        'ins',
        'kbd',
        'mark',
        'p',
        'span',
        'strong',
        'u',
        'var'
    ],
    attributes: [ // allowed HTML attribute(s)
        'class',
        'data-[\\w-]+?',
        'href',
        'id',
        'rel',
        'style',
        'target',
        'title'
    ],
    text: {
        b: ['Bold', 'B', '⌘+B'],
        i: ['Italic', 'I', '⌘+I'],
        u: ['Underline', 'U', '⌘+U'],
        a: ['Link', 'A', '⌘+L'],
        x: ['Source', '&#x22ef;', '⌘+⇧+X']
    },
    tidy: true, // tidy HTML output?
    enter: true, // set to `false` to automatically submit the closest form on enter key press
    x: function(e, node) {}, // on mode change (view/source); set to `false` to disable the source view
    update: function(e, node) {} // on view/source update
};

Note: All block tags are not allowed except <p> tags without attributes.

Methods

Interactions

editor.focus();
editor.focus(0); // focus start
editor.focus(1); // focus end
editor.focus(true); // select all
editor.blur();
editor.enable();
editor.disable();
editor.create();
editor.destroy();

Properties

editor.lot; // selection storage [source, view]
editor.config; // editor configuration
editor.container; // editor container
editor.view; // editor view
editor.source; // editor source
editor.tools; // editor tools
editor.dialog; // editor dialog

Set Value

editor.set('Lorem ipsum dolor sit amet.');

Get Value

console.log(editor.get());

Save Selection

var s = editor.s();

Restore Selection

editor.r(s);

Get Selection

editor.v(); // as plain text
editor.v(true); // as HTML
editor.v(true, false); // as original selected HTML value in `editor.view`
editor.v(true, true, false); // as HTML and remove the wrapping `<p>` tag

Wrap Selection with HTML Element

editor.w('strong'); // toggle wrap/unwrap `<strong>` tag
editor.w('strong', 1); // force wrap `<strong>` tag
editor.w('strong', 0); // force unwrap `<strong>` tag

Wrap selection with HTML element and add attributes on that element:

var e = editor.w('a');
e.href = 'http://example.com';
e.rel = 'nofollow';
e.target = '_blank';

Collapse Selection

editor.c(0); // collapse to the start of the selection
editor.c(1); // collapse to the end of the selection

Insert HTML at Caret/Selection

editor.i('<img arc="file.png">', true); // select the inserted HTML
editor.i('<img arc="file.png">', 0); // put caret after the inserted HTML (insert before caret)
editor.i('<img arc="file.png">', 1); // put caret before the inserted HTML (insert after caret)

Get Selected HTML Node

editor.e(); // return list of nodes in the current selection
editor.e('a'); // check if the selected text is an `<a>` tag

Sanitize HTML

editor.f('foo bar <b>baz</b> <span>qux</span>');

Get Selection as Node

console.log(editor.n());

Create Selection Range

Create selection range from A node to B node.

var p = editor.view.querySelectorAll('p');
editor.m([p[0], p.pop()]);

Tool State

if (editor.is.e('strong')) {
    // caret was selecting a `<strong>` tag or is placed in a `<strong>` tag
}

Tool

Create

// id: the tool ID
// text: array of [title, content, description]
// fn: the function that will be triggered on click
// i: tool index from the current tool list (if not defined, tool will be put at the end of the list)
//
// editor.t(id, text, fn, i);

Create a bold button:

editor.t('b', ['Bold', '<b>B</b>', 'Ctrl+B'], function(e, node) { … });

Dialog

Create

// fn(e, input);
editor.d(placeholder, value, fn);

Show

editor.d.v();
editor.d.v(true); // save previous selection

Hide

editor.d.x();
editor.d.x(true); // restore previous selection
editor.d.x(true, true); // ignore the error, exit anyway

State

Check whether these elements are visible at the time:

editor.is.view; // the rich text editor view
editor.is.source; // the HTML source view
editor.is.dialog; // the dialog view
editor.is.focus; // check if cursor is active in the view
editor.is.blur; // check if cursor is not active in the view
editor.is.error; // check if there was an error