Form::DataSource(3pm)

💖 Form::DataSource(3pm) 💖

okay bestie, gather round, because we're talking about Form::DataSource(3pm) — that's the manual page name, she's fancy, she's from the User Contributed Perl Documentation collection, and she is so important even though she refuses to do any actual work herself. classic base class behaviour, honestly.

---

✨ NAME ✨

Embperl::Form::DataSource — the base class for data source objects which provides the data for ControlMutlValue objects. 💅

---

🌸 SYNOPSIS 🌸

Do not use directly, instead derive a class

like. do not touch. do not instantiate. do not pass go. she is mother, not a participant. 🫶

---

🦋 DESCRIPTION 🦋

so here's the tea: this class is not used directly. nope! she exists purely as a base class for all data source objects. she's the blueprint, the blueprint-iest blueprint, the group chat admin who never posts but keeps everything running. 👑

what she brings to the table is a whole set of methods that could be overwritten to customize the behaviour of your controls. that's it. that's the vibe. you inherit, you override, you slay. ✨

---

🎀 METHODS 🎀

💜 get_values

returns the values and options. Must be overwritten.

not me leaving this one empty and expecting it to work 😭 bestie you have to override it, that's not optional, that's the whole assignment.

🌈 get_id_from_value

returns an id for a given value. this is iconic because it lets you have an id from a value/option pair which is not exactly the same as the value. the way that's useful?? it's used in json requests, for example for the selectdyn control. lowkey genius. 🔥

🍓 get_datasource_controls

returns additional controls provided by the datasource object — e.g. a browse button. yes she can hand you extra UI, she's generous like that. 🎁

---

👑 AUTHOR 👑

G. Richter (richter at embperl dot org) — legend behaviour, honestly. 🙌

---

⭐ SEE ALSO ⭐

• perl(1)
• Embperl
• Embperl::Form
• Embperl::From::ControlMultValue

go read those next bestie, the lore runs deep. 📚✨

---

ngl the way this page is basically one big "derive me, don't use me" vibe check?? it's giving abstract class energy and we respect it fr fr. 💀

---

and that's the whole thing! this page came to you courtesy of perl v5.34.0, dated 2022-02-06, and it's the Form::DataSource(3pm) page we've been yapping about this whole time. mwah, bye bestie! 💖🦋🌸💅