mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-12-29 11:30:28 +00:00
10ebd93df3
* Link ViewWidget formats to similar filter operators * Merge the ViewWidget columns and use the tip macro instead * Reference the format filter operator in ViewWidget * More accurate language in the ViewWidget docs
75 lines
4.3 KiB
Plaintext
75 lines
4.3 KiB
Plaintext
caption: view
|
|
created: 20131024141900000
|
|
modified: 20211219213444235
|
|
tags: Widgets
|
|
title: ViewWidget
|
|
type: text/vnd.tiddlywiki
|
|
|
|
! Introduction
|
|
|
|
The view widget displays the contents of a tiddler field in a specified format.
|
|
|
|
! Content and Attributes
|
|
|
|
The content of the `<$view>` widget is displayed if the field or property is missing or empty.
|
|
|
|
|!Attribute |!Description |
|
|
|tiddler |The title of the tiddler (defaults to the [[current tiddler|Current Tiddler]]) |
|
|
|field |The name of the field to view (defaults to "text") |
|
|
|index |The name of the index to view |
|
|
|format |The format for displaying the field (see below) |
|
|
|template |Optional template string used when the `format` attribute is set to "date" |
|
|
|subtiddler |Optional SubTiddler title when the target tiddler is a [[plugin|Plugins]] (see below) |
|
|
|mode |<<.from-version "5.1.15">> Optional transclusion parsing mode for wikified formats. May be "inline" or "block" (the default) |
|
|
|
|
!! Formats
|
|
|
|
The following formats can be specified in the `format` attribute:
|
|
|
|
|!Format |!Description |
|
|
|''text'' |Plain text (default) <<.tip "See also the TextWidget. `<$view format=text tiddler=MyTiddler/>` renders the same as `<$text text={{MyTiddler}}/>`">>|
|
|
|''htmlencoded'' |The field is displayed with HTML encoding. <<.tip "Rendered value is the same as the output from the [[encodehtml|encodehtml Operator]] filter operator">> |
|
|
|''htmltextencoded'' |<<.from-version "5.2.0">> The field is displayed with HTML encoding, only double quotes (") are not escaped. This creates a more compact htmlencoding appropriate for html text content, but //not// for attributes. |
|
|
|''urlencoded'' |The field is displayed with URL encoding <<.tip "Rendered value is the same as the output from the [[encodeuri|encodeuri Operator]] filter operator">> |
|
|
|''doubleurlencoded'' |The field is displayed with double URL encoding <<.tip "Rendered value is the same as the output from calling the [[encodeuri|encodeuri Operator]] filter operator twice">> |
|
|
|''htmlwikified'' |The field is wikified according to the mode attribute and the resulting HTML returned as plain text (ie HTML elements will appear in plain text) |
|
|
|''plainwikified'' |The field is wikified according to the mode attribute and the text content of the resulting HTML returned as plain text (ie HTML elements will be removed) |
|
|
|''htmlencodedplainwikified'' |The field is wikified according to the mode attribute and the text content of the resulting HTML returned as HTML encoded plain text (ie HTML elements will be removed) |
|
|
|''date'' |The field is interpreted as a UTC date and displayed according to the DateFormat specified in the `template` attribute <<.tip "Rendered value is the same as the output from the [[format:date|format Operator]] filter operator">> |
|
|
|''relativedate'' |The field is interpreted as a UTC date and displayed as the interval from the present instant <<.tip "Rendered value is the same as the output from the [[format:relativedate|format Operator]] filter operator">> |
|
|
|''stripcomments'' |The field is interpreted as JavaScript source code and any lines beginning `\\#` are stripped |
|
|
|''jsencoded'' |The field is displayed as a JavaScript encoded string <<.tip "Rendered value is the same as the output from the [[stringify|stringify Operator]] filter operator">> |
|
|
|
|
!! "WikiText format"
|
|
|
|
To display the field content as regular WikiText, for example with working links, use the [[TranscludeWidget]] instead.
|
|
|
|
! SubTiddler Access
|
|
|
|
The view widget allows access to the individual tiddlers stored within a [[plugin|Plugins]].
|
|
|
|
The following example will view the core version of the tiddler [[$:/DefaultTiddlers]] even if it has been overridden:
|
|
|
|
<<wikitext-example-without-html '
|
|
<$view tiddler="$:/core" subtiddler="$:/DefaultTiddlers"/>
|
|
|
|
'>>
|
|
|
|
! Examples
|
|
|
|
Given this [[Saturday]] example tiddler:
|
|
|
|
|!tiddler|!raw content|!rendered content|
|
|
|[[Saturday]]|<$text text={{Saturday}}/>|{{Saturday}}|
|
|
|
|
Here is how `<$view tiddler=Saturday format=<<format>>/>` renders for each format:
|
|
<table>
|
|
<tr><th>format</th><th>renders as</th></tr>
|
|
<$list filter="text htmlencoded htmltextencoded urlencoded doubleurlencoded htmlwikified plainwikified htmlencodedplainwikified stripcomments jsencoded" variable=format>
|
|
<tr>
|
|
<td>''<<format>>''</td>
|
|
<td><$view tiddler="Saturday" format=<<format>>/></td>
|
|
</tr>
|
|
</$list>
|
|
</table>
|