Nimble Pirate Monitor

    polar-tui-editor-react

    2.5.1 • Public • Published

    TOAST UI Editor for React

    This is a React component wrapping TOAST UI Editor.

    npm version

    🚩 Table of Contents

    Collect Statistics on the Use of Open Source

    React Wrapper of TOAST UI Editor applies Google Analytics (GA) to collect statistics on the use of open source, in order to identify how widely TOAST UI Editor is used throughout the world. It also serves as important index to determine the future course of projects. location.hostname (e.g. ui.toast.com) is to be collected and the sole purpose is nothing but to measure statistics on the usage. To disable GA, use the usageStatistics props like the example below.

    <Editor
      ...
      usageStatistics={false}
    />

    💾 Install

    Using npm

    npm install --save @toast-ui/react-editor

    📝 Usage

    Import

    You can use TOAST UI Editor for React as a ECMAScript module or a CommonJS module. As this module does not contain CSS files, you should import toastui-editor.css from @toast-ui/editor and codemirror.css from CodeMirror in the script.

    • ES Modules
    import 'codemirror/lib/codemirror.css';
    import '@toast-ui/editor/dist/toastui-editor.css';
    
    import { Editor } from '@toast-ui/react-editor';
    • CommonJS
    require('codemirror/lib/codemirror.css');
    require('@toast-ui/editor/dist/toastui-editor.css');
    
    const { Editor } = require('@toast-ui/react-editor');

    Props

    All the options of the TOAST UI Editor are supported in the form of props.

    import 'codemirror/lib/codemirror.css';
    import '@toast-ui/editor/dist/toastui-editor.css';
    
    import { Editor } from '@toast-ui/react-editor';
    
    const MyComponent = () => (
      <Editor
        initialValue="hello react editor world!"
        previewStyle="vertical"
        height="600px"
        initialEditType="markdown"
        useCommandShortcut={true}
      />
    );

    Instance Methods

    For using instance methods of TOAST UI Editor, first thing to do is creating Refs of wrapper component using createRef(). But the wrapper component does not provide a way to call instance methods of TOAST UI Editor directly. Instead, you can call getInstance() method of the wrapper component to get the instance, and call the methods on it.

    import 'codemirror/lib/codemirror.css';
    import '@toast-ui/editor/dist/toastui-editor.css';
    
    import { Editor } from '@toast-ui/react-editor';
    
    class MyComponent extends React.Component {
      editorRef = React.createRef();
    
      handleClick = () => {
        this.editorRef.current.getInstance().exec('Bold');
      };
    
      render() {
        return (
          <>
            <Editor
              previewStyle="vertical"
              height="400px"
              initialEditType="markdown"
              initialValue="hello"
              ref={this.editorRef}
            />
            <button onClick={this.handleClick}>make bold</button>
          </>
        );
      }
    }

    Getting the Root Element

    An instance of the wrapper component also provides a handy method for getting the root element. If you want to manipulate the root element directly, you can call getRootElement to get the element.

    import 'codemirror/lib/codemirror.css';
    import '@toast-ui/editor/dist/toastui-editor.css';
    
    import { Editor } from '@toast-ui/react-editor';
    
    class MyComponent extends React.Component {
      editorRef = React.createRef();
    
      handleClickButton = () => {
        this.editorRef.current.getRootElement().classList.add('my-editor-root');
      };
    
      render() {
        return (
          <>
            <Editor
              previewStyle="vertical"
              height="400px"
              initialEditType="markdown"
              initialValue="hello"
              ref={this.editorRef}
            />
            <button onClick={this.handleClickButton}>Click!</button>
          </>
        );
      }
    }

    Events

    All the events of TOAST UI Editor are supported in the form of on[EventName] props. The first letter of each event name should be capitalized. For example, for using focus event you can use onFocus prop like the example below.

    import 'codemirror/lib/codemirror.css';
    import '@toast-ui/editor/dist/toastui-editor.css';
    
    import { Editor } from '@toast-ui/react-editor';
    
    class MyComponent extends React.Component {
      handleFocus = () => {
        console.log('focus!!');
      };
    
      render() {
        return (
          <Editor
            previewStyle="vertical"
            height="400px"
            initialEditType="markdown"
            initialValue="hello"
            ref={this.editorRef}
            onFocus={this.handleFocus}
          />
        );
      }
    }

    Keywords

    none

    Install

    npm i polar-tui-editor-react

    Homepage

    ui.toast.com

    DownloadsWeekly Downloads

    1

    Version

    2.5.1

    License

    MIT

    Unpacked Size

    799 kB

    Total Files

    7

    Last publish

    Collaborators

    • bkdev