Struct TabInfo 

pub struct TabInfo { /* private fields */ }

Per-tab presentation metadata. Build with TabInfo::new and fluent setters.

let _info = TabInfo::new()
    .title(lit!("Welcome"))
    .icon(|| IconWidget::checkmark(16.0))
    .closable(true);

Implementations

impl TabInfo

pub fn new() -> Self

Empty defaults: no title, no icon, no tooltip, not closable, not pinned, enabled.

pub fn context_menu( self, f: impl Fn(Point, &mut EventContext<'_>) -> Option<Box<dyn Widget>> + 'static, ) -> Self

Attach a per-tab context menu (right-click the tab header). The factory receives the click position (tab-local) and a full [EventContext], and returns Some(menu) to mount or None to decline (falling through to an ancestor). Cloned per header build.

pub fn title(self, t: impl Into<LocalizedString>) -> Self

Set the tab’s title. Accepts tr!(...), a literal string, or any value implementing Into<LocalizedString>. None means icon-only (the pinned-tab presentation).

pub fn no_title(self) -> Self

Untitled — useful for icon-only tabs even when not pinned.

pub fn icon(self, factory: impl Fn() -> IconWidget + 'static) -> Self

Set the leading icon via a factory closure. The closure is called each time the TabHeader is built — typically once per tab lifetime, plus any rebuild triggered by data-source mutations.

pub fn tooltip(self, t: impl Into<LocalizedString>) -> Self

Tooltip text shown on hover. If unset and the tab is pinned, the framework promotes title to the tooltip — pinned tabs render icon-only and otherwise have no way for the user to identify them.

pub fn rich_tooltip(self, key: impl Into<String>) -> Self

Attach a rich tooltip resolved from the app-wide tooltip registry. See Button::rich_tooltip.

pub fn rich_tooltip_content(self, content: TooltipContent) -> Self

Attach a rich tooltip driven by inline TooltipContent.

pub fn composite_tooltip<W>(self, factory: impl Fn() -> W + 'static) -> Self

where W: Widget + 'static,

Attach a composite tooltip — third tier, hosting an arbitrary widget tree. The factory closure is called each time the tab’s header rebuilds, so the body picks up theme / locale changes naturally without retaining state across rebuilds.

pub fn closable(self, b: bool) -> Self

Whether the tab shows a close button + responds to middle-click. Default: false.

pub fn pinned(self, b: bool) -> Self

Whether the tab renders in the leading pinned strip (icon-only, fixed-width, no close button — Firefox / Chrome convention). Default: false.

pub fn enabled(self, enabled: impl Into<Prop<bool>>) -> Self

Whether the tab can be activated. Disabled tabs render but are skipped by keyboard navigation, can’t be clicked, and don’t get the close button. Default: true.

Forwarded to the arena via ctx.enabled_when(header_id, false) at build time when false. Ancestor-driven disable (e.g. a disabled TabBar) ANDs with this flag automatically.

pub fn focusable_panel(self, b: bool) -> Self

Make the tab’s content pane itself focusable, so keyboard users can press Tab from the selected tab header and land inside the panel.

Opt in for panels you know contain no focusable descendants — a static text-only “About” tab, a chart-only metrics tab. Panels that already host a Button, TextInput, ListView, or any other interactive widget don’t need this: focus will flow naturally into the descendant.

ARIA: this implements the tabindex="0" requirement that an empty tabpanel must be focusable so its content can be read by screen readers in browse mode. AccessKit has no tabindex field; the framework advertises Action::Focus on the panel node to signal focusability to AT. Default: false.

Trait Implementations

impl Clone for TabInfo

fn clone(&self) -> TabInfo

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TabInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TabInfo

fn default() -> Self

Returns the “default value” for a type.