mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-12-29 11:30:28 +00:00
53 lines
3.1 KiB
Plaintext
53 lines
3.1 KiB
Plaintext
caption: genesis
|
|
created: 20221101100729587
|
|
modified: 20231214093716044
|
|
tags: Widgets
|
|
title: GenesisWidget
|
|
type: text/vnd.tiddlywiki
|
|
|
|
! Introduction
|
|
|
|
<<.from-version "5.2.4">> The <<.wid genesis>> 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 <<.wid genesis>> 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) |
|
|
|$remappable |Set to "no" to prevent the generated widget from being affected by any custom widget overrides. Needed when invoking the original widget within a custom widget definition |
|
|
|$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 <<.attr $names>> |
|
|
|$mode |An optional override of the parsing mode. May be "inline" or "block" |
|
|
|//{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 applied 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 or HTML Element |
|
|
|
|
<<.from-version "5.2.6">> If the `$type` attribute is missing or blank, the <<.wlink GenesisWidget>> widget does not render an intrinsic element, instead just rendering its children.
|
|
|
|
<<.from-version "5.3.6">> Note that attributes explicitly specified take precedence over attributes with the same name specified in the `$names` filter. This has always been the documented behaviour but prior to [[Release 5.3.6]] the implementation was reversed, and the `$names` attributes took precedence. This was fixed in [[Release 5.3.6]].
|
|
|
|
! Examples
|
|
|
|
<$macrocall $name="wikitext-example"
|
|
src="""<$genesis $type="div" class="tc-thing" label="Squeak">Mouse</$genesis>"""/>
|
|
|
|
<$macrocall $name="wikitext-example"
|
|
src="""\define my-banner(mode:"inline",caption)
|
|
<$genesis $type={{{ [<__mode__>match[inline]then[span]else[div]] }}} class="tc-mybanner">
|
|
<<__caption__>>
|
|
</$genesis>
|
|
\end
|
|
|
|
<<my-banner caption:"I'm in a SPAN">>
|
|
|
|
<<my-banner mode:"block" caption:"I'm in a DIV">>
|
|
"""/>
|
|
|
|
! Important
|
|
|
|
<$macrocall $name=".warning" _="""
|
|
In the following example the widget attribute named `one` is not present in the HTML output. This is because HTML attributes starting with the prefix `on` are removed for security reasons. See [[HTML in WikiText]] "Security" for more details. This restriction only affects generated HTML elements, and does not prevent the use of attributes prefixed `on` with other widgets"""/>
|
|
|
|
<<wikitext-example '<$genesis $type="my-element" $names="one two" $values="1 2">Test Genesis Widget</$genesis>'>>
|