2013-05-16 10:43:18 -06:00
# Modifications to Lokaltog's EasyMotion
2013-05-16 10:42:57 -06:00
1. Use one - two character key jump. Display two keys if one-character key is not enough, so you can see what two keys to type without waiting after pressing the first key.
2. Added forward-backward search (bidirectional) search. You can jump to forward or backward at the same time.
3. Add SelectLines function which allows you to select any range of lines using consecutive easymotion calls.
2011-03-31 08:23:06 +02:00
# Introduction
2011-03-28 12:54:03 +02:00
2011-06-01 10:14:20 +02:00
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
2011-03-28 12:54:03 +02:00
jump directly to the target.
2011-06-01 10:14:20 +02:00
When one of the available motions is triggered, all visible text
preceding or following the cursor is faded, and motion targets are
2011-03-28 12:54:03 +02:00
highlighted.
2011-03-31 08:23:06 +02:00
EasyMotion is triggered by one of the provided mappings.
2011-03-28 12:54:03 +02:00
2011-04-07 10:29:03 +02:00
# Important notes about the default bindings
2011-11-07 14:39:51 +01:00
**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:
2011-04-07 10:29:03 +02:00
2011-06-01 10:14:20 +02:00
let g:EasyMotion_leader_key = '< Leader > '
2011-04-07 10:29:03 +02:00
2011-11-07 14:39:51 +01:00
All motions are now triggered with `<Leader><Leader>` by default, e.g.
`<Leader><Leader>t` , `<Leader><Leader>gE` .
2011-04-07 10:29:03 +02:00
2011-03-31 08:23:06 +02:00
## Usage example
2011-03-28 12:54:03 +02:00
2011-11-07 14:39:51 +01:00
Type `<Leader><Leader>w` to trigger the word motion `w` . When the motion is
2011-06-01 10:14:20 +02:00
triggered, the text is updated (no braces are actually added, the text
2011-03-31 08:23:06 +02:00
is highlighted in red by default):
2011-03-28 12:54:03 +02:00
< 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.
2011-06-01 10:14:20 +02:00
Similarly, if you're looking for an "o", you can use the `f` motion.
2011-11-07 14:39:51 +01:00
Type `<Leader><Leader>fo` , and all "o" characters are highlighted:
2011-03-31 08:23:06 +02:00
< 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.
2011-06-01 10:14:20 +02:00
Jeffrey Way of Nettuts+ has also [written
a tutorial](http://net.tutsplus.com/tutorials/other/vim-essential-plugin-easymotion/)
2011-03-31 08:23:06 +02:00
about EasyMotion.
2011-03-28 12:54:03 +02:00
## Animated demonstration
![Animated demonstration ](http://oi54.tinypic.com/2yysefm.jpg )