Enum lignin::web::DomRef [−][src]
pub enum DomRef<T> { Added(T), Removing(T), }
Expand description
Used as DOM reference callback parameter. (Expand for implementation contract!)
When you receive a DomRef
containing a stand-in type, use Materialize::materialize
to convert it to the actual value.
Implementation Contract
This is not a soundness contract. Code using this type must not rely on it for soundness. However, it is free to panic when encountering an incorrect implementation.
For VDOM-to-DOM renderers:
If a renderer invoked a callback with the Added
variant, it must invoke it with the Removing
variant before destroying or reusing the relevant part of the DOM.
This includes cases where the identity of the CallbackRef
or DOM node changes, in which case the new reference is Added
after, in this order, Removing
the old reference and updating the relevant part(s) of the DOM.
For apps/VDOM renderers:
Tearing down and reconstructing the child DOM according to the current child VDOM must be possible at any time.
Please refer to the variant documentation for more information.
Variants
When constructing the DOM, this variant is passed after all child elements have been processed and, if applicable, the element has been added to the document tree.
In particular, this means:
- Manipulating child elements is possible (but this can cause panics to occur later on if an incompatible child diff occurs).
- Traversing ancestors and their attributes should work.
- Scrolling the node into view and grabbing focus should work.
- Any siblings and ancestor siblings may be in an indeterminate state at this point!
When tearing down the DOM, this variant is passed before any child elements are processed and, if applicable, the element is removed from to the document tree.
In particular, this means:
- Child elements must be restored to a clean state compatible with their VDOM here!
- Traversing ancestors and their attributes should still work.
- Any siblings and ancestor siblings may be in an indeterminate state at this point!
Trait Implementations
impl<T: Materialize<U>, U> Materialize<DomRef<U>> for DomRef<T>
[src]
impl<T: Materialize<U>, U> Materialize<DomRef<U>> for DomRef<T>
[src]fn materialize(self) -> DomRef<U>
[src]
fn materialize(self) -> DomRef<U>
[src]Convert a DOM stand-in to its web type value. This is a no-op with the "callbacks"
feature and unreachable otherwise.
impl<T: Ord> Ord for DomRef<T>
[src]
impl<T: Ord> Ord for DomRef<T>
[src]impl<T: PartialOrd> PartialOrd<DomRef<T>> for DomRef<T>
[src]
impl<T: PartialOrd> PartialOrd<DomRef<T>> for DomRef<T>
[src]fn partial_cmp(&self, other: &DomRef<T>) -> Option<Ordering>
[src]
fn partial_cmp(&self, other: &DomRef<T>) -> Option<Ordering>
[src]This method returns an ordering between self
and other
values if one exists. Read more
#[must_use]fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
#[must_use]fn lt(&self, other: &Rhs) -> bool
1.0.0[src]This method tests less than (for self
and other
) and is used by the <
operator. Read more
#[must_use]fn le(&self, other: &Rhs) -> bool
1.0.0[src]
#[must_use]fn le(&self, other: &Rhs) -> bool
1.0.0[src]This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
impl<T: Copy> Copy for DomRef<T>
[src]
impl<T: Eq> Eq for DomRef<T>
[src]
impl<T> StructuralEq for DomRef<T>
[src]
impl<T> StructuralPartialEq for DomRef<T>
[src]
Auto Trait Implementations
impl<T> RefUnwindSafe for DomRef<T> where
T: RefUnwindSafe,
T: RefUnwindSafe,
impl<T> Send for DomRef<T> where
T: Send,
T: Send,
impl<T> Sync for DomRef<T> where
T: Sync,
T: Sync,
impl<T> Unpin for DomRef<T> where
T: Unpin,
T: Unpin,
impl<T> UnwindSafe for DomRef<T> where
T: UnwindSafe,
T: UnwindSafe,
Blanket Implementations
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]pub fn borrow_mut(&mut self) -> &mut T
[src]
pub fn borrow_mut(&mut self) -> &mut T
[src]Mutably borrows from an owned value. Read more
impl<T> ToOwned for T where
T: Clone,
[src]
impl<T> ToOwned for T where
T: Clone,
[src]type Owned = T
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn to_owned(&self) -> T
[src]Creates owned data from borrowed data, usually by cloning. Read more
pub fn clone_into(&self, target: &mut T)
[src]
pub fn clone_into(&self, target: &mut T)
[src]🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more