vim-mode-plus

vim-mode improved.

Installation

Install using Atoms package installer

apm install vim-mode-plus

Some Features

These features are very powerful, especially for the power user. Read the following documents to learn how to use them.

Important

You must disable vim-mode to use vim-mode-plus

You don't need the following packages since they're built-in to vim-mode-plus:
- vim-surround: No default keymap. See FAQ section in this doc.
- vim-mode-visual-block
Scope for CSS selector and keymap is different from vim-mode, not compatible.
Internal code base is very different. Thus, issues and PRs should be directly sent to vim-mode-plus. DON'T report vim-mode-plus's issues or PRs to the official vim-mode.

From v1.9.0 CoffeeScript based vim-mode-plus extension is no longer supported

Now all operations are defined as ES6 class which is NOT extend-able by CoffeeScript.
- If you have vmp custom operations in your init.coffee, those are no longer working.
- See CHANGELOG and Wiki for detail.

Thanks

My work is greatly owing to former achievements of the original vim-mode developers and many of its contributors.
As you can see in the commit history, this project was originally started by forking official vim-mode.
The great design to achieve Vim operation by composing operator with target (motion, text-object) on top of operationStack still lives in vim-mode-plus now.
I don't think I can find this idea by myself from nothing.
Sincerely, I feel I couldn't do anything without the original vim-mode.

Issue report

Read ISSUE_TEMPLATE

Whats this?

Fork of vim-mode. Started on 2015.8.1.

Many bug fixes.
Refactoring: Rewritten almost every line of code.
Highlight search
visual-blockwise built-in
Incremental search by incrementalSearch setting (disabled by default).
Cursor visible in all visual-mode (characterwise, blockwise, linewise).
Maintain the same cursor position after operations (e.g y, gU) by stayOnYank, stayOnOperate setting. (disabled by default)
Lots of new motions like move-up-to-edge, move-down-to-edge. (Mapped to [ and ], Aggressive decision.)
Surround built-in. Powerful AnyPair family (change-surround-any-pair operator, inner-any-pair text-object) to detect pair automatically.
Set cursor position to start of change on undo or redo by enabling setCursorToStartOfChangeOnUndoRedo (enabled by default. Atom's default is end of change).
Allow super granular keymap which is only effective when specific operation is pending like yank-pending, delete-pending. #215
And more...

FAQ

Search Q&A label on issues.

Why fork? why not directly contribute to official vim-mode?

Changes are too big.
I felt many features are too experimental to merge to the official vim-mode.

Behavior different from pure Vim?

Some behaviors are intentionally have different default behaviors. See DifferencesFromPureVim for details.

In visual-block mode, some motions make the editor slow, freeze.

Not freezing, it's just VERY slow.
You can workaround by disabling some keymap. See #214.

ex-mode?

The ex-mode package has the most complete ex-mode support.
Very immature package vim-mode-plus-ex-mode exists.
My thought for ex-mode is here #52.

Want to suppress autocomplete-plus's auto suggestion except insert-mode.

Set suppressActivationForEditorClasses autocomplete-plus's config to following value.

vim-mode-plus.normal-mode, vim-mode-plus.visual-mode, vim-mode-plus.operator-pending-mode, vim-mode-plus.insert-mode.replace

If you want to directly edit config.cson, here it is.

"autocomplete-plus":
  suppressActivationForEditorClasses: [
    "vim-mode-plus.normal-mode"
    "vim-mode-plus.visual-mode"
    "vim-mode-plus.operator-pending-mode"
    "vim-mode-plus.insert-mode.replace"
  ]

Flash effect does not appear on cursor-line, occurrence-marker is not displayed on cursor-line either.

This is because of the syntax-theme you are using. See this tips on Wiki.

Surround not work

No default keymaps are provided. If you want, install vim-mode-plus-keymaps-for-surround

How can I insert single white space when surround?

Set Characters To Add Space On Surround. from vim-mode-plus's setting.

I want to automatically disable IME when leaving `insert-mode`.(want `set imdisable` equivalent in pure-Vim).

Now in-eval phase for this experimental feature.
From vim-mode-plus's settings-view set autoDisableInputMethodWhenLeavingInsertMode to true(default false).

This feature doesn't actually disable IME, its' just set readonly attribute to editor's hidden input element.
It should work for most IME but some Chinese IME still type multibyte character even in readonly input.
For detail, see this discussion.

Wiki

Home

Keymap

vim-mode-plus has many advanced, experimental features but most of them have no default keymap.
If you want to use the full power of vim-mode-plus, see and experiment with each keymap, command in following links.

Commands summary of vmp's commands with keymap.
default keymaps
my dotfiles

Helper packages

ListOfVimModePlusPlugins

Below is list of my packages which provide more vim-like experience.
Why I don't build in these features? Because it takes more time and some features are useful for non-vim user.

cursor-history provides c-i, c-o to go/back in the cursor position history.
open-this provides gf to open file under cursor.
clip-history Does not exist in pure Vim, provides clip-board history you can pop yanked text until you get result you want.
choose-pane Does not exist in pure Vim, provides keyboard navigation between panes/panels by choosing it by label.
keystroke Keystrokes to keystroke keyamp in you keymap.cson.

References

Vim official

Other

operator, the true power of Vim by kana.
True power of Vim is Operator and TextObject.
List of text-object as vim plugin
vim-mode-plus builtin textobj for function, fold, entire, comment, indent, line, and any-pair(super set of many pair text-obj)

Commit emoji convention

📝 Add comment or doc
🎁 New feature.
🐛 Bug fix.
💣 Breaking compatibility.
✅ Write test.
🔥 Remove something.
🍺 I'm happy like reduced code complexity.