Excel:...nt::Var(3pm)

💖 Excel::Template::Element::Var 💖

ok so bestie, welcome to Excel::Template::Element::Var, a page from the User Contributed Perl Documentation collection. she's a little module, she's a legend, and she does exactly one job and does it flawlessly. let's get into it 🫶

---

✨ NAME ✨

Excel::Template::Element::Var — yes that's literally it, that's the whole name, and honestly? iconic. no notes. 💅

---

🎀 PURPOSE 🎀

her whole thing, her entire raison d'être, is parameter substitution. that's it. that's the job. she swaps placeholders out for actual values and she does NOT make it complicated.

---

🦋 NODE NAME 🦋

the node name is VAR. that's how you call her in your template. short, sweet, all caps, main character energy fr fr.

---

🌸 INHERITANCE 🌸

she inherits from Excel::Template::Element, which is giving "she learned everything she knows from her parent and then added nothing because she already ate." lowkey respect.

---

💜 ATTRIBUTES 💜

• NAME — this is the name of the parameter you want to substitute right here, right now. that's the one and only attribute. she's a minimalist, she's curated, she's not gonna make you learn forty flags.

---

🌈 CHILDREN 🌈

None. she has no children. she's a solo act. a lone wolf. a single independent queen who needs nobody. 😌

---

⭐ EFFECTS ⭐

None. no side effects, no chaos, no mess. she substitutes and she leaves. we love a clean exit. 🧚

---

🍓 DEPENDENCIES 🍓

ok important note bestie — she will only be used within CELL tags. that's it. if you try to use her somewhere else she simply will not show up, so don't do that to yourself. 🙈

---

💅 USAGE 💅

so here's the tea: she works exactly like HTML::Template's TMPL_VAR. same energy, same behaviour, no cap.

but there's one exception — and this is the fun part — because you can have variable names inside the parameters, you can do something like this:

<loop name="LOOPY">
  <var name="$SomeParam"/>
</loop>

where the actual name to be substituted is, itself, a parameter. yes, it's a variable naming a variable. it's meta. it's nested. it's giving inception. 🔥

---

👑 AUTHOR 👑

Rob Kinyon (rob.kinyon@gmail.com) — thank you for your service, king. 🫡

---

🔍 SEE ALSO 🔍

• CELL — go look at this one too, since that's the only place our girl is allowed to live. 🏠

---

and that's the whole page, bestie!! this was perl v5.34.0, dated 2022-06-13, and that's your cute lil sign-off — go forth and substitute those parameters, you absolute legend 💖✨🎀🦋