tiddlywiki 5.3.7 → 5.4.0

package/editions/tw5.com/tiddlers/hire-jeremy/HireJeremyStyles.tid

@@ -0,0 +1,163 @@
+title: $:/HireJeremy/styles
+tags: [[$:/tags/Stylesheet]]
+type: text/vnd.tiddlywiki
+
+\define sidebarbreakpoint()
+<$text text={{$:/themes/tiddlywiki/vanilla/metrics/sidebarbreakpoint}}/>
+\end
+
+\define sidebarbreakpoint-minus-one()
+<$text text={{{ [{$:/themes/tiddlywiki/vanilla/metrics/sidebarbreakpoint}removesuffix[px]subtract[1]addsuffix[px]] ~[{$:/themes/tiddlywiki/vanilla/metrics/sidebarbreakpoint}] }}}/>
+\end
+
+.yellow-note, [data-tiddler-title="Hire the founder of TiddlyWiki"] {
+	z-index: 800;
+	margin-top: 2em;
+	transform-origin: 50% 50%;
+	transition: transform 200ms ease-in-out;
+	transform: rotate(-0.6deg) scale(1);
+	background-color: #ffff92;
+	color: black;
+	box-shadow: 6px 6px 14px 0px rgba(0, 0, 0, 0.3);
+	border: 1px solid #cccc40;
+	text-shadow: 0 1px 0 #ffffff;
+}
+
+.yellow-note:hover, [data-tiddler-title="Hire the founder of TiddlyWiki"]:hover {
+	transform: rotate(-0deg) scale(1.03);
+}
+
+@media (max-width: <<sidebarbreakpoint-minus-one>>) {
+
+.yellow-note, [data-tiddler-title="Hire the founder of TiddlyWiki"] {
+	transform: rotate(-0.6deg) scale(0.9);
+}
+
+.yellow-note:hover, [data-tiddler-title="Hire the founder of TiddlyWiki"]:hover {
+	transform: rotate(-0deg) scale(1.03);
+}
+
+}
+
+.yellow-note h2.tc-title, [data-tiddler-title="Hire the founder of TiddlyWiki"] h2.tc-title {
+	margin: 0.5em 0;
+	color: #334;
+	font-weight: bold;
+}
+
+[data-tiddler-title="Hire the founder of TiddlyWiki"] .tc-tags-wrapper, [data-tiddler-title="Hire the founder of TiddlyWiki"] .tc-subtitle {
+	display: none;
+}
+
+.yellow-note p, [data-tiddler-title="Hire the founder of TiddlyWiki"] p {
+	margin: 0.5em 0;
+}
+
+.yellow-note .tc-tiddler-body h1, [data-tiddler-title="Hire the founder of TiddlyWiki"] .tc-tiddler-body h1 {
+	margin: 0.25em 0;
+	font-weight: bold;
+}
+
+.yellow-note .tc-tiddler-body a, [data-tiddler-title="Hire the founder of TiddlyWiki"] .tc-tiddler-body a {
+	color: #5778d8;
+}
+
+[data-tiddler-title="Hire the founder of TiddlyWiki"] .tc-btn-big-green {
+	margin: 0;
+	padding: 0;
+	text-align: left;
+	width: 100%;
+	color: #334;
+	font-weight: bold;
+	background-color: inherit;
+}
+
+@media (min-width: <<sidebarbreakpoint>>) {
+
+[data-tiddler-title="Hire the founder of TiddlyWiki"] .tc-btn-big-green {
+	margin-left: -1.35em;
+}
+
+}
+
+[data-tiddler-title="Hire the founder of TiddlyWiki"] .tc-btn-big-green svg {
+	fill: #cece86;
+}
+
+.yellow-note-sidebar-wrapper {
+	overflow-y: hidden;
+	max-height: {{{ [[$:/StoryList]contains[Hire the founder of TiddlyWiki]then[0em]else[15em]] }}};
+	transition: max-height 600ms ease-in-out;
+}
+
+.yellow-note-sidebar {
+	font-size: 2em;
+	text-align: center;
+	line-height: 1.3;
+	max-width: 8.5em;
+}
+
+.yellow-note-sidebar .yellow-note {
+	padding: 0.5em;
+	margin: 1em 0;
+	transform: perspective(600px) rotateX(10deg) rotateY(5deg) scale(0.9);
+	transform-style: preserve-3d;
+}
+
+.yellow-note-sidebar:hover .yellow-note {
+	transform: perspective(900px) rotateX(5deg) rotateY(10deg) scale(0.95);
+	transform-style: preserve-3d;
+}
+
+.yellow-note-sidebar:hover a {
+	text-decoration: none;
+}
+
+/* Thanks to https://codepen.io/dillonbrady/pen/EgRoZQ */
+
+.yellow-note-pin {
+	background-color: #aaa;
+	display: block;
+	height: 32px;
+	width: 2px;
+	position: absolute;
+	left: 50%;
+	top: -16px;
+	z-index: 1;
+}
+
+.yellow-note-pin:after {
+	background-color: #A31;
+	background-image: radial-gradient(25% 25%, circle, hsla(0,0%,100%,.3), hsla(0,0%,0%,.3));
+	border-radius: 50%;
+	box-shadow: inset 0 0 0 1px hsla(0,0%,0%,.1), inset 3px 3px 3px hsla(0,0%,100%,.2), inset -3px -3px 3px hsla(0,0%,0%,.2), 23px 20px 3px hsla(0,0%,0%,.15);
+	content: "";
+	height: 12px;
+	left: -5px;
+	position: absolute;
+	top: -10px;
+	width: 12px;
+}
+
+.yellow-note-pin:before {
+	background-color: hsla(0,0%,0%,0.1);
+	box-shadow: 0 0 .25em hsla(0,0%,0%,.1);
+	content: "";
+	height: 24px;
+	width: 2px;
+	left: 0;
+	position: absolute;
+	top: 8px;
+
+	transform: rotate(57.5deg);
+	-moz-transform: rotate(57.5deg);
+	-webkit-transform: rotate(57.5deg);
+	-o-transform: rotate(57.5deg);
+	-ms-transform: rotate(57.5deg);
+
+	transform-origin: 50% 100%;
+	-moz-transform-origin: 50% 100%;
+	-webkit-transform-origin: 50% 100%;
+	-ms-transform-origin: 50% 100%;
+	-o-transform-origin: 50% 100%;
+}

