25th January 2022 at 4:30pm
Introduction
The $qualify
widget sets a variable
to a unique string that encodes its position within the widget tree, as identified by the stack of transcluded tiddlers that lead to that position.
Internally, it is implemented using the transclusion variable.
Content and Attributes
The content of the $qualify
widget is the scope for the value assigned to the name
variable.
Attribute | Description |
---|---|
title | The prefix for the string, normally a tiddler title |
name | The name of the variable to be set to the unique string |
Examples
The two examples below are identical, but produce different results because the second one has been transcluded from another tiddler.
Each example shows the result of calling qualify
and then the value of the transclusion
variable.
<$qualify title="BaseTiddler" name="iamnotanumber">
<ul>
<li><code><<iamnotanumber>></code></li>
<li><code><<transclusion>></code></li>
</ul>
</$qualify>
<$qualify title="BaseTiddler" name="iamnotanumber">
<ul>
<li><code><<iamnotanumber>></code></li>
<li><code><<transclusion>></code></li>
</ul>
</$qualify>
Remarks
In most cases it will be simpler to use the qualify Macro.