Tab Multi-Select
Ver
:
Added in:4.0
Similar to the popular feature of multiple cursors, Sublime Text also allows users to select multiple tabs at once. Through a combination of UI elements, modifier keys and shortcuts, users can leverage this functionality to more quickly and easily navigate and organize tabs.
Basics🔗
Tab multi-select is an easy-to-use, lightweight and quick way to view multiple tabs at once. It is distinct from the functionality found in the
menu. When multiple tabs are selected, Sublime Text will automatically split the editor pane to display the tabs horizontally.Note: in the following key bindings, Primary refers to the Ctrl key on Windows and Linux, and the Cmd key on Mac.
Adding to the Selection🔗
Users may add tabs to the current tab selection by using one of the following:
Modifiers🔗
The following actions support adding a tab via modifier:
Clicking an unselected tab: Primary
Clicking an unselected filename in the tab dropdown: Primary
Clicking an unselected filename in the side bar: Primary
Shortcuts🔗
Add tab to the left: Primary+J, Primary+Shift+Left
Add tab to the right: Primary+J, Primary+Shift+Right
Changing Focus🔗
Users may switch input focus between selected tabs by using one of the following:
Shortcuts🔗
Focus tab to the left
Windows/Linux: Ctrl+J, Ctrl+Pageup
Mac: Cmd+J, Cmd+Shift+[
Focus tab to the right
Windows/Linux: Ctrl+J, Ctrl+Pagedown
Mac: Cmd+J, Cmd+Shift+]
Removing from the Selection🔗
Users may remove tabs from the current tab selection by using one of the following:
Modifiers🔗
The following actions support removing a tab via modifier:
Clicking a selected tab: Primary
Clicking a selected filename in the tab dropdown: Primary
Clicking a selected filename in the side bar: Primary
Shortcuts🔗
Deselect all but focused tab: Primary+J, Primary+Up
Deselect tabs to left: Primary+J, Primary+Left
Deselect tabs to right: Primary+J, Primary+Right
Replacing the Focused Tab🔗
Users may replace the focused tab in the selection by using one of the following:
Modifiers🔗
The following actions support replacing a tab via modifier:
Clicking an unselected tab: Alt
Clicking a filename in the tab dropdown: Alt (except Windows)
Clicking a filename in the side bar: Alt
Goto File🔗
When using Goto Anything to open a file, the following modifiers may be used when pressing Enter or clicking with a mouse:
Modifiers🔗
The following actions support replacing a tab via modifier:
Append the tab to the selection: Shift
Append the tab to the right of the focused tab, replacing others: Primary
Replace the focused tab: Alt
Switch Header/Implementation🔗
The command Switch Header/Implementation invoked via a key binding supports:
Append the tab to the selection: Shift
Plugins🔗
A number of API features exist to allow plugins to provide tab multi-selection behavior.
Event Dictionary🔗
Both commands and the quick panel on_done
callback, can choose to receive an
Event dict
. The dict
contains details about user input,
including which modifier keys were pressed.
For commands, the dict
is typically requested when a command is invoked via
a link in an HTML popup.
Window.open_file()
Flags🔗
The Window.open_file()
method accepts a number of bitwise flags that allow
controlling how the newly-opened file should be presented to the user. See
NewFileFlags
for the full list of flags.
Window
and Sheet
APIs🔗
Window
and Sheet
objects have a number of methods available for modifying
the selected sheets: