From cd2d4b3eb7b5a0eebd0d78c4dccdbd331a234976 Mon Sep 17 00:00:00 2001 From: yaisog Date: Wed, 29 May 2024 12:39:41 +0200 Subject: [PATCH] Clarify handling of title lists in ActionListopsWidget documentation (#8184) * Improve section on subfilter expressions * Further refinement of the info box. --- editions/tw5.com/tiddlers/widgets/ActionListopsWidget.tid | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/editions/tw5.com/tiddlers/widgets/ActionListopsWidget.tid b/editions/tw5.com/tiddlers/widgets/ActionListopsWidget.tid index 3771ab445..ec9faf68b 100644 --- a/editions/tw5.com/tiddlers/widgets/ActionListopsWidget.tid +++ b/editions/tw5.com/tiddlers/widgets/ActionListopsWidget.tid @@ -1,6 +1,6 @@ caption: action-listops created: 20141025120850184 -modified: 20230805103548113 +modified: 20240509135041526 myfield: tags: ActionWidgets Widgets title: ActionListopsWidget @@ -35,10 +35,12 @@ The above widget will toggle the presence of the element <<.value "List Item">> Similarly, if an element is to always be removed when it is present, the `-` / `:except` [[filter run prefix|Filter Expression]] can be used. Both of the following yield the same result: ``` -<$action-listops $subfilter="-[[List Item]]"/> -<$action-listops $subfilter="+[remove[List Item]]"/> +<$action-listops $subfilter="-[[ListItem]]"/> +<$action-listops $subfilter="+[remove[ListItem]]"/> ``` +<<.infoBox """Note that the parameter of the [[remove Operator]] is a [[Title List]]. To remove one or more titles containing spaces the individual titles must be wrapped in double square brackets, usually via a soft [[Filter Parameter]]. See //Filtered List Variable Assignment// in the [[SetWidget]] documentation to learn more.""">> + Without any prefixes, the filter run output is simply [[dominantly appended|Dominant Append]] to the list. See also the [[Examples|ActionListopsWidget (Examples)]].