Struct DndScope 

pub struct DndScope { /* private fields */ }

An explicit lifetime for Dioxus signals and stores created outside a component scope.

A scope owns both storage flavors Dioxus state may allocate: ordinary signals use UnsyncStorage, while a Store keeps its subscription tree in SyncStorage. Create state inside with, then retain a clone of the scope for exactly as long as that state may be used. Storage is reclaimed when the last clone drops.

Use use_dnd_model instead for an app-wide model shared by windows. A DndScope is intended for dynamic state whose lifetime really should end, such as the contents owned by one spawned window.

with must run inside a Dioxus runtime, like the state constructors it contains.

Do not drop the last scope clone while any owned read or write guard is live. Unsynchronized storage cannot be recycled through an active RefCell borrow and synchronized storage must wait for its lock guard.

use dioxus::prelude::*;
use dioxus_dnd::prelude::DndScope;

fn app() -> Element {
    let scope = use_hook(DndScope::new);
    let count = use_hook(|| scope.with(|| Signal::new(0)));
    rsx! { "{count}" }
}

Implementations

impl DndScope

pub fn new() -> Self

Create an empty scope. Mint every signal or store it owns with Self::with.

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

Run init with this scope as the current owner for both Dioxus storage flavors.

Owner restoration is unwind-safe: a panic from init is resumed only after both Dioxus owner overrides have returned normally and restored their previous values.

Trait Implementations

impl Clone for DndScope

fn clone(&self) -> DndScope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for DndScope

fn default() -> Self

Returns the “default value” for a type.