Struct NodeList 

pub struct NodeList<'a, Ext: 'static> { /* private fields */ }

Snapshot of node ids captured at construction. item(i) and iter() resolve against the borrowed &Dom; if a node has been removed since the snapshot, the resolution returns None for that slot (filtered out by iter()).

Implementations

impl<'a, Ext: 'static> NodeList<'a, Ext>

pub fn from_ids( dom: &'a Dom<Ext>, nodes: impl IntoIterator<Item = NodeId>, ) -> Self

Construct from an iterator of node ids and a borrowed Dom. Used by Dom::query_selector_all (M4b step 18) and tests.

pub fn len(&self) -> usize

Number of node ids in the snapshot. DOM length.

pub fn is_empty(&self) -> bool

true iff the snapshot has no node ids.

pub fn item(&self, index: usize) -> Option<NodeRef<'a, Ext>>

Borrow the i-th node if (a) the index is in range and (b) the underlying id still resolves to a live node. DOM item(i).

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

Iterate over the live members of the snapshot in snapshot order. Nodes that have been removed from the tree since the snapshot was taken are skipped.

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

Raw access to the snapshot’s id slice. Escape hatch for callers who want to do their own resolution (e.g. compare snapshots, build their own indices).