1
1
mirror of https://github.com/wez/wezterm.git synced 2024-12-13 18:39:30 +03:00
wezterm/docs/config/lua/TabInformation.md
Wez Furlong a282d07776 mux: add titles to mux window and tab objects
Previously, the mux layer had no internal understanding of titles other
than the Pane::get_title method to return state from a pane.

Users have asked for ways to explicitly set titles on windows and tabs,
so this commit is a step towards that.

The mux window and tab objects now store a title string.

The terminal layer now emits Alert::WindowTitleChanged when the window
title is changed via eg: OSC 0 or OSC 2.

The mux layer will respond to Alert::WindowTitleChanged by resolving the
window that corresponds to the source pane and amending its title.

The MuxWindow and MuxTab objects now provide accessor methods for the
title.

TabInformation (as used by format-tab-title and format-window-title) now
exposes the underlying window_id as well as tab_title and window_title.

The tab title can be changed via the lua MuxTab type, but there is not
currently an escape sequence associated with this.

The defaults for format-tab-title and format-window-title don't
currently consider these new title strings.

refs: https://github.com/wez/wezterm/issues/1598
2022-06-27 12:01:40 -07:00

19 lines
879 B
Markdown

# TabInformation
The `TabInformation` struct describes a tab. `TabInformation` is purely a
snapshot of some of the key characteristics of the tab, intended for use in
synchronous, fast, event callbacks that format GUI elements such as the window
and tab title bars.
The `TabInformation` struct contains the following fields:
* `tab_id` - the identifier for the tab
* `tab_index` - the logical tab position within its containing window, with 0 indicating the leftmost tab
* `is_active` - is true if this tab is the active tab
* `active_pane` - the [PaneInformation](PaneInformation.md) for the active pane in this tab
* `window_id` - the ID of the window that contains this tab (*Since: nightly builds only*)
* `window_title` - the title of the window that contains this tab (*Since: nightly builds only*)
* `tab_title` - the title of the tab (*Since: nightly builds only*)