created: 20230309202111093
creator: H La Vallee
modified: 20230721191954644
modifier: H La Vallee
tags: $:/tags/Macro meta
title: ButtonListMacro
type: text/vnd.tiddlywiki

\procedure buttonlist(listTag clickTag icon sort)
<$let
default="[!sort[created]]"
plus={{{[<sort>prefix[:]then[]else[+]]}}}
sortop={{{[<sort>!match[]else<default>]}}}
filterpre="[tag[<<listTag>>]!is[system]] <<plus>><<sortop>>">
<$wikify text=<<filterpre>> name=filter>
<$list filter=<<filter>>>
<$fieldmangler tiddler=<<currentTiddler>>>
<$button class="tc-btn-invisible" actions="""<$action-sendmessage $message="tm-add-tag" $param=<<clickTag>>/><$action-sendmessage $message="tm-remove-tag" $param=<<listTag>>/>""">
<$transclude tiddler=<<icon>>>x</$transclude>
</$button>
<$link to=<<currentTiddler>> text=<<currentTiddler>>/><br>
</$fieldmangler>
</$list>
</$wikify>
</$let>
\end

\procedure buttonlisttable(listTag clickTag icon sort)
<$let
default="[!sort[created]]"
plus={{{[<sort>prefix[:]then[]else[+]]}}}
sortop={{{[<sort>!match[]else<default>]}}}
filterpre="[tag[<<listTag>>]!is[system]] <<plus>><<sortop>>">
<$wikify text=<<filterpre>> name=filter>
<table style="width:100%">
<tr>
<td><<clickTag>></td>
<th><<listTag>></th>
</tr>
<$list filter=<<filter>>>
<$fieldmangler tiddler=<<currentTiddler>>>
<tr>
<td><$button class="tc-btn-invisible" style="width:100%" actions="""<$action-sendmessage $message="tm-add-tag" $param=<<clickTag>>/><$action-sendmessage $message="tm-remove-tag" $param=<<listTag>>/>""">
<$transclude tiddler=<<icon>>>x</$transclude>
</$button></td>
<td><$link to=<<currentTiddler>> text=<<currentTiddler>>/></td><br>
</tr>
</$fieldmangler>
</$list>
</table>
</$wikify>
</$let>
\end

\procedure buttonlist2(listTag clickTag icon clickTag2 icon2 sort)
<$let
default="[!sort[created]]"
plus={{{[<sort>prefix[:]then[]else[+]]}}}
sortop={{{[<sort>!match[]else<default>]}}}
filterpre="[tag[<<listTag>>]!is[system]] <<plus>><<sortop>>">
<$wikify text=<<filterpre>> name=filter>
<$list filter=<<filter>>>
<$fieldmangler tiddler=<<currentTiddler>>>
<$button class="tc-btn-invisible" actions="""<$action-sendmessage $message="tm-add-tag" $param=<<clickTag>>/><$action-sendmessage $message="tm-remove-tag" $param=<<listTag>>/>""">
<$transclude tiddler=<<icon>>>x</$transclude>
</$button>
<$link to=<<currentTiddler>> text=<<currentTiddler>>/>
<$button class="tc-btn-invisible" actions="""<$action-sendmessage $message="tm-add-tag" $param=<<clickTag2>>/><$action-sendmessage $message="tm-remove-tag" $param=<<listTag>>/>""">
<$transclude tiddler=<<icon2>>>x</$transclude>
</$button>
<br>
</$fieldmangler>
</$list>
</$wikify>
</$let>
\end

\procedure buttonlisttable2(listTag clickTag icon clickTag2 icon2 sort)
<$let
default="[!sort[created]]"
plus={{{[<sort>prefix[:]then[]else[+]]}}}
sortop={{{[<sort>!match[]else<default>]}}}
filterpre="[tag[<<listTag>>]!is[system]] <<plus>><<sortop>>">
<$wikify text=<<filterpre>> name=filter>
<table>
<tr>
<td><<clickTag>></td>
<th><<listTag>></th>
<td><<clickTag2>></td>
</tr>
<$list filter=<<filter>>>
<$fieldmangler tiddler=<<currentTiddler>>>
<tr>
<td><$button class="tc-btn-invisible" style="width:100%" actions="""<$action-sendmessage $message="tm-add-tag" $param=<<clickTag>>/><$action-sendmessage $message="tm-remove-tag" $param=<<listTag>>/>""">
<$transclude tiddler=<<icon>>>x</$transclude>
</$button></td>
<td><$link to=<<currentTiddler>> text=<<currentTiddler>>/></td>
<td><$button class="tc-btn-invisible" style="width:100%" actions="""<$action-sendmessage $message="tm-add-tag" $param=<<clickTag2>>/><$action-sendmessage $message="tm-remove-tag" $param=<<listTag>>/>""">
<$transclude tiddler=<<icon2>>>x</$transclude>
</$button></td>
</tr>
</$fieldmangler>
</$list>
</table>
</$wikify>
</$let>
\end

A handful of macros to list tiddlers by a tag (called listTag), with a button to replace the tag with a different one (called clickTag).

An image or svg tiddler can be specified as the icon, otherwise it will just use an "x".

To have the tiddlers shown in a nice table, use the `buttonlisttable` macro!

If you would like to have 2 options for tags, use the `buttonlist2` or `buttonlisttable2` macros, which support another button on the right side of the text that can switch to a second tag.

The last parameter (`sort`) is optional and allows for custom sort filter runs. Defaults to `[!sort[created]]`, sorting in order of creation date (newest first).

> Advanced: filter run prefixes beginning with `:` can also be used on the `sort` parameter. If one is not included, the run prefix defaults to `+`. Example: `:sort:number[]`

!!!Syntax:

`<<buttonlist listTag clickTag icon sort>>`

`<<buttonlist2 listTag clickTag icon clicktag2 icon2 sort>>`

`<<buttonlisttable listTag clickTag icon sort>>`

`<<buttonlisttable2 listTag clickTag icon clicktag2 icon2 sort>>`

!!!Example/Demo (tag some tiddlers with "now"):

---
!!My Todo List
!!!__Now__
`<<buttonlisttable2 now done $:/core/images/save-button pending $:/core/images/mail>>`

<<buttonlisttable2 now done $:/core/images/save-button pending $:/core/images/mail>>
!!! __Done__
`<<buttonlisttable done now $:/core/images/up-arrow>>`

<<buttonlisttable done now $:/core/images/up-arrow>>

!!!__Pending__
`<<buttonlisttable pending now $:/core/images/up-arrow>>`

<<buttonlisttable pending now $:/core/images/up-arrow>>