Struct NativeRef 

pub struct NativeRef { /* private fields */ }

A liveness-checked reference to a mounted piece’s realized node — the retained half of the tweaks API (docs/tweaks.md). Capture one with Decorate::native_ref, then reach the native widget later (from event handlers, timers) through a toolkit ext accessor. node/with yield None before mount and after the node’s subtree is disposed, so async races are safe no-ops.

Reads are REACTIVE: inside a binding or memo, node() subscribes to the ref’s mount/clear transitions (a Trigger underneath), so a label like label(move || if r.node().is_some() { "live" } else { "cleared" }) updates when the referenced piece unmounts — the toggle demo on the showcase Tweaks page. (The when-arm’s disposal lands at the turn boundary, after ordinary bindings re-ran — piggybacking on some other signal would read a stale mount state; the trigger fires at the actual transition.) Main-thread only, like every realized-tree type.

Implementations

impl NativeRef

pub fn new() -> NativeRef

pub fn node(&self) -> Option<RNode>

The mounted node, if it is currently live. A tracked read (see the type docs).

pub fn with<R>(&self, f: impl FnOnce(RNode) -> R) -> Option<R>

Run f with the live node (e.g. inside day_appkit::with_native); None if disposed.

Trait Implementations

impl Clone for NativeRef

fn clone(&self) -> NativeRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for NativeRef

fn default() -> NativeRef

Returns the “default value” for a type.