Undo tool for Editor.js
npm install editorjs-undo!Stability Badge
Undo/Redo feature for Editor.js.
This new version introduces breaking changes. Remember that it is still in beta version.
Please, report bugs or behavior issues :).
#### What's new?
* Overall plugin performance is improved, especially with large documents.
* Undo/Redo lifecycle is managed through block updates instead of a full document render.
* Solves issues in documents with several images, for example the blink with undo/redo.
* Sets the caret in the respective position when the user is typing inside an existing text.
* Adds support to ReadOnly toggle.
* Optimizes the observer, saving with the EditorJS API only when the content changes.
Get the package
``shell`
$ npm i --save-dev editorjs-undo
To install the latest v1 stable version
Get the package
`shell`
$ npm i --save-dev editorjs-undo@1.0.1
Include module in your application
`javascript`
import Undo from 'editorjs-undo';
You can load a specific version of the package from jsDelivr CDN.
Require this script on a page with Editor.js.
`html`
`javascript`
const editor = new EditorJS({
onReady: () => {
new Undo({ editor });
},
});
On the editor, use Ctrl + Z or ā + Z to undo, or use Ctrl + Y or ā + Y to redo.
If you are using React, you could create a function to handle the onReady property, the function will store the Undo instance. Then, you must call the function in onReady in the editorJS instance.
`javascript
const handleReady = (editor) => {
new Undo({ editor });
};
class ReactEditor extends Component {
render() {
return (
tools={ ... }
/>
)
}
}
`
If you are using react-editor-js, you could create a function to handle the onReady property, the function will store the undo instance and the respective configuration or initialize method if you want to use them (they will be explained below). Then, you must call the function in onReady in the editorJS instance.
React class components:
`javascript
class ReactEditor extends Component {
constructor(props) {
super(props);
this.editorCore = React.createRef();
}
handleInitialize = (instance) => {
this.editorCore.current = instance;
};
handleReady = () => {
const editor = this.editorCore.current._editorJS;
new Undo({ editor });
};
render() {
return (
onReady={ this.handleReady }
tools={ ... }
/>
)
}
}
`
Note: If you are already using editorjs-drag-drop your handleReady function must have the editorjs-drag-drop instance.
`javascript
handleReady = () => {
const editor = this.editorCore.current._editorJS;
new Undo({ editor });
new DragDrop(editor);
};
`
React functional components:
`javascript
........
export const ReactEditor = () => {
const editorCore = React.useRef(null)
const handleInitialize = React.useCallback((instance) => {
editorCore.current = instance
}, [])
const handleReady = () => {
const editor = editorCore.current._editorJS;
new Undo({ editor })
new DragDrop(editor);
};
const ReactEditorJS = createReactEditorJS()
return(
onReady={ handleReady }
tools={ ... }
defaultValue={ ... }
/>
)
}
`
Note: If you have loaded EditorJS with any initial data (such as some saved content), you _must_ pass in an initialData object. If you don't, the default initial undo state lead to an empty editor.
You may use the initialize method inside the editor's onReady callback.
`javascript`
const editor = new EditorJS({
onReady: () => {
const undo = new Undo({ editor });
undo.initialize(initialData);
},
});
Note: If you do not add any shortcut, the default shortcuts will be set up.
If you want to add custom shortcuts, pass a config object with a shortcut key in the undo instance, the shortcuts must be called undo and redo.
`javascript`
const config = {
shortcuts: {
undo: 'CMD+X',
redo: 'CMD+ALT+C'
}
}
const editor = new EditorJS({
onReady: () => {
const undo = new Undo({ editor, config });
},
});
You can set each shortcut with two or three keys, the available special keys are: CMD, ALT, SHIFT. CMD will be set up automatically as Ctrl or ā depending on your OS.
Internally, editorjs-undo uses an Observer instance that watches for changes in the text being entered. By default, it waits for a pause of 200ms in text entry before saving a change. If you want to have editorjs-undo save changes more or less often, pass a config object with a debounceTimer key in the undo instance and provide a different value in milliseconds.
`javascript`
const config = {
debounceTimer: 100
};
const editor = new EditorJS({
onReady: () => {
const undo = new Undo({ editor, config });
},
});
Lowering the debounceTimer value below 200ms will make editorjs-undo save changes more often. Raising the debounceTimer value above 200ms will make editorjs-undo save changes less often.
Setting the debounceTimer value to 0 makes editorjs-undo save every character entered as an individual change, which makes undo and redo operations only remove/replace one character at a time.
| Field | Type | Description |
| ---------- | ---------- | -------------------------------------------------------------- |
| editor | EditorJS | Required. The EditorJS instance. |Number
| maxLength | | Max amount of changes recorded by the history stack. |function
| onUpdate() | | Callback called when the user performs an undo or redo action. |object
| config | | Set up the configuration to editorjs-undo like the shortcuts |
Development mode
`shell`
$ yarn build:dev
Production release
1. Create a production bundle
`shell`
$ yarn build
2. Commit dist/bundle.js
Run tests
`shell``
$ yarn test
[license]: https://github.com/kommitters/editorjs-undo/blob/master/LICENSE
[coc]: https://github.com/kommitters/editorjs-undo/blob/master/CODE_OF_CONDUCT.md
[changelog]: https://github.com/kommitters/editorjs-undo/blob/master/CHANGELOG.md
[contributing]: https://github.com/kommitters/editorjs-undo/blob/master/CONTRIBUTING.md