Struct ListItem 

pub struct ListItem<'a> { /* private fields */ }

Individual item in a Material Design list.

List items can contain primary text, secondary text, overline text, leading and trailing icons, and custom actions.

Example

let item = ListItem::new("Primary Text")
    .secondary_text("Secondary supporting text")
    .leading_icon("person")
    .trailing_icon("more_vert")
    .on_click(|| println!("Item clicked"));

Implementations

impl<'a> ListItem<'a>

pub fn new(primary_text: impl Into<String>) -> Self

Create a new list item with primary text.

Arguments

• primary_text - The main text to display

Example

let item = ListItem::new("My List Item");

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

Set the secondary text for the item.

Secondary text is displayed below the primary text.

Arguments

• text - The secondary text to display

Example

let item = ListItem::new("Item")
    .secondary_text("This is some secondary text");

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

Set the overline text for the item.

Overline text is displayed above the primary text.

Arguments

• text - The overline text to display

Example

let item = ListItem::new("Item")
    .overline("Important")
    .secondary_text("This is some secondary text");

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

Set a leading icon for the item.

A leading icon is displayed at the start of the item, before the text.

Arguments

• icon - The name of the icon to display

Example

let item = ListItem::new("Item")
    .leading_icon("check");

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

Set a trailing icon for the item.

A trailing icon is displayed at the end of the item, after the text.

Arguments

• icon - The name of the icon to display

Example

let item = ListItem::new("Item")
    .trailing_icon("more_vert");

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

Set trailing text for the item.

Trailing text is displayed at the end of the item, after the icons.

Arguments

• text - The trailing text to display

Example

let item = ListItem::new("Item")
    .trailing_text("99+");

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

Enable or disable the item.

Disabled items are not interactive and are typically displayed with reduced opacity.

Arguments

• enabled - Whether the item should be enabled

Example

let item = ListItem::new("Item")
    .enabled(false); // This item is disabled

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

Set the selected state of the item.

Selected items are highlighted with a different background color and may use different text/icon colors.

Arguments

• selected - Whether the item should appear selected

Example

let item = ListItem::new("Item")
    .selected(true); // This item appears selected

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

Set whether this list tile is part of a vertically dense list.

Dense list tiles default to a smaller height.

Arguments

• dense - Whether to use dense layout

Example

let item = ListItem::new("Item")
    .dense(true); // Compact layout

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

Set whether this list tile is intended to display three lines of text.

Arguments

• is_three_line - Whether to use three-line layout

Example

let item = ListItem::new("Item")
    .is_three_line(true);

pub fn visual_density(self, density: VisualDensity) -> Self

Set the visual density for compact/comfortable/spacious layouts.

Arguments

• density - The visual density to apply

Example

let item = ListItem::new("Item")
    .visual_density(VisualDensity::COMPACT);

pub fn style(self, style: ListTileStyle) -> Self

Set the title style (List or Drawer).

Arguments

• style - The list tile style

Example

let item = ListItem::new("Item")
    .style(ListTileStyle::Drawer);

pub fn title_alignment(self, alignment: ListTileTitleAlignment) -> Self

Set how leading and trailing widgets are vertically aligned.

Arguments

• alignment - The title alignment mode

Example

let item = ListItem::new("Item")
    .title_alignment(ListTileTitleAlignment::Center);

pub fn horizontal_title_gap(self, gap: f32) -> Self

Set the horizontal gap between titles and leading/trailing widgets.

Arguments

• gap - The gap in pixels

Example

let item = ListItem::new("Item")
    .horizontal_title_gap(20.0);

pub fn min_vertical_padding(self, padding: f32) -> Self

Set the minimum padding on top and bottom of title/subtitle.

Arguments

• padding - The minimum vertical padding in pixels

Example

let item = ListItem::new("Item")
    .min_vertical_padding(8.0);

pub fn min_leading_width(self, width: f32) -> Self

Set the minimum width allocated for the leading widget.

Arguments

• width - The minimum leading width in pixels

Example

let item = ListItem::new("Item")
    .min_leading_width(48.0);

pub fn min_tile_height(self, height: f32) -> Self

Set the minimum height allocated for the list tile.

Arguments

• height - The minimum tile height in pixels

Example

let item = ListItem::new("Item")
    .min_tile_height(64.0);

pub fn tile_color(self, color: Color32) -> Self

Set the background color when not selected.

Arguments

• color - The tile background color

Example

let item = ListItem::new("Item")
    .tile_color(Color32::from_rgb(240, 240, 240));

pub fn selected_tile_color(self, color: Color32) -> Self

Set the background color when selected.

Arguments

• color - The selected tile background color

Example

let item = ListItem::new("Item")
    .selected_tile_color(Color32::from_rgb(200, 230, 255));

pub fn selected_color(self, color: Color32) -> Self

Set the color for icons and text when selected.

Arguments

• color - The selected content color

Example

let item = ListItem::new("Item")
    .selected_color(Color32::from_rgb(0, 100, 200));

pub fn icon_color(self, color: Color32) -> Self

Set the default color for leading and trailing icons.

Arguments

• color - The icon color

Example

let item = ListItem::new("Item")
    .icon_color(Color32::from_rgb(100, 100, 100));

pub fn text_color(self, color: Color32) -> Self

Set the text color for title, subtitle, leading, and trailing.

Arguments

• color - The text color

Example

let item = ListItem::new("Item")
    .text_color(Color32::from_rgb(0, 0, 0));

pub fn on_click<F>(self, f: F) -> Self

where F: Fn() + 'a,

Set a click action for the item.

Arguments

• f - A function to call when the item is clicked

Example

let item = ListItem::new("Item")
    .on_click(|| {
        println!("Item was clicked!");
    });