Struct plaster::virtual_dom::vtag::VTag

pub struct VTag<COMP: Component> {
    pub reference: Option<Element>,
    pub listeners: Vec<Box<dyn Listener<COMP>>>,
    pub attributes: HashMap<String, String>,
    pub childs: Vec<VNode<COMP>>,
    pub classes: HashSet<String>,
    pub value: Option<String>,
    pub kind: Option<String>,
    pub checked: bool,
    // some fields omitted
}

A type for a virtual Element representation.

Fields

reference: Option<Element>

A reference to the Element.

listeners: Vec<Box<dyn Listener<COMP>>>

List of attached listeners.

attributes: HashMap<String, String>

List of attributes.

childs: Vec<VNode<COMP>>

The list of children nodes. Which also could have own children.

classes: HashSet<String>

List of attached classes.

value: Option<String>

Contains a value of an HtmlInputElement.

kind: Option<String>

Contains kind value of an HtmlInputElement.

checked: bool

Represents checked attribute of input. It exists to override standard behavior of checked attribute, because in original HTML it sets defaultChecked value of HtmlInputElement, but for reactive frameworks it's more useful to control checked value of an HtmlInputElement.

Methods

impl<COMP: Component> VTag<COMP>

pub fn new<S: Into<Cow<'static, str>>>(tag: S) -> Self

Creates a new VTag instance with tag name (cannot be changed later in DOM).

pub fn tag(&self) -> &str

Returns tag of an Element. In HTML tags are always uppercase.

pub fn add_child(&mut self, child: VNode<COMP>)

Add VNode child.

pub fn add_class(&mut self, class: &str)

Adds asingle class to this virtual node. Actually it will set by Element.classList.add call later.

pub fn set_classes(&mut self, classes: &str)

Add classes to this virtual node. Actually it will set by Element.classList.add call later.

pub fn set_value<T: ToString>(&mut self, value: &T)

Sets value for an HtmlInputElement.

pub fn set_kind<T: ToString>(&mut self, value: &T)

Sets kind property of an HtmlInputElement. Same as set type attribute.

pub fn set_checked(&mut self, value: bool)

Sets checked property of an HtmlInputElement. (Not a value of node's attribute).

pub fn add_attribute<T: ToString>(&mut self, name: &str, value: &T)

Adds attribute to a virtual node. Not every attribute works when it set as attribute. We use workarounds for: class, type/kind, value and checked.

pub fn add_listener(&mut self, listener: Box<dyn Listener<COMP>>)

Adds new listener to the node. It's boxed because we want to keep it in a single list. Lates Listener::attach called to attach actual listener to a DOM node.

Trait Implementations

impl<COMP: Component> VDiff for VTag<COMP>

type Component = COMP

The component which this instance put into.

fn detach(&mut self, parent: &Node) -> Option<Node>

Remove VTag from parent.

fn apply(
    &mut self,
    parent: &Node,
    precursor: Option<&Node>,
    ancestor: Option<VNode<Self::Component>>,
    env: &Scope<Self::Component>
) -> Option<Node>

Renders virtual tag over DOM Element, but it also compares this with an ancestor VTag to compute what to patch in the actual DOM nodes.

impl<COMP: Component> PartialEq<VTag<COMP>> for VTag<COMP>

fn eq(&self, other: &VTag<COMP>) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<COMP: Component> From<VTag<COMP>> for VNode<COMP>

fn from(vtag: VTag<COMP>) -> Self

Performs the conversion.

impl<COMP: Component> Debug for VTag<COMP>

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

Formats the value using the given formatter.