Struct ToggleButtonView 

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

A declarative M3 Expressive toggle button. See the module docs.

Implementations

impl<State: 'static> ToggleButtonView<State>

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

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

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

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

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

Whether the toggle button accepts a press. A disabled button paints the 38%/12% disabled roles and reports disabled semantics.

pub fn icon(self, icon: impl View<State>) -> Self

Icon shown while unchecked (and while checked too, if Self::checked_icon is unset).

pub fn checked_icon(self, icon: impl View<State>) -> Self

Icon shown while checked. Falls back to Self::icon when unset.

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

Label shown while unchecked (and while checked too, if Self::checked_label is unset).

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

Label shown while checked. Falls back to Self::label when unset.

pub fn group_connected(self, connected: bool) -> Self

Whether this button is part of a connected group — the module docs’ Group-connection corner asymmetry section. Plumbing for the upcoming button-group rework.

pub fn first_in_group(self, first: bool) -> Self

Whether this is the first (leading) member of a connected group — only consulted while Self::group_connected is true. Defaults to true (a standalone button behaves as if it were both ends).

pub fn last_in_group(self, last: bool) -> Self

Whether this is the last (trailing) member of a connected group — only consulted while Self::group_connected is true. Defaults to true.

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

The haptic signal to fire on a confirmed checked-toggle. Defaults to HapticSignal::None (the module docs’ Haptics section).

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

Fire on_long_press when a press is held past the threshold — the module docs’ Long-press section documents the exact firing contract (deferred to the next pointer event, not immediate).

Trait Implementations

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

type Element = ToggleButtonWidget

The retained widget this view produces.

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

Materialise a fresh widget for this view.

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