Struct IconButtonView 

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

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

Implementations

impl<State: 'static> IconButtonView<State>

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

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

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

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

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

Set the resting shape family.

pub fn width(self, width: IconButtonWidth) -> Self

Set the container width tier.

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

Mark this a toggle icon button carrying selected, per the module docs’ Toggle section — never self-mutated by a press.

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

The icon painted while selected, falling back to the base icon when unset — also makes this a toggle icon button on its own even without Self::selected (the module docs’ Toggle section).

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

Whether the button accepts a press (default true). Never dims color — see the module docs’ Variants section.

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

The haptic signal to fire on a press. Defaults to HapticSignal::None.

pub fn badge(self, value: BadgeValue) -> Self

Attach a badge (the module docs’ Badge section).

pub fn suppress_ink(self, suppress: bool) -> Self

Suppress the hover/focus/pressed state-layer overlay (the reference’s suppressInk, which forces both its splash and its overlay color transparent — this framework has no ripple, so suppressing the state layer is the whole effect).

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

The accessible label, when the icon alone doesn’t name the action.

Trait Implementations

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

type Element = IconButtonWidget

The retained widget this view produces.

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

Materialise a fresh widget for this view.

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