1
0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-12-13 19:50:29 +00:00
TiddlyWiki5/editions/tw5.com/tiddlers/messages/WidgetMessage_ tm-new-tiddler.tid

48 lines
1.8 KiB
Plaintext
Raw Normal View History

caption: tm-new-tiddler
created: 20140226194405353
modified: 20230723215831560
2014-09-11 14:52:47 +00:00
tags: Messages navigator-message
2014-08-28 20:43:44 +00:00
title: WidgetMessage: tm-new-tiddler
type: text/vnd.tiddlywiki
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:
|!Name |!Description |
2014-11-26 11:22:20 +00:00
|param |The 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. |
|navigateFromTitle |Title 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
2014-11-26 11:22:20 +00:00
* 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
2014-10-21 12:25:27 +00:00
The new tiddler message is usually generated with the ButtonWidget or ActionSendMessageWidget and is handled by the NavigatorWidget.
2014-07-24 22:07:02 +00:00
! Examples
2014-07-24 22:07:02 +00:00
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:
2014-07-24 22:07:02 +00:00
```
2014-08-28 20:43:44 +00:00
<$button message="tm-new-tiddler" param="TaskTemplate">New Task</$button>
2014-07-24 22:07:02 +00:00
```
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>
```