NodeView

By default, document nodes are rendered using the result of the toDOM method of their spec, and managed entirely by the editor. For some use cases, such as embedded node-specific editing interfaces, you want more control over the behavior of a node's in-editor representation, and need to define a custom node view.

Mark views only support dom and contentDOM, and don't support any of the node view methods.

Objects returned as node views must conform to this interface.

interface NodeView {

contentDOM?: HTMLElement | null;

deselectNode?: () => void;

destroy?: () => void;

dom: DOMNode;

ignoreMutation?: (mutation: MutationRecord) => boolean;

selectNode?: () => void;

setSelection?: (

anchor: number,

head: number,

root: Document | ShadowRoot,

) => void;

stopEvent?: (event: Event) => boolean;

update?: (

node: Node,

decorations: readonly Decoration[],

innerDecorations: DecorationSource,

) => boolean;

}

§Properties

contentDOM?: HTMLElement | null

[src]

The DOM node that should hold the node's content. Only meaningful if the node view also defines a dom property and if its node type is not a leaf node type. When this is present, ProseMirror will take care of rendering the node's children into it. When it is not present, the node view itself is responsible for rendering (or deciding not to render) its child nodes.

deselectNode?: () => void

[src]

When defining a selectNode method, you should also provide a deselectNode method to remove the effect again.

destroy?: () => void

[src]

Called when the node view is removed from the editor or the whole editor is destroyed. (Not available for marks.)

dom: DOMNode

[src]

The outer DOM node that represents the document node.

ignoreMutation?: (mutation: MutationRecord) => boolean

[src]

Called when a DOM mutation or a selection change happens within the view. When the change is a selection change, the record will have a type property of "selection" (which doesn't occur for native mutation records). Return false if the editor should re-read the selection or re-parse the range around the mutation, true if it can safely be ignored.

selectNode?: () => void

[src]

Can be used to override the way the node's selected status (as a node selection) is displayed.

setSelection?: (anchor: number, head: number, root: Document | ShadowRoot) => void

[src]

This will be called to handle setting the selection inside the node. The anchor and head positions are relative to the start of the node. By default, a DOM selection will be created between the DOM positions corresponding to those positions, but if you override it you can do something else.

stopEvent?: (event: Event) => boolean

[src]

Can be used to prevent the editor view from trying to handle some or all DOM events that bubble up from the node view. Events for which this returns true are not handled by the editor.

update?: (node: Node, decorations: readonly Decoration[], innerDecorations: DecorationSource) => boolean

[src]

When given, this will be called when the view is updating itself. It will be given a node (possibly of a different type), an array of active decorations around the node (which are automatically drawn, and the node view may ignore if it isn't interested in them), and a decoration source that represents any decorations that apply to the content of the node (which again may be ignored). It should return true if it was able to update to that node, and false otherwise. If the node view has a contentDOM property (or no dom property), updating its child nodes will be handled by ProseMirror.