Struct Props 

pub struct Props {

    pub style: Option<Style>,
    pub hover_style: Option<Style>,
    pub press_style: Option<Style>,
    pub focus_style: Option<Style>,
    pub on_click: bool,
    pub on_pointer_down: bool,
    pub on_pointer_move: bool,
    pub on_pointer_up: bool,
    pub on_pointer_enter: bool,
    pub on_pointer_leave: bool,
    pub scroll_top: Option<f32>,
    pub scroll_left: Option<f32>,
    pub scroll_step: Option<f32>,
    pub on_scroll: bool,
    pub on_wheel: bool,
    pub animated: Option<AnimatedBindings>,
    pub anchor: Option<Anchor>,
    pub src: Option<String>,
    pub tint: Option<String>,
    pub flip_x: bool,
    pub flip_y: bool,
    pub image_mode: Option<ImageMode>,
    pub source_rect: Option<SourceRect>,
    pub atlas: Option<AtlasSpec>,
    pub visual_box: Option<String>,
    pub draw: Option<Vec<DrawCmd>>,
    pub on_resize: bool,
    pub target: Option<String>,
    pub value: Option<String>,
    pub max_length: Option<usize>,
    pub multiline: bool,
    pub on_change: bool,
    pub autofocus: bool,
    pub selection_start: Option<usize>,
    pub selection_end: Option<usize>,
    pub aria_label: Option<String>,
    pub on_select: bool,
    pub on_focus: bool,
    pub on_blur: bool,
}

Props for a host element. Event handlers never cross the boundary — the reconciler replaces them with booleans (e.g. onClick: true) and keeps the actual function in a JS-side map. Visual styling lives entirely in Style; the fields here are content/attribute level.

Fields

style: Option<Style>

CSS-like layout + visual style, mapped onto bevy_ui components.

hover_style: Option<Style>

Style overlaid on style while the element is hovered. Decoded exactly like style; applied on the Bevy side from the node’s Interaction.

press_style: Option<Style>

Style overlaid on style (and hover_style) while the element is pressed.

focus_style: Option<Style>

Style overlaid on style while the element is focused (currently editableText). Applied on the Bevy side from the node’s focus state, so focus styling needs no React round-trip.

on_click: bool

Whether this element has an onClick handler registered in JS.

on_pointer_down: bool

Whether this element has an onPointerDown handler registered in JS.

on_pointer_move: bool

Whether this element has an onPointerMove handler registered in JS. Fires each frame while the pointer is held down (a drag).

on_pointer_up: bool

Whether this element has an onPointerUp handler registered in JS.

on_pointer_enter: bool

Whether this element has an onPointerEnter handler registered in JS. Fires once when the pointer enters the element (hover begins).

on_pointer_leave: bool

Whether this element has an onPointerLeave handler registered in JS. Fires once when the pointer leaves the element (hover ends).

scroll_top: Option<f32>

Controlled vertical scroll offset (logical px) → ScrollPosition.y. On update it’s pushed into the node only when it diverges from the live offset (so a re-render echoing the user’s own wheel scroll is a no-op — see [crate::reconcile]). Each axis is independent; absent leaves it alone.

scroll_left: Option<f32>

Controlled horizontal scroll offset (logical px) → ScrollPosition.x.

scroll_step: Option<f32>

Logical pixels scrolled per mouse-wheel “line” for this container, overriding the default. Maps to [crate::bridge::ScrollStep]; only scales Line-unit wheels (trackpad Pixel deltas are used raw).

on_scroll: bool

Whether this element has an onScroll handler registered in JS. Present → the reconciler stamps a [crate::bridge::ScrollListener] so the read-back system reports offset changes (kept cheap by scoping its Changed query to that marker, since ScrollPosition is a required component of every Node).

on_wheel: bool

Whether this element has an onWheel handler registered in JS. Present → the reconciler stamps a [crate::bridge::WheelListener] so [crate::scroll::collect_wheel_events] reports raw wheel deltas over the node (any node, unlike onScroll, which needs overflow: scroll).

animated: Option<AnimatedBindings>

