Struct Tabs 

pub struct Tabs<Msg> { /* private fields */ }

A row of tabs. The open tab is a raised surface; tabs are never boxed or bracketed.

With no options it is the plainest strip: keys while focused are ←/→ (or h/l) to open the neighbouring tab, and 1–9 open a tab by number when numbers are shown. When the tabs do not fit, arrow controls appear at both ends: a click scrolls one tab, and ctrl+PgUp, ctrl+PgDn and the wheel do the same. Opening a tab brings it into view.

Capabilities are independent options:

• closable: a faint × on every tab that brightens on hover; clicking it, a middle click on the tab or ctrl+w closes the tab. pinned tabs cannot be closed.
• tab_width: fit, fixed or filling tabs.
• overflow: scroll arrows or a menu of hidden tabs.
• reorderable: drag a tab to move it; a ghost follows the pointer and the tabs make room where it will land. ctrl+shift+←/→ moves the open tab. Held on a scroll arrow or past an end of an overflowing strip, the dragged tab scrolls the strip: one tab after 400 ms, then one every 150 ms (sooner the further past the end) until the pointer leaves or the strip ends; the arrow lights up meanwhile and the drop slot follows the tabs coming into view. on_drag_scroll reports each step.
• context_menu: a right click on a tab opens a menu of actions for it at the pointer; the menu key or shift+F10 opens the menu of the open tab. Without it a right click does nothing.

Style keys: tab with hover, selected, focus; tab-index for numbers; close-mark (with active on a raised tab, hover under the pointer); tab-arrow (bg, fg, pillar) with hover, pressed, disabled; tab-menu (bg, fg, pillar) with hover, active while its menu is open; tab-ghost and tab-drop (bg) while dragging; popup-menu, popup-item, popup-check for the menu of hidden tabs; the keys of ContextItem for the context menu.

Implementations

impl<Msg: 'static> Tabs<Msg>

pub fn new(labels: impl IntoIterator<Item = impl Into<String>>) -> Self

Tabs with labels; the first is open.

pub fn active(self, index: usize) -> Self

The open tab.

pub fn numbered(self, numbered: bool) -> Self

Shows 1, 2, 3… before the labels and lets number keys open tabs.

pub fn on_select(self, message: impl Fn(usize) -> Msg + 'static) -> Self

Message for opening tab index.

pub fn closable(self, message: impl Fn(usize) -> Msg + 'static) -> Self

Makes tabs closable: message(index) asks the application to close tab index. TabEdit::Close applies it to the application’s list.

pub fn pinned(self, indices: impl IntoIterator<Item = usize>) -> Self

Tabs that cannot be closed, such as a pinned start page. They show no close mark.

pub fn tab_width(self, width: TabWidth) -> Self

How wide the tabs are; TabWidth::Fit by default.

pub fn overflow(self, overflow: Overflow) -> Self

What happens when the tabs do not fit; Overflow::Arrows by default.

pub fn reorderable( self, message: impl Fn(usize, usize) -> Msg + 'static, ) -> Self

Makes tabs reorderable: message(from, to) asks the application to move a tab. TabEdit::Move applies it to the application’s list.

pub fn on_drag_scroll(self, message: impl Fn(usize) -> Msg + 'static) -> Self

Message for each step a dragged tab scrolls an overflowing strip, with the position of the first tab now in view (counted from 0), e.g. to log it. Only reorderable strips scroll this way.

pub fn context_menu( self, items: impl Fn(usize) -> Vec<ContextItem<Msg>> + 'static, ) -> Self

Gives every tab a context menu: items(index) builds the entries for tab index, such as Close, Close others or Pin. A right click on a tab opens its menu at the pointer; the menu key or shift+F10 opens the menu of the open tab below it, scrolling the tab into view first. Choosing an entry sends its message.

Trait Implementations

impl<Msg: 'static> Widget<Msg> for Tabs<Msg>

fn measure(&self, _cx: &mut MeasureCx<'_>, available: Size) -> Size

The size the widget wants when it may use up to available.

fn paint(&self, cx: &mut PaintCx<'_>, area: Rect)

Draws the widget into area.

fn paint_overlay(&self, cx: &mut PaintCx<'_>, anchor: Rect)

Draws the widget’s overlay after the whole view was painted, when it asked for one with PaintCx::request_overlay. anchor is the area the widget was painted in.

fn event(&self, cx: &mut EventCx<'_, Msg>, event: &Event) -> bool

Handles input. Returns true when the event was used; unused key and scroll events bubble to the parent widget.

fn focusable(&self) -> bool

Whether the widget can take keyboard focus.

fn children(&self) -> &[Node<Msg>]

Child nodes, for widgets that contain other widgets.

fn children_mut(&mut self) -> &mut [Node<Msg>]

Mutable child nodes, used to assign ids.