wml::std::box(3)

💖 wml::std::box — bestie, we're building BOXES 💖

okay so this is wml::std::box(3) from the EN Tools manual, and it's literally the cutest little thing: it makes rectangular boxes. that's it. that's the whole job. and it ATE. 🎀

---

✨ NAME ✨

wml::std::box — Easily Create Rectangular Box

like, the name is the whole vibe. no notes. 👑

---

🌸 SYNOPSIS 🌸

#use wml::std::box

<box [attributes]>
...
</box>

see how clean that is?? #use it, wrap your stuff in <box>, boom. done. 💅

---

🦋 DESCRIPTION 🦋

so the <box> container tag takes whatever you put inside it and puts it in a nice rectangular box — and that box is built using an HTML <table> construct under the hood. it's giving "hiding the machinery behind a cute face," which honestly? iconic. ✨

---

💜 ATTRIBUTES 💜

every one of these goes on the <box> tag and each one is doing its own little job. let's go through them fr fr.

• header — this one is a whole personality switch, no cap. it flips between two totally different box variants. when header is present, you get a headlined box, made using one single table but with space GIFs. when header is missing, you get a standard box, made using two nested tables but without any space GIFs. two different builds, two different looks. pick your fighter. 🥊
• bgcolor — sets the background color of the box. the box's outfit. 💖
• fgcolor — sets the foreground (text) color of the box. the box's lip gloss. 💄
• bdcolor — sets the color for the border of the box. lowkey the drama of this one is that it automatically generates a nested table construct to achieve the optical effect. it's doing extra work for the look. respect. ✨
• bdspace — sets the space between the border and the body of the box, in pixels. default is 4 pixel. personal space matters bestie 🫶
• bdwidth — sets the border width in pixels. default is 1 pixel.
• width — sets the total table width in pixels. default is no specific width for the standard box and 300 pixels for the headlined box — and the reason is that the headlined variant needs to know a fixed size to create the GIFs accordingly. it just has to know. it's a fixed-size girlie. 😭
• summary — adds a description of this table. this attribute is recommended in HTML 4.0. accessibility queen behavior, we love to see it. 👑

---

🌈 EXAMPLE 🌈

here's both variants doing their thing, side by side, exactly as written:

<box bdcolor="#000000" bdwidth=1 bdspace=10
     bgcolor="#ffffff" fgcolor="#000000">
Foo Bar Quux
</box>

<box header="Foo Bar Quux Header"
     bdcolor="#000000" bdwidth=1 bdspace=10
     bgcolor="#ffffff" fgcolor="#000000">
Foo Bar Quux
</box>

first one: standard box, no header, nested-table build. second one: same colors and spacing but WITH header, so it's the headlined variant. same body text Foo Bar Quux in both, different construction entirely. the way that one attribute changes everything… 😭💖

---

🎀 AUTHOR 🎀

shoutout to the legend who made this:

Ralf S. Engelschall
rse@engelschall.com
www.engelschall.com

---

⭐ REQUIRES ⭐

• Internal: P1, P2

---

🧚 SEE ALSO 🧚

the HTML <table> tag. that's the whole family tree. that's where all the magic lives. iykyk.

---

heads up bestie: this is a wml (EN Tools) page, so the #use and the <box> tags are meant for WML processing, not plain raw HTML you just yeet into a browser. 💅

---

and that's the page!! wml::std::box(3), EN Tools, dated 2020-11-29 — ty for coming to my TED talk, go make some rectangular boxes, mwah 🫶💖🌸