Tabs layer

Table of ContentsClose

1. Description
- 1.1. Features:
2. Install
3. Configuration
4. Key bindings

1. Description

This layer adds support for tabs. Implementation is done using Centaur Tabs.

1.1. Features:

Sets up tabs using Centaur tabs as backend
Optionally auto hide tabs after delay

2. Install

To use this configuration layer, add it to your ~/.spacemacs. You will need to add tabs to the existing dotspacemacs-configuration-layers list in this file.

3. Configuration

3.1. Selected tab bar

To display a bar in the given direction to the selected tab, set tabs-highlight-current-tab to one of left (default), under, over.

For example,

(setq-default dotspacemacs-configuration-layers
              '(tabs :variables tabs-selected-tab-bar 'over))

Note that this has no effect when Emacs is running in daemon mode.

3.2. Hide tabs after a delay

You can set hooks for buffers in which it isn't desired to have tabs by customizing centaur-tabs-hide-tabs-hooks.

Alternatively you can set tabs-auto-hide to t to auto hide tabs after some delay tabs-auto-hide-delay via the :variables keyword in your .spacemacs:

(setq-default dotspacemacs-configuration-layers
              '(tabs :variables
                     tabs-auto-hide t
                     tabs-auto-hide-delay 3))

3.3. Tab icons

By default, tab icons are enabled, if the spacemacs-visual layer is enabled and the all-the-icons package is used. You can disable icons just for the tabs display by setting tabs-icons to nil:

(setq-default dotspacemacs-configuration-layers
              '(tabs :variables tabs-icons nil))

4. Key bindings

Key binding	Description
`g t`	Select the next available tab
`g T`	Select the previous available tab
`g C-t`	Move current tabe to right
`g C-T`	Move current tabe to left
`C-c t s`	Display a list of current buffer groups using Counsel
`C-c t p`	Group buffer tabs by projectile
`C-c t g`	Group buffer tabs by groups