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

WidgetMessage: tm-new-tiddler

7th November 2014 at 1:21pm
Messages navigator-message

The new tiddler message creates a new draft tiddler and adds it to the current story. It requires the following properties on the event object:

NameDescription
paramThe optional title of a tiddler to use as a template for the new tiddler
paramObjectOptional hashmap of additional tiddler fields
navigateFromTitleTitle of the tiddler from which the navigation to the new tiddler was initiated

The title for the draft tiddler is chosen according to these rules:

  • If a hashmap was used and a title field was specified, use that title
  • If a template tiddler was used, use the title of the template tiddler, making it unique with a numeric suffix
  • Otherwise, generate a new title based on the default new tiddler title with a numeric suffix to make it unique

The new tiddler message is usually generated with the ButtonWidget or ActionSendMessageWidget and is handled by the NavigatorWidget.

Examples

To make a button that creates new tiddlers tagged "task", create a tiddler called "TaskTemplate" with that tag, and then make your button like this:

<$button message="tm-new-tiddler" param="TaskTemplate">New Task</$button>

To create a new tiddler with given attributes rather than from a template:

<$button>
<$action-sendmessage $message="tm-new-tiddler" title="This is newly created tiddler" tags="OneTag [[Another Tag]]" text=<<now "Today is DDth, MMM YYYY">>/>
New Tiddler
</$button>