caymland-react-builder v1.1.0

Caymland React Editor

Installation

The easiest way to use React Email Editor is to install it from NPM and include it in your own React build process.

npm install caymland-react-editor --save

or

yarn add caymland-react-editor

Usage

Require the EmailEditor component and render it with JSX:

import React, { useRef } from 'react';
import { render } from 'react-dom';

import EmailEditor from 'caymland-react-editor';

const App = (props) => {
  const emailEditorRef = useRef(null);

  const exportHtml = () => {
    emailEditorRef.current.editor.exportHtml((data) => {
      const { design, html } = data;
      console.log('exportHtml', html);
    });
  };

  const onReady = () => {
    // editor is ready
    // you can load your template here;
    // const templateJson = {};
    // emailEditorRef.current.editor.loadDesign(templateJson);
  };

  return (
    <div>
      <div>
        <button onClick={exportHtml}>Export HTML</button>
      </div>

      <EmailEditor displayMode="email" ref={emailEditorRef} onReady={onReady} />
    </div>
  );
};

render(<App />, document.getElementById('app'));

Methods

See the example source for a reference implementation.

Properties

• editorId String HTML div id of the container where the editor will be embedded (optional)
• displayMode String style object for the editor container (required 'email' | 'web' | 'popup')
• style Object style object for the editor container (default {})
• minHeight String minimum height to initialize the editor with (default 500px)
• onLoad Function called when the editor instance is created
• onReady Function called when the editor has finished loading
• options Object options passed to the Unlayer editor instance (default {})
• tools Object configuration for the built-in and custom tools (default {})
• appearance Object configuration for appearance and theme (default {})
• projectId Integer Unlayer project ID (optional)

See the Unlayer Docs for all available options.

Custom Tools

Custom tools can help you add your own content blocks to the editor. Every application is different and needs different tools to reach it's full potential. Learn More

License

Copyright (c) 2023 Unlayer. MIT Licensed.