NewTiddlerWithFormMacro - Revision history

Dirkjan: Created page with "'''The newTiddlerWithForm Macro''' To create tiddlers that are referencing FormTemplates you may use the {{{<>}}} macro. The {{{<
2020-08-25T10:46:47Z

Created page with "'''The newTiddlerWithForm Macro''' To create tiddlers that are referencing FormTemplates you may use the {{{<<newTiddlerWithForm...>>}}} macro. The {{{<<ne..."

New page
'''The newTiddlerWithForm Macro'''

To create tiddlers that are referencing [[FormTemplate|FormTemplate]]s you may use the {{{<<newTiddlerWithForm...>>}}} macro.

The {{{<<newTiddlerWithForm...>>}}} macro displays a button. When pressed the button creates the requested tiddler and displays it.

If no title is given in the macro (or a tiddler with the given name already exists) the user can enter the tiddlers name in a dialog.

'''Syntax:'''
{| class="wikitable"
|>
|{{{<<}}}'''newTiddlerWithForm''' ''formTemplateName'' ''buttonLabel'' [''titleExpression'' ['''askUser''']] {{{>>}}}
|-
|''formTemplateName''
|The name of the tiddler that defines the form the new tiddler should use.
|-
|''buttonLabel''
|The label of the button
|-
|''titleExpression''
|A (quoted) JavaScript String expression that defines the title (/name) of the new tiddler.
|-
|'''askUser'''
|Typically the user is not asked for the title when a title is specified (and not yet used). When '''askUser''' is given the user will be asked in any case. This may be used when the calculated title is just a suggestion that must be confirmed by the user
|-
|>
|Syntax formatting: Keywords in '''bold''', optional parts in [...]. 'or' means that exactly one of the two alternatives must exist.
|-
|}
'''Examples'''
* Ask the user for a bug report name and create a bugreport.
{{{
<<newTiddlerWithForm BugReportTemplate "New Bugreport">>
}}}
<<newTiddlerWithForm BugReportTemplate "New Bugreport">>

* Create a blog entry tiddler. Let the user confirm the automatically generated title (that contains the current date) or change it.
{{{
<<newTiddlerWithForm
BlogTemplate
"New Blog"
'"Blog: "+(new Date()).formatString("YYYY-MM-DD")' askUser
>>
}}}
<<newTiddlerWithForm <missing '>>'>
BlogTemplate
"New Blog"
'"Blog: "+(new Date()).formatString("YYYY-MM-DD")' askUser
>>
=Using the build-in newTiddler macro=
Instead of the {{{<<newTiddlerWithForm>>}}} macro you may also use the build-in {{{<<newTiddler>>}}} macro to create tiddlers referencing [[FormTemplate|FormTemplate]]s. E.g. you may use the {{{<<newTiddler>>}}} macro to create a tiddler with tags .

In the "text" you need to call the formTiddler macro and in the tagparameters you specify your tags. E.g.:
{{{
<<newTiddler
label:"Button Label"
text:{{"<<formTiddler [[MyTemplateTiddler]]>"+">"}}
tag:"MyTag1"
tag:"Three Word Tag"
>>
}}}
For details on newTiddler see http://tiddlywiki.org/wiki/NewTiddler_%28macro%29
[[Category:thework]]