package/editions/tw5.com/tiddlers/howtos/Concatenating text and variables using macro substitution.tid

@@ -6,7 +6,7 @@ type: text/vnd.tiddlywiki
 
 !! Important
 
-<<.from-version "5.3.0">> It is recommended to use [[substituted attributes|Substituted Attribute Values]] or the [[substitute filter operator|substitute Operator]] to concatenate text and variables.
+Since <<.from-version "5.3.0">> it is recommended to use [[substituted attributes|Substituted Attribute Values]] or the [[substitute filter operator|substitute Operator]] to concatenate text and variables.
 
 It's a frequent use case in ~TiddlyWiki that you will want to put the results of variables together with various bits of strings of text. This process in some programming languages is often referred to as "concatenating" text.
 

package/editions/tw5.com/tiddlers/howtos/How to create dynamic editor toolbar buttons.tid

@@ -1,5 +1,5 @@
 created: 20201216182347597
-modified: 20211018102328148
+modified: 20260206104319886
 tags: 
 title: How to create dynamic editor toolbar buttons
 type: text/vnd.tiddlywiki
@@ -91,6 +91,9 @@ This tiddler contains all the necessary elements that are important for toolbar
 ; shortcuts
 : This is the [[Keyboard Shortcut Descriptor]] eg: `((temp-bold))`
 
+; button-classes <<.from-version "5.4.0">>
+: Additional CSS classes applied to the created button, definable as a list or filter expression
+
 <<<
 
 !! Disabled State

package/editions/tw5.com/tiddlers/howtos/How to create keyboard shortcuts.tid

@@ -1,30 +1,44 @@
+created: 20251209131215120
+modified: 20251209133619105
 tags: [[Customise TiddlyWiki]] Learning
 title: How to create keyboard shortcuts
 type: text/vnd.tiddlywiki
 
-<br>
-<<.tip """[[TiddlyWiki]] distinguishes two types of keyboard shortcuts. Those that are limited to work within <$macrocall $name=".tag" _="input"/> fields or <$macrocall $name=".tag" _="textareas"/> which are handled by the <$macrocall $name=".wlink" to="KeyboardWidget"/> widget and keyboard shortcuts that work globally - which means that only the page needs to have focus in order for them to be accessible. The latter are handled by a mechanism that starts to work when a wiki is loaded""">>
+\define tv-show-missing-links() no
 
