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.

cpanm HTML::Object

perl -MCPAN -e shell
install HTML::Object