244 lines
7.6 KiB
Markdown
244 lines
7.6 KiB
Markdown
Vim motion on speed! [](https://travis-ci.org/Lokaltog/vim-easymotion)
|
|
=====
|
|
|
|
|
|
|
|
About the authors
|
|
=====
|
|
|
|
- Kim Silkebækken (https://github.com/Lokaltog)
|
|
- haya14busa (https://github.com/haya14busa) (since version 2.0)
|
|
|
|
The EasyMotion project was revived!
|
|
======
|
|
|
|
Since version 2.0 [haya14busa](https://github.com/haya14busa) took over the project from
|
|
[Lokaltog](https://github.com/Lokaltog). He improved the default motions, implemented many new useful features,
|
|
and fixed some bugs.
|
|
|
|
EasyMotion is now completely
|
|
|
|
- **Well-behaved**: It's consistent with the default motions of Vim and works well in all modes. And it now suports dot repeat.
|
|
- **Configurable**. You can easily configure its behavior and map it to any key you want.
|
|
|
|
Even though some default behaviors where modified and many new features where added, I carefully considered backward compatibility, so you can easily update and enjoy significant benefit!
|
|
|
|
|
|
Introduction
|
|
=====
|
|
|
|
EasyMotion provides a much simpler way to use some motions in vim. It
|
|
takes the `<number>` out of `<number>w` or `<number>f{char}` by
|
|
highlighting all possible choices and allowing you to press one key to
|
|
jump directly to the target.
|
|
|
|
When one of the available motions is triggered, all visible text
|
|
preceding or following the cursor is faded, and motion targets are
|
|
highlighted.
|
|
|
|
EasyMotion is triggered by one of the provided mappings.
|
|
|
|
See `:help easymotion.txt` for more detail!
|
|
|
|
|
|
Important notes
|
|
=====
|
|
|
|
### Default bindings
|
|
|
|
**The default leader has been changed to `<Leader><Leader>` to avoid
|
|
conflicts with other plugins you may have installed.** This can easily be
|
|
changed back to pre-1.3 behavior by rebinding the leader in your vimrc:
|
|
|
|
```vim
|
|
map <Leader> <Plug>(easymotion-prefix)
|
|
```
|
|
|
|
All motions are now triggered with `<Leader>` by default, e.g.
|
|
`<Leader>s`, `<Leader>gE`.
|
|
|
|
### For users of the forked version
|
|
|
|
SelectLines and SelectPhrase are not related to *motion*, so I've moved them out
|
|
to seperate plugins.
|
|
|
|
- https://github.com/haya14busa/vim-easyoperator-line
|
|
- https://github.com/haya14busa/vim-easyoperator-phrase
|
|
|
|
Usage example for the base features
|
|
=====
|
|
|
|
<cursor>Lorem ipsum dolor sit amet.
|
|
|
|
Type `<Leader><Leader>w`(`<Plug>(easymotion-w)`) to trigger the word motion `w`. When the motion is
|
|
triggered, the text is updated (no braces are actually added, the text
|
|
is highlighted in red by default):
|
|
|
|
<cursor>Lorem {a}psum {b}olor {c}it {d}met.
|
|
|
|
Press `c` to jump to the beginning of the word "sit":
|
|
|
|
Lorem ipsum dolor <cursor>sit amet.
|
|
|
|
Similarly, if you're looking for an "o", you can use the `f` motion.
|
|
Type `<Leader><Leader>fo`, and all "o" characters are highlighted:
|
|
|
|
<cursor>L{a}rem ipsum d{b}l{c}r sit amet.
|
|
|
|
Press `b` to jump to the second "o":
|
|
|
|
Lorem ipsum d<cursor>olor sit amet.
|
|
|
|
Jeffrey Way of Nettuts+ has also [written
|
|
a tutorial](http://net.tutsplus.com/tutorials/other/vim-essential-plugin-easymotion/)
|
|
about EasyMotion.
|
|
|
|
|
|
New features since 2.0
|
|
====
|
|
|
|
### Two key highlighting
|
|
|
|
When EasyMotion runs out of single characters to highlight movement targets, it now tells you
|
|
right away both keys you have press.
|
|
|
|
In previous versions you would see the same character repeated over and over again for distant
|
|
movement targets. You first had to type this key before the highlighting changed to expose the
|
|
next key you had to press.
|
|
|
|
### Bidirectional motions
|
|
|
|
All motions now come in a bidirectional variant (e.g. `<Plug>(easymotion-s)`, `<Plug>(easymotion-bd-w)` and so forth).
|
|
By default you can already jump forward or backward with `<Leader>s`. A useful trick is to map `nmap s <Plug>(easymotion-s)` to use `s` instead and save one keystroke!
|
|
|
|
### 2-character search motion
|
|
|
|
You can now also perform a 2-character search, similar to [vim-seek](https://github.com/goldfeld/vim-seek)/[vim-sneak](https://github.com/justinmk/vim-sneak) with `<Plug>(easymotion-s2)`. For example you can highlight all words that start with `fu`.
|
|
|
|
|
|
|
|
```vim
|
|
" Gif config
|
|
nmap s <Plug>(easymotion-s2)
|
|
nmap t <Plug>(easymotion-t2)
|
|
```
|
|
|
|
### n-character search motion
|
|
|
|
You can also search for `n` characters, which basically can be used to replace the default search of Vim.
|
|
It suports incremental highlighting and you can use `<Tab>` and `<S-Tab>` to scroll down/up a page. If you press
|
|
`<CR>` you get the usual EasyMotion highlighting and can jump to any matching target destination with a
|
|
single keystroke.
|
|
|
|
What sounds complicated should become clear if you look at the following examples.
|
|
|
|
|
|
|
|
|
|
|
|
```vim
|
|
" Gif config
|
|
map / <Plug>(easymotion-sn)
|
|
omap / <Plug>(easymotion-tn)
|
|
map n <Plug>(easymotion-next)
|
|
map N <Plug>(easymotion-prev)
|
|
```
|
|
|
|
### Within line motion
|
|
|
|
Every motion can also be restricted to the current line (e.g. `<Plug>(easymotion-sl)`,
|
|
`<Plug>(easymotion-bd-wl)`, etc...). These motions match only the current line.
|
|
|
|
### hjkl motions
|
|
|
|
EasyMotion can be configured to avoid repetitive use of the `h` `j` `k` and `l`keys.
|
|
|
|
|
|
|
|
```vim
|
|
" Gif config
|
|
map <Leader>h <Plug>(easymotion-lineforward)
|
|
map <Leader>j <Plug>(easymotion-j)
|
|
map <Leader>k <Plug>(easymotion-k)
|
|
map <Leader>l <Plug>(easymotion-linebackward)
|
|
|
|
let g:EasyMotion_startofline = 0 " keep cursor colum when JK motion
|
|
```
|
|
|
|
### Smartcase & Smartsign
|
|
|
|
With this new setting EasyMotion works similar to Vim's smartcase option.
|
|
|
|
```vim
|
|
let g:EasyMotion_smartcase = 1
|
|
```
|
|
|
|
Type `v` to match `v` and `V`. Type `V` to match `V` only. Default: 0.
|
|
|
|
```vim
|
|
let g:EasyMotion_use_smartsign_us = 1 " US layout
|
|
" or
|
|
let g:EasyMotion_use_smartsign_jp = 1 " JP layout
|
|
```
|
|
|
|
Type `1` to match `1` and `!`. Type `!` to match `!` only. Default: 0.
|
|
|
|
|
|
### Migemo feature (for Japanese user)
|
|
|
|
```vim
|
|
let g:EasyMotion_use_migemo = 1
|
|
```
|
|
|
|
|
|
Easymotion can match multibyte Japanese characters with a alphabet input.
|
|
For example, `<Leader><Leader>sa` can search 'あ'.
|
|
This feature doesn't require cmigemo because Easymotion includes regex
|
|
patterns generated by cmigemo. However if you installed `cmigemo`,
|
|
2-character and n-character search motions also support the migemo feature.
|
|
Default:0
|
|
|
|
|
|
### Repeat motions
|
|
|
|
#### Repeat the last motion
|
|
|
|
`<Plug>(easymotion-repeat)`
|
|
|
|
#### Repeat the last find motion
|
|
|
|
In a find motion (e.g. `<Plug>(easymotion-s)`), type `<CR>` without
|
|
input characters to find the last motion again.
|
|
|
|
#### Jump to next/previous match (even on next/previous page)
|
|
|
|
* `<Plug>(easymotion-next)`
|
|
* `<Plug>(easymotion-prev)`
|
|
|
|
#### Support for dot repeat
|
|
|
|
This requires https://github.com/tpope/vim-repeat.
|
|
|
|
You can use EasyMotion in operator-pending and press `.` to repeat!
|
|
It is well-behaved, consistent with default behavior of Vim.
|
|
|
|
|
|
|
|
```vim
|
|
" Gif config
|
|
|
|
" Require tpope/vim-repeat to enable dot repeat support
|
|
" Jump to anywhere with only `s{char}{target}`
|
|
" `s<CR>` repeat last find motion.
|
|
nmap s <Plug>(easymotion-s)
|
|
" Bidirectional & within line 't' motion
|
|
omap t <Plug>(easymotion-bd-tl)
|
|
" Use uppercase target labels and type as a lower case
|
|
let g:EasyMotion_use_upper = 1
|
|
" type `l` and match `l`&`L`
|
|
let g:EasyMotion_smartcase = 1
|
|
" Smartsign (type `3` and match `3`&`#`)
|
|
let g:EasyMotion_use_smartsign_us = 1
|
|
```
|
|
|