+!! Introduction
 
-!! The configuration mechanism is the same for both shortcut-types
+~TiddlyWiki distinguishes two types of keyboard shortcuts:
 
-<$vars tv-show-missing-links="no">
+# Those that are limited to work within <$macrocall $name=".tag" _="input"/> fields or <$macrocall $name=".tag" _="textareas"/> which are handled by the <$macrocall $name=".wlink" to="KeyboardWidget"/> widget 
 
-A tiddler with the <<.def prefix>> `$:/config/ShortcutInfo/` and a ''unique suffix'' appended, like `my-shortcut`, makes the new shortcut appear in the $:/ControlPanel within the [[Keyboard Shortcuts Tab|$:/core/ui/ControlPanel/KeyboardShortcuts]]. An optional description can be added within its text field
+# Keyboard shortcuts that work globally, which means that only the page needs to have focus in order for them to be accessible
+
+The latter are handled by a mechanism that starts to work when a wiki is loaded
+
+!! Configuration Mechanism
+
+''The configuration mechanism is the same for both shortcut-types''.
+
+A tiddler with the ''prefix'' `$:/config/ShortcutInfo/` and a ''unique suffix'' appended, like `my-shortcut`, makes the new shortcut appear in the $:/ControlPanel within the [[Keyboard Shortcuts Tab|$:/core/ui/ControlPanel/KeyboardShortcuts]]. An optional description can be added within its text field
 
 In the [[Keyboard Shortcuts Tab|$:/core/ui/ControlPanel/KeyboardShortcuts]] the ''key combination'' that should trigger the shortcut can be configured:
 
-> Look for the ''unique suffix'' defined for the new shortcut and click the <$button class="tc-btn-invisible"><<.icon $:/core/images/edit-button>><$action-sendmessage $message="tm-notify" $param="$:/core/images/edit-button"/></$button> button to open a popup that detects ''key combinations'' and shows the detected combination in its input field
+<<<
+ Look for the ''unique suffix'' defined for the new shortcut and click the <$button class="tc-btn-invisible"><<.icon $:/core/images/edit-button>><$action-sendmessage $message="tm-notify" $param="$:/core/images/edit-button"/></$button> button to open a popup that detects ''key combinations'' and shows the detected combination in its input field
 
->The ''add shortcut'' assigns the key-combination to the shortcut
+The ''add shortcut'' assigns the key-combination to the shortcut
+<<<
 
-!!! Depending on the chosen platform the configuration mechanism creates a tiddler with a specific nomenclature
+Depending on the chosen platform the configuration mechanism creates a tiddler with a specific nomenclature
 
-> $:/config/shortcuts/ + the ''shortcut suffix'' for shortcuts that will work on all platforms (operating systems)
+<<<
+$:/config/shortcuts/ + the ''shortcut suffix'' for shortcuts that will work on all platforms (operating systems)
 
-> $:/config/shortcuts-(mac/not-mac/windows/not-windows/linux/not-linux)/ + the ''shortcut suffix'' for shortcuts that will work on the chosen platform only or that will not work on the excluded platform
+$:/config/shortcuts-(mac/not-mac/windows/not-windows/linux/not-linux)/ + the ''shortcut suffix'' for shortcuts that will work on the chosen platform only or that will not work on the excluded platform
+<<<
 
-!!! Examples
+!!! Shortcut Configuration Examples
 
 * $:/config/shortcuts/`my-shortcut`
 * $:/config/shortcuts-mac/`my-shortcut`
@@ -34,15 +48,14 @@ In the [[Keyboard Shortcuts Tab|$:/core/ui/ControlPanel/KeyboardShortcuts]] the
 * $:/config/shortcuts-not-windows/`my-shortcut`
 * $:/config/shortcuts-not-linux/`my-shortcut`
 
-<<.tip """Note that those platform-specific tiddlers don't have to be created manually if the ''ShortcutInfo'' tiddler as mentioned above is created first and the shortcut is configured in the ~ControlPanel""">>
+<<.note """Those platform-specific tiddlers don't have to be created manually if the ''ShortcutInfo'' tiddler as mentioned above is created first and the shortcut is configured in the ~ControlPanel""">>
 
