pub struct NavItem<A = ()> { /* private fields */ }Expand description
One optional-action navigation row.
Activation occurs on left-button release inside or pressed Enter/Space while focused. Only an enabled item with an action is focusable. Selection affects paint but does not suppress activation. Labels and badges are not clipped by this widget.
§Examples
use ailloli_ui_widgets::controls::NavItem;
let item: NavItem<()> = NavItem::new("Files");
let _ = item;Implementations§
Sourcepub fn height(self, value: impl Into<Length>) -> Self
pub fn height(self, value: impl Into<Length>) -> Self
Sets preferred height from a logical-pixel or length value.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().height(40.0);
let _ = widget;Sourcepub fn min_width(self, value: impl Into<Length>) -> Self
pub fn min_width(self, value: impl Into<Length>) -> Self
Sets the minimum width bound.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().min_width(40.0);
let _ = widget;Sourcepub fn max_width(self, value: impl Into<Length>) -> Self
pub fn max_width(self, value: impl Into<Length>) -> Self
Sets the maximum width bound.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().max_width(320.0);
let _ = widget;Sourcepub fn min_height(self, value: impl Into<Length>) -> Self
pub fn min_height(self, value: impl Into<Length>) -> Self
Sets the minimum height bound.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().min_height(24.0);
let _ = widget;Sourcepub fn max_height(self, value: impl Into<Length>) -> Self
pub fn max_height(self, value: impl Into<Length>) -> Self
Sets the maximum height bound.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().max_height(240.0);
let _ = widget;Sourcepub fn fill(self) -> Self
pub fn fill(self) -> Self
Sets both preferred axes to parent fill.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().fill();
let _ = widget;Sourcepub fn fill_width(self) -> Self
pub fn fill_width(self) -> Self
Sets preferred width to parent fill.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().fill_width();
let _ = widget;Sourcepub fn fill_height(self) -> Self
pub fn fill_height(self) -> Self
Sets preferred height to parent fill.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().fill_height();
let _ = widget;Sourcepub fn margin(self, value: f32) -> Self
pub fn margin(self, value: f32) -> Self
Sets uniform outer margin in logical pixels.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().margin(8.0);
let _ = widget;Sourcepub fn padding(self, value: f32) -> Self
pub fn padding(self, value: f32) -> Self
Sets uniform inner padding in logical pixels.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().padding(8.0);
let _ = widget;Sourcepub fn flex_grow(self) -> Self
pub fn flex_grow(self) -> Self
Sets flex-grow weight to one.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_grow();
let _ = widget;Sourcepub fn flex_grow_by(self, value: f32) -> Self
pub fn flex_grow_by(self, value: f32) -> Self
Sets a dimensionless flex-grow weight.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_grow_by(2.0);
let _ = widget;Sourcepub fn flex_shrink(self, value: f32) -> Self
pub fn flex_shrink(self, value: f32) -> Self
Sets a dimensionless flex-shrink weight.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_shrink(1.0);
let _ = widget;Sourcepub fn flex_basis(self, value: impl Into<Length>) -> Self
pub fn flex_basis(self, value: impl Into<Length>) -> Self
Sets the preferred main-axis flex basis.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_basis(80.0);
let _ = widget;Sourcepub fn align_self(self, value: AlignItems) -> Self
pub fn align_self(self, value: AlignItems) -> Self
Overrides cross-axis alignment for this flex item.
§Examples
use ailloli_ui_core::style::AlignItems;
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().align_self(AlignItems::Center);
let _ = widget;Sourcepub fn new(label: impl Into<String>) -> Self
pub fn new(label: impl Into<String>) -> Self
Creates an enabled, unselected item with no icon, badge, or action.
§Examples
use ailloli_ui_widgets::controls::NavItem;
let item: NavItem<()> = NavItem::new("Settings");
let _ = item;Sourcepub fn leading_icon(self, icon: IconId) -> Self
pub fn leading_icon(self, icon: IconId) -> Self
Sets the leading icon, replacing any prior icon.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::controls::NavItem;
let item: NavItem<()> = NavItem::new("History").leading_icon(IconId::History);
let _ = item;Sourcepub fn badge(self, count: u32) -> Self
pub fn badge(self, count: u32) -> Self
Sets an exact decimal badge count.
Every u32, including zero, is shown without a compact upper sentinel.
§Examples
use ailloli_ui_widgets::controls::NavItem;
let item: NavItem<()> = NavItem::new("Inbox").badge(5);
let _ = item;Sourcepub fn selected(self, selected: impl Into<Binding<bool>>) -> Self
pub fn selected(self, selected: impl Into<Binding<bool>>) -> Self
Sets static or reactive selected state.
Selected background takes precedence over pressed/hover state. Danger labels keep danger color while selected icons use selected tint.
§Examples
use ailloli_ui_widgets::controls::NavItem;
let item: NavItem<()> = NavItem::new("Current").selected(true);
let _ = item;Sourcepub fn disabled(self, disabled: impl Into<Binding<bool>>) -> Self
pub fn disabled(self, disabled: impl Into<Binding<bool>>) -> Self
Sets static or reactive disabled state.
Disabled items ignore events, are not focusable, and multiply paint
alpha by NavItemStyle::disabled_opacity.
§Examples
use ailloli_ui_widgets::controls::NavItem;
let item: NavItem<()> = NavItem::new("Unavailable").disabled(true);
let _ = item;Sourcepub fn variant(self, variant: NavItemVariant) -> Self
pub fn variant(self, variant: NavItemVariant) -> Self
Selects normal or danger label treatment.
§Examples
use ailloli_ui_widgets::controls::{NavItem, NavItemVariant};
let item: NavItem<()> = NavItem::new("Delete").variant(NavItemVariant::Danger);
let _ = item;Replaces complete row style and intrinsic metrics.
§Examples
use ailloli_ui_core::Theme;
use ailloli_ui_widgets::controls::{NavItem, NavItemStyle};
let style = NavItemStyle::from_theme(Theme::dark());
let item: NavItem<()> = NavItem::new("Styled").nav_item_style(style);
let _ = item;Sourcepub fn on_select(self, action: impl IntoClickAction<A>) -> Selfwhere
A: Clone,
pub fn on_select(self, action: impl IntoClickAction<A>) -> Selfwhere
A: Clone,
Installs an action value emitted on activation.
A later action builder replaces it. The item consumes input after the action runs.
§Examples
use ailloli_ui_widgets::controls::NavItem;
#[derive(Clone)]
enum Action { Open }
let item = NavItem::new("Files").on_select(Action::Open);
let _ = item;Sourcepub fn on_select_ctx(self, f: impl Fn(&mut EventCtx<A>) + 'static) -> Self
pub fn on_select_ctx(self, f: impl Fn(&mut EventCtx<A>) + 'static) -> Self
Installs a context-aware activation handler.
§Examples
use ailloli_ui_widgets::controls::NavItem;
let item = NavItem::<()>::new("Refresh").on_select_ctx(|ctx| ctx.request_repaint());
let _ = item;