tiddlywiki 5.1.23 → 5.2.2

package/editions/tw5.com/tiddlers/webserver/WebServer Parameter_ required-plugins.tid

@@ -0,0 +1,8 @@
+caption: required-plugins
+created: 20211226160733000
+modified: 20211226160754000 
+tags: [[WebServer Parameters]]
+title: WebServer Parameter: required-plugins
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.2.2">> The [[web server configuration parameter|WebServer Parameters]] ''required-plugins'' is used to specify the plugins required to start the [[WebServer]]. It take a comma seperated list of plugin titles. The WebServer will issue a warnign in the console if the required plugins are not loaded. This parameter defaults to `$:/plugins/tiddlywiki/filesystem,$:/plugins/tiddlywiki/tiddlyweb`.

package/editions/tw5.com/tiddlers/webserver/WebServer Parameter_ tls-passphrase.tid

@@ -0,0 +1,10 @@
+caption: tls-passphrase
+created: 20211111004416873
+modified: 20211111022120158
+tags: [[WebServer Parameters]]
+title: WebServer Parameter: tls-passphrase
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.2.2">> The optional [[web server configuration parameter|WebServer Parameters]] ''tls-passphrase'' contains the "certificate passphrase", a string used to decrypt the certificate file used when running the web server under HTTPS.
+
+See [[Using HTTPS]] for details.

package/editions/tw5.com/tiddlers/widgets/$__docs_anyField.tid

@@ -0,0 +1,8 @@
+created: 20210505094244703
+field: list
+modified: 20210505094434740
+tags: 
+title: $:/docs/anyField
+type: text/vnd.tiddlywiki
+
+This tiddler is needed for the last [[SetWidget]] example

package/editions/tw5.com/tiddlers/widgets/$__editions_tw5.com_widget-examples_qualify-transcluded.tid

@@ -0,0 +1,14 @@
+created: 20220125161941555
+modified: 20220125162920771
+tags: [[Widget Examples]]
+title: $:/editions/tw5.com/widget-examples/qualify-transcluded
+type: text/vnd.tiddlywiki
+
+<$macrocall $name=".example" n="1"
+eg="""<$qualify title="BaseTiddler" name="iamnotanumber">
+<ul>
+<li><code><<iamnotanumber>></code></li>
+<li><code><<transclusion>></code></li>
+</ul>
+</$qualify>
+"""/>

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget Example 1.tid

@@ -1,6 +1,6 @@
 created: 20200131142401129
-modified: 20201020112608874
-tags: ActionCreateTiddlerWidget
+modified: 20211113230406823
+tags: ActionCreateTiddlerWidget Widgets
 title: ActionCreateTiddlerWidget Example 1
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget Example 2.tid

@@ -1,6 +1,6 @@
 created: 20200131144828713
-modified: 20201020112601032
-tags: ActionCreateTiddlerWidget
+modified: 20211113011036840
+tags: ActionCreateTiddlerWidget Widgets
 title: ActionCreateTiddlerWidget Example 2
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget Example 3.tid

@@ -1,6 +1,6 @@
 created: 20200131145355658
-modified: 20201020112553050
-tags: ActionCreateTiddlerWidget
+modified: 20211113011111052
+tags: ActionCreateTiddlerWidget Widgets
 title: ActionCreateTiddlerWidget Example 3
 type: text/vnd.tiddlywiki
 
@@ -25,4 +25,4 @@ Create Tiddler
 <$button actions=<<testCreate>> >
 <$action-setfield $tiddler="$:/state/tab/sidebar--595412856" text="$:/core/ui/SideBar/Recent"/>
 Create Tiddler
-</$button> - Clicking this button, will also open the Right sidebar: Recent tab
+</$button> - Clicking this button will also open the Right sidebar: Recent tab

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget Example 4.tid

@@ -1,6 +1,6 @@
 created: 20200131150229551
-modified: 20201020112544146
-tags: ActionCreateTiddlerWidget
+modified: 20211113011129601
+tags: ActionCreateTiddlerWidget Widgets
 title: ActionCreateTiddlerWidget Example 4
 type: text/vnd.tiddlywiki
 
