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.

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.