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

WidgetMessage: tm-new-tiddler

 23rd July 2023 at 9:58pm

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
{any other params}The names and values 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 additional parameters were 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 explicit parameters rather than by cloning a template tiddler:

<$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>

To create a new tiddler from a template with additional parameters:

 <$button>
 <$action-sendmessage $message="tm-new-tiddler" $param=<<currentTiddler>> fieldname="field value"/>
 New Tiddler
 </$button>
 ```