Struct Signal 

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

A Copy, !Send reactive value handle (§4.2).

Implementations

impl<T: 'static> Signal<T>

pub fn new(value: T) -> Self

pub fn global(value: T) -> Self

A process-global signal: allocated in the root scope regardless of where the call runs, so it never dies with a transient caller. Every lazily-initialized global registry must use this, not Signal::new, because a lazy global first touched inside a presented cover / pushed page / when arm otherwise inherits that scope and is disposed with it, and every later read panics (the day-l10n locale signal was the observed case).

pub fn new_in(scope: Scope, value: T) -> Self

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

Tracked read by reference.

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

pub fn with_untracked<R>(self, f: impl FnOnce(&T) -> R) -> R

pub fn get(self) -> T

where T: Clone,

pub fn try_get(self) -> Option<T>

where T: Clone,

pub fn get_untracked(self) -> T

where T: Clone,

pub fn track(self)

Mark-only tracked read (subscribe without reading).

pub fn set(self, value: T)

pub fn set_if_changed(self, value: T)

where T: PartialEq,

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

pub fn setter(self) -> Setter<T>

where T: Send,

A Send write-only handle (§3.3).

Trait Implementations

impl<T: Clone + 'static> Binding<T> for Signal<T>

fn read(&self) -> T

Tracked read: the current value, subscribing the running computation to changes.

fn peek(&self) -> T

Untracked read: the current value, subscribing nothing (the reactive world’s “peek”).

fn write(&self, v: T)

Write the value, waking whatever tracks it.

fn write_teardown(&self, _v: T)

Seal the last preview when its control is disposed. Persistent bindings default to committing; scope-owned signals have already received the preview and may be gone.

fn write_preview(&self, v: T)

A live write mid-gesture (Event::ValueChanged): readers must follow, but nothing durable should key off it. Defaults to Binding::write: a plain signal has no notion of “durable”, and a degraded backend that never commits stays correct.

fn write_commit(&self, v: T)

The settled value that ends a gesture (Event::ValueCommitted). Defaults to Binding::write; a day-model field seals its preview session here: one change record, one undo unit, one UPDATE for the whole drag.

impl<T: 'static> 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.

impl<T: 'static> Copy for Signal<T>

impl<T: 'static> Debug for Signal<T>

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

Formats the value using the given formatter.