Struct NativeTabBarView 

pub struct NativeTabBarView { /* private fields */ }

A real, bare UITabBar on iOS/iPadOS — a controlled bottom tab bar that never navigates by itself: a tap reports the requested TabId through Self::on_select, the app routes (typically RouteNavigator::go) and feeds the confirmed id back as selected on the next build. A tap on the tab already showing reports through Self::on_reselect instead (“scroll to top / pop to root”). macOS and Android (and every host target) render a frust-drawn refusal banner. Build one with native_tab_bar.

Placement and height

The bar sizes itself: 49pt tall plus the window’s bottom safe-area inset, read at layout time, as wide as its parent allows — so its background runs under the home indicator while UIKit keeps the items above it. Put it last in a Column docked to the window’s bottom edge, and do not also consume the bottom inset above it: if you wrap it in frust::safe_area for horizontal cutouts, use .top(false).bottom(false) — the shape examples/huddle uses for Material’s navigation_bar, which self-insets the same way. For a bar that is not docked to the bottom edge, call Self::safe_area(false) to get the bare 49pt.

On iPadOS a bare UITabBar stays a bottom bar (the iPadOS 18 top tab bar and the Liquid Glass floating bar are UITabBarController features), which is expected.

Implementations

impl NativeTabBarView

pub fn on_select(self, handler: impl Fn(TabId) + Send + Sync + 'static) -> Self

Fires with the requested tab’s id when the user taps a tab other than the one showing — the app confirms (or rejects) it by feeding selected back through the next build. Never fires on a target with no tab-bar arm.

pub fn on_reselect( self, handler: impl Fn(TabId) + Send + Sync + 'static, ) -> Self

Fires with the showing tab’s id when the user taps it again — conventionally “scroll to top” or “pop to the tab’s root”. Changes nothing by itself.

pub fn safe_area(self, enabled: bool) -> Self

Whether the bar grows by the window’s bottom safe-area inset (default true, for a bar docked to the bottom edge). false keeps the bare 49pt, for a bar embedded mid-screen.

Trait Implementations

impl Clone for NativeTabBarView

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Component for NativeTabBarView

type State = u64

The retained local state this component owns across rebuilds.

fn init(&self) -> SlotId

Create the component’s initial local state. Runs exactly once, when the ComponentWidget is first built, under the component’s Owner (so on_cleanup/provide_context registered here bind to that owner).

fn build(&self, state: &mut SlotId) -> AnyView<SlotId>

Produce the component’s subtree from its current local state.

impl<Outer: 'static> View<Outer> for NativeTabBarView

type Element = ComponentWidget<NativeTabBarView>

The retained widget this view produces.

fn build(&self, ctx: &mut BuildCtx<'_>) -> Self::Element

Materialise a fresh widget for this view.

fn rebuild( &self, prev: &Self, element: &mut Self::Element, ctx: &mut BuildCtx<'_>, ) -> ChangeFlags

Reconcile prev (the previous view of the same type) against the live element, mutating it in place and reporting what changed.

fn teardown(&self, element: &mut Self::Element, ctx: &mut BuildCtx<'_>)

Tear down element when this view is being removed.

fn message(&self, _element: &mut Self::Element, _state: &mut State)

Deliver an event message to this view, mutating application state.