plugins.barbar.settings
Options provided to the require('barbar').setup function.
Type: attribute set of anything
Default:
{ }
Example:
{
animation = false;
exclude_ft = [
"oil"
"qf"
"fugitive"
];
exclude_name = [
"UnicodeTable.txt"
];
highlight_alternate = true;
icons = {
button = false;
separator_at_end = false;
};
}
Declared by:
plugins.barbar.settings.animation
Enable/disable animations.
Plugin default: true
Type: null or boolean or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.auto_hide
Automatically hide the ‘tabline’ when there are this many buffers left.
Set to any value less than 0 to disable.
For example: auto_hide = 0 hides the ‘tabline’ when there would be zero buffers shown,
auto_hide = 1 hides the ‘tabline’ when there would only be one, etc.
Plugin default: -1
Type: null or signed integer or value false (singular enum) or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.clickable
If set, you can left-click on a tab to switch to that buffer, and middle-click to delete it.
Plugin default: true
Type: null or boolean or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.exclude_ft
Excludes filetypes from appearing in the tabs.
Plugin default: [ ]
Type: null or (list of (string or raw lua code))
Default:
null
Declared by:
plugins.barbar.settings.exclude_name
Excludes buffers matching name from appearing in the tabs.
Plugin default: [ ]
Type: null or (list of (string or raw lua code))
Default:
null
Declared by:
plugins.barbar.settings.focus_on_close
The algorithm to use for getting the next buffer after closing the current one:
'left': focus the buffer to the left of the current buffer.'previous': focus the previous buffer.'right': focus the buffer to the right of the current buffer.
Plugin default: "left"
Type: null or one of “left”, “previous”, “right” or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.highlight_alternate
Enables highlighting of alternate buffers.
Plugin default: false
Type: null or boolean or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.highlight_inactive_file_icons
Enables highlighting the file icons of inactive buffers.
Plugin default: false
Type: null or boolean or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.highlight_visible
Enables highlighting of visible buffers.
Plugin default: true
Type: null or boolean or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.insert_at_end
If true, new buffers appear at the end of the list.
Default is to open after the current buffer.
Plugin default: false
Type: null or boolean or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.insert_at_start
If true, new buffers appear at the start of the list.
Default is to open after the current buffer.
Has priority over insert_at_end.
Plugin default: false
Type: null or boolean or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.letters
New buffer letters are assigned in this order. This order is optimal for the QWERTY keyboard layout but might need adjustment for other layouts.
Plugin default: "asdfjkl;ghnmxcvbziowerutyqpASDFJKLGHNMXCVBZIOWERUTYQP"
Type: null or string or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.maximum_length
Sets the maximum buffer name length.
Plugin default: 30
Type: null or unsigned integer, meaning >=0, or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.maximum_padding
Sets the maximum padding width with which to surround each tab.
Plugin default: 4
Type: null or unsigned integer, meaning >=0, or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.minimum_length
Sets the minimum buffer name length.
Plugin default: 0
Type: null or unsigned integer, meaning >=0, or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.minimum_padding
Sets the minimum padding width with which to surround each tab.
Plugin default: 1
Type: null or unsigned integer, meaning >=0, or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.no_name_title
Sets the name of unnamed buffers.
By default format is '[Buffer X]' where X is the buffer number.
However, only a static string is accepted here.
Plugin default: null
Type: null or string or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.semantic_letters
If true, the letters for each buffer in buffer-pick mode will be assigned based on their name.
Otherwise (or in case all letters are already assigned), the behavior is to assign letters in
the order of provided to letters.
Plugin default: true
Type: null or boolean or raw lua code
Default:
null
Declared by:
plugins.barbar.settings.sidebar_filetypes
Control which filetypes will cause barbar to add an offset.
Plugin default: { }
Type: null or (attribute set of (value true (singular enum) or (attribute set of anything) or raw lua code))
Default:
null
Declared by:
plugins.barbar.settings.tabpages
Enable/disable current/total tabpages indicator (top right corner).
Plugin default: true
Type: null or boolean or raw lua code
Default:
null
Declared by: