Struct NavigationBar 

pub struct NavigationBar { /* private fields */ }

M3 Expressive flexible navigation bar: 3–5 primary destinations along the bottom of a compact or medium window, on surface-container.

Implementations

impl NavigationBar

pub fn new(id: impl Into<ElementId>, label: impl Into<SharedString>) -> Self

label is the navigation landmark’s accessible name.

pub fn items(self, items: impl IntoIterator<Item = NavItem>) -> Self

The destinations. Values must be unique.

pub fn selected(self, value: impl Into<SharedString>) -> Self

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

Choose the item layout from the bar’s own width, M3’s window size classes: vertical items while compact (under 600dp), horizontal items from medium widths up. Overrides Self::layout.

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

Whether presses spread a ripple (on by default).

pub fn layout(self, layout: NavItemLayout) -> Self

Horizontal items (icon beside label) for medium windows; vertical (the default) for compact ones. Expanded is a rail layout and renders as horizontal here.

pub fn show_labels(self, show: bool) -> Self

pub fn on_change( self, handler: impl Fn(&SharedString, &mut Window, &mut App) + 'static, ) -> Self

Trait Implementations

impl IntoElement for NavigationBar

type Element = ViewElement<NavigationBar>

The specific type of element into which the implementing type is converted. Useful for converting other types into elements automatically, like Strings

fn into_element(self) -> Self::Element

Convert self into a type that implements [Element].

fn into_any_element(self) -> AnyElement

Convert self into a dynamically-typed [AnyElement].

impl RenderOnce for NavigationBar

fn render(self, window: &mut Window, cx: &mut App) -> impl IntoElement

Render this component into an element tree. Note that this method takes ownership of self, as compared to [Render::render()] method which takes a mutable reference.