This page is part of a static HTML representation of the TiddlyWiki at https://tiddlywiki.com/

list-links-draggable Macro

6th February 2026 at 1:18pm

The list-links-draggable macro renders the ListField of a tiddler as a list of links that can be reordered via drag and drop.

Parameters

tiddler
The title of the tiddler containing the list
New in v5.4.0 If the tiddler parameter is not defined it defaults to: currentTiddler
field
The name of the field containing the list (defaults to list)
emptyMessage
Optional wikitext to display if there is no output (tiddler is not existed, field is not existed or empty)
type
The element tag to use for the list wrapper (defaults to ul)
subtype
The element tag to use for the list items (defaults to li)
class
Optional space separated classes to add to the wrapper element
itemTemplate
Optional title of a tiddler to use as the template for rendering list items
displayField New in v5.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 New in v5.4.0
Optional action string that gets invoked when link dragging starts
actionTiddler variable is available in this action
endactions New in v5.4.0
Optional action string that gets invoked when link dragging ends
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.

Examples