3.0.0 • Published 3 years ago

editorjs-paragraph-with-alignment v3.0.0

Weekly downloads
284
License
MIT
Repository
github
Last release
3 years ago

npm.io

Paragraph Tool with alignment for Editor.js

If you can help, please push the Star button :)

image

If you want to add an alignment to another block

This is useful editorjs-alignment-blocktune

versions

versionDescription
@2.xsupport alignment left/center/right
@3.xsupport alignment left/center/right/justify

Installation

Install via NPM

Get the package

npm i --save editorjs-paragraph-with-alignment@3.x

Include module at your application

const Paragraph = require('editorjs-paragraph-with-alignment');

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

https://cdn.jsdelivr.net/npm/editorjs-paragraph-with-alignment@3.0.0

Usage

The Paragraph tool is included at editor.js by default, so you don't need to connect it manually. If you want to connect your customized version of this tool, do not forget to use the initialBlock option of the editor config.

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

var editor = EditorJS({
  ...

  tools: {
    ...
    paragraph: {
      class: Paragraph,
      inlineToolbar: true,
    },
  }

  ...
});

Config Params

The Paragraph Tool supports these configuration parameters:

FieldTypeDescription
placeholderstringThe placeholder. Will be shown only in the first paragraph when the whole editor is empty.
preserveBlankboolean(default: false) Whether or not to keep blank paragraphs when saving editor data

Output data

FieldTypeDescription
textstringparagraph's text
alignmentstringleft/center/right/justify
{
    "type" : "paragraph",
    "data" : {
        "text" : "Check out our projects on a <a href=\"https://github.com/codex-team\">GitHub page</a>.",
        "alignment": "left"
    }
}