Struct Node

pub struct Node<'a> { /* private fields */ }

A single node of an HTML document. Nodes may be HTML elements, comments, or text nodes.

Implementations

impl<'a> Node<'a>

pub fn new(document: &'a Document, index: usize) -> Option<Node<'a>>

Create a Node referring to the indexth Node of a document.

pub fn index(&self) -> usize

Get the index of this Node in its Document.

pub fn raw(&self) -> &'a Raw

Obtain the inner representation of this Node.

pub fn data(&self) -> &'a Data

Get the text node, HTML element, or comment from a Node.

pub fn name(&self) -> Option<&'a str>

Get the name of a Node if it is an HTML element, or None otherwise.

pub fn attr(&self, name: &str) -> Option<&'a str>

Get the value of the attribute name from a Node representing a HTML element.

pub fn attrs(&self) -> impl Iterator<Item = (&'a str, &'a str)>

Get an iterator over the names and values of attributes of the Element. Returns an empty iterator for non Element nodes.

pub fn parent(&self) -> Option<Node<'a>>

pub fn prev(&self) -> Option<Node<'a>>

pub fn next(&self) -> Option<Node<'a>>

pub fn first_child(&self) -> Option<Node<'a>>

pub fn last_child(&self) -> Option<Node<'a>>

pub fn text(&self) -> String

Get the combined textual content of a Node and all of its children.

pub fn html(&self) -> String

Serialize a Node to an HTML string.

pub fn inner_html(&self) -> String

Serialize a Node’s children to an HTML string.

pub fn find<P: Predicate>(&self, predicate: P) -> Find<'a, P>

Search for Nodes fulfilling predicate in the descendants of a Node.

pub fn is<P: Predicate>(&self, p: P) -> bool

Evaluate a predicate on this Node.

pub fn as_text(&self) -> Option<&'a str>

Get the text of a text Node, or None if the node is not text.

pub fn as_comment(&self) -> Option<&'a str>

Get the text of a comment Node, or None if the node is not a comment.

pub fn children(&self) -> Children<'a>

Construct an iterator over a Node’s child Nodes.

pub fn descendants(&self) -> Descendants<'a>

Construct an iterator over a Node’s descendant (transitive children) Nodes.

Trait Implementations

impl<'a> Clone for Node<'a>

fn clone(&self) -> Node<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Node<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq for Node<'a>

fn eq(&self, other: &Node<'a>) -> 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<'a> Serialize for Node<'a>

fn serialize<S: Serializer>( &self, serializer: &mut S, traversal_scope: TraversalScope, ) -> Result<()>

Take the serializer and call its methods to serialize this type. The type will dictate which methods are called and with what parameters.

impl<'a> Copy for Node<'a>

impl<'a> Eq for Node<'a>

impl<'a> StructuralPartialEq for Node<'a>