-<br>
-
-!! At this point the shortcut is defined and its ''actions'' can be configured
+''At this point the shortcut is defined and its ''actions'' can be configured''
 
 !! Using the [[Keyboard Widget|KeyboardWidget]]
 
-> A <<.wlink "KeyboardWidget">> widget detects the key combinations pressed within an <<.tag input>> or <<.tag textarea>> field within its scope. The <<.wlink "KeyboardWidget">> widget needs to "embrace" the <<.tag input>> or <<.tag textarea>> field and its <<.attr key>> attribute either points to a configuration tiddler using the [[Key Descriptor]] Syntax or explicitely contains the key
+<<<
+A <<.wlink "KeyboardWidget">> widget detects the key combinations pressed within an <<.tag input>> or <<.tag textarea>> field within its scope. The <<.wlink "KeyboardWidget">> widget needs to "embrace" the <<.tag input>> or <<.tag textarea>> field and its <<.attr key>> attribute either points to a configuration tiddler using the [[Key Descriptor]] Syntax or explicitely contains the key
 
 ```
 <$keyboard key="((my-shortcut))" actions='<$action-setfield $tiddler="my-tiddler" $field="my-field" $value="my-value"/>'>
@@ -60,47 +73,45 @@ In the [[Keyboard Shortcuts Tab|$:/core/ui/ControlPanel/KeyboardShortcuts]] the
 </$keyboard>
 ```
 
-> If actions are defined , the <<.wlink KeyboardWidget>> widget will invoke the actions defined in its <<.attr actions>> attribute when it detects the key-combination defined in its <<.attr key>> attribute being pressed in any <<.tag input>> or <<.tag textarea>> field within its scope
-
-<br>
+If actions are defined , the <<.wlink KeyboardWidget>> widget will invoke the actions defined in its <<.attr actions>> attribute when it detects the key-combination defined in its <<.attr key>> attribute being pressed in any <<.tag input>> or <<.tag textarea>> field within its scope
+<<<
 
 !! Using global Keyboard Shortcuts
 
-> See [[Keyboard Shortcut Tiddler]] for detailed information about creating new global keyboard shortcuts.
+<<<
+
+See [[Keyboard Shortcut Tiddler]] for detailed information about creating new global keyboard shortcuts.
 
-> The actions for ''global'' keyboard shortcuts are stored in the ''text'' field of tiddlers tagged with <<tag $:/tags/KeyboardShortcut>>
+The actions for ''global'' keyboard shortcuts are stored in the ''text'' field of tiddlers tagged with <<tag $:/tags/KeyboardShortcut>>
 
-> The ''key field'' connects an action-tiddler with the corresponding shortcut through the `((my-shortcut))` syntax, called [[Keyboard Shortcut Descriptor]]
+The ''key field'' connects an action-tiddler with the corresponding shortcut through the `((my-shortcut))` syntax, called [[Keyboard Shortcut Descriptor]]
 
-:<h3> Syntax: `((` + `a chosen suffix` + `))` </h3>
+; Syntax
+: `((` + `a chosen suffix` + `))`
 
-> If the tiddler has the tag <<tag $:/tags/KeyboardShortcut>>, the field ''key'' with the [[Keyboard Shortcut Descriptor]] as its value and some actions in its text field, the actions will be triggered when the mechanism detects the configured key-combination
+If the tiddler has the tag <<tag $:/tags/KeyboardShortcut>>, the field ''key'' with the [[Keyboard Shortcut Descriptor]] as its value and some actions in its text field, the actions will be triggered when the mechanism detects the configured key-combination
 
