TiddlyWiki5/editions/tw5.com/tiddlers/widgets/GenesisWidget.tid

caption: genesis
created: 20220909102917736
modified: 20220909102917736
tags: Widgets
title: GenesisWidget
type: text/vnd.tiddlywiki

! Introduction

<<.from-version "5.3.0">> The <<.wlink GenesisWidget>> widget allows the dynamic construction of another widget, where the name and attributes of the new widget can be dynamically determined, without needing to be known in advance.

! Content and Attributes

The content of the <<.wlink GenesisWidget>> widget is used as the content of the dynamically created widget.

|!Attribute |!Description |
|$type |The type of widget or element to create (an initial `$` indicates a widget, otherwise an HTML element will be created) |
|$names |An optional filter evaluating to the names of a list of attributes to be applied to the widget |
|$values |An optional filter evaluating to the values corresponding to the list of names specified in `$names` |
|//{other attributes starting with $}// |Other attributes starting with a single dollar sign are reserved for future use |
|//{attributes starting with $$}// |Attributes starting with two dollar signs are appplied as attributes to the output widget, but with the attribute name changed to use a single dollar sign |
|//{attributes not starting with $}// |Any other attributes that do not start with a dollar are applied as attributes to the output widget |

Note that attributes explicitly specified take precedence over attributes with the same name specified in the `$names` filter.

! Examples

<$macrocall $name='wikitext-example-without-html' 
src='<$genesis $type="div" class="tc-thing" label="Squeak">Mouse</$genesis>'/>
Introduce genesis widget for dynamically creating widgets See the "RedefineLet" test for a contrived example of usage 2022-05-03 11:55:10 +00:00			`caption: genesis`
Rejig genesis widget to be easier to use 2022-09-09 09:37:39 +00:00			`created: 20220909102917736`
			`modified: 20220909102917736`
Introduce genesis widget for dynamically creating widgets See the "RedefineLet" test for a contrived example of usage 2022-05-03 11:55:10 +00:00			`tags: Widgets`
			`title: GenesisWidget`
			`type: text/vnd.tiddlywiki`

			`! Introduction`

Docs updates 2022-09-09 11:05:08 +00:00			`<<.from-version "5.3.0">> The <<.wlink GenesisWidget>> widget allows the dynamic construction of another widget, where the name and attributes of the new widget can be dynamically determined, without needing to be known in advance.`
Introduce genesis widget for dynamically creating widgets See the "RedefineLet" test for a contrived example of usage 2022-05-03 11:55:10 +00:00
			`! Content and Attributes`

Docs updates 2022-09-09 11:05:08 +00:00			`The content of the <<.wlink GenesisWidget>> widget is used as the content of the dynamically created widget.`
Introduce genesis widget for dynamically creating widgets See the "RedefineLet" test for a contrived example of usage 2022-05-03 11:55:10 +00:00
			`\|!Attribute \|!Description \|`
Rejig genesis widget to be easier to use 2022-09-09 09:37:39 +00:00			\|$type \|The type of widget or element to create (an initial `$` indicates a widget, otherwise an HTML element will be created) \|
Docs: JSON operators and tweaks to genesis widget 2022-06-11 14:22:43 +00:00			`\|$names \|An optional filter evaluating to the names of a list of attributes to be applied to the widget \|`
Introduce genesis widget for dynamically creating widgets See the "RedefineLet" test for a contrived example of usage 2022-05-03 11:55:10 +00:00			\|$values \|An optional filter evaluating to the values corresponding to the list of names specified in `$names` \|
			`\|//{other attributes starting with $}// \|Other attributes starting with a single dollar sign are reserved for future use \|`
			`\|//{attributes starting with $$}// \|Attributes starting with two dollar signs are appplied as attributes to the output widget, but with the attribute name changed to use a single dollar sign \|`
			`\|//{attributes not starting with $}// \|Any other attributes that do not start with a dollar are applied as attributes to the output widget \|`

			Note that attributes explicitly specified take precedence over attributes with the same name specified in the `$names` filter.

			`! Examples`

			`<$macrocall $name='wikitext-example-without-html'`
Rejig genesis widget to be easier to use 2022-09-09 09:37:39 +00:00			`src='<$genesis $type="div" class="tc-thing" label="Squeak">Mouse</$genesis>'/>`