HTML::...ntainer(3pm)

✨ HTML::Widget::Container ✨

okay bestie, so this is a page from the User Contributed Perl Documentation set, and the man page header calls it HTML::...ntainer(3pm) 💅 (yes the name is literally truncated with dots, we love an abridged icon). The real module name is right down below, don't worry.

---

🎀 NAME 🎀

HTML::Widget::Container — Container

that's it. that's the description. she's a container. iconic, honestly. 💖

---

🌸 SYNOPSIS 🌸

    my $container  = $form->element('foo');

    my $field = $container->field;
    my $error = $container->error;
        my $label = $container->label;

    my $field_xml      = $container->field_xml;
    my $error_xml      = $container->error_xml;
    my $javascript_xml = $container->javascript_xml;

    my $xml = $container->as_xml;
        # $xml eq "$container"

    my $javascript = $container->javascript;

(and yes, the $label line really is indented like that in the original, i am not touching it, it's part of her aura 🦋)

---

💜 DESCRIPTION 💜

Container.

that's the whole description. no notes. slay. ✨

---

👑 METHODS 👑

as_xml

Return Value: $xml

_build_element

Arguments: $element

Return Value: @elements

Convert $element to HTML::Element object. Accepts arrayref.

If you wish to change the rendering behaviour of HTML::Widget — specifically, the handling of elements which are array-refs — you can specify "container_class" in HTML::Widget::Element to a custom class which just overrides this function. 🛠️

build_single_element

Arguments: $element

Return Value: $element

Convert $element to HTML::Element object.

Called by "_build_element".

If you wish to change the rendering behaviour of HTML::Widget — specifically, the handling of an individual element — you can override this function.

build_element_error

Arguments: $element

Return Value: $element

Called by "build_single_element".

If you wish to change how an error is rendered, override this function. 😭

build_element_label

Arguments: $element, $class

Return Value: $element

Called by "build_single_element".

If you wish to change how an element's label is rendered, override this function.

The $class argument is the original class of the element, before "build_element_error" was called. 🏷️ (so like, keep that in mind, it's the pre-error version of the class, fr fr)

as_list

Return Value: @elements

Returns a list of HTML::Element objects. 📝

element

field

Arguments: $element

"field" is an alias for "element". two names, one queen. 👯

element_xml

field_xml

Return Value: $xml

"field_xml" is an alias for "element_xml".

error

Arguments: $error

Return Value: $error

error_xml

Return Value: $xml

javascript

js

Arguments: $javascript

Return Value: $javascript

"js" is an alias for "javascript". short and cute, we stan a nickname 💅

javascript_element

Return Value: $javascript_element

Returns javascript in a script HTML::Element.

javascript_xml

js_xml

Return Value: $javascript_xml

Returns javascript in a script block.

"js_xml" is an alias for "javascript_xml". 🧚

---

🌈 AUTHOR 🌈

Sebastian Riedel, "sri@oook.de"

---

🫶 LICENSE 🫶

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

---

lowkey the most important part: everything above is exactly what the man page says. i just gave it main character energy. no facts were harmed in the making of this vibe check. 💖

and that's a wrap bestie!! 🌸 this beauty comes to you from perl v5.36.0, dated 2023-08-10, filed under HTML::...ntainer(3pm). go forth and container-ify, periodt. 🎀✨💜