HTML::DOM::Collection - A Perl implementation of the HTMLCollection interface
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 @$images
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).
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.
Returns the number of items in the collection.
Returns item number $index, numbered from 0. Note that you call also use $collection->[$index] for short.
$index
$collection->[$index]
Returns the item named $name. If an item with an ID of $name exists, that will be returned. Otherwise the first item whose name attribute is $name will be returned. You can also write $collection->{$name}.
$name
name
$collection->{$name}
HTML::DOM
HTML::DOM::NodeList
To install HTML::DOM, copy and paste the appropriate command in to your terminal.
cpanm
cpanm HTML::DOM
CPAN shell
perl -MCPAN -e shell install HTML::DOM
For more information on module installation, please visit the detailed CPAN module installation guide.