Struct BuildCtx 

pub struct BuildCtx<S: AppState> {
    pub registry: ActionRegistry<S>,
    pub animation_requests: Vec<(WidgetNodeId, AnimationRequest)>,
    pub video_nodes: Vec<VideoRegistration>,
    pub web_nodes: Vec<WebRegistration>,
    pub portals: Vec<PortalEntry>,
    /* private fields */
}

The mutable context passed to Widget::build.

BuildCtx is where widgets register side-effects that must survive beyond the build phase:

• Action binding – bind registers a handler and returns an ActionEnvelope that can be stored in widget fields like on_press.
• Portals – register_portal places a node in the global overlay stack (modals, toasts, flyouts).
• Animations – request_animation_for or the anim_for helper.
• Video / WebView registration – register_video, register_web_view.

Example

fn build(&self, ctx: &mut BuildCtx<S>, view: &View<S>) -> Node {
    let on_press = ctx.bind(MyAction { .. }, handler as fn(&mut S, MyAction));
    Button { on_press: Some(on_press), ..Default::default() }.into_node()
}

Fields

registry: ActionRegistry<S>

The action registry that accumulates handlers during the build phase.

animation_requests: Vec<(WidgetNodeId, AnimationRequest)>

Pending animation requests.

video_nodes: Vec<VideoRegistration>

Registered video nodes.

web_nodes: Vec<WebRegistration>

Registered web view nodes.

portals: Vec<PortalEntry>

Portal entries (overlays, modals, toasts).

Implementations

impl<S: AppState> BuildCtx<S>

pub fn new() -> Self

pub fn bind<A: Action, H>(&mut self, action: A, handler: H) -> ActionEnvelope

where H: IntoHandler<S, A> + Send + Sync + 'static,

pub fn request_animation_for( &mut self, target: WidgetNodeId, request: AnimationRequest, )

pub fn register_video(&mut self, registration: VideoRegistration)

pub fn register_web_view(&mut self, registration: WebRegistration)

pub fn take_animation_requests( &mut self, ) -> Vec<(WidgetNodeId, AnimationRequest)>

pub fn take_video_registrations(&mut self) -> Vec<VideoRegistration>

pub fn take_web_registrations(&mut self) -> Vec<WebRegistration>

pub fn register_portal(&mut self, node: Node)

pub fn register_portal_with_id(&mut self, id: WidgetNodeId, node: Node)

pub fn register_portal_with_layer( &mut self, layer: PortalLayer, id: Option<WidgetNodeId>, node: Node, )

pub fn take_portals(&mut self) -> Vec<(Option<WidgetNodeId>, Node)>

pub fn anim_for(&mut self, target: WidgetNodeId) -> AnimCtx<'_, S>

pub fn video_controls(&self, target: WidgetNodeId) -> VideoControlCtx