3.0.0 • Published 1 year ago

react-editor-js-reverp v3.0.0

Weekly downloads
-
License
-
Repository
-
Last release
1 year ago

šŸž DEMO

šŸ€ Supported Official Plugin

  • Paragraph (default)
  • Embed
  • Table
  • List
  • Warning
  • Code
  • Link
  • Image
  • Raw
  • Header
  • Quote
  • Marker
  • CheckList
  • Delimiter
  • InlineCode
  • SimpleImage

šŸ¤ŸšŸ» Getting Started

Install via npm (or yarn)

npm install --save react-editor-js-reverp @editorjs/editorjs @editorjs/paragraph ...other plugins
import { Editor } from 'react-editor-js-reverp'

<Editor value={blocks} />

šŸ“™ API

Allow all options of editor-js

NameTypeDescription
valueOutputDataInitial data when using editor js as uncontrolled component. highly recommend it
valueOutputDatadata when using editor js as controlled component. āš ļø Don't use it with onChange prop. Infinite loops can occur.
onInitialize(editorCore?: EditorCore) => voidCall after editor-js is initialized

🧐 FAQ

How can I install plugins?

There is an only Paragraph block already included in Editor.js. Probably you want to use several Block Tools that should be installed and connected.

To add more Block Tools, simply add them to your repo and pass them as tools-property to your editor:

npm install --save-dev @editorjs/checklist
import { Editor } from 'react-editor-js-reverp'
import CheckList from '@editorjs/checklist'

<Editor value={blocks} tools={{ checkList: CheckList }} />

We recommend to create a tools.js file and export your tools as a constant. Here is an example using all of the default plugins:

// tools.js
import Embed from '@editorjs/embed'
import Table from '@editorjs/table'
import Paragraph from '@editorjs/paragraph'
import List from '@editorjs/list'
import Warning from '@editorjs/warning'
import Code from '@editorjs/code'
import LinkTool from '@editorjs/link'
import Image from '@editorjs/image'
import Raw from '@editorjs/raw'
import Header from '@editorjs/header'
import Quote from '@editorjs/quote'
import Marker from '@editorjs/marker'
import CheckList from '@editorjs/checklist'
import Delimiter from '@editorjs/delimiter'
import InlineCode from '@editorjs/inline-code'
import SimpleImage from '@editorjs/simple-image'

export const EDITOR_JS_TOOLS = {
  paragraph: Paragraph,
  embed: Embed,
  table: Table,
  list: List,
  warning: Warning,
  code: Code,
  linkTool: LinkTool,
  image: Image,
  raw: Raw,
  header: Header,
  quote: Quote,
  marker: Marker,
  checklist: CheckList,
  delimiter: Delimiter,
  inlineCode: InlineCode,
  simpleImage: SimpleImage,
}

You can read more about plugins/tools at editor-js: Tools installation

import { Editor } from 'react-editor-js-reverp'
import { EDITOR_JS_TOOLS } from './tools'


<Editor className={} style={{}} value={blocks} tools={EDITOR_JS_TOOLS} onChange={} />

How to access editor-js instance?

The editor-js instance is inaccessible. However, you can access the abstracted editor-js for isomorphic react-editor-js.

const editorCore = React.useRef(null)

const handleInitialize = React.useCallback((instance) => {
  editorCore.current = instance
}, [])

const handleSave = React.useCallback(async () => {
  const savedData = await editorCore.current.save();
}, [])

<Editor onInitialize={handleInitialize} value={blocks} />

If you want to access low-level instance, you can use dangerouslyLowLevelInstance

āš ļø dangerouslyLowLevelInstance depends on the execution environment.

EnvironmentInstnace Type
BrowserEditorJS instance
NodeJSnull
const editorCore = React.useRef(null)

const handleInitialize = React.useCallback((instance) => {
  editorCore.current = instance
}, [])

const handleSave = React.useCallback(async () => {
  const savedData = await editorCore.current.save();
}, [])

<Editor onInitialize={handleInitialize} value={blocks} />

Haven't received data from server (when use Link)

You should set linkTool config. šŸ’ŖšŸ»

import LinkTool from '@editorjs/link'

<Editor
  value={blocks}
  tools={{
    linkTool: {
      class: LinkTool,
      config: {
        endpoint: 'http://localhost:8008/fetchUrl',
      }
    }
  }}
/>
3.0.0

1 year ago

2.8.0

1 year ago

2.7.0

1 year ago

2.6.0

1 year ago

2.5.0

1 year ago

2.4.0

1 year ago

2.3.0

1 year ago

2.2.0

1 year ago

2.1.0

1 year ago

2.0.0

1 year ago

0.1.1

1 year ago