2013-08-27 08:01:40 +00:00
|
|
|
created: 201308270759
|
2015-01-24 21:18:44 +00:00
|
|
|
modified: 20150124211238000
|
2014-09-11 14:52:47 +00:00
|
|
|
tags: Concepts
|
2013-08-27 08:01:40 +00:00
|
|
|
title: TextReference
|
2012-06-19 07:56:45 +00:00
|
|
|
|
|
|
|
A TextReference identifies a chunk of text from a tiddler that can be retrieved or modified depending on the context.
|
|
|
|
|
2013-08-27 08:01:40 +00:00
|
|
|
Text references are made up of several parts, most of which can be optional:
|
2012-06-19 07:56:45 +00:00
|
|
|
|
2013-08-20 14:18:15 +00:00
|
|
|
* `<tiddler title>` - the text [[field|TiddlerFields]] of the specified tiddler
|
|
|
|
* `<tiddler title>!!<metadata field>` - a tiddler metadata [[field|TiddlerFields]] (eg, `modified`, `modifier`, `type` etc)
|
|
|
|
* `!!<metadata field>` - a metadata [[field|TiddlerFields]] of the current tiddler
|
2013-01-16 13:44:09 +00:00
|
|
|
* `<tiddler title>##<property index>` - extracts a named property from DataTiddlers
|
2013-08-27 08:01:40 +00:00
|
|
|
|
|
|
|
Text references can be used in several places:
|
|
|
|
|
2015-01-24 21:18:44 +00:00
|
|
|
* As [[indirect parameters|Filter Parameter]] within [[Filters]] (eg, `<$list filter="[tag{MyTag!!name}]"/>`)
|
2013-08-27 08:01:40 +00:00
|
|
|
* As IndirectAttributes of an element or widget (eg, `<$widget attrib={{Title!!description}}/>`)
|
|
|
|
* As the operand of a shortcut transclusion (eg, `{{MyTiddler!!title}}`)
|
|
|
|
* As the `state` attribute of the RevealWidget and the LinkCatcherWidget
|