@replit/codemirror-vim
v6.2.1
Published
Vim keybindings for CodeMirror 6
Downloads
100,972
Readme
Vim keybindings for CM6
Installation
npm i @replit/codemirror-vim
Usage
import { basicSetup, EditorView } from 'codemirror';
import { vim } from "@replit/codemirror-vim"
let view = new EditorView({
doc: "",
extensions: [
// make sure vim is included before other keymaps
vim(),
// include the default keymap and all other keymaps you want to use in insert mode
basicSetup,
],
parent: document.querySelector('#editor'),
})
Note: if you are not using
basicSetup
, make sure you include the drawSelection plugin to correctly render the selection in visual mode.
Usage of cm5 vim extension api
The same api that could be used in previous version of codemirror https://codemirror.net/doc/manual.html#vimapi, can be used with this plugin too, just replace the old editor instance with view.cm
in your code
import {Vim, getCM} from "@replit/codemirror-vim"
let cm = getCM(view)
// use cm to access the old cm5 api
Vim.exitInsertMode(cm)
Vim.handleKey(cm, "<Esc>")
Define additional ex commands
Vim.defineEx('write', 'w', function() {
// save the file
});
Map keys
Vim.map("jj", "<Esc>", "insert"); // in insert mode
Vim.map("Y", "y$"); // in normal mode
Unmap keys
Vim.unmap("jj", "insert");
Add custom key
defaultKeymap.push({ keys: 'gq', type: 'operator', operator: 'hardWrap' });
Vim.defineOperator("hardWrap", function(cm, operatorArgs, ranges, oldAnchor, newHead) {
// make changes and return new cursor position
});