Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

cadot-info/editorjs-inline-image

Open more actions menu
 
 

Repository files navigation

EditorJS Inline Image Tool

Image tool for Editor.js.

Embed images from image files, URLs or Unsplash.

Notes

Requires no server-side uploader.

Built following the Unsplash API Guidelines.

Extends the functionality of simple-image.

Installation

Install via NPM

Get the package

$ npm i --save-dev editorjs-inline-image

Include module at your application

import InlineImage from 'editorjs-inline-image';

Usage

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

const editor = EditorJS({
  tools: {
      image: {
        class: InlineImage,
        inlineToolbar: true,
        config: {
          embed: {
            display: true,
          },
          unsplash: {
            appName: 'your_app_name',
            clientId: 'your_client_id'
          }
        }
      }
  }
});

Config Params

Field Type Description
embed {display: boolean} You could display or not the embed tab, If you don't fill the embed config by default the value is set on true
unsplash {appName: string, clientId: string, maxResults: string} Config for Unsplash API. Contains 3 fields:

appName: Unspalsh Application Name.

clientId: Unsplash Access Key.

maxResults: Max number of images per search (default 30).

Tool's tunes

  1. Add border

  2. Stretch to full-width

  3. Add background

Output data

Field Type Description
url string Image's url
caption string Image's caption
withBorder boolean Add border to image
withBackground boolean Add background
stretched boolean Stretch image to screen's width
middle boolean Stretch image to screen's width middle
unsplash {author: string, profileLink: string} Unsplash image author information.

author: Author's name.

profileLink: Unsplash porfile link.

Image

{
    "type" : "image",
    "data" : {
        "url" : "https://www.example.com/image.jpg",
        "caption" : "An image",
        "withBorder" : false,
        "withBackground" : false,
        "stretched" : true,
        "middle" : true
    }
}

Unsplash image

        {
            "type": "image",
            "data": {
                "url": "https://images.unsplash.com/photo-xxxxxxxxxxxxxxxxx",
                "caption": "An image from Unsplash",
                "withBorder": false,
                "withBackground": true,
                "stretched": false,
                "middle" : false
                "unsplash": {
                    "author": "John Doe",
                    "profileLink": "https://unsplash.com/@john_doe_fake"
                }
            }
        }

Development

Development mode

$ yarn build:dev

Production release

  1. Create a production bundle
$ yarn build
  1. Commit dist/bundle.js

Run tests

$ yarn test

Contributing and Development

Bug reports and pull requests are welcome on GitHub https://github.com/kommitters/editorjs-inline-image. Everyone is welcome to participate in the project. If you are thinking about contributing to the project, please check our Contributing Guide.

Changelog

See the CHANGELOG for versions details.

License

See LICENSE for details.

Credits

Made with 💙 by kommit

About

Inline images plugin for editorjs

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 93.9%
  • CSS 6.1%
Morty Proxy This is a proxified and sanitized view of the page, visit original site.