embed-ui v1.0.1

Embed UI Tool

Provides Block tool for embedded content for the Editor.js. Tool uses Editor.js pasted patterns handling and inserts iframe with embedded content. Forked from the Editorjs Embed Tool, and updated to show tool in toolbox and include an input prompt for better UI.

List of services supported

service — is a service name that will be saved to Tool's output JSON

• Facebook - facebook service
• Instagram - instagram service
• YouTube - youtube service
• Twitter - twitter service. (https://twitframe.com used for render)
• Twitch - twitch-video service for videos and twitch-channel for channels
• Miro - miro service
• Vimeo — vimeo service
• Gfycat — gfycat service
• Imgur — imgur service
• Vine - vine service. The project is in archive state now
• Aparat - aparat service
• Yandex.Music - yandex-music-track service for tracks, yandex-music-album for albums and yandex-music-playlist for playlists
• Coub — coub service
• CodePen — codepen service
• Pinterest - pinterest service
• Loom - loom service
• 👇 Any other customized service

Installation

Install via NPM

Get the package

npm i embed-ui

Include module at your application

import Embed from "embed-ui";

Usage

Add a new Tool to the tools property of the Editor.js initial config.

var editor = EditorJS({
  ...

  tools: {
    ...
    embed: Embed,
  },

  ...
});

Available configuration

Enabling / disabling services

Embed Tool supports some services by default (see above). You can specify services you would like to use:

var editor = EditorJS({
  ...

  tools: {
    ...
    embed: {
      class: Embed,
      config: {
        services: {
          youtube: true,
          loom: true
        }
      }
    },
  },

  ...
});

Note that if you pass services you want to use like in the example above, others will not be enabled.

Add more services

You can provide your own services using simple configuration.

First, you should create a Service configuration object. It contains following fields:

Example:

{
  regex: /https?:\/\/codepen.io\/([^\/\?\&]*)\/pen\/([^\/\?\&]*)/,
  embedUrl: 'https://codepen.io/<%= remote_id %>?height=300&theme-id=0&default-tab=css,result&embed-version=2',
  html: "<iframe height='300' scrolling='no' frameborder='no' allowtransparency='true' allowfullscreen='true' style='width: 100%;'></iframe>",
  height: 300,
  width: 600,
  id: (groups) => groups.join('/embed/')
}

When you create a Service configuration object, you can provide it with Tool`s configuration:

var editor = EditorJS({
  ...

  tools: {
    ...
    embed: {
      class: Embed,
      config: {
        services: {
          youtube: true,
          coub: true,
          codepen: {
            regex: /https?:\/\/codepen.io\/([^\/\?\&]*)\/pen\/([^\/\?\&]*)/,
            embedUrl: 'https://codepen.io/<%= remote_id %>?height=300&theme-id=0&default-tab=css,result&embed-version=2',
            html: "<iframe height='300' scrolling='no' frameborder='no' allowtransparency='true' allowfullscreen='true' style='width: 100%;'></iframe>",
            height: 300,
            width: 600,
            id: (groups) => groups.join('/embed/')
          }
        }
      }
    },
  },

  ...
});

Inline Toolbar

Editor.js provides useful inline toolbar. You can allow it`s usage in the Embed Tool caption by providing inlineToolbar: true.

var editor = EditorJS({
  ...

  tools: {
    ...
    embed: {
      class: Embed,
      inlineToolbar: true
    },
  },

  ...
});

Output data

{
  "type": "embed",
  "data": {
    "service": "coub",
    "source": "https://coub.com/view/1czcdf",
    "embed": "https://coub.com/embed/1czcdf",
    "width": 580,
    "height": 320,
    "caption": "My Life"
  }
}