TiddlyWiki5/editions/tw5.com/tiddlers/wikitext/Widgets in WikiText.tid

caption: Widgets
created: 20131205160840915
modified: 20220513113347606
tags: WikiText
title: Widgets in WikiText
type: text/vnd.tiddlywiki

Widgets provide rich functionality within WikiText. They have the same syntax as [[HTML elements|HTML in WikiText]], but the tag name always starts with `$`. For example:

<$macrocall $name=".example" n="1"
eg="""<$button message="tm-navigate" to="HelloThere">Open ~HelloThere</$button>
"""/>

Note that widgets inherit all the features of [[HTML in WikiText]]:

* Widget attributes can be specified as:
** Unquoted strings (that cannot contain spaces)
** Strings quoted with single or double quotes
** Strings quoted with triple-double quotes
** Macro invocations (eg `attr=<<myMacro>>`)
** Transclusions (eg, `attr={{MyTiddler!!field}}`)
** Filtered transclusions (eg, `attr={{{ [filter[op]] }}}`)
* The content of a widget is [[parsed|WikiText Parser Modes]] in [[inline mode|Inline Mode WikiText]] unless the opening tag is followed by two linebreaks, which forces [[block mode|Block Mode WikiText]]
** [[inline mode|Inline Mode WikiText]] means that [[block mode|Block Mode WikiText]] parse rules like headings, tables and lists are not recognised

See [[HTML in WikiText]] for more details.

The available widgets include:

<<list-links "[tag[Widgets]]">>
Add support for filtered attributes to HTML elements and widgets Fixes #2624 2016-10-21 10:27:07 +00:00			`caption: Widgets`
Big docs update Finally sorting out the wikitext documentation 2013-12-05 16:21:10 +00:00			`created: 20131205160840915`
Fix headings in wikitext example code (#6692) 2022-05-14 12:31:36 +00:00			`modified: 20220513113347606`
Update wikitext documentation 2014-09-11 08:15:58 +00:00			`tags: WikiText`
Big docs update Finally sorting out the wikitext documentation 2013-12-05 16:21:10 +00:00			`title: Widgets in WikiText`
			`type: text/vnd.tiddlywiki`

Use double linebreaks to indicate content of a widget or html element should be parsed in block mode Fixes #82. The old behaviour was to parse the content of a widget or html element in block mode if the opening tag was followed by a line break. The new behaviour requires two line breaks. This makes it possible to include linebreaks more liberally within wikitext, although care must still be taken to only use double line breaks when the block mode behaviour is desired. The code change here is very simple, just a single line change in html.js. Most of the other changes are to convert various single line breaks into double line breaks. 2014-02-20 21:42:31 +00:00			Widgets provide rich functionality within WikiText. They have the same syntax as [[HTML elements\|HTML in WikiText]], but the tag name always starts with `$`. For example:

Fix headings in wikitext example code (#6692) 2022-05-14 12:31:36 +00:00			`<$macrocall $name=".example" n="1"`
			`eg="""<$button message="tm-navigate" to="HelloThere">Open ~HelloThere</$button>`
			`"""/>`
Use double linebreaks to indicate content of a widget or html element should be parsed in block mode Fixes #82. The old behaviour was to parse the content of a widget or html element in block mode if the opening tag was followed by a line break. The new behaviour requires two line breaks. This makes it possible to include linebreaks more liberally within wikitext, although care must still be taken to only use double line breaks when the block mode behaviour is desired. The code change here is very simple, just a single line change in html.js. Most of the other changes are to convert various single line breaks into double line breaks. 2014-02-20 21:42:31 +00:00
			`Note that widgets inherit all the features of [[HTML in WikiText]]:`

			`* Widget attributes can be specified as:`
			`** Unquoted strings (that cannot contain spaces)`
			`** Strings quoted with single or double quotes`
Docs update 2014-06-19 11:37:54 +00:00			`** Strings quoted with triple-double quotes`
Use double linebreaks to indicate content of a widget or html element should be parsed in block mode Fixes #82. The old behaviour was to parse the content of a widget or html element in block mode if the opening tag was followed by a line break. The new behaviour requires two line breaks. This makes it possible to include linebreaks more liberally within wikitext, although care must still be taken to only use double line breaks when the block mode behaviour is desired. The code change here is very simple, just a single line change in html.js. Most of the other changes are to convert various single line breaks into double line breaks. 2014-02-20 21:42:31 +00:00			** Macro invocations (eg `attr=<<myMacro>>`)
			** Transclusions (eg, `attr={{MyTiddler!!field}}`)
Add support for filtered attributes to HTML elements and widgets Fixes #2624 2016-10-21 10:27:07 +00:00			** Filtered transclusions (eg, `attr={{{ [filter[op]] }}}`)
Add doc related to WikiText parser modes (#6415) * Added macros for displaying wikitext examples in a table * Added documentation for WikiText parsing * Changed recognize to British spelling * Add links to the new wikitext parser tiddlers 2022-01-23 09:44:01 +00:00			`* The content of a widget is [[parsed\|WikiText Parser Modes]] in [[inline mode\|Inline Mode WikiText]] unless the opening tag is followed by two linebreaks, which forces [[block mode\|Block Mode WikiText]]`
			`** [[inline mode\|Inline Mode WikiText]] means that [[block mode\|Block Mode WikiText]] parse rules like headings, tables and lists are not recognised`
Use double linebreaks to indicate content of a widget or html element should be parsed in block mode Fixes #82. The old behaviour was to parse the content of a widget or html element in block mode if the opening tag was followed by a line break. The new behaviour requires two line breaks. This makes it possible to include linebreaks more liberally within wikitext, although care must still be taken to only use double line breaks when the block mode behaviour is desired. The code change here is very simple, just a single line change in html.js. Most of the other changes are to convert various single line breaks into double line breaks. 2014-02-20 21:42:31 +00:00
			`See [[HTML in WikiText]] for more details.`

			`The available widgets include:`
Big docs update Finally sorting out the wikitext documentation 2013-12-05 16:21:10 +00:00
Refine preliminary list macro @pmario: I’ve taken your suggestion and made the HTML element type(s) be macro parameters. 2014-09-17 11:13:24 +00:00			`<<list-links "[tag[Widgets]]">>`