Struct ListItem 

pub struct ListItem { /* private fields */ }

A list item

Implementations

impl ListItem

pub fn new() -> ListItem

Create a new list item

pub fn child(self, child: impl ElementBuilder + 'static) -> ListItem

Add content to the list item

pub fn child_box(self, child: Box<dyn ElementBuilder>) -> ListItem

Add a boxed child element (for dynamic element types)

Methods from Deref<Target = Div>

pub fn element_id(&self) -> Option<&str>

Get the element ID if set

pub fn classes(&self) -> &[String]

Get the element’s class list

pub fn stateful_context_key(&self) -> Option<&str>

Get the stateful context key if set

pub fn swap(&mut self) -> Div

Swap this Div with a default, returning the original

This is a convenience method for use in state callbacks where you need to consume self to chain builder methods, then assign back.

Note: This takes ownership of the current Div and leaves a default in its place. All properties are preserved in the returned Div. You must assign the result back to complete the update.

For updating specific properties without the swap pattern, consider using the setter methods directly (e.g., set_bg(), set_transform()).

Example

.on_state(|state, div| match state {
    ButtonState::Idle => {
        *div = div.swap().bg(Color::BLUE).rounded(4.0);
    }
    ButtonState::Hovered => {
        *div = div.swap().bg(Color::CYAN).rounded(8.0);
    }
})

pub fn set_bg(&mut self, color: impl Into<Brush>)

Set the background color/brush without consuming self

This is useful in state callbacks where you want to update properties without using the swap pattern.

pub fn set_rounded(&mut self, radius: f32)

Set the corner radius without consuming self

pub fn set_transform(&mut self, transform: Transform)

Set the transform without consuming self

pub fn set_shadow(&mut self, shadow: Shadow)

Set the shadow without consuming self

pub fn set_opacity(&mut self, opacity: f32)

Set the opacity without consuming self

pub fn set_border(&mut self, width: f32, color: Color)

Set border with width and color without consuming self

pub fn set_overflow_clip(&mut self, clip: bool)

Set overflow clip without consuming self

pub fn set_padding_x(&mut self, px: f32)

Set horizontal padding without consuming self

pub fn set_padding_y(&mut self, px: f32)

Set vertical padding without consuming self

pub fn set_child(&mut self, child: impl ElementBuilder + 'static)

Clear all children and add a single child

pub fn clear_children(&mut self)

Clear all children

pub fn set_w(&mut self, px: f32)

Set width in pixels without consuming self

This is useful in state callbacks where you want to update layout properties without using the swap pattern.

pub fn set_h(&mut self, px: f32)

Set height in pixels without consuming self

pub fn set_h_auto(&mut self)

Set height to auto without consuming self

pub fn set_style(&mut self, style: &ElementStyle)

Apply an ElementStyle without consuming self

This is useful in state callbacks where you want to update styling without using the swap pattern.

Example

.on_state(|state, div| {
    div.set_style(&hover_style);
})

pub fn merge(&mut self, other: Div)

Merge properties from another Div into this one

This applies the other Div’s non-default properties on top of this one. Useful in on_state callbacks to apply changes without reassignment:

.on_state(|state, div| {
    div.merge(div().bg(color).child(label));
})

pub fn style_mut(&mut self) -> &mut Style

Get direct access to the taffy style for advanced configuration

pub fn event_handlers(&self) -> &EventHandlers

Get a reference to the event handlers

pub fn event_handlers_mut(&mut self) -> &mut EventHandlers

Get a mutable reference to the event handlers

Trait Implementations

impl Default for ListItem

fn default() -> ListItem

Returns the “default value” for a type.

impl Deref for ListItem

type Target = Div

The resulting type after dereferencing.

fn deref(&self) -> &<ListItem as Deref>::Target

Dereferences the value.

impl DerefMut for ListItem

fn deref_mut(&mut self) -> &mut <ListItem as Deref>::Target

Mutably dereferences the value.

impl ElementBuilder for ListItem

fn build(&self, tree: &mut LayoutTree) -> LayoutNodeId

Build this element into a layout tree, returning the node ID

fn render_props(&self) -> RenderProps

Get the render properties for this element

fn children_builders(&self) -> &[Box<dyn ElementBuilder>]

Get children builders (for recursive traversal)

fn element_type_id(&self) -> ElementTypeId

Get the element type identifier

fn semantic_type_name(&self) -> Option<&'static str>

Semantic HTML-like tag name for CSS type selectors (e.g., “button”, “a”, “ul”)

fn element_id(&self) -> Option<&str>

Get the element ID for selector API queries

fn element_classes(&self) -> &[String]

Get the element’s CSS class list for selector matching

fn text_render_info(&self) -> Option<TextRenderInfo>

Get text render info if this is a text element

fn styled_text_render_info(&self) -> Option<StyledTextRenderInfo>

Get styled text render info if this is a styled text element (rich_text)

fn svg_render_info(&self) -> Option<SvgRenderInfo>

Get SVG render info if this is an SVG element

fn image_render_info(&self) -> Option<ImageRenderInfo>

Get image render info if this is an image element

fn canvas_render_info( &self, ) -> Option<Rc<dyn Fn(&mut dyn DrawContext, CanvasBounds)>>

Get canvas render info if this is a canvas element

fn event_handlers(&self) -> Option<&EventHandlers>

Get event handlers for this element

fn scroll_info(&self) -> Option<ScrollRenderInfo>

Get scroll render info if this is a scroll element

fn scroll_physics(&self) -> Option<Arc<Mutex<ScrollPhysics>>>

Get scroll physics handle if this is a scroll element

fn motion_animation_for_child( &self, _child_index: usize, ) -> Option<MotionAnimation>

Get motion animation config for a child at given index

fn motion_bindings(&self) -> Option<MotionBindings>

Get motion bindings for continuous animation

fn motion_stable_id(&self) -> Option<&str>

Get stable ID for motion animation tracking

fn motion_should_replay(&self) -> bool

Check if this motion should replay its animation

fn motion_is_suspended(&self) -> bool

Check if this motion should start in suspended state

fn motion_is_exiting(&self) -> bool

👎Deprecated since 0.1.0:

Use query_motion(key).exit() to explicitly trigger motion exit

DEPRECATED: Check if this motion should start its exit animation

fn layout_style(&self) -> Option<&Style>

Get the layout style for this element

fn layout_bounds_storage(&self) -> Option<Arc<Mutex<Option<ElementBounds>>>>

Get layout bounds storage for this element

fn layout_bounds_callback( &self, ) -> Option<Arc<dyn Fn(ElementBounds) + Send + Sync>>

Get layout bounds change callback for this element

fn set_auto_id(&mut self, _id: String) -> bool

Set an auto-generated element ID (used by stateful containers for stable child IDs).

fn children_builders_mut(&mut self) -> &mut [Box<dyn ElementBuilder>]

Get mutable access to children for auto-ID assignment

fn bound_scroll_ref(&self) -> Option<&ScrollRef>

Get the bound ScrollRef for programmatic scroll control

fn motion_on_ready_callback( &self, ) -> Option<Arc<dyn Fn(ElementBounds) + Send + Sync>>

Get the on_ready callback for this motion container

fn layout_animation_config(&self) -> Option<LayoutAnimationConfig>

Get layout animation configuration for this element

fn visual_animation_config(&self) -> Option<VisualAnimationConfig>

Get visual animation config for new FLIP-style animations (read-only layout)