-<br>
-<$macrocall $name=".tip" _="""''Macros'' defined ''outside'' a global keyboard-shortcut (through a tiddler tagged `$:/tags/Global`) need to be ''imported'' in order to be accessible.
+<$macrocall $name=".note" _="""''Macros'' defined ''outside'' a global keyboard-shortcut (through a tiddler tagged `$:/tags/Global`) need to be ''imported'' in order to be accessible.
 The [[import pragma|Pragma]] can be used for that"""/>
 
-<pre>
+```
 \import [subfilter{$:/core/config/GlobalImportFilter}]
-</pre>
+```
 
 If the tiddler that contains the macro definition is known and - for example - titled `my-macro-tiddler`
 
-<pre>
+```
 \import [[my-macro-tiddler]]
-</pre>
+```
+
+<$macrocall $name=".note" _="""Some actions require to be wrapped within a <<.wlink NavigatorWidget>> widget. That is necessary for the following list of widgets and messages in order to work if used within global keyboard shortcuts"""/>
 
-<br>
-<$macrocall $name=".tip" _="""Some actions require to be wrapped within a <<.wlink NavigatorWidget>> widget. That is necessary for the following list of widgets and messages in order to work if used within global keyboard shortcuts"""/>
+<<<
 
 !!! Widgets
 
-<<.wlink ActionNavigateWidget>> (ActionNavigateWidget)
+* <<.wlink ActionNavigateWidget>> (ActionNavigateWidget)
 
 !!! Messages
 
-<$list filter="[tag[navigator-message]]">
-<$link/><br>
-</$list>
-
-</$vars>
+<<list-links filter:"[tag[navigator-message]]"  class:"multi-columns">>

package/editions/tw5.com/tiddlers/images/Community Survey 2025 Image.webp.meta

@@ -0,0 +1,4 @@
+alt-text: Shape the future by taking the TiddlyWiki Community Survey 2025
+tags: picture
+title: Community Survey 2025 Image
+type: image/webp

package/editions/tw5.com/tiddlers/images/Intertwingled Innovations Image.webp.meta

@@ -0,0 +1,3 @@
+title: Intertwingled Innovations Image
+type: image/webp
+tags: picture

package/editions/tw5.com/tiddlers/images/MWS Banner.webp.meta

@@ -0,0 +1,6 @@
+alt-text: Banner for the new Multi Wiki Server plugin for TiddlyWiki
+created: 20250718090840336
+modified: 20250718091156532
+tags: picture
+title: MWS Banner
+type: image/webp

package/editions/tw5.com/tiddlers/images/Marketplace Banner.webp.meta

@@ -0,0 +1,4 @@
+title: TiddlyWiki Marketplace Banner
+type: image/webp
+tags: picture
+alt-text: Motovun Jack with a shopping cart. Blue floor, orange background.

package/editions/tw5.com/tiddlers/images/New Release Banner.webp.meta

@@ -0,0 +1,4 @@
+title: New Release Banner
+type: image/webp
+tags: picture
+alt-text: Release banner, with a custom background and a release version in big letters.

package/editions/tw5.com/tiddlers/images/TW5-Graph.png.meta

@@ -0,0 +1,4 @@
+title: TW5-Graph.png
+type: image/png
+tags: picture
+alt-text: TW5-Graph and data visualization

package/editions/tw5.com/tiddlers/images/Tiddler Poster.webp.meta

@@ -0,0 +1,5 @@
+title: Tiddler Poster
+type: image/webp
+source: https://tiddlywiki.com/poster
+tags: picture
+alt-text: Poster with a headline: Your messy thoughts. Organized. Below is an abstract Stickleback fish and tiddlywiki.com URL.

package/editions/tw5.com/tiddlers/images/TiddlyFox Apocalypse.webp.meta

@@ -0,0 +1,4 @@
+title: TiddlyFox Apocalypse Badge
+type: image/webp
+tags: picture
+alt-text: Motovun Jack's head with a FireFox logo over the head and a date: Nov. 14th 2017 on the left.

package/editions/tw5.com/tiddlers/images/TiddlyWiki Classic.webp.meta

@@ -0,0 +1,4 @@
+title: TiddlyWiki Classic
+type: image/webp
+tags: picture
+alt-text: TiddlyWiki classic screenshto thumbnail.

package/editions/tw5.com/tiddlers/images/TiddlyWiki Donation Graphic.webp.meta

@@ -0,0 +1,4 @@
+alt-text: Motovun Jack appreciates incoming donations
+tags: picture
+title: TiddlyWiki Donation Graphic
+type: image/webp

package/editions/tw5.com/tiddlers/images/TiddlyWiki Newsletter Badge.webp.meta

@@ -0,0 +1,4 @@
+alt-text: Motovun Jack reads a Newsletter.
+tags: picture
+title: TiddlyWiki Newsletter Badge
+type: image/webp

package/editions/tw5.com/tiddlers/images/TiddlyWiki Privacy Badge.webp.meta

@@ -0,0 +1,4 @@
+created: 20250718090420319
+modified: 20250718090424617
+title: TiddlyWiki Privacy Badge
+type: image/webp

package/editions/tw5.com/tiddlers/images/Twenty Years of TiddlyWiki.webp.meta

@@ -0,0 +1,4 @@
+title: Twenty Years of TiddlyWiki
+type: image/webp
+tags: picture
+alt-text: Screenshot of TiddlyWiki from 20th September 2004 with a banner reading "Twenty Years"

package/editions/tw5.com/tiddlers/macros/StylesheetMacros.tid

@@ -1,25 +1,10 @@
 created: 20150221181835000
-modified: 20230803034031256
+modified: 20251101090648379
 tags: Macros [[Core Macros]]
 title: Stylesheet Macros
 type: text/vnd.tiddlywiki
 
-The following core [[macros|Macros]] make it easy to specify alternative browser-specific properties when constructing a [[stylesheet|Cascading Style Sheets]] tiddler:
-
-;`<<box-shadow shadow>>`
-: for the `x-box-shadow` properties
-;`<<filter filter>>`
-: for the `x-filter` properties
-;`<<transition transition>>`
-: for the `x-transition` properties
-;`<<transform-origin origin>>`
-: for the `x-transition-origin` properties
-;`<<background-linear-gradient gradient>>`
-: for the `x-linear-gradient` values of the `background-image` property
-;`<<column-count columns>>`
-: for the `x-column-count` property
-
-The following macros are documented separately:
+The following stylesheet macros are documented separately:
 
 * <<.mlink colour>>
 * <<.mlink datauri>>

package/editions/tw5.com/tiddlers/macros/TableOfContentsMacro.tid

@@ -1,5 +1,5 @@
 created: 20140919155729620
-modified: 20240624102502089
+modified: 20260124130054271
 tags: Macros [[Core Macros]]
 title: Table-of-Contents Macros
 type: text/vnd.tiddlywiki
@@ -74,6 +74,9 @@ These two parameters are combined into a single [[filter expression|Filter Expre
 ; exclude <<.from-version "5.3.0">>
 : This optional parameter can be used to exclude tiddlers from the TOC list. It allows a [[Title List]] or a <<.olink subfilter>>. Eg: `exclude:"HelloThere [[Title with spaces]]"` or `exclude:"[has[excludeTOC]]"`. Where the former will exclude two tiddlers and the later would exclude every tiddler that has a field <<.field excludeTOC>> independent of its value.<br>''Be aware'' that eg: `[prefix[H]]` is a shortcut for `[all[tiddlers]prefix[H]]`, which can have a performance impact, if used carelessly. So use $:/AdvancedSearch -> ''Filters'' tab to test the <<.param exclude>> parameter
 
+; level <<.from-version "5.4.0">>
+: This optional parameter can be used to define how many toc levels are shown by the toc-macro. By default all levels are shown. 
+
 !! Custom Icons
 
 <<.from-version "5.2.4">>

package/editions/tw5.com/tiddlers/macros/examples/tabs.tid

@@ -12,3 +12,15 @@ eg="""<<tabs "[tag[sampletab]]" "SampleTabTwo" "$:/state/tab2" "tc-vertical">>""
 
 <$macrocall $name=".example" n="3"
 eg="""<<tabs "[tag[sampletab]nsort[order]]" "SampleTabThree" "$:/state/tab3" "tc-vertical">>"""/>
