Struct TabBar

pub struct TabBar<Msg: Clone> {
    pub labels: Vec<String>,
    pub selected: usize,
    pub on_select: Option<Arc<dyn Fn(usize) -> Msg>>,
    pub strip_bg: Option<Color>,
}

Segmented horizontal tab selector. One row of pressable cells with the active cell painted as a filled pill and inactive cells as plain text. Build it from a slice of labels; produce an Element with Self::build (or by .into()-ing it where an Element is expected).

Fields

labels: Vec<String>

selected: usize

on_select: Option<Arc<dyn Fn(usize) -> Msg>>

strip_bg: Option<Color>

Background colour of the strip itself. None paints no background, letting the parent surface show through.

Implementations

impl<Msg: Clone + 'static> TabBar<Msg>

pub fn new<I, S>(labels: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Build a tab bar from an iterable of labels.

pub fn selected(self, idx: usize) -> Self

Index of the currently selected tab. Out-of-range values are drawn as “no tab active”.

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

Callback invoked with the index of the tapped tab.

pub fn strip_bg(self, c: Color) -> Self

Override the strip background colour. Pass None (via Self::strip_bg_none) to disable the background entirely.

pub fn strip_bg_none(self) -> Self

Paint no strip background. Useful inside containers that already provide their own surface chrome.

pub fn build(self) -> Element<Msg>

Build the Element tree representing this tab bar. Equivalent to Element::from( self ).

Trait Implementations

impl<Msg: Clone + 'static> From<TabBar<Msg>> for Element<Msg>

fn from(t: TabBar<Msg>) -> Self

Converts to this type from the input type.