Sublime Text 2/3 plugin to quickly add an arbitrary selection to the current one.
- Total 417
- Win 249
- OS X 100
- Linux 68
|Oct 17||Oct 16||Oct 15||Oct 14||Oct 13||Oct 12||Oct 11||Oct 10||Oct 9||Oct 8||Oct 7||Oct 6||Oct 5||Oct 4||Oct 3||Oct 2||Oct 1||Sep 30||Sep 29||Sep 28||Sep 27||Sep 26||Sep 25||Sep 24||Sep 23||Sep 22||Sep 21||Sep 20||Sep 19||Sep 18||Sep 17||Sep 16||Sep 15||Sep 14||Sep 13||Sep 12||Sep 11||Sep 10||Sep 9||Sep 8||Sep 7||Sep 6||Sep 5||Sep 4||Sep 3|
After triggering the “Extend Selection” command (be it by using the key shortcuts, or the menu item in the “Selection” menu), you simply make a new selection and it will get added to the current one, instead of replacing it. You can make the new selection(s) in whatever way you would like - any method of navigation should be handled well.
Before you continue, do consider the package MultiEditUtils. It offers a lot more and can be used to achieve the same functionality as this plugin's.
Add the next selection to the current one
It will listen for the next change in the selection and append it to the previous selection (“current selection” at time of pressing alt+shift+m).
For example, if I want to keep my current selection at
line 15, column 10 and add to it a caret at line 12, I would trigger the “Extend Selection” command (default alt+shift+m), then call “Goto line”, type “:12” and press enter. That will move my caret to the beginning of line 12 but because I triggered “Extend Selection” beforehand, the new selection will be added to the previous one, rather than replacing it. So I will have a multi-selection at
line 12, column 0 and
line 15, column 10.
Manually completing “Extend Selection”
You can also extend the current selection with multiple new selections. Trigger “Start extending the selection” which is bound to ctrl+alt+m by default. Then make as many selections as you want. They will all add to the current one rather than overriding it. When you are done making selections, complete the command by calling “Finish extending the selection”, bound to ctrl+alt+m again (Esc would also work).
You may also have a look at the “Stay active until timeout expires” setting described below.
row 9 column 5
trigger “Start extending the selection” (ctrl+alt+m)
make selection at
row 10 column 0 to row 12 column 51
make selection at
row 0 column 0 to row 0 column 27
call “Finish extending the selection” (ctrl+alt+m again, or Esc)
selection is now multi-selection at
10:0 to 12:51and
0:0 to 0:27
Combine 'one-move' change events
The plugin by default tries to handle drag-selections (mouse dragging). This is achieved by combining new selections that are within one move from the recently-made new selection. While this does work, it also means that further selections made using the arrow keys, for example, will also be 'combined' with the latest one.
Example of when this may be unwanted
row 10 column 2
row 15 column 5to
row 15 column 20
This will add to the last selection, instead of doing shift+right for EVERY selection
Please beware of this and disable the feature if that behaviour is undesired.
Stay active until timeout expires
"active_until_timeout": 0 //ms
The completion of the command can be delayed for a specified amount of time. This means that selection changes will continue to be handled by the command even after the first one, until the timeout expires. The timeout refreshes after each selection change, so if frequent enough changes are made all of them will be handled by the command.
This is potentially confusing, even with a small timeout delay. Because of that, this feature is disabled by default.
The setting specifies the time to delay the completion by. The value is in milliseconds. Negative values and zero effectively disable the behaviour.
“active_until_timeout” is set to 500
row 11 column 3
make a selection at
row 16 column 6
within 0.5 second, make a selection at
row 17 column 7
the actual selection is now multi-selection at
wait 0.5 second, and the command completes
Install via PackageControl
If you have the PackageControl plugin installed, you can use that to install
ctrl-shift-p on win/linux) to bring up the command palette then type
install and pick
Package Control: Install Package from the dropdown.
ExtendSelection and choose the ExtendSelection plugin from the dropdown. Hit
enter and it will install.
Manual installation should be as easy as cloning this git repository into your Sublime
(mind the version of sublime)
cd "%AppData%\Sublime Text 2\Packages" git clone git://github.com/anly2/sublime-extend-selection.git ExtendSelection
Or you can copy the files manually into a folder
\Packages\ExtendSelection, if you do not have git or are not feeling comfortable with it.
[1.2.0] - released 15/12/15
- a feature named 'active_until_timeout' that delays the actual completion of the command for a specified time
[1.1.1] - released 14/12/15
- a feature named 'combine_onemove_events' that handles drag-selections
[1.0.0] - released 24/10/15
Initial release with basic functionality.