How-to
Website
Web app
Run a script after each page draws
A script that finds elements itself, with querySelectorAll, has to run after the page is drawn. The page is drawn after your scripts run, drawn again over a pre-rendered page, and drawn anew on every route, so the script listens for the wf:render event on document. This page shows Markdown with links to other sites, and a script opens each of them in a new tab:
Needs: the script src/new-tab.js, shown below.
const NOTES = """
Read the [WebFluent guide](https://webfluent.monzeromer.dev/docs), or
the [MDN page on links](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a).
"""
page Notes(path: "/notes", title: "Notes", description: "Links in Markdown that open in a new tab.") {
Heading("Notes").h1
Markdown(NOTES, class: "notes")
}
The script is a plain file under src/ (Call your own JavaScript):
// src/new-tab.js
document.addEventListener("wf:render", (e) => {
// e.detail.route is the route that was drawn, e.detail.params its parameters.
for (const a of document.querySelectorAll(".notes a")) {
const href = a.getAttribute("href") || "";
if (a.hasAttribute("target") || !href.startsWith("http")) continue;
a.setAttribute("target", "_blank");
a.setAttribute("rel", "noopener noreferrer");
}
});
How it works
- The build links the script on every page before the compiled code, so the listener is in place before the first drawing.
wf:renderfires ondocumentonce per drawing: the first mount, the takeover of a pre-rendered page, and every route.e.detailcarries theroutethat was drawn and itsparams.- The script skips a link that already has a
target, so a second drawing of the same page changes nothing twice. - The links come from
Markdown, which writes them itself, so the page has no element of its own to put atargeton. The script adds it, withrel="noopener noreferrer"beside it so the new tab cannot reach back into this one.
Variations
wf:render does not fire for an if branch or a list item that arrives later. For an element that comes and goes inside a page, hand it to the script with mount: instead (Hand an element to a script).