HTML::...:Button(3pm)

💖 HTML::Widget::Element::Button 💖

okay bestie, listen up — this is the manual page for HTML::Widget::Element::Button, straight out of the User Contributed Perl Documentation corner of your friendly neighbourhood section 3pm. It's the Button Element, and yes, it's exactly as iconic as it sounds. 💅

---

✨ NAME ✨

HTML::Widget::Element::Button — the Button Element. That's it, that's the name, she's simple and she serves. 🎀

---

✨ SYNOPSIS ✨

Like, here's the whole vibe in two lines:

$e = $widget->element( 'Button', 'foo' );
$e->value('bar');

See? You grab a Button element off your widget, name it 'foo', and then you set its value to 'bar'. Slay. ✨

---

✨ DESCRIPTION ✨

It's a Button Element. Button. Element. The whole personality. 🦋

---

✨ METHODS ✨

🌸 new

🌸 value

🌸 label

okay so this is the good part — the value of this Button element. It's also what the browser uses as the button's label. So like, the value and the visible text are the same thing here. Two jobs, one queen. 👑

And heads up: label is literally just an alias for value. Same girl, different name. ✨

🌸 content

If you set this one, the element switches up and uses a button tag instead of an input tag. It's giving glow up. 💅

And the value of content goes between the button tags — unescaped. Which means, bestie, you can put any html markup in there to display the button. Any. You have been warned, iykyk. 😭

🌸 type

The valid values are:

• button
• submit
• reset
• image

Pick one, any one. 🌈

🌸 src

If you set this, the element gets rendered as an image button, using this url as the actual image. 🖼️

⚠️ And it automatically sets type to image for you. No cap, it just does it. 🙈

🌸 retain_default

If this one is true, it overrides the default behaviour. So after a field is missing from the form submission, the xml output will contain the default value instead of being empty. Because sometimes you want the default to stay, and honestly? Same. 🫶

🌸 render

🌸 containerize

---

✨ SEE ALSO ✨

HTML::Widget::Element — go read that one next, bestie, it's the parent energy. 👑

---

✨ AUTHOR ✨

Marcus Ramberg, mramberg@cpan.org. Iconic. 💜

---

✨ LICENSE ✨

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

---

and that's the whole page, bestie!! 🎀 This lil doc shipped with perl v5.36.0 and got dated 2023-08-10, so go forth and build buttons. You ate, no crumbs left. 🦋✨💖