NAME
HTML::DOM::Collection - A Perl implementation of the HTMLCollection interface
VERSION
Version 0.055
SYNOPSIS
use HTML::DOM;
$doc = HTML::DOM->new;
$doc->write('<html> ..... </html>');
$doc->close;
$images = $doc->images; # returns an HTML::DOM::Collection
$images->[0]; # first image
$images->{logo}; # image named 'logo'
$images->item(0);
$images->namedItem('logo');
$images->length; # same as scalar @$imagesDESCRIPTION
This implements the HTMLCollection interface as described in the W3C's DOM standard. This class is actually just a wrapper around the NodeList classes. In addition to the methods below, you can use a collection as a hash and as an array (both read-only).
CONSTRUCTOR
Normally you would simply call a method that returns an HTML collection (as in the "SYNOPSIS"). But if you wall to call the constructor, here is the syntax:
$collection = HTML::DOM::Collection->new($nodelist)$nodelist should be a node list object.
OBJECT METHODS
- $collection->length
-
Returns the number of items in the collection.
- $collection->item($index)
-
Returns item number
$index, numbered from 0. Note that you call also use$collection->[$index]for short. - $collection->namedItem($name)
-
Returns the item named
$name. If an item with an ID of$nameexists, that will be returned. Otherwise the first item whosenameattribute is$namewill be returned. You can also write$collection->{$name}.