I made a plugin that enables using the browser Back and Forward buttons to navigate between recent tiddlers. This can be useful when e.g. copy-pasting data between multiple tiddlers.
The functionality is super-charged when you have mouse gestures set up in your browser.
Get it here:
Browser History Plugin
Overview
When $:/config/Navigation/UpdateHistory is set to yes and $:/config/Navigation/UpdateAddressBar is set to no, TiddlyWiki integrates with the browser’s history API, allowing users to navigate through their tiddler history using the browser’s back and forward buttons.
You can change these values using the Settings tab in $:/ControlPanel under the headings Navigation Address Bar and Navigation History.
Configuration
Required Settings
-
$:/config/Navigation/UpdateAddressBar must be set to
no(“Do not update the address bar”) -
$:/config/Navigation/UpdateHistory must be set to
yes(“Update history”)
Optional Settings
- $:/config/Navigation/HistoryBackstopTiddler specifies a tiddler to show when reaching the beginning of the history stack, see History Backstop Feature below. Navigating back once more from this tiddler will leave the wiki or trigger an unsaved changes warning. Default value for the tiddler to show is $:/plugins/yaisog/ui/HistoryBackstopWarning.
- $:/config/Navigation/HistoryExcludeList is an optional exclude title list. Any tiddlers listed here will not be added to the browser history.
Draft Tiddler Handling
For draft tiddlers, the original tiddler title is saved to history so that history entries remain valid after drafts are saved or cancelled (unless the tiddler is renamed). When history navigation would open a tiddler that has a draft, the draft is opened instead.
History Backstop Feature
The history backstop feature shows a warning tiddler or executes predefined actions before leaving the wiki via further browser history navigation. The warning is not shown when navigating to a different URL or closing the browser tab or window.
Backstop Actions
When navigating back to the history backstop tiddler, you can trigger custom action widgets by tagging tiddlers with $:/tags/HistoryEndActions. These actions are executed instead of the normal navigation behavior. If you want to show the warning tiddler and execute actions, include an $action-navigate widget as part of your actions.
Common use cases:
- Display a custom message or interface when the user reaches the beginning of history
- Navigate to a specific tiddler or view
- Perform cleanup or state management tasks