Variable: tab-line-tabs-function

tab-line-tabs-function is a customizable variable defined in tab-line.el.gz.

Value

tab-line-tabs-fixed-window-buffers

Documentation

Function to get a list of tabs to display in the tab line.

This function should return either a list of buffers whose names will be displayed, or just a list of strings to display in the tab line. By default, use function tab-line-tabs-fixed-window-buffers that returns a list of buffers associated with the selected window where buffers always keep the original order after switching buffers. When tab-line-tabs-mode-buffers, return a list of buffers with the same major mode as the current buffer. When tab-line-tabs-buffer-groups(var)/tab-line-tabs-buffer-groups(fun), return a list of buffers grouped by tab-line-tabs-buffer-group-function. The result of this function is cached using tab-line-cache-key-function.

This variable was added, or its default value changed, in Emacs 27.1.

Source Code

;; Defined in /usr/src/emacs/lisp/tab-line.el.gz
(defcustom tab-line-tabs-function #'tab-line-tabs-fixed-window-buffers
  "Function to get a list of tabs to display in the tab line.
This function should return either a list of buffers whose names will
be displayed, or just a list of strings to display in the tab line.
By default, use function `tab-line-tabs-fixed-window-buffers' that
returns a list of buffers associated with the selected window where
buffers always keep the original order after switching buffers.
When `tab-line-tabs-mode-buffers', return a list of buffers
with the same major mode as the current buffer.
When `tab-line-tabs-buffer-groups', return a list of buffers
grouped by `tab-line-tabs-buffer-group-function'.
The result of this function is cached using
`tab-line-cache-key-function'."
  :type '(choice (const :tag "Window buffers"
                        tab-line-tabs-window-buffers)
                 (const :tag "Window buffers with fixed order"
                        tab-line-tabs-fixed-window-buffers)
                 (const :tag "Same mode buffers"
                        tab-line-tabs-mode-buffers)
                 (const :tag "Grouped buffers"
                        tab-line-tabs-buffer-groups)
                 (function :tag "Function"))
  :initialize 'custom-initialize-default
  :set (lambda (sym val)
         (set-default sym val)
         (tab-line-force-update t))
  :group 'tab-line
  :version "27.1")