@@ -8,7 +8,7 @@ type: text/vnd.tiddlywiki
 <$action-createtiddler $basetitle="base" $template="ActionCreateTiddlerWidget Template" aa="new field aa" bb="new field bb" />
 \end
 
-This example will uses a base-title: "base" and a template: [[ActionCreateTiddlerWidget Template]].
+This example uses a base-title "base" and a template: [[ActionCreateTiddlerWidget Template]].
 
 There will be new fields "aa" and "bb" which are added to the new tiddlers.
 
@@ -25,4 +25,4 @@ Create Tiddler
 <$button actions=<<testCreate>> >
 <$action-setfield $tiddler="$:/state/tab/sidebar--595412856" text="$:/core/ui/SideBar/Recent"/>
 Create Tiddler
-</$button> - Clicking this button, will also open the Right sidebar: Recent tab
+</$button> - Clicking this button will also open the Right sidebar: Recent tab

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget Template.tid

@@ -1,6 +1,6 @@
 created: 20200131145608087
-modified: 20200131150801682
-tags: test
+modified: 20211116192551162
+tags: test [[Widget Examples]]
 title: ActionCreateTiddlerWidget Template
 type: text/vnd.tiddlywiki
 x: x

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget.tid

@@ -1,6 +1,6 @@
 caption: action-createtiddler
 created: 20161020152745942
-modified: 20200131151847266
+modified: 20210601092956998
 tags: Widgets ActionWidgets
 title: ActionCreateTiddlerWidget
 type: text/vnd.tiddlywiki
