Struct ListItem

Source
pub struct ListItem<A = ()> { /* private fields */ }
Expand description

One optional-action row for a ListView.

Activation occurs on left-button release inside or a pressed Enter/Space key while focused. Only an enabled item with an action is focusable. Selection affects paint but does not suppress activation. No text is clipped or truncated by the row itself.

§Examples

use ailloli_ui_widgets::controls::ListItem;
let item: ListItem<()> = ListItem::new("Downloads");
let _ = item;

Implementations§

Source§

impl<A: 'static> ListItem<A>

Source

pub fn width(self, value: impl Into<Length>) -> Self

Sets preferred width from a logical-pixel or length value.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().width(120.0);
let _ = widget;
Source

pub fn height(self, value: impl Into<Length>) -> Self

Sets preferred height from a logical-pixel or length value.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().height(40.0);
let _ = widget;
Source

pub fn min_width(self, value: impl Into<Length>) -> Self

Sets the minimum width bound.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().min_width(40.0);
let _ = widget;
Source

pub fn max_width(self, value: impl Into<Length>) -> Self

Sets the maximum width bound.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().max_width(320.0);
let _ = widget;
Source

pub fn min_height(self, value: impl Into<Length>) -> Self

Sets the minimum height bound.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().min_height(24.0);
let _ = widget;
Source

pub fn max_height(self, value: impl Into<Length>) -> Self

Sets the maximum height bound.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().max_height(240.0);
let _ = widget;
Source

pub fn fill(self) -> Self

Sets both preferred axes to parent fill.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().fill();
let _ = widget;
Source

pub fn fill_width(self) -> Self

Sets preferred width to parent fill.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().fill_width();
let _ = widget;
Source

pub fn fill_height(self) -> Self

Sets preferred height to parent fill.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().fill_height();
let _ = widget;
Source

pub fn margin(self, value: f32) -> Self

Sets uniform outer margin in logical pixels.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().margin(8.0);
let _ = widget;
Source

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

Sets uniform inner padding in logical pixels.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().padding(8.0);
let _ = widget;
Source

pub fn flex_grow(self) -> Self

Sets flex-grow weight to one.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_grow();
let _ = widget;
Source

pub fn flex_grow_by(self, value: f32) -> Self

Sets a dimensionless flex-grow weight.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_grow_by(2.0);
let _ = widget;
Source

pub fn flex_shrink(self, value: f32) -> Self

Sets a dimensionless flex-shrink weight.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_shrink(1.0);
let _ = widget;
Source

pub fn flex_basis(self, value: impl Into<Length>) -> Self

Sets the preferred main-axis flex basis.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_basis(80.0);
let _ = widget;
Source

pub fn align_self(self, value: AlignItems) -> Self

Overrides cross-axis alignment for this flex item.

§Examples
use ailloli_ui_core::style::AlignItems;
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().align_self(AlignItems::Center);
let _ = widget;
Source§

impl<A: 'static> ListItem<A>

Source

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

Creates an enabled, unselected item with no optional content or action.

§Examples
use ailloli_ui_widgets::controls::ListItem;
let item: ListItem<()> = ListItem::new("Settings");
let _ = item;
Source

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

Sets a second line, replacing any previous subtitle.

An empty string still changes intrinsic height to subtitle_height.

§Examples
use ailloli_ui_widgets::controls::ListItem;
let item: ListItem<()> = ListItem::new("Account").subtitle("Signed in");
let _ = item;
Source

pub fn leading_icon(self, icon: IconId) -> Self

Sets the leading icon, replacing any prior icon.

§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::controls::ListItem;
let item: ListItem<()> = ListItem::new("History").leading_icon(IconId::History);
let _ = item;
Source

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

Sets right-aligned trailing text, replacing any previous value.

§Examples
use ailloli_ui_widgets::controls::ListItem;
let item: ListItem<()> = ListItem::new("Version").trailing_text("1.0");
let _ = item;
Source

pub fn badge(self, count: u32) -> Self

Sets a decimal numeric badge, replacing any previous count.

Every u32 value is accepted, including zero; no compact 99+ sentinel is applied.

§Examples
use ailloli_ui_widgets::controls::ListItem;
let item: ListItem<()> = ListItem::new("Inbox").badge(12);
let _ = item;
Source

