HTML::...eckbox(3pm)

💖 NAME 💖

HTML::FormHandler::Field::Checkbox — a checkbox field type, bestie. This page is from the User Contributed Perl Documentation, and the manpage header is literally HTML::...eckbox(3pm) — yes, the terminal said “not today” and truncated it, iconic. ✨

✨ VERSION ✨

version 0.40068, periodt. 💅

🦋 DESCRIPTION 🦋

okay so this field is very similar to the Boolean Widget except that this field allows other positive values besides 1. Since unselected checkboxes do not return a parameter, fields with Checkbox type will always be set to the 'input_without_param' default if they do not appear in the form. 🫶

🎀 widget 🎀

checkbox — that’s the widget, that’s the vibe. ✅

🎀 checkbox_value 🎀

In order to create the HTML for a checkbox, there must be a value="xx". This value is specified with the 'checkbox_value' attribute, which defaults to 1. Not me being obsessed with a default. 💖

🎀 input_without_param 🎀

If the checkbox is not checked, it will be set to the value of this attribute (the unchecked value). Default = 0. Because unchecked checkboxes do not return anything in the HTTP parameters, the absence of a checkbox key in the parameters hash forces this field to this value. This means that Checkbox fields, unlike other fields, will not be ignored if there is no input. If a particular checkbox should not be processed for a particular form, you must set 'inactive' to 1 instead. 🚨

bestie, this is the key lore: no checkbox key in the HTTP parameters = this field gets forced to input_without_param. It does not get ignored like other fields. If you need it skipped for a form, inactive = 1, no cap. 💀

Note that a checkbox is only 'checked' when the 'checkbox_value' is provided. The 'value' for a non-checked checkbox is only really useful for creating form values such as are stored in a database. 🌸

🌸 AUTHOR 🌸

FormHandler Contributors - see HTML::FormHandler. 🫶

🎀 COPYRIGHT AND LICENSE 🎀

This software is copyright (c) 2017 by Gerda Shank. 👑

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. 🌈

---

okay that’s the whole page, bestie 🫶 it’s perl v5.34.0, dated 2022-03-25, and the footer title is HTML::...eckbox(3pm) — still truncated, still iconic. bye! 💅✨