README
slate-auto-replace
A Slate plugin to automatically replace text and apply transforms when the user types certain strings. Useful for implementing "auto-markdown" or other hotkey-based replacement behaviors.
import AutoReplace from 'slate-auto-replace'
import { Editor } from 'slate-react'
// Add the plugin to your set of plugins...
const plugins = [
AutoReplace({
trigger: 'space',
before: /^(>)$/,
transform: (transform, e, matches) => {
return transform.setBlock({ type: 'quote' })
}
})
]
// And later pass it into the Slate editor...
<Editor
...
plugins={plugins}
/>
Option | Type | Description |
---|---|---|
trigger |
String RegExp Function |
The trigger to match the inputed character against—either a character like a or a key name like enter or tab . |
transform |
Function |
A function to apply the desired transform. It will be called with transform, e, matches, editor from the event handler. The matching (before and after ) text is deleted but are accessible inside matches.before and matches.after . |
after |
RegExp |
An optional regexp that must match the text after the trigger for the replacement to occur. Any capturing groups in the regexp will be deleted from the text content, but is accessible in matches parameter in the transform function. |
before |
RegExp |
An optional regexp that must match the text before the trigger for the replacement to occur. Any capturing groups in the regexp will be deleted from the text content, but is accessible in matches parameter in the transform function. |
ignoreIn |
Function Array String |
An optional block matcher to ignore triggers inside. If passed an array or string it will match by node.type . |
onlyIn |
Function Array String |
An optional block matcher to only replace triggers inside. If passed an array or string it will match by node.type . |