Editor Groups

Add an additional tab panel for files belonging to the same logic group.

This is an implementation of https://github.com/SomewhatCloudy/phpstorm-related-proposal

[](

Features

Group by File Name

Displays all files with the same name (without extension) in the project.

Group by Folder

Displays all files in the same folder.

Group by Bookmarked Files

Show all files and line bookmarks from your bookmark groups.

Group by Regex (Advanced)

Define regex groups and group all files matching the regex.

Group Switcher

Quickly switch between groups using the group switcher.

Switch current opened file

You can switch the current opened file with another file from the same group

• From the tab panel
• From the inline popup at the top right

You can also open the file in a new tab, window, or split window:

• Ctrl + Click - open a file in a new tab
• Shift + Click - open a file in a new window
• Alt + Click - open a file in a vertical split window
• Alt + Shift + Click - open a file in a horizontal split window

Tool Window

The plugin also provides a tool window to display all the groups and files.

Shortcuts

• Ctrl + Alt + Q - Refresh

• Ctrl + Alt + W - Switch Group popup

• Ctrl + Alt + Shift + W - Switch File popup

• Ctrl + Mouse Wheel or Ctrl + ; or ' - switch file (closing the previous one)

• Ctrl + Alt + Mouse Wheel or Ctrl + Alt + ; or ' - switch file (leaving the previous one opened)

• Ctrl + Shift + Mouse Wheel - switch file into a new window

---

Settings

The plugin includes a vast choice of settings to customize the behavior, performance and appearance of the plugin.

You can enter the settings either by looking for Editor Groups in the settings search bar, or by right clicking on the panel and selecting Open Editor Groups Settings.

Global

• Show Tabs Panel: Whether to disable the tabs panel globally

Behavior

Fallback behavior

By default, the plugin will try to match the best suited group for the current file:

• If it belongs to a bookmark group

If no match is found, it will fall back to the following cases, in this order:

• Fallback to "Regex Group": Will try to match to one of the defined Regex Groups
• Fallback to "Same Name" group: Will try to match all files with the same name (without extension)
• Fallback to "Current Folder" group: Will try to match all files within the same folder

If no match is found (e.g. there is only one file in this group, the current file), then it will execute the following check:

• If Hide Panel If Empty is enabled, the panel will be hidden
• Otherwise it will display the current file

Remember Last Group

When enabled, the plugin will keep in memory the last selected group for each opened file.

---

Appearance

Rounded Tabs

Display the tabs in a new style, similar to the one used within the new "Islands Layout"

Tabs Position

You can customize the position of the tab panel (TOP or BOTTOM)

Custom Font

You can change the font of the tabs.

Display Group Size

Displays the size of the group.

There's also an icon that displays the size of the group in the tab panel.

Compact Tabs

Reduce the size of the tabs.

Colorize Tabs

With this setting, opened tabs belonging to the same group will be reflected in the main tab panel. This is useful to get a quick glance of all the related opened tabs for quicker switching.

Note: The default groups (Same Name, Current Folder, Bookmarks) have their own predefined color that you can customize in the File Colors Settings.

---

Performance

You can also improve the performance of the plugins with the following options

Initialize groups synchronously

By default, the plugin will match files belonging to the same group asynchronously, which results in showing a "Loading..." pane until all files are indexed. You can disable this behavior to show the files immediately.

Group Size Limit

The maximum number of files that can be matched within a group. If the group size exceeds this limit, the group will not be displayed.

Tab Limit

The maximum number of tabs that can be displayed in the tab panel. If the number of tabs exceeds this limit, the exceeding tabs will not be displayed.