NAME

HTML::Object::DOM::NodeList - HTML Object DOM NodeList Class

SYNOPSIS

use HTML::Object::DOM::NodeList;
my $list = HTML::Object::DOM::NodeList->new || 
    die( HTML::Object::DOM::NodeList->error, "\n" );

VERSION

v0.2.0

DESCRIPTION

NodeList objects are collections of nodes, usually returned by properties such as "childNodes" in HTML::Object::DOM::Node and methods such as "querySelectorAll" in HTML::Object::DOM::Document.

PROPERTIES

length

The number of nodes in the NodeList.

Example:

# All the paragraphs in the document
my $items = $doc->getElementsByTagName("p");

# For each item in the list,
# append the entire element as a string of HTML
my $gross = "";
for( my $i = 0; $i < $items->length; $i++ )
{
    $gross += $items->[$i]->innerHTML;
}
# $gross is now all the HTML for the paragraphs

See also Mozilla documentation

METHODS

Inherits methods from its parent Module::Generic::Array

forEach

Executes a provided code reference (reference to a subroutine or anonymous subroutine) once per NodeList element, passing the element as an argument to the subroutine.

Example:

my $node = $doc->createElement("div");
my $kid1 = $doc->createElement("p");
my $kid2 = $doc->createTextNode("hey");
my $kid3 = $doc->createElement("span");

$node->appendChild( $kid1 );
$node->appendChild( $kid2 );
$node->appendChild( $kid3 );

my $list = $node->childNodes;
$list->forEach(sub(currentValue, currentIndex, listObj)
{
    my( $currentValue, $currentIndex, $listObj ) = @_;
    say( "$currentValue, $currentIndex, $_" );
});

See also Mozilla documentation

item

Returns an item in the list by its index, or undef if the index is out-of-bounds. An alternative to accessing nodeList[i] (which instead returns undefined when i is out-of-bounds). This is mostly useful for non-JavaScript DOM implementations.

Example:

my $tables = $doc->getElementsByTagName( 'table' );
my $firstTable = $tables->item(1); # or $tables->[1] - returns the second table in the DOM

See also Mozilla documentation

keys

Returns an iterator, allowing code to go through all the keys of the key/value pairs contained in the collection. (In this case, the keys are numbers starting from 0.)

Example:

my $node = $doc->createElement("div");
my $kid1 = $doc->createElement("p");
my $kid2 = $doc->createTextNode("hey");
my $kid3 = $doc->createElement("span");

$node->appendChild( $kid1 );
$node->appendChild( $kid2 );
$node->appendChild( $kid3 );

my $list = $node->childNodes;

# Using for..of
foreach my $key ( $list->keys->list )
{
    say( $key );
}

See also Mozilla documentation

values

Returns an iterator allowing code to go through all values (nodes) of the key/value pairs contained in the collection.

Example:

my $node = $doc->createElement("div");
my $kid1 = $doc->createElement("p");
my $kid2 = $doc->createTextNode("hey");
my $kid3 = $doc->createElement("span");

$node->appendChild( $kid1 );
$node->appendChild( $kid2 );
$node->appendChild( $kid3 );

my $list = $node->childNodes;

# Using for..of
foreach my $value ( $list->values )
{
    say( $value );
}

See also Mozilla documentation

AUTHOR

Jacques Deguest <jack@deguest.jp>

SEE ALSO

Mozilla documentation

COPYRIGHT & LICENSE

Copyright(c) 2022 DEGUEST Pte. Ltd.

All rights reserved

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.