Trait WriteMutations

Source

pub trait WriteMutations {
Show 15 methods    // Required methods
    fn append_children(&mut self, id: ElementId, m: usize);
    fn assign_node_id(&mut self, path: &'static [u8], id: ElementId);
    fn create_placeholder(&mut self, id: ElementId);
    fn create_text_node(&mut self, value: &str, id: ElementId);
    fn load_template(&mut self, template: Template, index: usize, id: ElementId);
    fn replace_node_with(&mut self, id: ElementId, m: usize);
    fn replace_placeholder_with_nodes(&mut self, path: &'static [u8], m: usize);
    fn insert_nodes_after(&mut self, id: ElementId, m: usize);
    fn insert_nodes_before(&mut self, id: ElementId, m: usize);
    fn set_attribute(
        &mut self,
        name: &'static str,
        ns: Option<&'static str>,
        value: &AttributeValue,
        id: ElementId,
    );
    fn set_node_text(&mut self, value: &str, id: ElementId);
    fn create_event_listener(&mut self, name: &'static str, id: ElementId);
    fn remove_event_listener(&mut self, name: &'static str, id: ElementId);
    fn remove_node(&mut self, id: ElementId);
    fn push_root(&mut self, id: ElementId);
}

Expand description

Something that can handle the mutations that are generated by the diffing process and apply them to the Real DOM

This object provides a bunch of important information for a renderer to use patch the Real Dom with the state of the VirtualDom. This includes the scopes that were modified, the templates that were discovered, and a list of changes in the form of a Mutation.

These changes are specific to one subtree, so to patch multiple subtrees, you’d need to handle each set separately.

Templates, however, apply to all subtrees, not just target subtree.

Mutations are the only link between the RealDOM and the VirtualDOM.

Required Methods§

Source

fn append_children(&mut self, id: ElementId, m: usize)

Add these m children to the target element

Id: The ID of the element being mounted to M: The number of nodes on the stack to append to the target element

Source

fn assign_node_id(&mut self, path: &'static [u8], id: ElementId)

Assign the element at the given path the target ElementId.

The path is in the form of a list of indices based on children. Templates cannot have more than 255 children per element, hence the use of a single byte.

Path: The path of the child of the topmost node on the stack. A path of [] represents the topmost node. A path of [0] represents the first child. [0,1,2] represents 1st child’s 2nd child’s 3rd child. Id: The ID we’re assigning to this element/placeholder. This will be used later to modify the element or replace it with another element.

Source

fn create_placeholder(&mut self, id: ElementId)

Create a placeholder in the DOM that we will use later.

Dioxus currently requires the use of placeholders to maintain a re-entrance point for things like list diffing

Id: The ID we’re assigning to this element/placeholder. This will be used later to modify the element or replace it with another element.

Source

fn create_text_node(&mut self, value: &str, id: ElementId)

Create a node specifically for text with the given value

Value: The text content of this text node Id: The ID we’re assigning to this specific text nodes. This will be used later to modify the element or replace it with another element.

Source

fn load_template(&mut self, template: Template, index: usize, id: ElementId)

Load and clone an existing node from a template saved under that specific name

Dioxus guarantees that the renderer will have already been provided the template. When the template is picked up in the template list, it should be saved under its “name” - here, the name

Name: The unique “name” of the template based on the template location. When paired with rsx!, this is autogenerated Index: The index root we loading from the template. The template is stored as a list of nodes. This index represents the position of that root Id: The ID we’re assigning to this element being loaded from the template (This will be used later to move the element around in lists)

Source

fn replace_node_with(&mut self, id: ElementId, m: usize)

Replace the target element (given by its ID) with the topmost m nodes on the stack

id: The ID of the node we’re going to replace with new nodes m: The number of nodes on the stack to replace the target element with

Source

fn replace_placeholder_with_nodes(&mut self, path: &'static [u8], m: usize)

Replace an existing element in the template at the given path with the m nodes on the stack

Path: The path of the child of the topmost node on the stack. A path of [] represents the topmost node. A path of [0] represents the first child. [0,1,2] represents 1st child’s 2nd child’s 3rd child. M: The number of nodes on the stack to replace the target element with

Source

fn insert_nodes_after(&mut self, id: ElementId, m: usize)

Insert a number of nodes after a given node.

Id: The ID of the node to insert after. M: The number of nodes on the stack to insert after the target node.

Source

fn insert_nodes_before(&mut self, id: ElementId, m: usize)

Insert a number of nodes before a given node.

Id: The ID of the node to insert before. M: The number of nodes on the stack to insert before the target node.

Source

fn set_attribute( &mut self, name: &'static str, ns: Option<&'static str>, value: &AttributeValue, id: ElementId, )

Set the value of a node’s attribute.

Name: The name of the attribute to set. NS: The (optional) namespace of the attribute. For instance, “style” is in the “style” namespace. Value: The value of the attribute. Id: The ID of the node to set the attribute of.

Source