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

WidgetMessage: tm-rename-tiddler

9th September 2019 at 1:36pm
Messages navigator-message

The tm-rename-tiddler message renames a tiddler by deleting it and recreating it with a new title. The rename tiddler message requires the following properties on the event object:

NameDescription
fromCurrent title of tiddler
toNew title of tiddler
renameInTags New in: 5.1.23 Optional value "no" to disable renaming in tags fields of other tiddlers (defaults to "yes")
renameInLists New in: 5.1.23 Optional value "no" to disable renaming in list fields of other tiddlers (defaults to "yes")

The rename tiddler message is usually generated with the ButtonWidget and is handled by the NavigatorWidget.

Examples

To rename a tiddler called Tiddler1 to Tiddler2 and also renaming Tiddler1 in tags and list fields of other tiddlers:

<$action-sendmessage $message="tm-rename-tiddler" from="Tiddler1" to="Tiddler2" />

To rename a tiddler called Tiddler1 to Tiddler2 and not rename Tiddler1 in tags and list fields of other tiddlers:

<$action-sendmessage $message="tm-rename-tiddler" from="Tiddler1" to="Tiddler2" renameInTags="no" renameInLists="no"/>

To rename a tiddler called Tiddler1 to Tiddler2 and respect the setting in the tiddler $:/config/RelinkOnRename for whether to rename Tiddler1 in tags and list fields of other tiddlers:

<$action-sendmessage $message="tm-rename-tiddler" from="Tiddler1" to="Tiddler2" renameInTags={{$:/config/RelinkOnRename}} renameInLists={{$:/config/RelinkOnRename}}/>