Form::...:button(3pm)

💖 Form::...:button(3pm) 💖

okay bestie, so this is the manual page for Embperl::Form::Control::submit — yeah the title says button but the actual thing is called submit, we love a little name chaos, it's giving mystery 💅. She's a Perl module, she lives in the User Contributed Perl Documentation section, and she makes buttons inside an Embperl Form. Periodt.

---

✨ SYNOPSIS ✨

  {
  type => 'submit',
  text => 'send',
  name => 'foo',
  value => 'xxx',
  image => 'xxx',
  onclick => 'window.open (...)',

  button => [
             {
             onclick     => 'do_something()',
             style       => 'border: 1px solid black;',
             },
             {
             name        => 'foobar',
             value       => 'Click here, too',
             onclick     => 'do_something()',
             class       => 'HurzCSSClass',
             onmouseover => 'do(this)';
             onmouseout  => 'do(that)';
             }
            ]

  }

like, copy that vibe exactly, okay? every quote, every semicolon, no notes 🎀

---

🌸 DESCRIPTION 🌸

So what does she do? She creates a submit control inside an Embperl Form. That's the whole job and she ate 🔥.

And here's the cute part: if you hand her an image, she'll make you an image button instead. Iconic. If you wanna know how to actually pass parameters around here, go peek at Embperl::Form, she's the one with the lore.

---

🦋 PARAMETER 🦋

okay so these are the keys you can feed her:

• type — has to be 'button'. no negotiating, bestie, that's the rule 💀
• name — the name of the button. yeah. it's the name. we're keeping it simple 🫶
• text — this becomes the label on your submit button. OR, if it's an image button, it becomes the tool tip instead. dual purpose queen 👑
• value — the value she sends along. that's what goes out into the world ✨
• image — a URL to an image. if you give her one, you get an image button. if you don't, you get a plain normal submit button. your call, both are valid 🌈
• onclick — the Javascript that runs when the user clicks the button. go wild, window.open(...) and all that 💅
• button — a hashref holding the key-value pairs of every attribute the button needs. all of them. she takes the whole package 🎀

---

👑 Author 👑

G. Richter (richter at embperl dot org) and A. Beckert (beckert@ecos.de) made this. absolute legends, we stan ⭐

---

🧚 See Also 🧚

perl(1), Embperl, Embperl::Form — go read those too, iykyk 💖

---

okay that's the whole page!! and a lil cute sign-off for you: this gorgeous thing is from perl v5.34.0, dated 2022-02-06, and she's filed under Form::...:button(3pm). go forth and make buttons, bestie, you're gonna slay 💅✨🦋🌸