Tab Multi-Select
Version:

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 View β–Ά Layout 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

Symbol NavigationπŸ”—

In addition to the basic usage of tab multi-select, the symbol navigation in Sublime Text fully supports this behavior, making it easy to lookup and navigate around code in a very natural way.

Goto DefinitionπŸ”—

The commands Goto Definition and Goto Reference invoked via a key binding support:

  • Appends the tab to the right of the focused tab, replacing others: Primary

Goto Symbol in ProjectπŸ”—

When selecting a symbol in the quick panel the following modifiers may be used when pressing Enter or clicking with a mouse:

  • 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

Definitions PopupπŸ”—

When clicking on any of the links in the Definitions popup, the following modifiers work:

  • Append the tab to the selection: Shift

  • Append the tab to the right of the focused tab, replacing others: Primary

  • Replace entire tab selection: Alt

In this case, the Alt modifier is reversed since the default behavior is to replace the focused tab in the selection.

To make the tab multi-select functionality more obvious, an icon is displayed at the end of each file path that is equivalent to holding the Primary modifier.

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:

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /