This repository has been archived on 2024-10-22. You can view files and clone it, but cannot push or open issues or pull requests.
spacemacs/layers/+emacs/tabs
Lucius Hu 0bdddfc165
tabs: fix a typo
co-authored-by: Yixuan Chen <yixuan.chen@yale.edu>
2022-02-14 14:01:17 -05:00
..
config.el tabs: fix a typo 2022-02-14 14:01:17 -05:00
funcs.el tabs: Rework (#15293) 2022-02-04 05:36:26 +00:00
packages.el tabs: Rework (#15293) 2022-02-04 05:36:26 +00:00
README.org [bot] documentation_updates (#15310) 2022-02-04 05:39:59 +00:00

Tabs layer

Description

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

Features:

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

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.

Configuration

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-highlight-current-tab 'left))

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

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))

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