Per-property animation bindings for an Animated.node (Reanimated-style). Present → the main reconciler stamps a crate::animations::AnimatedNode on the entity so the animations plugin drives the listed props each frame. Bevy-free, pure-serde, like the rest of the protocol.

anchor: Option<Anchor>

World-anchor binding for an Anchored.node: the Bevy entity to follow and an optional offset. Present → the reconciler stamps a crate::anchor::Anchored so the per-frame positioning system tracks it. Pure-serde, Bevy-free.

src: Option<String>

Asset path for an image, resolved by Bevy’s AssetServer (relative to the app’s assets/ folder). Absent → a solid-color image (see tint).

tint: Option<String>

Tint multiplied with the image (hex); also the fill of a src-less image.

flip_x: bool

Flip the image along its x-axis.

flip_y: bool

Flip the image along its y-axis.

image_mode: Option<ImageMode>

How the image fits its box: the keyword "auto"/"stretch", or a type-tagged object for 9-slice ("sliced") / "tiled" scaling.

source_rect: Option<SourceRect>

Source sub-rect of the texture to display, in source-texture pixels. Maps to ImageNode.rect. With atlas, it offsets from the atlas cell’s top-left corner.

atlas: Option<AtlasSpec>

Treat src as a uniform sprite-sheet grid and select one cell. Maps to ImageNode.texture_atlas (builds/caches a TextureAtlasLayout).

visual_box: Option<String>

Which box of the node the image fills: "content" | "padding" (default) | "border". Maps to ImageNode.visual_box.

draw: Option<Vec<DrawCmd>>

The declarative display list for a canvas element: an ordered batch of vector draw commands (the recorded form of an HTML-canvas-like ctx.moveTo/lineTo/… session). Present → the retained surface is cleared and the list replayed (raster state reset first). Some(vec![]) clears the canvas; absent leaves the retained pixels. Imperative (accumulating) drawing rides Op::Draw instead.

on_resize: bool

Whether this element has an onResize handler registered in JS. Cached only so the delta stays truthful — "resize" events are not gated on it (the JS runtime consumes them unconditionally, to replay a declarative painter and keep the canvas handle’s size fresh).

target: Option<String>

The render-target name a portal element displays. The reconciler stamps a crate::portal::RPortal carrying it; the binding system points the node’s ImageNode at the texture the app registered under this name (or a transparent placeholder until it appears). Pure-serde, Bevy-free.

value: Option<String>

The controlled text value of an editableText. Seeds the field on create; on update it’s pushed into the widget only when it diverges from the live buffer (so normal typing is never clobbered — see [crate::reconcile]).

max_length: Option<usize>

Maximum number of characters an editableText accepts.

multiline: bool

Whether an editableText accepts newlines (multi-line input).

on_change: bool

Whether this element has an onChange handler registered in JS.

autofocus: bool

Focus an editableText when it mounts (inserts AutoFocus).

selection_start: Option<usize>

Controlled selection anchor, a UTF-8 byte offset into the value. When selection_start/selection_end diverge from the live selection they’re pushed into the widget (see [crate::reconcile]).

selection_end: Option<usize>

Controlled selection focus, a UTF-8 byte offset into the value.

aria_label: Option<String>

Accessible name announced to assistive tech (sets the a11y node’s label).

on_select: bool

Whether this element has an onSelect handler registered in JS.

on_focus: bool

Whether this element has an onFocus handler registered in JS.

on_blur: bool

Whether this element has an onBlur handler registered in JS.

Implementations

impl Props

pub fn split_events(self) -> (Props, UpdateEvents)

Split the event-like fields (see UpdateEvents) out of self, leaving the retained state. Used to seed the per-node props cache from a create.

pub fn merge_delta( &mut self, delta: Props, unset: &[String], style_unset: &[String], ) -> (PropsDirty, UpdateEvents)

Merge an Op::Update delta (props + unset + style_unset) into self (the retained last-applied props), returning what the delta touched and the event-like fields to act on. See the semantics on Op::Update.

Trait Implementations

impl Clone for Props

fn clone(&self) -> Props

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Props

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Props

fn default() -> Props

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Props

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.