HTML::O...ptGroup(3)

📦 version 0.6.0, in alpine 3.24

💅 HTML::O...ptGroup(3) — like, the whole entire manual, bestie

Okay so this is the page for HTML::Object::DOM::Element::OptGroup, straight out of the User Contributed Perl Documentation section, and yes the header is doing that abbreviated HTML::O...ptGroup(3) thing because even manpage titles get shy sometimes. Sit down, grab a strawberry 🍓, we're learning about <optgroup> today and it's gonna be adorable.

✨ NAME ✨

HTML::Object::DOM::Element::OptGroup — the HTML Object DOM OptGroup Class. That's it, that's the name, she's an icon, she's a class, she handles optgroups. Periodt. 👑

🎀 SYNOPSIS 🎀

Here's how you actually summon one, copy-paste blessed:

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

Notice the || die(...) — because if the constructor flops, we're printing HTML::Object::DOM::Element::OptGroup->error and a "\n" and then leaving. No silent failures in this house. 💀

🦋 VERSION 🦋

v0.2.0

Tiny version number, big main character energy. 🌈

🌸 DESCRIPTION 🌸

So, what does this thing do? This interface hands you special properties and methods — and yes, on top of the regular HTML::Object::Element object interface that they already get by inheritance, because nepo babies exist and honestly good for them 💖 — all for the purpose of manipulating the layout and presentation of "<optgroup"> elements.

That's the whole job. Layout. Presentation. <optgroup> care and keeping. Slay.

💜 INHERITANCE 💜

The family tree is giving royalty, look at this lineage:

+-----------------------+     +---------------------------+     +-------------------------+     +----------------------------+     +--------------------------------------+
| HTML::Object::Element | --> | HTML::Object::EventTarget | --> | HTML::Object::DOM::Node | --> | HTML::Object::DOM::Element | --> | HTML::Object::DOM::Element::OptGroup |
+-----------------------+     +---------------------------+     +-------------------------+     +----------------------------+     +--------------------------------------+

Five generations deep and every single one of them is serving. HTML::Object::DOM::Element::OptGroup is literally the youngest of the line and she inherited everything. 🫶

🧚 PROPERTIES 🧚

She inherits properties from her parent, HTML::Object::DOM::Element. (Yes, the one right there in the diagram. Her mom. Iconic.)

💅 disabled

Is a boolean value representing whether or not the whole list of children "<option"> is disabled (true) or not (false).

Like, the entire group of options, all at once, no takebacks — true means they're all off the table, false means they're live. So dramatic and so efficient. 😭

See also Mozilla documentation https://developer.mozilla.org/en-US/docs/Web/API/HTMLOptGroupElement/disabled

🎀 label

Is a string representing the label for the group.

That's the little name tag the group wears. A string. Very simple, very chic. 🌸

See also Mozilla documentation https://developer.mozilla.org/en-US/docs/Web/API/HTMLOptGroupElement/label

⭐ METHODS ⭐

She inherits methods from her parent, HTML::Object::DOM::Element. No new methods of her own listed here — she's got hand-me-downs and they're good hand-me-downs. Ngl, lowkey the comfiest way to be. 🦋

👑 AUTHOR 👑

Jacques Deguest <jack@deguest.jp>

The genius behind the whole thing. Respect. 🫡

🌈 SEE ALSO 🌈

Go read them, they're the reference material for all of this, iykyk. 📚

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.

🫶 Fr fr, it's free software — same terms as Perl itself, redistribute and/or modify as you please, but keep that notice, bestie. All rights reserved is right there and we respect it.

💌 the sign-off 💌

This little beauty shipped as part of perl v5.42.2, dated 2026-02-15, and you can find her filed under HTML::O...ptGroup(3) in the manual pages. Go forth, manipulate those <optgroup> layouts, and remember: layout and presentation are a lifestyle. 💅✨🎀

📦 where this page comes from