1
0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-12-01 05:49:55 +00:00
TiddlyWiki5/editions/tw5.com/tiddlers/concepts/TemplateTiddlers.tid

41 lines
1.6 KiB
Plaintext
Raw Normal View History

2014-01-07 11:57:42 +00:00
created: 20140107114355828
modified: 20140317213147507
2014-01-07 11:57:42 +00:00
tags: concepts
title: TemplateTiddlers
type: text/vnd.tiddlywiki
A template tiddler is not in fact a type of tiddler, it is a role in which a tiddler can be used.
When text is wikified there is the concept of the CurrentTiddler. Certain widgets (like the ViewWidget) can use the current tiddler implicitly. For example:
```
<$view tiddler="HelloThere" field="myfield"/> - displays the field "myfield" of the tiddler HelloThere
<$view field="myfield"/> - displays the field "myfield" of the current tiddler
```
When the TranscludeWidget pulls in the content from another tiddler, by default it does not change the current tiddler, so the transcluded content behaves as if it were in the context of the transcluding tiddler.
So, if we have a tiddler "A" that contains:
```
<$view field="myfield"/>
```
And then transclude it from a tiddler "B" like so:
```
My field value is: <$transclude tiddler="A"/>
```
The result will be that the field from the tiddler "B" is displayed; in other words, tiddler "A" is acting as a template for displaying information from tiddler "B".
The TiddlerWidget is used to change the current tiddler. Consider a tiddler "C" containing:
```
<$tiddler tiddler="A"><$transclude tiddler="A"/></$tiddler>
```
It is still transcluding tiddler "A", but now it is also setting the current tiddler to "A". The result is therefore that the field "myfield" for tiddler "A" is displayed.
The shorthand syntax for [[Transclusion in WikiText]] actually generates both a TiddlerWidget and a TranscludeWidget.