Struct Segment 

pub struct Segment { /* private fields */ }

One segment descriptor: a localized label with a stable SegmentId, an optional leading icon, a hover tooltip, and reactive disabled / visible flags.

Implementations

impl Segment

pub fn new(label: impl Into<LocalizedString>) -> Self

A text segment with a freshly allocated SegmentId. The label may come from tr!(...) (translated — follows a live locale switch) or lit!(...) (untranslated).

Call id when the segment needs a stable identity — one that survives a restart, or that another crate can name.

pub fn id(self, id: SegmentId) -> Self

Give this segment an app-chosen stable identity, replacing the fresh id new allocated. Use this whenever the selection is persisted or the segment is contributed by another crate.

pub fn segment_id(&self) -> SegmentId

This segment’s identity.

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

Add a leading icon. The factory is invoked at build time (and on rebuild); the icon’s tint is bound reactively to the segment’s selected / focus / enabled state so it matches the label.

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

Hover tooltip — most useful for icon-only segments.

Mutually exclusive with rich_tooltip / rich_tooltip_content / composite_tooltip — last call wins.

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

Rich hover tooltip resolved from the app-wide registry by key.

Mutually exclusive with tooltip / rich_tooltip_content / composite_tooltip — last call wins.

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

Rich hover tooltip driven by an inline TooltipContent entry (no registry key needed).

Mutually exclusive with tooltip / rich_tooltip / composite_tooltip — last call wins.

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

Composite hover tooltip built by a factory closure at attach time.

The factory is called once per build() to produce the tooltip body widget. It is stored as an Rc<dyn Fn> so that Segment remains Clone.

Mutually exclusive with tooltip / rich_tooltip / rich_tooltip_content — last call wins.

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

Disable this segment: not selectable via click or keyboard, dimmed, and announced disabled to assistive tech.

Accepts a bool or a Signal<bool> — a bound signal flips the segment live, with no rebuild, and keyboard stepping honours the new value immediately (the flags are read at event time, not snapshotted at build time).

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

Hide this segment entirely: it leaves the strip, the overflow menu, the keyboard order, and the accessibility tree, and it is excluded from the overflow calculation.

Distinct from overflowed — an overflowed segment is still reachable from the chevron menu, a hidden one is not there at all. Accepts a bool or a Signal<bool>; a bound signal re-runs the overflow plan with no rebuild.

Trait Implementations

impl Clone for Segment

fn clone(&self) -> Segment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Segment

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

Formats the value using the given formatter.

impl From<LocalizedString> for Segment

Label-only convenience: tr!(day()) / lit!("Off") flow straight into .segment(...) / .segments([...]) without Segment::new.

fn from(label: LocalizedString) -> Self

Converts to this type from the input type.