Struct Binding

pub struct Binding<L>
where
    L: Lens,
{ /* private fields */ }

A view with a binding which rebuilds its contents when the observed data changes.

This view is typically used to switch between two or more views when the bound data changes. The binding view will destroy and then recreate its contents whenever the bound data changes, so it is usually preferable to bind a view directly to the data (if supported) or to bind to a view modifier, which will update the properties of a view without rebuilding it.

Implementations

impl<L> Binding<L>

where L: 'static + Lens, <L as Lens>::Source: 'static, <L as Lens>::Target: Data,

pub fn new<F>(cx: &mut Context, lens: L, builder: F)

where F: 'static + Fn(&mut Context, L),

Creates a new binding view.

A binding view observes application data through a lens and rebuilds its contents if the data changes.

Example

When the value of AppData::some_data changes, the label inside of the binding will be rebuilt.

Binding::new(cx, AppData::some_data, |cx, lens|{
    // Retrieve the data from context
    let value = *lens.get(cx);
    Label::new(cx, value.to_string());
});