Struct SplitButtonView 

pub struct SplitButtonView<State: 'static> { /* private fields */ }

A declarative split button. See the module docs.

Implementations

impl<State: 'static> SplitButtonView<State>

pub fn size(self, size: SplitButtonSize) -> Self

Set the size tier (the module docs’ Sizes table).

pub fn shape(self, shape: SplitButtonShape) -> Self

Set the corner-radius family (pill vs. per-size token radius).

pub fn variant(self, variant: SplitButtonVariant) -> Self

Set the container treatment (the module docs’ Variants section).

pub fn trailing_alignment(self, alignment: SplitButtonTrailingAlignment) -> Self

Set how the trailing chevron is centred (trailingAlignment).

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

Whether the control as a whole accepts input — the reference’s IgnorePointer(ignoring: !enabled). false disables both halves regardless of Self::trailing_enabled.

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

Whether the trailing menu trigger accepts input, independently of the leading action (default true).

The reference carries leadingEnabled/trailingEnabled as two distinct variables fed from one prop (m3e_split_button_content.dart:212); this makes the second one real, so an app can offer the action while the menu has nothing to show. A disabled trailing half paints the 38%/12% disabled roles, reports disabled semantics, and simply never arms.

pub fn leading_icon<F, V>(self, icon: F) -> Self

where F: Fn() -> V + 'static, V: View<State>,

Attach a leading icon before the label (M3ESplitButton.leadingIcon). The factory is re-invoked per pass, since a view is a value rebuilt every frame. The factory may return any view, which is erased here: .leading_icon(|| icon(icons::CHECK)).

pub fn trailing_label(self, label: impl Into<String>) -> Self

Override the trailing half’s accessible name (default "Show menu") — the reference’s trailingTooltip in the one role this framework has for it.

pub fn gap(self, gap: f64) -> Self

Override the gap between the halves, in logical px (M3ESplitButtonDecoration.gap). Unset resolves SPLIT_ELEVATED_INNER_GAP for SplitButtonVariant::Elevated and SPLIT_INNER_GAP otherwise.

pub fn haptic(self, haptic: HapticSignal) -> Self

The haptic signal both halves fire on activation. Defaults to HapticSignal::None, matching the reference (a button is silent unless its decoration names a signal).

pub fn items(self, items: Vec<SplitButtonItem>) -> Self

The menu’s items (M3ESplitButton.items) — the list both SplitButtonMenuStyles present.

pub fn selected_value(self, value: Option<String>) -> Self

The app-confirmed selected value the menu’s rows check against (M3ESplitButton.selectedValue).

pub fn menu_style(self, style: SplitButtonMenuStyle) -> Self

Which presentation the menu takes (M3ESplitButtonDecoration.menuStyle).

pub fn on_select<F: Fn(&mut State, MenuSelection) + 'static>( self, on_select: F, ) -> Self

Fired when a menu row is activated (M3ESplitButton.onSelected).

pub fn menu_anchor(self, anchor: &OverlayAnchor) -> Self

Capture the trailing segment’s window rect into anchor on every paint, so Self::popup_menu has a rect to place against — the same OverlayAnchor handoff crate::button_group::ButtonGroupView::overflow_anchor takes.

pub fn popup_menu(&self) -> AnyView<State>

The popup-style menu — a crate::menu() anchored below the trailing segment. Mount it separately (the top of the app’s own frust::Stack, or a transparent navigator page) and keep it mounted, toggling the open flag split_button takes rather than unmounting it, for the host’s exit ramp. See the module docs’ Menu styles section.

pub fn sheet_menu(&self) -> BottomSheetView<State>

The bottom-sheet-style menu — the same items inside a crate::bottom_sheet, to hand to crate::show_bottom_sheet (which needs a frust::NavigatorController this widget cannot reach). See the module docs’ Menu styles section.

pub fn menu_route(&self) -> SplitButtonMenuRoute<State>

The presentation this button’s Self::menu_style calls for — the route selector _openMenu performs (m3e_split_button_menu.dart:22), minus the descoped native arm.

Trait Implementations

impl<State: 'static> View<State> for SplitButtonView<State>

type Element = SplitButtonWidget

The retained widget this view produces.

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

Materialise a fresh widget for this view.

fn rebuild( &self, prev: &Self, element: &mut SplitButtonWidget, 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 SplitButtonWidget, 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.