A plugin for Sublime Text 3 heavily inspired by AceJump for emacs.
AceJump allows you to move the cursor to any character to any place currently on screen. To clarify, you can jump between characters in all visible portions of currently open documents in any panes. Like it's emacs counterpart, AceJump for sublime features word (on the image below), character and line modes which make jumping even easier.
After selecting a mode, you type in a character (except in line mode, where you don't have to type in anything) and appropriate labels are displayed. Then all you need to do is press the key from the label and voila!
You can install AceJump from PackageControl by following the steps below:
- Open up the command palette and select
Package Control: Install Package - Wait for the packages index to load and select
AceJump
You can install AceJump manually using git by running the following command within sublime packages directory (Preferences > Browse Packages):
$ git clone [email protected]:ice9js/ace-jump-sublime.git AceJump/
Or you can just copy the contents of this repository into Packages/AceJump.
Goes to a word starting with the given character. This mode works only with alphanumeric characters. If you're interested in jumping to a special character, use character mode instead.
Ctrl/Super + Shift + ;<head character><label>
No need to press enter after selecting a label!
Goes to an occurence of the given character.
Ctrl/Super + Shift + '<character><label>
Labels all non-empty lines and lets you jump to one of them.
Ctrl/Super + Shift + .<label>
Labels all words within the line where current cursor locate and lets you jump to one of them.
Ctrl/Super + Shift + ,<label>
After triggering select mode, the next jump will select everything inbetween the current cursor position and the selected label. When select mode is triggered, the next jump is limited to the current file.
Alt+;(Ctrl+;for OS X)- perform a jump using word, character or line mode
After triggering multiple cursors mode, the next jump will add a new cursor to the view instead of moving the existing one. Again, when this mode is triggered, only jumps in the same file are available.
Alt+'(Ctrl+'for OS X)
In this mode, the cursor will jump behind the targeted instance. Unfortunetely, this mode cannot be paired with select or multiple cursors mode yet.
Alt+.(Ctrl+.for OS X)
In case there are more places to jump to than labels available, labels will be batched and you can cycle through them by simply pressing enter.
In order to access AceJump settings, go to Preferences > Package Settings > AceJump > Settings - User or open command palette commands:
Preferences: AceJump Settingsto open default and user settings side-by-sidePreferences: AceJump Settings: DefaultPreferences: AceJump Settings: UserPreferences: AceJump Keybinds: Defaultto open default and user (commonDefault (OSX).sublime-keymapfile, not AceJump-specific) keybinds side-by-sidePreferences: AceJump Keybinds: UserPreferences: AceJump Keybinds
Default keybindings are disabled to avoid conflicts with your other keybinds, you can enable them by adding either of the following settings to your Preferences.sublime-settings file via Preferences: Settings command palette command (NOT AceJump.sublime-settings):
"ace_jump_key_single":true,every command mapped to a single key combo"ace_jump_key_chain" :true,⌃j as a prefix key (⌘ on a Mac) with letter-based "mnemonics" likeWord"ace_jump_key_chome" :true,⌃j as a prefix key (⌘ on a Mac) with more convenient home-row based locations
| Command | Single | Chain | CHome |
|---|---|---|---|
ace_jump_word |
⇧⌃; | ⌃j, ⌃w | ⌃j, ⌃k |
ace_jump_char |
⇧⌃' | ⌃j, ⌃c | ⌃j, ⌃l |
ace_jump_line |
⇧⌃. | ⌃j, ⌃l | ⌃j, ⌃; |
ace_jump_within_line |
⇧⌃, | ⌃j, ⌃i | ⌃j, ⌃j |
| ↓ Modes | |||
ace_jump_add_cursor |
⎇' | ⌃j, c | ⌃j, ⌃a, ⌃k1 or l or ; or j |
ace_jump_select |
⎇; | ⌃j, s | ⌃j, ⌃s, ⌃k1 or l or ; or j |
ace_jump_after |
⎇. | ⌃j, a | ⌃j, ⌃f, ⌃k1 or l or ; or j |
Or you can then override the bindings for any of the following commands via Preferences > Package Settings > AceJump > Key Bindings - User:
ace_jump_wordace_jump_charace_jump_lineace_jump_within_lineace_jump_selectace_jump_add_cursorace_jump_after
The commands accept an optional Boolean current_buffer_only argument. When present and set to true, AceJump only performs on the currently edited buffer.
You can override the labels setting to provide your own set of labels to be used by AceJump.
When invoking 3 mode commands (ace_jump_select, ace_jump_add_cursor, and ace_jump_after) you can have visual indicators that a mode is on via a popup menu (e.g., when selection is on you'd see a ▋ symbol 
) or in the statubar by setting popup_mode and status_mode settings. There are also additional settings for more control of these indicators, see Preferences: AceJump Settings: Default
You can also set the syntax scope that's used for highlighting by overriding labels_scope. The default scope is invalid. Also you can set the syntax scope for the carets via the inactive_carets_scope setting, e.g., "" blank would hide the carets when labels are shown.
Ace jump is case sensitive by default. Case sensitivity can be toggled on and off by altering the search_case_sensitivity setting.
By setting jump_behind_last_characters to true, AceJump will jump behind a character if it's the last character on a line, without the need to trigger jump after mode. This only works in character mode and is switched off by default.
AceJump changes the theme to a blank one when labels are shown to make them more visible, by setting change_theme to false you can disable this.
It has been reported that the Select mode, Multi cursors mode and Jump after mode might not work using the specified keybinding.
As a workaround for that follow these steps:
- Start a regular search, e.g. word search (default keybinding: Ctrl+Shift+;).
- Before entering any character, activate the advanced mode (e.g. for Select mode use Alt+;).
- Now enter the character to lookup.
- Use the label to go to the corresponding location.