Struct Signal 

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

Shared state. A read in a registered builder subscribes that Element.

Implementations

impl<T: 'static> Signal<T>

pub fn new(value: T) -> Self

Creates single-threaded application state. It attaches to the runtime that reads it during a build. Clones may be explicitly shared between windows or independent applications on the same UI thread.

pub fn devtools(self, name: &str) -> Self

where T: Debug + 'static,

Attaches a DevTools-visible debug name and registers the signal in the DevTools registry. Requires T: Debug for value summaries.

pub fn devtools_editable(self) -> Self

where T: Debug + PartialEq + 'static,

Marks this named signal development-editable from DevTools. Only the supported primitive kinds can round-trip an EditableValue.

pub fn get(&self) -> T

where T: Clone,

pub fn set(&self, value: T) -> bool

where T: PartialEq,

Replaces the value and invalidates dependents when it changed.

Reactive state must be changed from an event callback, effect, or action. Mutating a signal while a widget builder is running is rejected because builders must remain side-effect free.

pub fn dependent_count(&self) -> usize

pub fn get_untracked(&self) -> T

where T: Clone,

Reads the value without registering a dependency.

pub fn update(&self, update: impl FnOnce(&mut T))

Mutates the value once and schedules only the Elements that read it.

See Signal::set for the builder-side-effect rule.

pub fn update_if_changed(&self, update: impl FnOnce(&mut T)) -> bool

where T: Clone + PartialEq,

Mutates the value and invalidates dependents only when the value changed. This is the equality-aware counterpart to Signal::update for mutable values that implement Clone and PartialEq.

Trait Implementations

impl<T: Clone> Clone for Signal<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.