+
+The following example sets the default tab to be the first tiddler selected in the filter and makes the saved state non-persistent (by using "~$:/temp/"):
+
+<$macrocall $name=".example" n="4"
+eg="""<$set name=tl filter="[tag[sampletab]nsort[order]]">
+<$transclude $variable=tabs tabsList=<<tl>> default={{{[enlist<tl>]}}} state="$:/temp/state/tab" class="tc-vertical"/>
+</$set>"""/>
+
+<<.from-version "5.4.0">> Dynamic parameters can be used to specify the default tab:
+
+<$macrocall $name=".example" n="5"
+eg="""<<tabs "[tag[sampletab]nsort[order]]" default={{{[tag[sampletab]nsort[order]]}}} state="$:/temp/state/tab" class="tc-vertical">>"""/>

package/editions/tw5.com/tiddlers/macros/list-links-draggable Macro.tid

@@ -1,6 +1,6 @@
 caption: list-links-draggable
 created: 20170328204925306
-modified: 20211214141650488
+modified: 20260206131823536
 tags: Macros [[Core Macros]]
 title: list-links-draggable Macro
 type: text/vnd.tiddlywiki
@@ -9,21 +9,39 @@ The <<.def list-links-draggable>> [[macro|Macros]] renders the ListField of a ti
 
 !! Parameters
 
