wml::std::href(3)

💖 wml::std::href — Enhanced Hyperlink 💖

okay bestie, this is wml::std::href from the EN Tools manual pages, and it's literally the glow-up version of a hyperlink. no cap. let's get into it 🫶

---

✨ SYNOPSIS ✨

#use wml::std::href

<href url="..." [name="..."] [image="..."] [hint="..."] [target="..."]>

like, that's the whole vibe. one tag. you're welcome 💅

---

🌸 DESCRIPTION 🌸

so this is an interface to the standard HTML anchor tag (<a href="...">...</a>), but make it iconic. the whole intended use of <href> is to simplify the creation of hyperlinks, because typing out all that anchor nonsense by hand is giving 2003 and we are NOT doing that.

watch this. when you write:

<href url="THE://URL">

<href url="THE://URL" name="THE_NAME">
<href url="THE://URL" image="THE_IMG.EXT">

<href url="THE://URL" name="THE_NAME" image="THE_IMG.EXT">

<href url="THE://URL" hint="THE_HINT">
<href url="THE://URL" name="THE_NAME" image="THE_IMG.EXT" hint="THE_HINT">

it gets expanded to, like, this:

<a href="THE://URL"><tt>THE://URL</tt></a>

<a href="THE://URL">THE_NAME</a>
<a href="THE://URL"><img src="THE_IMG.EXT" alt="THE://URL" border="0"></a>

<a href="THE://URL"><img src="THE_IMG.EXT" alt="THE_NAME" border="0"></a>

<a href="THE://URL" onmouseover="self.status='THE_HINT';return true" onmouseout="self.status='';return true" onfocus="self.status='THE_HINT';return true" onblur="self.status='';return true"><tt>THE://URL</tt></a>
<a href="THE://URL" onmouseover="self.status='THE_HINT';return true" onmouseout="self.status='';return true" onfocus="self.status='THE_HINT';return true" onblur="self.status='';return true"><img src="THE_IMG.EXT" alt="THE_NAME" border="0"></a>

see how much typing you just got out of?? the <href> tag ate and left zero crumbs 🍓

heads up tho — peep the synopsis again: there's also a target="..." attribute in the tag signature, and the examples above show url, name, image and hint all doing their little thing. name becomes the link text, image becomes the <img src> (and its alt falls back to the url when there's no name), and hint wires up all four of those onmouseover / onmouseout / onfocus / onblur status-bar handlers. every single one of them. four handlers. she's thorough 💅

---

👑 AUTHOR 👑

this masterpiece was written by Ralf S. Engelschall:

• rse@engelschall.com
• www.engelschall.com

the main character energy is real 😭

---

🧚 REQUIRES 🧚

• Internal: P1, P2
• External: --

(yes, external is literally just --. she needs nothing from the outside world. self-sufficient queen 👑)

---

🌈 SEE ALSO 🌈

the HTML <a> and <img> tags. that's it, that's the family tree 🌳

---

okay and before you go, the little sign-off at the bottom of the original page said EN Tools and dated it 2020-11-29 — so that's your source, your version, and your timestamp, bestie. go forth and hyperlink responsibly 💖✨🎀🦋