Struct ButtonView 

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

A declarative M3 Expressive button. See the module docs.

Implementations

impl<State: 'static> ButtonView<State>

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

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

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

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

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

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

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

Whether the button accepts a press. A disabled button paints the 38% / 12% disabled roles, reports disabled semantics, and swallows nothing — it simply never arms (m3e_button_content.dart:174’s null onPressed).

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

Attach a leading icon (see button_with_icon).

pub fn icon_alignment(self, alignment: IconAlignment) -> Self

Put the icon on the trailing side instead of the leading one.

pub fn corner_radius(self, radius: f64) -> Self

Override the resting corner radius, ignoring both the shape family and the per-size token — the reference’s M3EButtonDecoration.borderRadius (m3e_button_content.dart:42). It also becomes the hovered radius, and the pressed one unless ButtonView::pressed_radius is set too, since that is the precedence _resolveShapes applies.

pub fn pressed_radius(self, radius: f64) -> Self

Override the pressed corner radius — the reference’s M3EButtonDecoration.pressedRadius, the highest-precedence pressed input.

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

The haptic signal to fire on a press. Defaults to HapticSignal::None — matching the reference, where a button is silent unless its decoration names a signal (the module docs’ Haptics section).

pub fn decoration(self, decoration: Rc<dyn ButtonDecoration>) -> Self

Install a paint-time decoration layer (the module docs’ Seams section).

pub fn overflow_observer(self, observer: Rc<dyn OverflowObserver>) -> Self

Install a layout-time content-measurement observer (the module docs’ Seams section).

pub fn overflow(self, strategy: OverflowStrategy) -> Self

Select which strategy an overflowing label uses — OverflowStrategy::None (the default) by default. See OverflowStrategy’s own docs for the full three-way contract, and ButtonView::overflow_observer for the hook OverflowStrategy::BottomSheet calls into.

Trait Implementations

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

type Element = ButtonWidget

The retained widget this view produces.

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

Materialise a fresh widget for this view.

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