Struct Document 

pub struct Document { /* private fields */ }

A parsed HTML document backed by an arena.

Provides access to the root node and convenience methods for querying the DOM tree.

Implementations

impl Document

pub fn root(&self) -> NodeRef<'_>

Get a reference to the root node.

pub fn get(&self, id: NodeId) -> NodeRef<'_>

Get a node by its id.

Panics

Panics if id is out of bounds.

pub fn arena(&self) -> &Arena

Get the underlying arena (for advanced usage).

pub fn to_html(&self) -> String

Serialize the entire document back to an HTML string.

This produces the outer HTML of the root node, which includes all children with proper entity escaping for text and attribute values.

Example

use fhp_tree::parse;

let doc = parse("<p>Hello &amp; world</p>").unwrap();
let html = doc.to_html();
assert!(html.contains("&amp;"));

pub fn node_count(&self) -> usize

Total number of nodes in the document.

pub fn root_id(&self) -> NodeId

Root node id.

Trait Implementations

impl Selectable for Document

fn select(&self, css: &str) -> Result<Selection<'_>, SelectorError>

Select all nodes matching a CSS selector.

fn select_compiled( &self, sel: &CompiledSelector, ) -> Result<Selection<'_>, SelectorError>

Select all nodes matching a pre-compiled CSS selector.

fn select_first_compiled( &self, sel: &CompiledSelector, ) -> Result<Option<NodeRef<'_>>, SelectorError>

Select the first node matching a pre-compiled CSS selector.

fn select_first(&self, css: &str) -> Result<Option<NodeRef<'_>>, SelectorError>

Select the first node matching a CSS selector.

fn find_by_tag(&self, tag: Tag) -> Selection<'_>

Find all elements with the given tag.

fn find_by_id(&self, id: &str) -> Option<NodeRef<'_>>

Find an element by its id attribute.

fn find_by_class(&self, class: &str) -> Selection<'_>

Find all elements with the given CSS class.

fn find_by_attr(&self, name: &str, value: &str) -> Selection<'_>

Find all elements with an attribute matching a value.

fn xpath(&self, expr: &str) -> Result<XPathResult, XPathError>

Evaluate an XPath expression against the document.