A grouped list is made by nesting one list inside another. The outer list collects each distinct value of a field, and the inner list finds the tiddlers holding that value.

TiddlyWiki uses the pattern in two of its sidebar tabs. The Types Tab groups tiddlers by their type field, and sits under More in the sidebar. The Recent Tab groups them by day, through the timeline macro. Both are reproduced as examples below.

Interactive Examples

Each example is a runnable test case carrying its own sample data. Where a field is grouped on, it is named once in groupField, so the grouping can be changed without touching anything else.

GroupedLists/Example/TypesTab

Group tiddlers by their type, as the sidebar Types tab does

GroupedLists/Example/ByField

Group tiddlers by the value of a field chosen in one place

GroupedLists/Example/WithSearch

Narrow a grouped list with a search box

GroupedLists/Example/WithTabs

Bucket the groups into tabs by first character, with a count per tab

GroupedLists/Example/TabsWithSearch

Combine the tab strip with a search box inside the tab panel

GroupedLists/Example/SearchAnotherField

Group by one field while the search box filters on another

GroupedLists/Example/RecentTab

Group tiddlers by day with the timeline macro, as the sidebar Recent tab does