Skip to content

ocavue/prosemirror-virtual-cursor

Repository files navigation

prosemirror-virtual-cursor

NPM version

This is a plugin that adds a virtual cursor (or caret) to your editor. It implements Bike’s typing affinity caret, which shows a tail under the cursor between mark boundary.

prosemirror-virtual-cursor.mp4

Install

npm install prosemirror-virtual-cursor

Usage

import 'prosemirror-virtual-cursor/style/virtual-cursor.css';

import { createVirtualCursor } from 'prosemirror-virtual-cursor';

const plugin = createVirtualCursor();

Options

Cursor color

The default color of the cursor is red. You can change it by overriding the CSS variable --prosemirror-virtual-cursor-color. You can also copy all the CSS rules from style/virtual-cursor.css to your own stylesheet and change more things.

skipWarning

By default, prosemirror-virtual-cursor will warn you if any mark has inclusive set to false, as inclusive is not useful for prosemirror-virtual-cursor. You can disable this warning by setting skipWarning to true. You can also specify an array of mark names to skip the warning for specific marks.

const plugin = createVirtualCursor({ skipWarning: true });
const plugin = createVirtualCursor({ skipWarning: ['mark_type_name'] });

License

MIT