Struct Selection 

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

A collection of matched nodes from a selector query.

Provides iteration, text extraction, attribute access, and sub-selection (chaining).

Implementations

impl<'a> Selection<'a>

pub fn first(&self) -> Option<NodeRef<'a>>

Get the first matched node.

pub fn iter(&self) -> impl Iterator<Item = NodeRef<'a>> + '_

Iterate over matched nodes as NodeRef.

pub fn node_ids(&self) -> &[NodeId]

Iterate over matched node ids.

pub fn text(&self) -> String

Collect text content from all matched nodes.

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

Get an attribute value from the first matched node.

pub fn inner_html(&self) -> String

Get inner HTML from the first matched node.

pub fn len(&self) -> usize

Number of matched nodes.

pub fn is_empty(&self) -> bool

Whether the selection is empty.

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

Sub-select with a pre-compiled selector within the matched nodes.

Each matched node is used as a subtree root, and results are deduplicated in document order.

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

Sub-select: run a CSS selector within the matched nodes.

Each matched node is used as a subtree root, and results are deduplicated in document order.

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

Evaluate an XPath expression within the matched nodes.

Each matched node is used as a context root, and results are deduplicated in document order.

Note: the leading // is evaluated relative to each matched node’s subtree (descendant-or-self), not against the whole document. So doc.select("div").xpath("//span") finds the spans inside each matched div, and an axis like //div also yields the context div itself. This scoping is intentional so XPath composes with a prior selection; for a document-wide query, evaluate from the document root instead.

Trait Implementations

impl<'a> IntoIterator for &'a Selection<'a>

type Item = NodeRef<'a>

The type of the elements being iterated over.

type IntoIter = SelectionIter<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.