Struct RefHandle 

pub struct RefHandle<T> { /* private fields */ }

A handle to a mutable reference that persists across renders

This mirrors React’s useRef return value. Unlike StateHandle, mutations do NOT trigger re-renders.

Implementations

impl<T> RefHandle<T>

pub fn new<F>(initializer: F) -> Self

where F: FnOnce() -> T,

Create a new ref handle with an initial value

pub fn from_container(container: Arc<RefContainer<T>>) -> Self

Create a ref handle from an existing container

pub fn get(&self) -> T

where T: Clone,

Get a clone of the current value

pub fn set(&self, new_value: T)

Set a new value (does NOT trigger re-render)

pub fn update<F>(&self, updater: F)

where F: FnOnce(&mut T),

Update the value using a mutable closure (does NOT trigger re-render)

pub fn with<F, R>(&self, accessor: F) -> R

where F: FnOnce(&T) -> R,

Access the value immutably with a closure

pub fn with_mut<F, R>(&self, mutator: F) -> R

where F: FnOnce(&mut T) -> R,

Access the value mutably with a closure (does NOT trigger re-render)

pub fn replace(&self, new_value: T) -> T

Replace the value and return the old value

pub fn take(&self) -> T

where T: Default,

Take the value, leaving Default::default() in its place

pub fn container(&self) -> &Arc<RefContainer<T>>

Get access to the underlying container (for advanced use cases)

Trait Implementations

impl<T> Clone for RefHandle<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for RefHandle<T>

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

Formats the value using the given formatter.