pub fn selected(self, selected: impl Into<Binding<bool>>) -> Self

Sets static or reactive selected state.

Selected background takes precedence over pressed/hover state. A danger item keeps danger title color while its icon uses selected tint.

§Examples
use ailloli_ui_widgets::controls::ListItem;
let item: ListItem<()> = ListItem::new("Current").selected(true);
let _ = item;
Source

pub fn disabled(self, disabled: impl Into<Binding<bool>>) -> Self

Sets static or reactive disabled state.

Disabled items ignore events, are not focusable, and multiply paint alpha by ListItemStyle::disabled_opacity.

§Examples
use ailloli_ui_widgets::controls::ListItem;
let item: ListItem<()> = ListItem::new("Unavailable").disabled(true);
let _ = item;
Source

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

Selects normal or danger title treatment.

§Examples
use ailloli_ui_widgets::controls::{ListItem, ListItemVariant};
let item: ListItem<()> = ListItem::new("Delete").variant(ListItemVariant::Danger);
let _ = item;
Source

pub fn list_item_style(self, style: ListItemStyle) -> Self

Replaces complete resolved row style and intrinsic metrics.

Values are accepted as-is; layout builders may override intrinsic size.

§Examples
use ailloli_ui_core::Theme;
use ailloli_ui_widgets::controls::{ListItem, ListItemStyle};
let style = ListItemStyle::from_theme(Theme::dark());
let item: ListItem<()> = ListItem::new("Styled").list_item_style(style);
let _ = item;
Source

pub fn on_select(self, action: impl IntoClickAction<A>) -> Self
where A: Clone,

Installs an action value emitted on activation.

A later action builder replaces it. The item stops propagation after running the action.

§Examples
use ailloli_ui_widgets::controls::ListItem;
#[derive(Clone)]
enum Action { Open }
let item = ListItem::new("Project").on_select(Action::Open);
let _ = item;
Source

pub fn on_select_ctx(self, f: impl Fn(&mut EventCtx<A>) + 'static) -> Self

Installs a context-aware activation handler.

A later action builder replaces it.

§Examples
use ailloli_ui_widgets::controls::ListItem;
let item = ListItem::<()>::new("Refresh").on_select_ctx(|ctx| ctx.request_repaint());
let _ = item;

Trait Implementations§

Source§

impl<A: 'static> IntoView<A> for ListItem<A>

Source§

fn into_view(self) -> View<A>

Consumes a builder/value and returns its declarative view tree. Read more
Source§

impl<A: 'static> LayoutExt for ListItem<A>

Source§

fn layout_mut(&mut self) -> &mut LayoutStyle

Returns the widget’s mutable declarative size/inset state. Read more

Auto Trait Implementations§

§

impl<A> Freeze for ListItem<A>

§

impl<A = ()> !RefUnwindSafe for ListItem<A>

§

impl<A = ()> !Send for ListItem<A>

§

impl<A = ()> !Sync for ListItem<A>

§

impl<A> Unpin for ListItem<A>

§

impl<A = ()> !UnwindSafe for ListItem<A>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T, A> FlexItemExt<A> for T
where T: IntoView<A>,

Source§

fn flex_grow(self) -> View<A>

Sets flex-grow weight to one. Read more
Source§

fn flex_grow_by(self, value: f32) -> View<A>

Sets the dimensionless flex-grow weight. Read more
Source§

fn flex_shrink(self, value: f32) -> View<A>

Sets the dimensionless flex-shrink weight. Read more
Source§

fn flex_basis(self, value: impl Into<Length>) -> View<A>

Sets the preferred main-axis flex basis. Read more
Source§

fn align_self(self, value: AlignItems) -> View<A>

Overrides the parent cross-axis alignment for this view. Read more
Source§

fn fill_width(self) -> View<A>

Marks width as parent-fill in the view size hint. Read more
Source§

fn fill_height(self) -> View<A>

Marks height as parent-fill in the view size hint. Read more
Source§

fn fill(self) -> View<A>

Marks both axes as parent-fill in the view size hint. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T, A> IntoViewKeyExt<A> for T
where T: IntoView<A>,

§

fn key(self, key: impl Into<String>) -> View<A>

Converts self, assigns the owned key, and returns the view. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<T> ErasedDestructor for T
where T: 'static,