-;tiddler
+; tiddler
 : The title of the tiddler containing the list
-;field
+: <<.from-version 5.4.0>> If the tiddler parameter is not defined it defaults to: <<.var currentTiddler>>
+
+; field
 : The name of the field containing the list (defaults to `list`)
-;emptyMessage
+
+; emptyMessage
 : Optional wikitext to display if there is no output (tiddler is not existed, field is not existed or empty)
-;type
+
+; type
 : The element tag to use for the list wrapper (defaults to `ul`)
-;subtype
+
+; subtype
 : The element tag to use for the list items (defaults to `li`)
-;class
+
+; class
 : Optional space separated classes to add to the wrapper element
-;itemTemplate
+
+; itemTemplate
 : Optional title of a tiddler to use as the template for rendering list items
 
+; displayField <<.from-version 5.4.0>>
+: Optional name of the field to display when the list is rendered. Defaults to the "caption" field; if "caption" is not present, the "title" field is used instead
+
+; startactions <<.from-version "5.4.0">>
+: Optional action string that gets invoked when link ''dragging starts''
+: <<.var actionTiddler>> variable is available in this action
+
+; endactions <<.from-version "5.4.0">>
+: Optional action string that gets invoked when link ''dragging ends'' 
+: <<.var actionTiddler>> variable is available in this action
+
 If the `itemTemplate` parameter is not provided then the list items are rendered as simple links. Within the `itemTemplate`, the [[currentTiddler Variable]] refers to the current list item.
 
 <<.macro-examples "list-links-draggable">>

package/editions/tw5.com/tiddlers/macros/list-tagged-draggable Macro.tid

@@ -1,6 +1,6 @@
 caption: list-tagged-draggable
 created: 20170329092723939
-modified: 20180109171254045
+modified: 20260206131803841
 tags: Macros [[Core Macros]]
 title: list-tagged-draggable Macro
 type: text/vnd.tiddlywiki
@@ -9,16 +9,30 @@ The <<.def list-tagged-draggable>> [[macro|Macros]] renders the tiddlers with a
 
 !! Parameters
 
-;tag
+; tag
 : The title of the tag
-;subFilter
+
+; subFilter
 : An optional subfilter to filter out unwanted items (eg `!tag[done]`)
-;itemTemplate
+
+; itemTemplate
 : Optional title of a tiddler to use as the template for rendering list items
-;emptyMessage
+
+; emptyMessage
 : Optional wikitext to display if there are no tiddlers with the specified tag
 
-Note that the [[ordering|Order of Tagged Tiddlers]] is accomplished by assigning a new list to the `list` field of the tag tiddler. Any `list-before` or `list-after` fields on any of the other tiddlers carrying the tag are also removed to ensure the `list` field is respected.
+; displayField <<.from-version 5.4.0>>
+: Optional name of the field to display when the list is rendered. Defaults to `title` field
+
+; startactions <<.from-version "5.4.0">>
+: Optional action string that gets invoked when link ''dragging starts'' 
+: <<.var actionTiddler>> variable is available in this action.
+
+; endactions <<.from-version "5.4.0">>
+: Optional action string that gets invoked when link ''dragging ends'' 
+: <<.var actionTiddler>> variable is available in this action
+
+Note that the [[ordering|Order of Tagged Tiddlers]] is accomplished by assigning a new list to the `list` field of the tag tiddler. Any `list-before` or `list-after` fields on any of the other tiddlers carrying the tag are also removed to ensure the `list` field is respected
 
 If the `itemTemplate` parameter is not provided then the list items are rendered as simple links. Within the `itemTemplate`, the [[currentTiddler Variable]] refers to the current list item.