@signalk/app-dock 1.3.3 → 1.4.0

package/README.md

@@ -31,7 +31,7 @@ Open: `http://your-sk-server:3000/@signalk/app-dock/`
 
 ## Usage
 
-**Double-tap anywhere** on the screen to open the dock. Tap an app icon to switch. The dock auto-dismisses after selection, or tap the backdrop to close it. Double-click works the same way for mouse users.
+**Double-tap anywhere** on the screen to open the dock. Tap an app icon to switch. Tap the icon of the app already on screen to reload it, for example after the app was updated on the server. The dock auto-dismisses after selection, or tap the backdrop to close it. Double-click works the same way for mouse users.
 
 Tip: double-tapping a clickable element in the underlying webapp will activate that element once before the dock opens -- aim double-taps at non-interactive regions (maps, gauge backgrounds, empty space).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signalk/app-dock",
-  "version": "1.3.3",
+  "version": "1.4.0",
   "description": "macOS-style configurable app dock for switching between SignalK webapps on touch screens",
   "repository": {
     "url": "https://github.com/SignalK/app-dock"

package/public/dock.js

@@ -626,6 +626,18 @@
     }
   }
 
+  // Reloads the frame at the page it is on now. A frame on another origin
+  // refuses access to its location, so it starts over at the app's URL.
+  function reloadFrame($frame, app) {
+    showLoading(app.label)
+    $frame.addEventListener('load', hideLoading, { once: true })
+    try {
+      $frame.contentWindow.location.reload()
+    } catch {
+      $frame.src = app.url
+    }
+  }
+
   function switchToApp(index) {
     const app = cfg.apps[index]
     if (!app) return
@@ -641,6 +653,16 @@
     const fresh = opensFresh(app)
     const alreadyLoaded = !fresh && !!iframes[app.url]
 
+    // Tapping the app already on screen reloads it where it is, so a webapp
+    // updated on the server is picked up without restarting the browser.
+    // destroy mode and fresh apps get a new frame below anyway.
+    if (alreadyLoaded && cfg.iframeMode !== 'destroy' && iframes[app.url].classList.contains('active')) {
+      reloadFrame(iframes[app.url], app)
+      updateHandle()
+      hideDock()
+      return
+    }
+
     if (cfg.iframeMode === 'destroy') {
       $iframeContainer.innerHTML = ''
       Object.keys(iframes).forEach((k) => delete iframes[k])