Variable: tab-bar-auto-width-max

tab-bar-auto-width-max is a customizable variable defined in tab-bar.el.gz.

Value

((220) 20)

Documentation

Maximum width for automatic resizing of width of tab-bar tabs.

This determines the maximum width of tabs before their names will be truncated on display.

The value should be a list of two values: the first is the maximum width of tabs in pixels for GUI frames, the second is the maximum width of tabs in characters on TTY frames. Of these two values both accept integers, but the first element that provides a width in pixels can further be a list of a single integer, also specifying an integral width in pixels, but signifying that it should be scaled by the difference between the frame-char-height of the tab bar's frame, and 15, when the former height exceeds the latter threshold.

If the value of this variable is nil, there is no limit on maximum width. This variable has effect only when tab-bar-auto-width(var)/tab-bar-auto-width(fun) is non-nil.

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

Probably introduced at or before Emacs version 29.1.

Source Code

;; Defined in /usr/src/emacs/lisp/tab-bar.el.gz
(defcustom tab-bar-auto-width-max '((220) 20)
  "Maximum width for automatic resizing of width of tab-bar tabs.
This determines the maximum width of tabs before their names will be
truncated on display.

The value should be a list of two values: the first is the maximum width
of tabs in pixels for GUI frames, the second is the maximum width of
tabs in characters on TTY frames.  Of these two values both accept
integers, but the first element that provides a width in pixels can
further be a list of a single integer, also specifying an integral width
in pixels, but signifying that it should be scaled by the difference
between the `frame-char-height' of the tab bar's frame, and 15, when the
former height exceeds the latter threshold.

If the value of this variable is nil, there is no limit on maximum
width.
This variable has effect only when `tab-bar-auto-width' is non-nil."
  :type '(choice
          (const :tag "No limit" nil)
          (list (choice
                 (integer :tag "Max width (pixels)" :value 220)
                 (list (integer :tag "Max width (scaled pixels)"
                                :value 220)))
                (integer :tag "Max width (chars)" :value 20)))
  :initialize #'custom-initialize-default
  :set (lambda (sym val)
         (set-default sym val)
         (setq tab-bar--auto-width-hash nil))
  :group 'tab-bar
  :version "30.1")