main
Walkthroughs
Concepts
Plugins
You've already seen how the behaviors of Slate editors can be overridden. These overrides can also be packaged up into "plugins" to be reused, tested and shared. This is one of the most powerful aspects of Slate's architecture.
A plugin is simply a function that takes an
Editor object and returns it after it has augmented it in some way.For example, a plugin that marks image nodes as "void":
1
const withImages = editor => {
2
const { isVoid } = editor
3
​
4
editor.isVoid = element => {
5
return element.type === 'image' ? true : isVoid(element)
6
}
7
​
8
return editor
9
}
Copied!
And then to use the plugin, simply:
1
import { createEditor } from 'slate'
2
​
3
const editor = withImages(createEditor())
Copied!
This plugin composition model makes Slate extremely easy to extend!
Helper Functions
In addition to the plugin functions, you might want to expose helper functions that are used alongside your plugins. For example:
1
import { Editor, Element } from 'slate'
2
​
3
const MyEditor = {
4
...Editor,
5
insertImage(editor, url) {
6
const element = { type: 'image', url, children: [{ text: '' }] }
7
Transforms.insertNodes(editor, element)
8
},
9
}
10
​
11
const MyElement = {
12
...Element,
13
isImageElement(value) {
14
return Element.isElement(element) && element.type === 'image'
15
},
16
}
Copied!
Then you can use
MyEditor and MyElement everywhere and have access to all your helpers in one place.Last modified 9mo ago
Copy link
Contents
Helper Functions