Struct BoundStateful 

pub struct BoundStateful<S>
where
    S: StateTransitions,
{ /* private fields */ }

A bound stateful element that maintains shared storage with an ElementRef

This wrapper is returned by Stateful::bind() and provides the same fluent API as Stateful, but all modifications go through shared storage accessible via the original ElementRef.

Implementations

impl<S> BoundStateful<S>

where S: StateTransitions,

pub fn on_state<F>(self, callback: F) -> BoundStateful<S>

where F: Fn(&S, &mut Div) + Send + Sync + 'static,

Set the state callback (builder pattern)

pub fn w(self, px: f32) -> BoundStateful<S>

Set width (builder pattern)

pub fn h(self, px: f32) -> BoundStateful<S>

Set height (builder pattern)

pub fn w_full(self) -> BoundStateful<S>

Set width to 100% (builder pattern)

pub fn h_full(self) -> BoundStateful<S>

Set height to 100% (builder pattern)

pub fn size(self, w: f32, h: f32) -> BoundStateful<S>

Set both width and height (builder pattern)

pub fn square(self, size: f32) -> BoundStateful<S>

Set square size (builder pattern)

pub fn flex_row(self) -> BoundStateful<S>

Set flex direction to row (builder pattern)

pub fn flex_col(self) -> BoundStateful<S>

Set flex direction to column (builder pattern)

pub fn flex_grow(self) -> BoundStateful<S>

Set flex grow (builder pattern)

pub fn w_fit(self) -> BoundStateful<S>

Set width to fit content (builder pattern)

pub fn h_fit(self) -> BoundStateful<S>

Set height to fit content (builder pattern)

pub fn p(self, units: f32) -> BoundStateful<S>

Set padding all sides (builder pattern)

pub fn px(self, units: f32) -> BoundStateful<S>

Set horizontal padding (builder pattern)

pub fn py(self, units: f32) -> BoundStateful<S>

Set vertical padding (builder pattern)

pub fn gap(self, units: f32) -> BoundStateful<S>

Set gap (builder pattern)

pub fn items_center(self) -> BoundStateful<S>

Center items (builder pattern)

pub fn justify_center(self) -> BoundStateful<S>

Center justify (builder pattern)

pub fn justify_between(self) -> BoundStateful<S>

Space between (builder pattern)

pub fn bg(self, color: impl Into<Brush>) -> BoundStateful<S>

Set background (builder pattern)

pub fn rounded(self, radius: f32) -> BoundStateful<S>

Set corner radius (builder pattern)

pub fn border(self, width: f32, color: Color) -> BoundStateful<S>

Set border with color and width (builder pattern)

pub fn border_color(self, color: Color) -> BoundStateful<S>

Set border color only (builder pattern)

pub fn border_width(self, width: f32) -> BoundStateful<S>

Set border width only (builder pattern)

pub fn shadow(self, shadow: Shadow) -> BoundStateful<S>

Set shadow (builder pattern)

pub fn shadow_sm(self) -> BoundStateful<S>

Set small shadow (builder pattern)

pub fn shadow_md(self) -> BoundStateful<S>

Set medium shadow (builder pattern)

pub fn shadow_lg(self) -> BoundStateful<S>

Set large shadow (builder pattern)

pub fn shadow_xl(self) -> BoundStateful<S>

Set extra-large shadow (builder pattern)

pub fn opacity(self, opacity: f32) -> BoundStateful<S>

Set opacity (builder pattern)

pub fn flex_shrink(self) -> BoundStateful<S>

Set flex shrink (builder pattern)

pub fn flex_shrink_0(self) -> BoundStateful<S>

Set flex shrink to 0 (builder pattern)

pub fn transform_style(self, xform: Transform) -> BoundStateful<S>

Set transform (builder pattern)

pub fn overflow_clip(self) -> BoundStateful<S>

Set overflow to clip (clips children to container bounds)

pub fn cursor(self, cursor: CursorStyle) -> BoundStateful<S>

Set cursor style (builder pattern)

pub fn cursor_pointer(self) -> BoundStateful<S>

Set cursor to pointer (hand) - convenience for clickable elements

pub fn cursor_text(self) -> BoundStateful<S>

Set cursor to text (I-beam) - for text input areas

pub fn child(self, child: impl ElementBuilder + 'static) -> BoundStateful<S>

Add child (builder pattern)

pub fn on_click<F>(self, handler: F) -> BoundStateful<S>

where F: Fn(&EventContext) + Send + Sync + 'static,

Register a click handler (builder pattern)

pub fn on_mouse_down<F>(self, handler: F) -> BoundStateful<S>

where F: Fn(&EventContext) + Send + Sync + 'static,

Register a mouse down handler (builder pattern)

pub fn on_mouse_up<F>(self, handler: F) -> BoundStateful<S>

where F: Fn(&EventContext) + Send + Sync + 'static,

Register a mouse up handler (builder pattern)

pub fn on_hover_enter<F>(self, handler: F) -> BoundStateful<S>

where F: Fn(&EventContext) + Send + Sync + 'static,

Register a hover enter handler (builder pattern)

pub fn on_hover_leave<F>(self, handler: F) -> BoundStateful<S>

where F: Fn(&EventContext) + Send + Sync + 'static,

Register a hover leave handler (builder pattern)

pub fn on_focus<F>(self, handler: F) -> BoundStateful<S>

where F: Fn(&EventContext) + Send + Sync + 'static,

Register a focus handler (builder pattern)

pub fn on_blur<F>(self, handler: F) -> BoundStateful<S>

where F: Fn(&EventContext) + Send + Sync + 'static,

Register a blur handler (builder pattern)

pub fn on_mount<F>(self, handler: F) -> BoundStateful<S>

where F: Fn(&EventContext) + Send + Sync + 'static,

Register a mount handler (builder pattern)

pub fn on_unmount<F>(self, handler: F) -> BoundStateful<S>

where F: Fn(&EventContext) + Send + Sync + 'static,

Register an unmount handler (builder pattern)

pub fn on_key_down<F>(self, handler: F) -> BoundStateful<S>

where F: Fn(&EventContext) + Send + Sync + 'static,

Register a key down handler (builder pattern)

pub fn on_key_up<F>(self, handler: F) -> BoundStateful<S>

where F: Fn(&EventContext) + Send + Sync + 'static,

Register a key up handler (builder pattern)

pub fn on_scroll<F>(self, handler: F) -> BoundStateful<S>

where F: Fn(&EventContext) + Send + Sync + 'static,

Register a scroll handler (builder pattern)

pub fn on_mouse_move<F>(self, handler: F) -> BoundStateful<S>

where F: Fn(&EventContext) + Send + Sync + 'static,

Register a mouse move handler (builder pattern)

pub fn on_resize<F>(self, handler: F) -> BoundStateful<S>

where F: Fn(&EventContext) + Send + Sync + 'static,

Register a resize handler (builder pattern)

pub fn on_event<F>(self, event_type: u32, handler: F) -> BoundStateful<S>

where F: Fn(&EventContext) + Send + Sync + 'static,

Register a handler for a specific event type (builder pattern)

pub fn on_layout<F>(self, callback: F) -> BoundStateful<S>

where F: Fn(ElementBounds) + Send + Sync + 'static,

Set a layout callback that fires synchronously after each layout computation (builder pattern)

Trait Implementations

impl<S> ElementBuilder for BoundStateful<S>

where S: StateTransitions + Default,

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 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)

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 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 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 element_classes(&self) -> &[String]

Get the element’s CSS class list for selector matching

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