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

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

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:

```
<$button message="tm-close-tiddler">Close Me!</$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}}`)
* The content of a widget is parsed in inline mode unless the opening tag is followed by two linebreaks, which forces block mode
** 'Inline mode' means that 'block mode' 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]]">>
Big docs update Finally sorting out the wikitext documentation 2013-12-05 16:21:10 +00:00			`created: 20131205160840915`
Docs update 2014-06-19 11:37:54 +00:00			`modified: 20140619111725471`
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`
Update wikitext documentation 2014-09-11 08:15:58 +00:00			`caption: Widgets`
Big docs update Finally sorting out the wikitext documentation 2013-12-05 16:21:10 +00:00
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:

			```
Rename "tw-" messages to "tm-" 2014-08-28 20:43:44 +00:00			`<$button message="tm-close-tiddler">Close Me!</$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}}`)
			`* The content of a widget is parsed in inline mode unless the opening tag is followed by two linebreaks, which forces block mode`
			`** 'Inline mode' means that 'block mode' parse rules like headings, tables and lists are not recognised`

			`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]]">>`