Struct Signal 

pub struct Signal<T>
where
    T: Clone + PartialEq,
{ /* private fields */ }

A reactive signal handle.

Allows reading, writing, and subscribing to changes. Implements Copy for ergonomic use; all copies share the same underlying state.

SAFETY: The inner pointer is allocated via Box::leak and lives for the entire program. This is safe in single-threaded WASM contexts where no concurrent access can occur.

Implementations

impl<T> Signal<T>

where T: Clone + PartialEq,

Implementation of reactive signal operations.

pub fn from_inner(inner: *mut SignalInner<T>) -> Self

Creates a new Signal from an existing raw pointer.

Safety

The caller must ensure the pointer was allocated via Box::leak and remains valid for the entire program lifetime.

pub fn get(&self) -> T

Returns the current value of the signal.

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

Attempts to return the current value of the signal without panicking.

Returns

• Some(T): The current value if the borrow succeeds.
• None: If the inner value is already mutably borrowed.

pub fn subscribe<F>(&self, callback: F)

where F: FnMut() + 'static,

Subscribes a callback to be invoked when the signal changes.

pub fn set(&self, value: T)

Sets the value of the signal and notifies listeners.

If the new value is equal to the current value, no update is performed and no listeners are notified. This prevents unnecessary re-renders and avoids cascading no-op updates through intermediate signal chains.

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

Attempts to set the value of the signal and notify listeners without panicking.

If the new value is equal to the current value, no update is performed.

Arguments

• value: The new value to assign to the signal.

Returns

• true: If the value was successfully updated and listeners were notified.
• false: If the value is unchanged and no update was performed.

Trait Implementations

impl<T> AsNode for Signal<T>

where T: Clone + PartialEq + Display + 'static,

Converts a signal into a reactive text virtual node.

fn as_node(&self) -> Option<VirtualNode>

Converts this value into a VirtualNode, if possible.

impl<T> AsReactiveText for Signal<T>

where T: Clone + PartialEq + Display + 'static,

Converts a signal into a reactive text node with listener wiring.

fn as_reactive_text(&self) -> VirtualNode

Converts this value into a VirtualNode::Text with reactive signal binding.

impl<T> Clone for Signal<T>

where T: Clone + PartialEq,

Clones the signal, sharing the same inner state.

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Deref for Signal<T>

where T: Clone + PartialEq,

Prevents direct dereference of a signal to enforce explicit API usage.

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T> DerefMut for Signal<T>

where T: Clone + PartialEq,

Prevents direct mutable dereference of a signal to enforce explicit API usage.

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<T> IntoNode for Signal<T>

where T: Clone + PartialEq + Display + 'static,

Converts a signal into a reactive text virtual node via IntoNode.

fn into_node(self) -> VirtualNode

Converts this value into a VirtualNode by consuming it.

impl IntoReactiveValue for Signal<String>

Converts a string signal into a reactive attribute value.

fn into_reactive_value(self) -> AttributeValue

Converts this value into an AttributeValue, wrapping signals for reactive updates or converting static values to text.

impl IntoReactiveValue for Signal<bool>

Converts a mutable bool signal into a reactive attribute value.

The signal is mapped to a Signal<String> that yields "true" or "false", enabling boolean attributes like checked to reactively update the DOM.

fn into_reactive_value(self) -> AttributeValue

Converts this value into an AttributeValue, wrapping signals for reactive updates or converting static values to text.

impl<T> Copy for Signal<T>

where T: Clone + PartialEq,

Copies the signal, sharing the same inner state.

A Signal is just a raw pointer; copying it is a trivial bitwise copy.