tiptap/packages/core/src/Editor.ts

520 lines
13 KiB
TypeScript
Raw Normal View History

2020-08-22 05:35:15 +08:00
import { EditorState, Plugin, Transaction } from 'prosemirror-state'
2020-03-06 06:59:48 +08:00
import { EditorView} from 'prosemirror-view'
import { Schema, DOMParser, DOMSerializer } from 'prosemirror-model'
2020-03-11 17:23:28 +08:00
import magicMethods from './utils/magicMethods'
2019-12-17 06:51:18 +08:00
import elementFromString from './utils/elementFromString'
2020-03-30 02:36:57 +08:00
import getAllMethodNames from './utils/getAllMethodNames'
2020-03-30 17:25:07 +08:00
import nodeIsActive from './utils/nodeIsActive'
2020-03-30 20:42:10 +08:00
import markIsActive from './utils/markIsActive'
2020-04-11 17:45:41 +08:00
import getNodeAttrs from './utils/getNodeAttrs'
2020-03-30 20:42:10 +08:00
import getMarkAttrs from './utils/getMarkAttrs'
2020-03-31 19:06:34 +08:00
import removeElement from './utils/removeElement'
2020-03-31 18:53:52 +08:00
import getSchemaTypeByName from './utils/getSchemaTypeByName'
import getHtmlFromFragment from './utils/getHtmlFromFragment'
2020-03-06 04:05:01 +08:00
import ExtensionManager from './ExtensionManager'
2020-04-02 03:15:23 +08:00
import EventEmitter from './EventEmitter'
2020-03-08 06:37:58 +08:00
import Extension from './Extension'
import Node from './Node'
2020-04-11 04:59:09 +08:00
import Mark from './Mark'
2020-08-18 16:06:08 +08:00
import ComponentRenderer from './ComponentRenderer'
2020-08-22 03:23:46 +08:00
import defaultPlugins from './plugins'
2020-08-22 03:44:34 +08:00
import * as commands from './commands'
2020-08-21 05:25:55 +08:00
2020-09-21 05:19:27 +08:00
// export type Command = (next: Function, editor: Editor) => (...args: any) => any
// export type Command = (...args: any) => ({ editor: Editor }) => boolean
export type Command = (props: {
editor: Editor
tr: Transaction
2020-09-21 06:14:59 +08:00
// TODO: find correct type
commands: any
2020-09-22 00:40:32 +08:00
state: EditorState
2020-09-21 05:19:27 +08:00
}) => boolean
2020-04-11 04:59:09 +08:00
2020-04-02 20:34:07 +08:00
export interface CommandSpec {
[key: string]: Command
}
2019-12-17 06:20:05 +08:00
2020-04-11 04:59:09 +08:00
type EditorContent = string | JSON | null
2020-09-12 00:06:13 +08:00
// interface Element {
// editor?: Editor
// }
interface HTMLElement {
editor?: Editor
}
// Element.prototype.editor = Editor
2020-04-14 16:13:27 +08:00
interface EditorOptions {
2020-04-27 05:21:27 +08:00
element: Element,
2020-08-22 03:01:41 +08:00
content: EditorContent,
extensions: (Extension | Node | Mark)[],
2020-08-22 03:53:45 +08:00
injectCSS: boolean,
2020-08-22 03:01:41 +08:00
autoFocus: 'start' | 'end' | number | boolean | null,
2020-08-22 03:53:45 +08:00
editable: boolean,
2019-12-08 07:16:44 +08:00
}
2019-12-17 06:20:05 +08:00
2020-03-11 17:02:47 +08:00
@magicMethods
2020-03-06 06:59:48 +08:00
export class Editor extends EventEmitter {
2019-12-08 07:16:44 +08:00
2020-08-18 16:06:08 +08:00
public renderer!: any
private proxy!: Editor
2020-08-18 15:36:37 +08:00
private extensionManager!: ExtensionManager
private commands: { [key: string]: any } = {}
private css!: HTMLStyleElement
private lastCommand = Promise.resolve()
2020-09-11 23:30:55 +08:00
public lastCommandValue: any = undefined
2020-08-18 15:36:37 +08:00
public schema!: Schema
public view!: EditorView
public selection = { from: 0, to: 0 }
2020-08-22 04:08:54 +08:00
public isFocused = false
2020-08-18 15:41:31 +08:00
public options: EditorOptions = {
2020-04-11 20:33:58 +08:00
element: document.createElement('div'),
2020-03-05 05:40:08 +08:00
content: '',
injectCSS: true,
2020-03-06 03:30:58 +08:00
extensions: [],
2020-08-21 23:44:02 +08:00
autoFocus: false,
2020-08-22 03:53:45 +08:00
editable: true,
2020-03-05 05:40:08 +08:00
}
2020-08-11 22:57:11 +08:00
2020-09-11 23:30:55 +08:00
2020-04-14 16:13:27 +08:00
constructor(options: Partial<EditorOptions> = {}) {
2020-03-06 06:59:48 +08:00
super()
2020-03-05 05:40:08 +08:00
this.options = { ...this.options, ...options }
2020-08-22 05:43:08 +08:00
this.on('createdProxy', this.init)
2020-04-01 04:17:54 +08:00
}
2020-08-11 22:57:11 +08:00
2020-08-22 05:35:15 +08:00
/**
* This method is called after the proxy is initialized.
*/
2020-04-01 04:17:54 +08:00
private init() {
2020-03-06 04:49:53 +08:00
this.createExtensionManager()
this.createSchema()
2020-09-10 06:09:05 +08:00
this.extensionManager.resolveConfigs()
2020-03-06 04:49:53 +08:00
this.createView()
2020-08-22 03:44:34 +08:00
this.registerCommands(commands)
2020-08-11 22:57:11 +08:00
2020-03-05 05:40:08 +08:00
if (this.options.injectCSS) {
2020-04-11 05:09:31 +08:00
require('./style.css')
2020-03-05 05:40:08 +08:00
}
2020-09-03 21:11:55 +08:00
2020-08-21 23:44:02 +08:00
this.proxy.focus(this.options.autoFocus)
2019-12-08 07:16:44 +08:00
}
2020-08-22 05:35:15 +08:00
/**
* A magic method to call commands.
2020-09-03 21:11:55 +08:00
*
2020-08-22 05:35:15 +08:00
* @param name The name of the command
*/
2020-08-18 15:36:37 +08:00
private __get(name: string) {
2020-03-11 17:02:47 +08:00
const command = this.commands[name]
if (!command) {
2020-04-02 03:15:23 +08:00
// TODO: prevent vue devtools to throw error
// throw new Error(`tiptap: command '${name}' not found.`)
return
2020-03-11 17:02:47 +08:00
}
2020-08-11 22:57:11 +08:00
2020-09-21 05:19:27 +08:00
return (...args: any) => {
const { tr } = this.state
2020-09-22 00:40:32 +08:00
const callback = command(...args)({
editor: this.proxy,
state: this.chainableEditorState(tr, this.state),
view: this.view,
2020-09-22 02:11:32 +08:00
dispatch: () => false,
2020-09-22 00:40:32 +08:00
tr,
})
2020-09-21 05:19:27 +08:00
this.view.dispatch(tr)
return callback
}
}
public chain() {
2020-09-22 00:40:32 +08:00
const { tr } = this.state
2020-09-21 05:19:27 +08:00
const callbacks = []
return new Proxy({}, {
get: (target, name: string, proxy) => {
if (name === 'run') {
this.view.dispatch(tr)
return () => callbacks.every(callback => callback === true)
}
const command = this.commands[name]
if (!command) {
throw new Error(`tiptap: command '${name}' not found.`)
}
return (...args: any) => {
2020-09-21 06:14:59 +08:00
const props = {
editor: this.proxy,
2020-09-22 00:40:32 +08:00
state: this.chainableEditorState(tr, this.state),
view: this.view,
2020-09-22 02:11:32 +08:00
dispatch: () => false,
2020-09-21 06:14:59 +08:00
tr,
}
Object.defineProperty(props, 'commands', {
get: function() {
return Object.fromEntries(Object
.entries(this.commands)
.map(([name, command]) => {
return [name, (...args) => command(...args)(props)]
}))
}.bind(this)
});
const callback = command(...args)(props)
2020-09-21 05:19:27 +08:00
callbacks.push(callback)
return proxy
}
}
})
2020-03-11 17:02:47 +08:00
}
2020-09-22 00:40:32 +08:00
protected chainableEditorState(tr: Transaction, state: EditorState): EditorState {
let selection = tr.selection
let doc = tr.doc
let storedMarks = tr.storedMarks
return {
...state,
schema: state.schema,
plugins: state.plugins,
apply: state.apply.bind(state),
applyTransaction: state.applyTransaction.bind(state),
reconfigure: state.reconfigure.bind(state),
toJSON: state.toJSON.bind(state),
get storedMarks() {
return storedMarks
},
get selection() {
return selection
},
get doc() {
return doc
},
get tr() {
selection = tr.selection
doc = tr.doc
storedMarks = tr.storedMarks
return tr
},
};
}
2020-08-22 05:35:15 +08:00
/**
* Update editor options.
2020-09-03 21:11:55 +08:00
*
2020-08-22 05:35:15 +08:00
* @param options A list of options
*/
2020-08-22 03:53:45 +08:00
public setOptions(options: Partial<EditorOptions> = {}) {
this.options = { ...this.options, ...options }
if (this.view && this.state) {
this.view.updateState(this.state)
}
}
2020-09-03 21:11:55 +08:00
2020-08-22 05:35:15 +08:00
/**
* Returns whether the editor is editable.
*/
2020-08-22 04:08:54 +08:00
public get isEditable() {
return this.view && this.view.editable
}
2020-08-22 05:35:15 +08:00
/**
* Returns the editor state.
*/
2020-03-29 07:21:28 +08:00
public get state() {
return this.view.state
}
2020-08-22 05:35:15 +08:00
/**
* Register a list of commands.
2020-09-03 21:11:55 +08:00
*
2020-08-22 05:35:15 +08:00
* @param commands A list of commands
*/
2020-08-22 03:53:45 +08:00
public registerCommands(commands: CommandSpec) {
2020-08-22 03:44:34 +08:00
Object
.entries(commands)
.forEach(([name, command]) => this.registerCommand(name, command))
}
2020-08-22 05:35:15 +08:00
/**
* Register a command.
2020-09-03 21:11:55 +08:00
*
2020-08-22 05:35:15 +08:00
* @param name The name of your command
* @param callback The method of your command
*/
2020-09-21 05:19:27 +08:00
public registerCommand(name: string, callback: (bla?: any) => Command): Editor {
2020-03-11 06:19:41 +08:00
if (this.commands[name]) {
throw new Error(`tiptap: command '${name}' is already defined.`)
}
2020-08-11 22:57:11 +08:00
2020-03-30 02:36:57 +08:00
if (getAllMethodNames(this).includes(name)) {
throw new Error(`tiptap: '${name}' is a protected name.`)
}
2020-08-11 22:57:11 +08:00
2020-09-21 05:19:27 +08:00
// this.commands[name] = this.chainCommand((...args: any) => {
// // console.log('command', this.lastCommandValue)
// const commandValue = callback(() => {}, this.proxy)(...args)
2020-09-11 23:30:55 +08:00
2020-09-21 05:19:27 +08:00
// // if (commandValue !== undefined) {
// this.lastCommandValue = commandValue
// // }
2020-09-11 23:30:55 +08:00
2020-09-21 05:19:27 +08:00
// return this.proxy
// })
// this.commands[name] = (...args: any) => {
// const tr = this.state.tr
// callback(...args)({ editor: this.proxy, tr })
// this.view.dispatch(tr)
// }
this.commands[name] = callback
// // if (commandValue !== undefined) {
// this.lastCommandValue = commandValue
// // }
// return this.proxy
// })
2020-03-11 06:19:41 +08:00
2020-03-11 17:02:47 +08:00
return this.proxy
2020-03-11 06:19:41 +08:00
}
2020-09-11 23:30:55 +08:00
/**
* Call a command.
*
* @param name The name of the command you want to call.
* @param options The options of the command.
*/
public command(name: string, ...options: any) {
return this.commands[name](...options)
}
/**
* Wraps a command to make it chainable.
*
* @param method
*/
private chainCommand = (method: Function) => (...args: any) => {
// console.log('chain', this.lastCommandValue)
// this.lastCommand = this.lastCommand
// .then(() => {
// const jo = method.apply(this, args)
// console.log({jo})
// })
// // .then(method.apply(this, args))
// .catch(console.error)
method.apply(this, args)
return this.proxy
}
2020-08-22 05:35:15 +08:00
/**
* Register a ProseMirror plugin.
2020-09-03 21:11:55 +08:00
*
2020-08-22 05:35:15 +08:00
* @param plugin A ProseMirror plugin
* @param handlePlugins Control how to merge the plugin into the existing plugins.
*/
public registerPlugin(plugin: Plugin, handlePlugins?: (plugin: Plugin, plugins: Plugin[]) => Plugin[]) {
const plugins = typeof handlePlugins === 'function'
? handlePlugins(plugin, this.state.plugins)
: [plugin, ...this.state.plugins]
2020-04-11 03:43:23 +08:00
const state = this.state.reconfigure({ plugins })
2020-04-11 03:43:23 +08:00
this.view.updateState(state)
}
2020-08-22 05:35:15 +08:00
/**
* Unregister a ProseMirror plugin.
2020-09-03 21:11:55 +08:00
*
2020-08-22 05:35:15 +08:00
* @param name The plugins name
*/
2020-04-11 04:55:14 +08:00
public unregisterPlugin(name: string) {
const state = this.state.reconfigure({
// @ts-ignore
plugins: this.state.plugins.filter(plugin => !plugin.key.startsWith(`${name}$`)),
})
this.view.updateState(state)
}
2020-08-22 05:35:15 +08:00
/**
* Creates an extension manager.
*/
2020-03-06 04:49:53 +08:00
private createExtensionManager() {
2020-04-01 04:17:54 +08:00
this.extensionManager = new ExtensionManager(this.options.extensions, this.proxy)
2019-12-08 07:16:44 +08:00
}
2020-08-22 05:35:15 +08:00
/**
* Creates a ProseMirror schema.
*/
2020-03-06 04:05:01 +08:00
private createSchema() {
2020-09-10 06:09:05 +08:00
this.schema = this.extensionManager.schema
2020-03-06 04:05:01 +08:00
}
2020-08-22 05:35:15 +08:00
/**
* Creates a ProseMirror view.
*/
2019-12-08 07:16:44 +08:00
private createView() {
2020-04-11 20:33:58 +08:00
this.view = new EditorView(this.options.element, {
2020-03-06 04:49:53 +08:00
state: EditorState.create({
doc: this.createDocument(this.options.content),
2020-08-22 05:35:15 +08:00
plugins: [
...this.extensionManager.plugins,
...defaultPlugins.map(plugin => plugin(this.proxy)),
],
2020-03-06 04:49:53 +08:00
}),
2019-12-08 07:16:44 +08:00
dispatchTransaction: this.dispatchTransaction.bind(this),
2020-04-24 15:32:37 +08:00
nodeViews: this.extensionManager.nodeViews,
2019-12-08 07:16:44 +08:00
})
2020-09-12 00:06:13 +08:00
// store editor in dom element for better testing
const dom = this.view.dom as HTMLElement
dom.editor = this.proxy
2019-12-08 07:16:44 +08:00
}
2020-08-22 05:35:15 +08:00
/**
* Creates a ProseMirror document.
*/
2020-03-30 04:24:51 +08:00
public createDocument = (content: EditorContent, parseOptions: any = {}): any => {
2020-03-29 07:21:28 +08:00
if (content && typeof content === 'object') {
2020-03-29 07:11:10 +08:00
try {
return this.schema.nodeFromJSON(content)
} catch (error) {
console.warn('[tiptap warn]: Invalid content.', 'Passed value:', content, 'Error:', error)
return this.createDocument('')
}
}
2019-12-08 07:16:44 +08:00
if (typeof content === 'string') {
2019-12-17 06:51:18 +08:00
return DOMParser
.fromSchema(this.schema)
2020-03-05 05:47:50 +08:00
.parse(elementFromString(content), parseOptions)
2019-12-08 07:16:44 +08:00
}
2020-03-29 07:21:28 +08:00
return this.createDocument('')
}
2020-08-22 05:35:15 +08:00
/**
* Store the current selection.
*/
2020-03-29 07:21:28 +08:00
private storeSelection() {
const { from, to } = this.state.selection
this.selection = { from, to }
2019-12-08 07:16:44 +08:00
}
2020-08-22 05:35:15 +08:00
/**
* The callback over which to send transactions (state updates) produced by the view.
2020-09-03 21:11:55 +08:00
*
2020-08-22 05:35:15 +08:00
* @param transaction An editor state transaction
*/
private dispatchTransaction(transaction: Transaction) {
2020-03-05 05:40:08 +08:00
const state = this.state.apply(transaction)
this.view.updateState(state)
2020-03-29 07:21:28 +08:00
this.storeSelection()
2020-03-30 03:04:56 +08:00
this.emit('transaction', { transaction })
2020-08-11 22:57:11 +08:00
2019-12-08 07:16:44 +08:00
if (!transaction.docChanged || transaction.getMeta('preventUpdate')) {
return
}
2020-03-30 03:04:56 +08:00
this.emit('update', { transaction })
2019-12-08 07:16:44 +08:00
}
2019-12-17 06:51:18 +08:00
2020-08-22 05:35:15 +08:00
/**
* Get attributes of the currently selected node.
2020-09-03 21:11:55 +08:00
*
2020-08-22 05:35:15 +08:00
* @param name Name of the node
*/
2020-04-11 17:45:41 +08:00
public getNodeAttrs(name: string) {
return getNodeAttrs(this.state, this.schema.nodes[name])
}
2020-08-22 05:35:15 +08:00
/**
* Get attributes of the currently selected mark.
2020-09-03 21:11:55 +08:00
*
2020-08-22 05:35:15 +08:00
* @param name Name of the mark
*/
2020-04-02 03:41:53 +08:00
public getMarkAttrs(name: string) {
2020-03-31 18:53:52 +08:00
return getMarkAttrs(this.state, this.schema.marks[name])
}
2020-03-30 20:49:48 +08:00
2020-08-22 05:35:15 +08:00
/**
* Returns if the currently selected node or mark is active.
2020-09-03 21:11:55 +08:00
*
2020-08-22 05:35:15 +08:00
* @param name Name of the node or mark
* @param attrs Attributes of the node or mark
*/
2020-04-02 03:41:53 +08:00
public isActive(name: string, attrs = {}) {
2020-03-31 18:53:52 +08:00
const schemaType = getSchemaTypeByName(name, this.schema)
2020-03-30 20:49:48 +08:00
2020-03-31 18:53:52 +08:00
if (schemaType === 'node') {
return nodeIsActive(this.state, this.schema.nodes[name], attrs)
} else if (schemaType === 'mark') {
return markIsActive(this.state, this.schema.marks[name])
}
2020-03-30 20:42:10 +08:00
2020-03-31 18:53:52 +08:00
return false
2020-03-06 04:49:53 +08:00
}
2020-03-09 06:25:48 +08:00
// public setParentComponent(component = null) {
// if (!component) {
// return
// }
// this.view.setProps({
// nodeViews: this.initNodeViews({
// parent: component,
// extensions: [
// ...this.builtInExtensions,
// ...this.options.extensions,
// ],
// }),
// })
// }
2020-08-22 05:35:15 +08:00
/**
* Get the document as JSON.
*/
2020-03-04 17:21:48 +08:00
public json() {
return this.state.doc.toJSON()
}
2020-08-22 05:35:15 +08:00
/**
* Get the document as HTML.
*/
2020-03-04 17:21:48 +08:00
public html() {
return getHtmlFromFragment(this.state.doc, this.schema)
2020-03-04 17:21:48 +08:00
}
2020-03-05 04:45:49 +08:00
2020-08-22 05:35:15 +08:00
/**
* Destroy the editor.
*/
2020-03-05 04:45:49 +08:00
public destroy() {
2020-03-31 19:07:57 +08:00
if (this.view) {
this.view.destroy()
2020-03-05 04:45:49 +08:00
}
2020-03-06 06:59:48 +08:00
this.removeAllListeners()
2020-03-31 19:06:34 +08:00
removeElement(this.css)
2020-03-05 04:45:49 +08:00
}
2020-08-11 22:57:11 +08:00
2019-12-08 07:16:44 +08:00
}