← New: AnnotationsPlugin and FootnotesPlugin

New: TiddlerNotesPlugin →

How to: List tiddlers by tags - the filter tipped way.

October 23rd, 2007 | Development, How To, TiddlyWiki

One of the most often asked questions by new TiddlyWiki users is, “How can I get a list of all tiddlers with a particular tag?”.

Thanks to one of the new features in TiddlyWiki version 2.2.6, there is a very easy way to do it now. The filter tipped way.

TiddlyWiki has a ‘list’ macro, which has been extended to use the new filter syntax introduced in TiddlyWiki. How do you use it? It couldn’t be simpler:

<<list filter [tag[MyFavouriteTag]]>> generates a list of tiddlers with the tag MyFavouriteTag.

You could also do <<list filter [tag[MyFavouriteTag]] [tag[AnotherTag]]>> to get a list of tiddlers with the tag MyFavouriteTag or AnotherTag. However, currently a small bug will make a tiddler appear twice in the list if it has both tags. But do not despair! This will be fixed in the next release, hopefully along with another powerful feature, the ability to exclude tiddlers with a given tag.

What this means is that very soon you should be able, to do something like this:

<<list filter [tag[MyFavouriteTag]] [tag[AnotherTag]] [!tag[[NotThisTag]]>>

Please note the ! before the last tag, to imply that we do no want to include tiddlers with this tag. What this will give us, is an extremely powerful and versatile way of filtering and listing tiddlers by tags, without the need for any plugins!

Bookmark at: StumbleUpon | Digg | Del.icio.us | Dzone | Spurl | Furl | Reddit

8 comments ↓

#1 FND on 10.23.07 at 5:37 pm

Nice discovery, Saq - thanks for sharing!

#2 Dave Gifford on 10.23.07 at 8:07 pm

Wow, great! That will greatly reduce my need for the ForEachTiddlerPlugin!

#3 Saq on 10.24.07 at 12:27 am

Dave: My thoughts exactly! While the ForEachTiddlerPlugin is a terrific plugin, given its hefty size, it is overkill for just listing tiddlers.

FND: My pleasure!

#4 Curt on 01.16.08 at 10:09 pm

Is there any way to sort using <>?

#5 ocalTW on 04.28.08 at 9:09 pm

Hi Saq
You wrote “What this means is that very soon you should be able, to do something like this: …”.
Is it available now or will it be available with TW 2.4.0?

#6 Rob on 05.13.08 at 5:50 am

Nice one,

I would like to see an “AND” construct as well, so that I can filter for a list of tiddlers matching “tag one” AND “tag two”. :)

#7 jean-cedric T. on 08.12.08 at 4:56 pm

EXCELLENT, do somebody have the time to report this on the official wiki [[tiddlyWiki Wiki|tiddlywiki.org]]

#8 Sjoerd on 12.24.08 at 11:19 am

Thanks for the work! Filtering tiddlers for containing tag X and tag y would really be a great feature.

Leave a Comment