HTML::O...lection(3)

📦 version 0.6.0, in alpine 3.24

🎀 NAME 🎀

HTML::Object::Collection — HTML Object XQuery Collection Class. This is the HTML::O...lection(3) manual page, from User Contributed Perl Documentation, bestie, and it's here to make collections of HTML elements make sense 💅✨

🌸 SYNOPSIS 🌸

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

🦋 VERSION 🦋

v0.2.0 — tiny version number, big main character energy 🎀

💖 DESCRIPTION 💖

Okay so HTML::Object::Collection is literally a collection of HTML elements. XQuery uses it when a query is made with a selector or other criteria to group several HTML objects together, just like jQuery does. No cap, that's the whole vibe.

It inherits from HTML::Object::Document and does not do much except for a handful methods. Low-key iconic for being low-key 🫶

👑 INHERITANCE 👑

Here's the family tree, and it's giving pipeline realness:

+-----------------------+     +----------------------------+     +--------------------------+
| HTML::Object::Element | --> | HTML::Object::DOM::Element | --> | HTML::Object::Collection |
+-----------------------+     +----------------------------+     +--------------------------+

🍓 PROPERTIES 🍓

🎀 nodeValue

This returns or sets the value of the current node.

For document, element or collection, this returns undef; for attribute, text or comment, this returns the objct value 💀

For more information, the page points here: https://developer.mozilla.org/en-US/docs/Web/API/Node/nodeValue

🔥 METHODS 🔥

✨ as_string

When called, this will return the string representation of the first HTML element object it contains, similar to the behaviour of jQuery. But wait, there's an added feature: if this method is called with all set to 1 or a positive value, then it will return the string representation for all the HTML element objects it holds. Obsessed 🫶

🦋 end

Set or get the end element. Simple, clean, slay 💅

🌈 AUTHOR 🌈

Jacques Deguest <jack@deguest.jp> 👑

⭐ SEE ALSO ⭐

All the little friends:

  • HTML::Object
  • HTML::Object::Attribute
  • HTML::Object::Boolean
  • HTML::Object::Closing
  • HTML::Object::Collection
  • HTML::Object::Comment
  • HTML::Object::Declaration
  • HTML::Object::Document
  • HTML::Object::Element
  • HTML::Object::Exception
  • HTML::Object::Literal
  • HTML::Object::Number
  • HTML::Object::Root
  • HTML::Object::Space
  • HTML::Object::Text
  • HTML::Object::XQuery

Copyright (c) 2021 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.

🎀 cute sign-off: this page is from perl v5.42.2, dated 2026-02-15 — mwah, bestie! 💋✨

📦 where this page comes from