Struct HtmlCollection 

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

Snapshot of element ids captured at construction with name-based lookup. Used by form.elements, getElementsByTagName, etc.

Implementations

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

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

Construct from an iterator of element ids and a borrowed Dom. Used by form.elements() (M4b step 30) and tests.

pub fn len(&self) -> usize

Number of element ids in the snapshot. DOM length.

pub fn is_empty(&self) -> bool

true iff the snapshot has no element ids.

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

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

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

Look up the first element whose name attribute matches name, falling back to id attribute. Matches DOM namedItem (the “named property getter” on HTMLCollection). Snapshot-resolved — removed nodes are skipped even if their id was in the original snapshot.

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

Iterate over the live members of the snapshot in snapshot order. Nodes removed since the snapshot was taken are skipped.

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

Raw access to the snapshot’s id slice. Escape hatch.