Struct BindingScope 

pub struct BindingScope { /* private fields */ }

Collects subscriptions and bindings for a logical scope (e.g., a widget).

When the scope is dropped, all held subscriptions are released, cleanly disconnecting all reactive bindings associated with that scope.

Usage

let mut scope = BindingScope::new();

let obs = Observable::new(42);
scope.subscribe(&obs, |v| println!("value: {v}"));
scope.bind(&obs, |v| format!("display: {v}"));

// When scope drops, all subscriptions are released.

Invariants

1. Subscriptions are released in reverse registration order on drop.
2. After drop, no callbacks from this scope will fire.
3. clear() releases all subscriptions immediately (reusable scope).
4. Binding count is always accurate.

Implementations

impl BindingScope

pub fn new() -> Self

Create an empty binding scope.

pub fn hold(&mut self, sub: Subscription)

Add a subscription to this scope. The subscription will be held alive until the scope is dropped or clear() is called.

pub fn subscribe<T: Clone + PartialEq + 'static>( &mut self, source: &Observable<T>, callback: impl Fn(&T) + 'static, ) -> &mut Self

Subscribe to an observable within this scope.

Returns a reference to the scope for chaining.

pub fn bind<T: Clone + PartialEq + 'static>( &mut self, source: &Observable<T>, ) -> Binding<T>

Create a one-way binding within this scope.

The binding’s underlying subscription is held by the scope. Returns the Binding<T> for reading the value.

pub fn bind_map<S: Clone + PartialEq + 'static, T: 'static>( &mut self, source: &Observable<S>, map: impl Fn(&S) -> T + 'static, ) -> Binding<T>

Create a mapped binding within this scope.

pub fn binding_count(&self) -> usize

Number of active subscriptions/bindings in this scope.

pub fn is_empty(&self) -> bool

Whether the scope has no active bindings.

pub fn clear(&mut self)

Release all subscriptions immediately (scope becomes empty but reusable).

Trait Implementations

impl Debug for BindingScope

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

Formats the value using the given formatter.

impl Default for BindingScope

fn default() -> Self

Returns the “default value” for a type.