HTML::...pyValue(3pm)

💖 HTML::FormFu::Filter::CopyValue — the manual, but make it make sense 💖

okay bestie, so this is a page from the User Contributed Perl Documentation collection, and the module we're gagging over today is HTML::FormFu::Filter::CopyValue(3pm). yes the title got truncated in the header, we don't talk about that. 🫶

---

✨ NAME ✨

HTML::FormFu::Filter::CopyValue — copy the value from another field. that's it. that's the whole job. iconic behaviour honestly. 👑

---

🌸 VERSION 🌸

version 2.07 — she's got lore, she's got history.

---

🦋 SYNOPSIS 🦋

here's the vibe in YAML, copy it exactly, don't freestyle:

elements:
   - type: Text
     name: username
   - type: Text
     name: nickname
     filters:
        - type: CopyValue
          field: username

so nickname is like "if you didn't type anything, just steal whatever username said." 💅

---

💜 DESCRIPTION 💜

this filter copies the value of another field — but only if the original value of this field is empty. so like, if you actually wrote something in the field, it minds its own business. nothing happens. she's respectful. but if you left it blank? boom, it goes and grabs the value from the field you named. no cap.

---

😭 CAVEATS 😭 (read this one fr fr)

okay so this is the part where it gets spicy. if the original field contains an invalid value — and by invalid we mean a value that's gonna get constrained through a constraint — then that invalid value will be copied to this field (the field with the CopyValue filter). 💀

which means the user has to change two fields to fix it. or, alternatively, you can remove the invalid value in a custom constraint. those are your options, bestie. choose wisely.

🚨 not me warning you: this is real behaviour, not a vibe. two fields, or a custom constraint. periodt.

---

🎀 AUTHOR 🎀

Mario Minati, "mario.minati@googlemail.com" — thank you for your service, king. 🫶

---

🌈 LICENSE 🌈

This library is free software, you can redistribute it and/or modify it under the same terms as Perl itself. slay, open source, we love to see it. ✨

---

👑 AUTHOR 👑 (yes again, two authors, we contain multitudes)

Carl Franks <cpan@fireartist.com> — also a legend.

---

💖 COPYRIGHT AND LICENSE 💖

This software is copyright (c) 2018 by Carl Franks.

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

---

and that's the whole page, no skips, no summarising, every detail present and accounted for. 🧚

sign-off time: this beautiful mess was rendered by perl v5.28.1 on 2019-01-12, and it belongs to HTML::...pyValue(3pm). mwah. 💋 bye bestie, go copy some values responsibly. 🍓