@@ -16,17 +16,21 @@ There are several differences from the [[tm-new-tiddler message|WidgetMessage: t
 
 ! Content and Attributes
 
-The ''action-createtiddler'' widget is invisible. Any content within it is ignored.
+The ''action-createtiddler'' widget is invisible.
+
+<<.from-version "5.2.0">> The action widgets contained within the ''action-createtiddler'' widget are executed after the new tiddler has been created with the title of the tiddler in the variable `createTiddler-title` and `createTiddler-draftTitle`.
 
 |!Attribute |!Description |
 |$basetitle |The initial title that will be attempted. If a tiddler with that title already exists, then a numerical counter is added to the title and incremented until it is unique|
-|$savetitle |A text reference identifying a field or index into which the title of the newly created tiddler will be stored after it is created |
-|$savedrafttitle |<<.from-version "5.1.20">> A text reference identifying a field or index into which the draft title associated with the newly created tiddler will be stored after it is created. This is useful when using a sequence of action widgets to create a new tiddler, put it into edit mode, and position it within the list of its parent tag |
+|$savetitle |//(deprecated – see below)// A text reference identifying a field or index into which the title of the newly created tiddler will be stored after it is created |
+|$savedrafttitle |//(deprecated – see below)// <<.from-version "5.1.20">> A text reference identifying a field or index into which the draft title associated with the newly created tiddler will be stored after it is created. This is useful when using a sequence of action widgets to create a new tiddler, put it into edit mode, and position it within the list of its parent tag |
 |$timestamp |Specifies whether the timestamp(s) of the target tiddler will be updated (''modified'' and ''modifier'', plus ''created'' and ''creator'' for newly created tiddlers). Can be "yes" (the default) or "no" |
-|$template |<<.from-version "5.1.22">>  The title of a template tiddler, that will be used to create a new tiddler |
-|$overwrite |<<.from-version "5.1.22">>  If set to "yes", it will overwrite existing tiddlers. ''Be careful!'' |
+|$template |<<.from-version "5.1.22">> The title of a template tiddler, that will be used to create a new tiddler |
+|$overwrite |<<.from-version "5.1.22">> If set to "yes", it will overwrite existing tiddlers. ''Be careful!'' |
 |//{any attributes not starting with $}// |Each attribute name specifies a field to be created in the new tiddler  |
 
+<<.from-version "5.2.0">> Note that the attributes `$savetitle` and `$savedrafttitle` are no longer needed. Instead, any action widgets that need to use the title of the newly created tiddler should be contained within the ''action-createtiddler'' widget, and reference the variables `createTiddler-title` and `createTiddler-draftTitle` to obtain the title.
+
 ! Examples
 
 <<<

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget_Example.tid

@@ -1,12 +1,14 @@
 created: 20161020153426686
-modified: 20161020155142990
-tags: ActionCreateTiddlerWidget
+modified: 20211113011019510
+tags: ActionCreateTiddlerWidget Widgets
 title: ActionCreateTiddlerWidget Example
 type: text/vnd.tiddlywiki
 
-New button caption: <$edit-text tiddler="$:/state/new-button-caption" tag="input" default=""/>
+Caption for new button: <$edit-text tiddler="$:/state/new-button-caption" tag="input" default=""/>
 
 <$button>
-<$action-createtiddler $basetitle="Homemade Button" tags="$:/tags/PageControls" text={{$:/state/new-button-caption}}/>
-Create non-functional page control button
+<$action-createtiddler $basetitle="Homemade Button" tags="$:/tags/PageControls" text={{$:/state/new-button-caption}}>
+<$action-navigate $to=<<createTiddler-title>>/>
+</$action-createtiddler>
+Create a new non-functional page control button and open the tiddler
 </$button>

package/editions/tw5.com/tiddlers/widgets/ActionListopsWidget.tid

@@ -1,7 +1,7 @@
 caption: action-listops
 created: 20141025120850184
 list: efg hlm pqr
-modified: 20151228083329099
+modified: 20211115091121133
 myfield: 
 revision: 0
 tags: ActionWidgets Widgets
@@ -29,13 +29,63 @@ The ''action-listops'' widget is an [[action widget|ActionWidgets]] that manipul
 The ''action-listops'' widget is invisible. Any content within it is ignored.
 
 |!Attribute |!Description |
-|$tiddler |The title of the tiddler whose lists are to be modified (if not provided defaults to the [[current tiddler|Current Tiddler]] |
+|$tiddler |The title of the tiddler whose lists are to be modified (if not provided defaults to the [[current tiddler|Current Tiddler]]) |
 |$field |The name of a field to be manipulated as a list (defaults to 'list') |
 |$index |Optional index of a property in a [[data tiddler|DataTiddlers]] index to be manipulated as a list |
 |$filter |An optional filter expression, the output of which will be saved to the field/index being manipulated |
 |$subfilter |An optional subfilter expression, which takes the list being manipulated as input, and saves the modified list back to the field/index being manipulated |
 |$tags |An optional subfilter expression, which takes the 'tags' field of the target tiddler as input, and saves the modified list of tags back to the 'tags' field |
 
+! $filter vs. $subfilter
+
+Standalone use of the `$subfilter` attribute can be replaced by using a (more complicated) `$filter` attribute value.
+
+For example, the items "abc" and "123" can be appended to the field `myfield` using the `$subfilter` attribute:
+
+```
+<$action-listops $field="myfield" $subfilter="abc 123"/>
+```
+
+The same can be achieved using the `$filter` attribute and prepending the [[Filter Run]] `[all[current]get[myfield]enlist-input[]]` to the [[Filter Expression]]:
+
+```
+<$action-listops $field="myfield" $filter="[all[current]get[myfield]enlist-input[]] abc 123"/>
+```
+
+The short form is more convenient, but the long form is useful for live-debugging complicated `$subfilter` values using the filter tab of [[$:/AdvancedSearch]]. By using [[$:/AdvancedSearch]], the [[Filter Expression]] can be tested before using ''action-listops'' to modify actual tiddler fields. For this use case, the `all[current]` portion of the expression needs to be changed to select the proper test tiddler.
+
+! $tags vs. $field + $subfilter
+
+[[Tagging]] is implemented using a tiddler's 'tags' field, so appending the tags "abc" and "123" using the `$tags` attribute like this:
+
+```
+<$action-listops $tags="abc 123"/>
+```
+
+is mostly equivalent to using `$subfilter` along with "tags" for the value of `$field`:
+
+```
+<$action-listops $field="tags" $subfilter="abc 123"/>
+```
+
+! $action-listops widget vs. $action-setfield widget
+
+The ActionSetFieldWidget replaces a field's value using `$field`/`$value` attributes. A single ActionSetFieldWidget can be used to set any number of fields by using attributes not starting with $.
+
+The ActionListopsWidget replaces or modifies a single field's value. The new value is generated using filters.
+
+The following two examples are functionally equivalent:
+
+```
+<$action-setfield $field="myfield" $value="abc 123"/>
+```
+
+```
+<$action-listops $field="myfield" $filter="abc 123"/>
+```
+
+In general, ActionSetFieldWidget is better for setting multiple fields at once and for replacing a field's value. The ActionListopsWidget is better for modifying a field based on the field's existing value and for using a [[Filter Expression]] to derive the value.
+
 ! Extended Filter Operators
 
 A number of [[extended filter operators|The Extended Listops Filters]] are necessary for the manipulation of lists. These operators have been designed primarily for use in subfilter expressions whereby the modified current list is returned in place of the current list.

package/editions/tw5.com/tiddlers/widgets/ActionPopupWidget.tid

@@ -1,6 +1,6 @@
 caption: action-popup
 created: 20200303114556528
-modified: 20200421221304177
+modified: 20210501203451387
 tags: Widgets ActionWidgets
 title: ActionPopupWidget
 type: text/vnd.tiddlywiki
@@ -16,9 +16,12 @@ The ''action-popup'' widget is invisible. Any content within it is ignored.
 |!Attribute |!Description |
 |$state |The title of the state tiddler for the popup |
 |$coords |Optional coordinates for the handle to which popup is positioned (in the format `(x,y,w,h)`) |
+|$floating |<<.from-version "5.2.0">> Optional. Defaults to `no`. Set to `yes` to create a popup that must be closed explicitly. |
 
 <<.from-version "5.1.23">> If the ''$coords'' attribute is missing or empty then all popups are cancelled.
 
+<<.tip "Delete the state tiddler for a floating popup to close it.">>
+
 ! Examples
 
 Here is an example of button that triggers the "more" button in the sidebar "Tools" tab. You may need to scroll to see the popup

package/editions/tw5.com/tiddlers/widgets/ActionSendMessageWidget.tid

@@ -1,6 +1,6 @@
 caption: action-sendmessage
 created: 20141008134309742
-modified: 20150518210909583
+modified: 20211023160110220
 tags: Widgets ActionWidgets
 title: ActionSendMessageWidget
 type: text/vnd.tiddlywiki
@@ -18,6 +18,8 @@ The ''action-sendmessage'' widget is invisible. Any content within it is ignored
 |$param |Optional parameter string whose meaning is dependent on the message being sent |
 |$name |Optional name of additional parameter |
 |$value |Value for optional parameter whose name is specified in `$name` |
+|$names |<<.from-version "5.2.1">> Optional filter evaluating to a list of additional parameter names |
+|$values |<<.from-version "5.2.1">> Optional filter evaluating to a list of parameter values corresponding to the parameters names specified in `$names` |
 |//{any attributes not starting with $}// |Multiple additional, optional named parameters that are attached to the message |
 
 ! Examples

package/editions/tw5.com/tiddlers/widgets/ActionSetMultipleFieldsWidget.tid

@@ -0,0 +1,31 @@
+caption: action-setmultiplefields
+created: 20211023160110220
+modified: 20211023160110220
+tags: Widgets ActionWidgets
+title: ActionSetMultipleFieldsWidget
+type: text/vnd.tiddlywiki
+
+! Introduction
+
+The ''action-setmultiplefields'' widget is an [[action widget|ActionWidgets]] that assigns multiple fields to a tiddler where the names and values of the fields are specified as separate filters. ActionWidgets are used within triggering widgets such as the ButtonWidget.
+
+! Content and Attributes
+
+The ''action-setmultiplefields'' widget is invisible. Any content within it is ignored.
+
+|!Attribute |!Description |
+|$tiddler |Optional title of the tiddler to modify (defaults to the current tiddler) |
+|$fields |Optional filter evaluating to the names of a list of fields to assign. Either `$fields` or `$indexes` must be specified  |
+|$indexes |Optional filter evaluating to the names of a list of indexes to assign. Either `$fields` or `$indexes` must be specified |
+|$values |Filter evaluating to the values to be assigned to the fields or indexes |
+|$timestamp |Specifies whether the timestamp(s) of the target tiddler will be updated (''modified'' and ''modifier'', plus ''created'' and ''creator'' for newly created tiddlers). Can be "yes" (the default) or "no" |
+
+! Examples
+
+Here is an example of button that uses the data in [[Days of the Week]] to assign fields `day-Monday`, `day-Tuesday` etc. to the tiddler "HelloThere":
+
+<$macrocall $name='wikitext-example-without-html'
+src='<$button>
+<$action-setmultiplefields $tiddler="HelloThere" $fields="[list[Days of the Week]addprefix[day-]]" $values="[list[Days of the Week]]"/>
+Click me!
+</$button>'/>

package/editions/tw5.com/tiddlers/widgets/ActionWidget Execution Modes.tid

@@ -0,0 +1,49 @@
+created: 20211003094722447
+modified: 20211116193245990
+tags: Widgets
+title: ActionWidget Execution Modes
+
+<<.from-version "5.2.0">> The default behaviour of action widgets has some peculiarities that often cause confusion. There is now an improved mode that simplifies how things work, but due to BackwardsCompatibility constraints, it must be explicitly engaged in order to take advantage of it.
+
+The peculiarities relate to the way that the results of previous action widgets are available to subsequent action widgets. By default, action widgets are refreshed before each execution which ensure that they reflect the results of previous actions. However, ordinary widgets are not updated in the same way.
+
+In the following contrived example, a button triggers a series of actions that should result in the string `foo` being assigned to the ''text'' field of the tiddler ActionTestTiddler. However, it fails to produce the expected result because the `<$set>` widget is not refreshed with the new value of ActionTestTiddler after the execution of the first `<$action-setfield>` widget.
+
+
+<$macrocall $name='wikitext-example-without-html'
+src='\define actions()
+<$action-setfield $tiddler="ActionTestTiddler" $field="text" $value="FOO"/>
+<$set name="newvalue" value={{{ [{ActionTestTiddler}lowercase[]] }}}>
+<$action-setfield $tiddler="ActionTestTiddler" $field="text" $value=<<newvalue>>/>
+</$set>
+\end
+
+Current value of ActionTestTiddler: {{ActionTestTiddler}}
+
+<$button actions=<<actions>>>
+Click me
+</$button>'/>
+
+The new behaviour avoids these problems by refreshing all widgets before execution, not just action widgets. It is engaged by running the actions in a scope that includes the variable `tv-action-refresh-policy` set to the value `always`.  (The default value for `tv-action-refresh-policy` is `once`).
+
+The assignment can be done within an action string, or via a local variable declaration containing the widget triggering the action.
+
+<<.warning "Do not attempt to set `tv-action-refresh-policy` globally; the core will only work correctly with the default setting">>
+
+The example above works as expected with the addition of `tv-action-refresh-policy`:
+
+<$macrocall $name='wikitext-example-without-html'
+src='\define tv-action-refresh-policy() always
+
+\define actions()
+<$action-setfield $tiddler="ActionTestTiddler" $field="text" $value="FOO"/>
+<$set name="newvalue" value={{{ [{ActionTestTiddler}lowercase[]] }}}>
+<$action-setfield $tiddler="ActionTestTiddler" $field="text" $value=<<newvalue>>/>
+</$set>
+\end
+
+Current value of ActionTestTiddler: {{ActionTestTiddler}}
+
+<$button actions=<<actions>>>
+Click me
+</$button>'/>

package/editions/tw5.com/tiddlers/widgets/ActionWidgets.tid

@@ -1,10 +1,10 @@
 created: 20141008134425548
-modified: 20160429165240169
+modified: 20211031172913375
 tags: Widgets
 title: ActionWidgets
 type: text/vnd.tiddlywiki
 
-Action widgets are a special type of widget that have no visual appearance but perform an action when triggered (such as sending a message, navigating to a tiddler, or changing the value of a tiddler). Action widgets are used in association with other widgets that trigger those actions (for example, the ButtonWidget).
+Action widgets are a special type of widget that have no visual appearance but perform an action when triggered (such as sending a message, navigating to a tiddler, or changing the value of a tiddler). Action widgets are used in association with other widgets that [[trigger those actions|TriggeringWidgets]] (for example, the ButtonWidget).
 
 The following action widgets are provided:
 
@@ -12,12 +12,12 @@ The following action widgets are provided:
 
 There are two ways to use action widgets:
 
-* Using the `actions` attribute of the triggering widget (this is the preferred way)
+* Placing them within an action string attribute (typically called `actions`) on the triggering widget (this is the preferred way)
 * Embedding the actions within the triggering widget (an older technique that is now deprecated)
 
-!! Assigning action widgets with the `actions` attribute
+!! Using action string attributes
 
-The action widgets are passed as a string to the `actions` attribute of the triggering widget. Usually, it is more convenient to use a macro to assign the action widgets to a variable. For example, here is a button that triggers two actions of sending different messages:
+The action widgets are passed as a string to the `actions` attribute of the [[triggering widget|TriggeringWidgets]]. Usually, it is more convenient to use a macro to assign the action widgets to a variable. For example, here is a button that triggers two actions of sending different messages:
 
 ```
 \define my-actions()
@@ -30,9 +30,9 @@ Click me!
 </$button>
 ```
 
-!! Assigning action widgets by embedding
+!! Directly embedding action widgets
 
-The action widgets need not be immediate children of their triggering widget, but they must be descendents of it. The actions are performed in sequence. Here is the above example rewritten to use embedding:
+The action widgets need not be immediate children of their [[triggering widget|TriggeringWidgets]], but they must be descendents of it. The actions are performed in sequence. Here is the above example rewritten to use embedding:
 
 ```
 <$button>
@@ -42,3 +42,6 @@ Click me!
 </$button>
 ```
 
+! Action Execution Modes
+
+{{ActionWidget Execution Modes}}

package/editions/tw5.com/tiddlers/widgets/ButtonWidget.tid

@@ -1,7 +1,7 @@
 caption: button
 created: 20131024141900000
-modified: 20201108183908170
-tags: Widgets
+modified: 20211009121239795
+tags: Widgets TriggeringWidgets
 title: ButtonWidget
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/CheckboxWidget.tid

@@ -1,7 +1,7 @@
 caption: checkbox
 created: 20131024141900000
-modified: 20201109090732190
-tags: Widgets
+modified: 20211009121239806
+tags: Widgets TriggeringWidgets
 title: CheckboxWidget
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/DraggableWidget.tid

@@ -1,7 +1,7 @@
 caption: draggable
 created: 20170406081938627
-modified: 20190118084621046
-tags: Widgets
+modified: 20220223145136863
+tags: Widgets TriggeringWidgets
 title: DraggableWidget
 type: text/vnd.tiddlywiki
 
@@ -16,10 +16,13 @@ See DragAndDropMechanism for an overview.
 |!Attribute |!Description |
 |tiddler |Optional title of the payload tiddler for the drag |
 |filter |Optional filter defining the payload tiddlers for the drag |
-|class |Optional CSS classes to assign to the draggable element. The class `tc-draggable` is added automatically, and the class `tc-dragging` is applied while the element is being dragged |
-|tag |Optional tag to override the default "div" element |
+|tag |Optional tag to override the default "div" element created by the widget|
+|selector|<<.from-version 5.2.2>> Optional CSS Selector to identify a DOM element within the widget that will be used as the drag handle |
+|class |Optional CSS classes to assign to the DOM element created by the widget. The class `tc-draggable` is added to the drag handle, which is the same as the DOM element created by the widget unless the <<.param selector>> attribute is used. The class `tc-dragging` is applied to the drag handle while the element is being dragged |
+
 |startactions |Optional action string that gets invoked when dragging ''starts'' |
 |endactions |Optional action string that gets invoked when dragging ''ends'' |
+|dragimagetype |<<.from-version "5.2.0">> Optional type of drag image: `dom` (the default) or `blank` to disable the drag image |
 
 Either or both of the ''tiddler'' and ''filter'' attributes must be specified in order for there to be a payload to drag.
 
@@ -27,5 +30,7 @@ The [[actionTiddler Variable]] is accessible in both //startactions// and //enda
 
 <<.tip """Note that the [[actionTiddler Variable]] holds a [[Title List]] quoted with double square brackets. This is unlike the DroppableWidget which uses the same variable to pass a single unquoted title.""">>
 
+<<.tip """When specifying a DOM node to use as the drag handle with the <<.param selector>> attribute, give it the class `tc-draggable` in order for it to have the appropriate cursor.""">>
+
 
 The LinkWidget incorporates the functionality of the DraggableWidget via the ''draggable'' attribute.

package/editions/tw5.com/tiddlers/widgets/DroppableWidget.tid

@@ -1,7 +1,7 @@
 caption: droppable
 created: 20170406082820317
-modified: 20200317142604572
-tags: Widgets
+modified: 20211009122023265
+tags: Widgets TriggeringWidgets
 title: DroppableWidget
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/DropzoneWidget.tid

@@ -1,7 +1,7 @@
 caption: dropzone
 created: 20131024141900000
-modified: 20200403103224328
-tags: Widgets
+modified: 20211009122205481
+tags: Widgets TriggeringWidgets
 title: DropzoneWidget
 type: text/vnd.tiddlywiki
 
@@ -16,17 +16,22 @@ It sends a [[WidgetMessage: tm-import-tiddlers]] carrying a JSON representation
 |!Attribute |!Description |
 |deserializer |<<.from-version "5.1.15">> Optional name of deserializer to be used (by default the deserializer is derived from the file extension) |
 |enable |<<.from-version "5.1.22">> Optional value "no" to disable the dropzone functionality (defaults to "yes") |
-|class |<<.from-version "5.1.22">> Optional CSS class to be assigned to the dropzone (defaults to "tc-drag-over") |
+|class |<<.from-version "5.1.22">> Optional CSS class to be assigned to the DOM node created by the dropzone (defaults to "tc-dropzone") |
 |autoOpenOnImport |<<.from-version "5.1.23">> Optional value "no" or "yes" that can override tv-auto-open-on-import |
-|importTitle|<<.from-version "5.1.23">> optional tiddler title to use for import process instead of ~$:/Import |
+|importTitle|<<.from-version "5.1.23">> Optional tiddler title to use for import process instead of ~$:/Import |
+|actions|<<.from-version "5.2.0">> Optional actions string to be invoked after the `tm-import-tiddlers` message has been sent. The variable `importTitle` provides the title of the tiddler used for the import process. |
+|contentTypesFilter |<<.from-version "5.2.0">> Optional filter that specifies the [[content types|ContentType]] accepted by the dropzone. |
+|filesOnly|<<.from-version "5.2.0">> Optional. When set to "yes", the dropzone only accepts files and not string data. Defaults to "no" |
 
-The list of available deserializers can be inspected by executing `Object.keys($tw.Wiki.tiddlerDeserializerModules).sort().join("\n")` in the browser JavaScript console.
+<<.tip """Use the `prefix` filter operator to easily accept multiple related content types. For example this filter will accept all image content types: `[prefix[image/]]`""">>
+
+<<.tip "The list of available deserializers can be seen by using the filter `[deserializers[]]` in the Filter tab in [[Advanced Search|$:/AdvancedSearch]].">>
 
 The dropzone widget displays any contained content within the dropzone.
 
 ! Display
 
-The dropzone widget creates an HTML `<div class="tc-dropzone">` to contain its content. During a drag operation the class `tc-dragover` is added. CSS is used to provide user feedback.
+The dropzone widget creates an HTML `<div class="tc-dropzone">` to contain its content. During a drag operation the class `tc-dragover` is added. CSS is used to provide user feedback. For custom styling of this state where a drag is in progress, specify a custom class name with the `class` attribute and use CSS with the selector `.myclass.tc-dragover`.
 
 ! Data types supported
 

package/editions/tw5.com/tiddlers/widgets/EditTextWidget.tid

@@ -1,6 +1,6 @@
 caption: edit-text
 created: 20131024141900000
-modified: 20201130184701532
+modified: 20211104200554064
 tags: Widgets
 title: EditTextWidget
 type: text/vnd.tiddlywiki
@@ -28,33 +28,23 @@ The content of the `<$edit-text>` widget is ignored.
 |autocomplete |<<.from-version 5.1.23>> An optional string to provide a hint to the browser how to handle autocomplete for this input |
 |tag |Overrides the generated HTML editing element tag. For a multi-line editor use `tag=textarea`. For a single-line editor use `tag=input` |
 |type |Overrides the generated HTML editing element `type` attribute |
-|size |The size of the input field (in characters) |
+|size |The size of the input field (in characters). This exact result depends on browser and font. Use the `class` attribute to style width for precise control |
 |autoHeight |Either "yes" or "no" to specify whether to automatically resize `textarea` editors to fit their content (defaults to "yes") |
 |minHeight |Minimum height for automatically resized `textarea` editors, specified in CSS length units such as "px", "em" or "%" |
 |rows|Sets the rows attribute of a generated textarea |
 |cancelPopups |<<.from-version "5.1.23">> if set to "yes", cancels all popups when the input gets focus |
-|inputActions |<<.from-version 5.1.23>> Optional actions that are triggered every time an input event occurs within the input field or textarea |
+|inputActions |<<.from-version 5.1.23>> Optional actions that are triggered every time an input event occurs within the input field or textarea.<br><<.from-version "5.2.1">> The variable `actionValue` is available to the `inputActions` and contains the value of the input field. |
 |refreshTitle |<<.from-version 5.1.23>> An optional tiddler title that makes the input field update whenever the specified tiddler changes |
 |disabled|<<.from-version "5.1.23">> Optional, disables the text input if set to "yes". Defaults to "no"|
+|fileDrop|<<.from-version "5.2.0">> Optional. When set to "yes" allows dropping or pasting images into the editor to import them. Defaults to "no"|
 
-! Notes
 
-One trap to be aware of is that the edit text widget //cannot be used// to edit a field of the tiddler that contains it. Each keypress results in the tiddler being re-rendered, which loses the cursor position within the text field.
+! Example
 
-Instead, place the edit text widget in a [[template|TemplateTiddlers]] that references the tiddler you want to modify.
+If you wanted to change the field //myconfig// of the tiddler //AppSettings//, you could use an EditTextWidget to edit the field, and then show the result anywhere else by using `{{AppSettings!!myconfig}}`. Note that this will create tiddler AppSettings if it doesn't already exist.
 
-For example, if you wanted the tiddler GettingStarted to edit the value of the "myconfig" field of the tiddler "AppSettings", you might do so by creating a separate tiddler "ChangeAppSettings" that contains the following:
+<$macrocall $name=".example" n="1"
+eg="""<$edit-text tiddler="AppSettings" field="myconfig"/><p/>
+Value of ''myconfig'' : {{AppSettings!!myconfig}}
+"""/>
 
-```
-<$edit-text tiddler="AppSettings" field="myconfig"/>
-```
-
-And reference the template in any other tiddler (e.g. GettingStarted) with `{{ChangeAppSettings}}`.
-
-This works when your use of the tiddler //is not// the AppSettings itself which would cause a recursion problem. In this latter case you have to save the fields to a temporary (or alternative) tiddler (sort of the reverse of above) like so:
-
-```
-<$edit-text tiddler="StoreAppSettings" field="myconfig"/>
-```
-
-In short the EditTextWidget //can not// change properties of the tiddler it is embedded in or part of. It can only change fields of //other// tiddlers. One could use ShadowTiddlers to accomplish the field storage if needed.

package/editions/tw5.com/tiddlers/widgets/EditWidget.tid

@@ -1,7 +1,7 @@
 caption: edit
 created: 20131024141900000
-modified: 20201130184647904
-tags: Widgets
+modified: 20211009121634055
+tags: Widgets TriggeringWidgets
 title: EditWidget
 type: text/vnd.tiddlywiki