Struct ListItem 

pub struct ListItem { /* private fields */ }

One M3 list item. Strings come from the caller. Give it on_click to make the whole row a button; without one it is static content.

Implementations

impl ListItem

pub fn new(id: impl Into<ElementId>, headline: impl Into<SharedString>) -> Self

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

A label-medium line above the headline.

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

Body-medium text under the headline, on one line (ellipsized).

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

Let the supporting text wrap to two lines: the three-line item.

pub fn trailing_text(self, text: impl Into<SharedString>) -> Self

Label-small text before the trailing element (e.g. “100+”).

pub fn leading(self, leading: ListLeading) -> Self

pub fn trailing(self, trailing: ListTrailing) -> Self

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

A full-width outline-variant divider under the item.

pub fn divider_inset(self, inset: bool) -> Self

Inset the divider 16dp from the start edge (the design kit’s Horizontal/Inset divider) instead of running full width.

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

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

pub fn container(self, role: ColorRole) -> Self

The resting container role (surface by default), e.g. a dialog’s surface-container-high so items sit on it. Selected rows keep the secondary container.

pub fn density(self, density: ListDensity) -> Self

pub fn segment(self, corners: OuterCorners) -> Self

Round the item as a segment of an Expressive segmented list (top-left, top-right, bottom-right, bottom-left; true = outside).

pub fn preview_state(self, state: InteractionPreview) -> Self

Render a static specimen in one forced interaction state: the state layer, the inner focus ring or the disabled row. See InteractionPreview.

pub fn on_click( self, f: impl Fn(&ClickEvent, &mut Window, &mut App) + 'static, ) -> Self

Make the whole row a button. Rows with a checkbox, radio or switch toggle it here: the embedded control only shows the state.

pub fn lines(&self) -> ListLines

The lines this item occupies.

Trait Implementations

impl IntoElement for ListItem

type Element = ViewElement<ListItem>

The specific type of element into which the implementing type is converted. Useful for converting other types into elements automatically, like Strings

fn into_element(self) -> Self::Element

Convert self into a type that implements [Element].

fn into_any_element(self) -> AnyElement

Convert self into a dynamically-typed [AnyElement].

impl RenderOnce for ListItem

fn render(self, _: &mut Window, _: &mut App) -> impl IntoElement

Render this component into an element tree. Note that this method takes ownership of self, as compared to [Render::render()] method which takes a mutable reference.