Struct ListItem 

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

A declarative M3 list row. See the module docs.

Implementations

impl<State: 'static> ListItem<State>

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

Add supporting text below the headline, promoting the row’s height per the reference’s line rule (see the module docs’ Height table).

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

Add an overline label above the headline (M3EListItem.overline), promoting the row’s height per the reference’s line rule (see the module docs’ Height table).

pub fn three_line(self) -> Self

Force the three-line (88dp) variant (for a supporting line that wraps to two visual lines).

pub fn leading<V: View<State>>(self, leading: V) -> Self

Set the leading slot (an icon/avatar/image/control) — vertically centered, or pinned to the top inset on a three-line row.

pub fn trailing<V: View<State>>(self, trailing: V) -> Self

Set the trailing slot (an icon, a metadata/supporting-text run, a checkbox/switch) — vertically centered, or pinned to the top inset on a three-line row.

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

Make the whole row interactive, firing on_press on release inside its bounds (see the module docs’ Interactivity section).

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

Paint the row’s container with the selected fill (colors.secondary_container, M3EListItemTheme.selectedColor) and report the state to accessibility. Defaults to false. A selected row paints its fill whether or not it is ListItem::contained — the state has to be visible.

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

Paint the reference’s standalone row surface: the filled-card container (colors.surface_container_highest) at the shape.medium radius. Defaults to false — a bare row is content, the shape a row hosted by super::card_list (or any other container that owns the surface) needs. See the module docs’ Container surface section for why this port inverts the reference’s default.

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

Gate the interactive treatment (hover/press tint and firing ListItem::on_press) and dim the container, without dropping back to a transparently-forwarding row. Defaults to true; only meaningful once on_press is chained. See the module docs’ Disabled state section.

Trait Implementations

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

type Element = ListItemWidget

The retained widget this view produces.

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

Materialise a fresh widget for this view.

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