From cde8ea497916b497bb1ec6e0e2d760848d575040 Mon Sep 17 00:00:00 2001 From: Aaron Kimbrell Date: Tue, 29 Sep 2026 02:10:04 -0500 Subject: [PATCH] docs: goTo, reloadInPlace and dash:refreshed for page scripts Check: docs/Dashboard.md, Live updates: the page-scripts paragraph names goTo(url) and reloadInPlace() and says when dash:refreshed is used. Co-Authored-By: Claude Opus 5.5 --- docs/Dashboard.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/Dashboard.md b/docs/Dashboard.md index 6500f90dd..4ca0b9209 100644 --- a/docs/Dashboard.md +++ b/docs/Dashboard.md @@ -373,9 +373,10 @@ them load normally. Leaving a page with unsaved changes (Settings, Vanity) asks For page scripts (`static/js/nav.js`): listeners a page adds to `document` or `window`, its `setInterval` timers, its `Live` watchers and its DataTables are removed when another page is swapped in; its scripts run again when it's opened again, and `DOMContentLoaded`/`load` handlers they add run once they have all run. Elements a page appends to `` -are removed unless marked `data-nav-keep`. `Nav.go(url)` opens a page, `Nav.refresh()` updates the current one in place. -`document` gets `dash:page` after a page is swapped in, `dash:leave` before, and `dash:refreshed` after an in-place -update. A page that must always load on its own adds `data-nav="reload"` to any element; a link with `data-nav="off"` +are removed unless marked `data-nav-keep`. `Nav.go(url)` opens a page, `Nav.refresh()` updates the current one in place; +`goTo(url)` and `reloadInPlace()` (`common.js`) do the same, or load normally without `nav.js`. `document` gets +`dash:page` after a page is swapped in, `dash:leave` before, and `dash:refreshed` after an in-place update (pages that +format server values in the browser, like times, do it again then). A page that must always load on its own adds `data-nav="reload"` to any element; a link with `data-nav="off"` always loads normally. View choices you make on the pages (show staff, filters, the 3D viewer's switches, ...) are saved to your account, so