Skip to main content

DomMutation

Enum DomMutation 

Source
pub enum DomMutation<Id> {
    Inserted {
        node: Id,
        parent: Id,
    },
    Removed {
        node: Id,
        former_parent: Id,
    },
    AttributeChanged {
        node: Id,
        name: QualName,
        old_value: Option<String>,
    },
    CharacterDataChanged {
        node: Id,
    },
    SubtreeReplaced {
        node: Id,
    },
    Moved {
        node: Id,
        from_parent: Id,
        to_parent: Id,
    },
}
Expand description

A recorded structural DOM mutation — render-state-free (no dirty bits, no style). Id is the implementor’s LayoutDom::NodeId.

Variants§

§

Inserted

node was inserted under parent.

Fields

§node: Id
§parent: Id
§

Removed

node was removed from former_parent.

Fields

§node: Id
§former_parent: Id
§

AttributeChanged

The attribute named name was set or changed on node.

old_value is the attribute’s value before this change (None if the attribute was newly added). It is plain pre-mutation DOM data — not render state — and lets serval-layout reconstruct a Stylo ElementSnapshot at restyle time (the old value is gone from the live DOM by then). See docs/2026-05-25_fine_grained_restyle_plan.md.

Fields

§node: Id
§old_value: Option<String>
§

CharacterDataChanged

A text/comment node’s character data changed.

Fields

§node: Id
§

SubtreeReplaced

node’s entire child subtree was replaced (e.g. via innerHTML).

Fields

§node: Id
§

Moved

node moved atomically from from_parent to to_parent (possibly the same parent, reordered) with state preserved — the Node.moveBefore() contract (WHATWG DOM). Unlike a Removed + Inserted pair this promises the subtree never left the tree: consumers may keep per-node retained state (boxes, shaped text, focus, scroll) and treat the move as a splice/graft candidate rather than a teardown. A conservative consumer handles it exactly as removed-from + inserted-under. (docs/2026-07-05_movebefore_dom_standard_plan.md, S1.)

Fields

§node: Id
§from_parent: Id
§to_parent: Id

Trait Implementations§

Source§

impl<Id: Clone> Clone for DomMutation<Id>

Source§

fn clone(&self) -> DomMutation<Id>

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<Id: Debug> Debug for DomMutation<Id>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<Id: Eq> Eq for DomMutation<Id>

Source§

impl<Id: PartialEq> PartialEq for DomMutation<Id>

Source§

fn eq(&self, other: &DomMutation<Id>) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl<Id: PartialEq> StructuralPartialEq for DomMutation<Id>

Auto Trait Implementations§

§

impl<Id> Freeze for DomMutation<Id>
where Id: Freeze,

§

impl<Id> RefUnwindSafe for DomMutation<Id>
where Id: RefUnwindSafe,

§

impl<Id> Send for DomMutation<Id>
where Id: Send,

§

impl<Id> Sync for DomMutation<Id>
where Id: Sync,

§

impl<Id> Unpin for DomMutation<Id>
where Id: Unpin,

§

impl<Id> UnsafeUnpin for DomMutation<Id>
where Id: UnsafeUnpin,

§

impl<Id> UnwindSafe for DomMutation<Id>
where Id: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.