List Tool for Editor.js

This Tool for the Editor.js allows you to add ordered or unordered (bulleted) lists to your article.

Installation

Install via NPM

Get the package

npm i --save @editorjs/list

yarn add @editorjs/list

Include module at your application

import List from '@editorjs/list';

Download to your project's source dir

1. Upload folder dist from repository
2. Add dist/bundle.js file to your page.

Load from CDN

Load the script from jsDelivr CDN and connect to your page.

<script src="https://cdn.jsdelivr.net/npm/@editorjs/list@latest"></script>

Usage

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

import EditorJS from '@editorjs/editorjs';
import List from '@editorjs/list';

var editor = EditorJS({
  // ...
  tools: {
    ...
    list: {
      class: List,
      inlineToolbar: true,
      config: {
        defaultStyle: 'unordered'
      }
    },
  },
});

Config Params

Field	Type	Description
defaultStyle	string	type of a list: ordered or unordered, default is ordered

Tool's settings

You can choose list`s type.

Output data

Field	Type	Description
style	string	type of a list: ordered or unordered
items	string[]	the array of list's items

{
    "type" : "list",
    "data" : {
        "style" : "unordered",
        "items" : [
            "This is a block-styled editor",
            "Clean output data",
            "Simple and powerful API"
        ]
    }
},

I18n support

This tool supports the i18n api. To localize UI labels, put this object to your i18n dictionary under the tools section:

"list": {
  "Ordered": "Нумерованный",
  "Unordered": "Маркированный"
}

See more instructions about Editor.js internationalization here: https://editorjs.io/internationalization