Struct Node

pub struct Node(/* private fields */);

A reference to a JavaScript object which implements the INode interface.

(JavaScript docs)

Implementations

impl Node

pub fn from_html(html: &str) -> Result<Node, SyntaxError>

Attempt to create the Node from raw html. The html string must contain exactly one root node.

Returns a SyntaxError if:

• There is not exactly one root node.
• The html syntax is wrong. However, on most browsers the html parsing algorighm is unbelievably forgiving and will just turn your html into text or maybe even an empty string.

It is recommended to have control over the html being given to this function as not having control is a security concern.

For more details, see information about setting innerHTML:

https://developer.mozilla.org/en-US/docs/Web/API/Element/innerHTML

Trait Implementations

impl AsRef<Reference> for Node

fn as_ref(&self) -> &Reference

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Node

fn clone(&self) -> Node

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Node

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

Formats the value using the given formatter.

impl From<CanvasElement> for Node

fn from(value: CanvasElement) -> Self

Converts to this type from the input type.

impl From<Document> for Node

fn from(value: Document) -> Self

Converts to this type from the input type.

impl From<DocumentFragment> for Node

fn from(value: DocumentFragment) -> Self

Converts to this type from the input type.

impl From<Element> for Node

fn from(value: Element) -> Self

Converts to this type from the input type.

impl From<HtmlElement> for Node

fn from(value: HtmlElement) -> Self

Converts to this type from the input type.

impl From<ImageElement> for Node

fn from(value: ImageElement) -> Self

Converts to this type from the input type.

impl From<InputElement> for Node

fn from(value: InputElement) -> Self

Converts to this type from the input type.

impl From<Node> for EventTarget

fn from(value: Node) -> Self

Converts to this type from the input type.

impl From<Node> for Reference

fn from(value: Node) -> Self

Converts to this type from the input type.

impl From<OptionElement> for Node

fn from(value: OptionElement) -> Self

Converts to this type from the input type.

impl From<SelectElement> for Node

fn from(value: SelectElement) -> Self

Converts to this type from the input type.

impl From<ShadowRoot> for Node

fn from(value: ShadowRoot) -> Self

Converts to this type from the input type.

impl From<SlotElement> for Node

fn from(value: SlotElement) -> Self

Converts to this type from the input type.

impl From<TemplateElement> for Node

fn from(value: TemplateElement) -> Self

Converts to this type from the input type.

impl From<TextAreaElement> for Node

fn from(value: TextAreaElement) -> Self

Converts to this type from the input type.

impl From<TextNode> for Node

fn from(value: TextNode) -> Self

Converts to this type from the input type.

impl IEventTarget for Node

fn add_event_listener<T, F>(&self, listener: F) -> EventListenerHandle

where T: ConcreteEvent, F: FnMut(T) + 'static,

Adds given event handler to the list of event listeners for the specified EventTarget on which it’s called.

fn dispatch_event<T: IEvent>(&self, event: &T) -> Result<bool, TODO>

Dispatches an Event at this EventTarget, invoking the affected event listeners in the appropriate order.

impl INode for Node

fn as_node(&self) -> &Node

Casts a reference to this object into a reference to a Node.

fn append_child<T: INode>(&self, child: &T)

Adds a node to the end of the list of children of a specified parent node.

fn remove_child<T: INode>(&self, child: &T) -> Result<Node, NotFoundError>

Removes a child node from the DOM.

fn clone_node(&self, kind: CloneKind) -> Result<Self, TODO>

Returns a duplicate of the node on which this method was called.

fn contains<T: INode>(&self, node: &T) -> bool

Checks whenever a given node is a descendant of this one or not.

fn insert_before<T: INode, U: INode>( &self, new_node: &T, reference_node: &U, ) -> Result<Node, InsertNodeError>

Inserts the specified node before the reference node as a child of the current node.

fn replace_child<T: INode, U: INode>( &self, new_child: &T, old_child: &U, ) -> Result<Node, InsertNodeError>

Replaces one hild node of the specified node with another.

fn parent_node(&self) -> Option<Node>

Returns the parent of this node in the DOM tree.

fn first_child(&self) -> Option<Node>

Returns the node’s first child in the tree, or None if the node is childless.

fn last_child(&self) -> Option<Node>

Returns the node’s last child in the tree, or None if the node is childless.

fn next_sibling(&self) -> Option<Node>

Returns the node’s next sibling in the tree, or None if there isn’t such a node.

fn node_name(&self) -> String

Returns the name of the node.

fn node_type(&self) -> NodeType

Returns the type of the node.

fn node_value(&self) -> Option<String>

Returns the value of the node.

fn set_node_value(&self, value: Option<&str>)

Sets the value of the node.

fn owner_document(&self) -> Option<Document>

Returns the Document that this node belongs to.

fn parent_element(&self) -> Option<Element>

Returns an Element that is the parent of this node. Returns null if the node has no parent or the parent is not an Element.

fn previous_sibling(&self) -> Option<Node>

Returns the node’s previous sibling in the tree, or None if there isn’t such a node.

fn text_content(&self) -> Option<String>

A property which represents the text content of a node and its descendants.

fn set_text_content(&self, text: &str)

Sets the text content of this node; calling thil removes all of node’s children and replaces them with a single text node with the given value.

fn child_nodes(&self) -> NodeList

Returns a live collection of child nodes of this node.

fn base_uri(&self) -> String

Gets the base URL.

fn has_child_nodes(&self) -> bool

Returns whether this node has children nodes.

fn is_default_namespace(&self, namespace: &str) -> bool

Determines whether the given namespace is the default namespace of this node.

fn is_equal_node<T: INode>(&self, node: &T) -> bool

Tests whether this node is equal to another node. Two nodes are equal if they have the same type, defining characteristics, matching attributes, and so on.

fn is_same_node<T: INode>(&self, node: &T) -> bool

Test whether two Node references are the same.

fn lookup_prefix(&self, namespace: &str) -> Option<String>

Returns the prefix for the given namespace URI, if present.

fn lookup_namespace_uri(&self, prefix: &str) -> Option<String>

Returns the namespace URI for the given prefix.

fn normalize(&self)

Merges any adjacent text nodes and removes empty text nodes under this node.

impl InstanceOf for Node

fn instance_of(reference: &Reference) -> bool

Checks whenever a given Reference if of type Self.

impl PartialEq for Node

fn eq(&self, other: &Node) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl ReferenceType for Node

unsafe fn from_reference_unchecked(reference: Reference) -> Self

Converts a given reference into a concrete reference-like wrapper. Doesn’t do any type checking; highly unsafe to use!

impl<'_r> TryFrom<&'_r Reference> for Node

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(reference: &Reference) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_r> TryFrom<&'_r Value> for Node

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: &Value) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<EventTarget> for Node

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: EventTarget) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for CanvasElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for Document

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for DocumentFragment

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for Element

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for HtmlElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for ImageElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for InputElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for OptionElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for Reference

type Error = Void

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for SelectElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for ShadowRoot

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for SlotElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for TemplateElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for TextAreaElement

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Node> for TextNode

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Node) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Reference> for Node

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(reference: Reference) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Value> for Node

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Value) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for Node

impl JsSerialize for Node

impl StructuralPartialEq for Node