HTML::O...Comment(3)

📦 version 0.6.0, in alpine 3.24

💖 NAME 💖

okay bestie, welcome to the HTML::O...Comment(3) manual page! This module is HTML::Object::DOM::Comment — HTML Object DOM Comment Class. Periodt. ✨

✨ SYNOPSIS ✨

use HTML::Object::DOM::Comment;
my $this = HTML::Object::DOM::Comment->new( value => $some_comment ) ||
    die( HTML::Object::DOM::Comment->error, "\n" );

🌈 VERSION 🌈

v0.2.0

🦋 DESCRIPTION 🦋

The Comment interface represents textual notations within markup — it's generally not visually shown, but bestie, those comments are still available to be read in the source view. 👀

Comments are represented in HTML and XML as content between <!-- and -->. In XML, like inside SVG or MathML markup, the character sequence -- cannot be used within a comment. ⚠️

It inherits from HTML::Object::Comment and HTML::Object::DOM::CharacterData.

🎀 INHERITANCE 🎀

the family tree is giving legacy DOM energy, and honestly it ate:

           +-----------------------+     +---------------------------+     +-------------------------+     +----------------------------------+     +----------------------------+
           | HTML::Object::Element | --> | HTML::Object::EventTarget | --> | HTML::Object::DOM::Node | --> | HTML::Object::DOM::CharacterData | --> | HTML::Object::DOM::Comment |
           +-----------------------+     +---------------------------+     +-------------------------+     +----------------------------------+     +----------------------------+
             |                                                                                                                                        ^
             |                                                                                                                                        |
             v                                                                                                                                        |
           +-----------------------+                                                                                                                  |
           | HTML::Object::Comment | -----------------------------------------------------------------------------------------------------------------+
           +-----------------------+

💅 PROPERTIES 💅

🍓 nodeValue 🍓

Sets or gets the text value for this element.

🔥 METHODS 🔥

getAttributes

Returns an empty list in list context, or an empty array reference in scalar context. no cap, that's the whole deal. 💅

getChildNodes

Returns an empty list in list context, or an empty array reference in scalar context.

getElementById

Returns an empty list in list context, or undef in scalar context.

getFirstChild

Returns an empty list in list context, or undef in scalar context.

getLastChild

Returns an empty list in list context, or undef in scalar context.

getParentNode

Returns the parent node, if any.

getRootNode

Returns the root node.

getValue

Returns the text value of this comment, i.e. the text between <!-- and -->.

isAttributeNode

Returns false.

isCommentNode

Returns true.

isElementNode

Returns false.

isEqualNode

Provided with another element object, and this returns true if both comment element are the same, or false otherwise.

isNamespaceNode

Returns false.

isPINode

Returns false.

isProcessingInstructionNode

Returns false.

isTextNode

Returns false.

string_value

Returns the content of the comment as a string.

toString

Returns the content of the comment as a string.

🫶 AUTHOR 🫶

Jacques Deguest <jack@deguest.jp>

👑 SEE ALSO 👑

Mozilla documentation: https://developer.mozilla.org/en-US/docs/Web/API/Comment

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 little sign-off, bestie: this page comes from perl v5.42.2, dated 2026-02-15, with User Contributed Perl Documentation energy for HTML::O...Comment(3). mwah 💖
📦 where this page comes from