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:

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