Variable: tab-line-tabs-function

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

Value

tab-line-tabs-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-window-buffers that returns a list of buffers associated with the selected window. 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 either by tab-line-tabs-buffer-group-function, when set, or by tab-line-tabs-buffer-groups(var)/tab-line-tabs-buffer-groups(fun).

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-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-window-buffers' that
returns a list of buffers associated with the selected window.
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 either by `tab-line-tabs-buffer-group-function', when set,
or by `tab-line-tabs-buffer-groups'."
  :type '(choice (const :tag "Window buffers"
                        tab-line-tabs-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)
         (force-mode-line-update))
  :group 'tab-line
  :version "27.1")