This page is part of a static HTML representation of the TiddlyWiki at

tabs Macro

21st February 2015 at 9:17pm
Core Macros Macros

The tabs macro presents a selection of tiddlers as a set of tabs that the user can switch between.

The tabs display the caption field of a tiddler if it has one, or the tiddler's title otherwise. If specified, the tabs display the tooltip field of a tiddler as the respective button tooltip.

By default the tabs are arranged horizontally above the content. To get vertical tabs, set the class parameter to tc-vertical.


A filter selecting which tiddlers to include
The title of the tiddler whose tab is to be selected by default
The prefix for the title of a state tiddler for noting the currently selected tab, defaulting to $:/state/tab. It is recommended that this be a system tiddler
Additional CSS classes for the generated div elements. Multiple classes can be separated with spaces
Optionally, the title of a tiddler to use as a template for transcluding the content of the selected tab

Within the template, the title of the selected tab is available in the currentTab variable.

The currentTiddler variable is not affected by the tabs macro. This can put you in trouble if the list of tabs includes tiddlers that depend on the value of the currentTiddler, for example tiddlers listing children based on its own name. To overcome this problem you can use a TemplateTiddler like the following:

<$tiddler tiddler=<<currentTab>>>
<$transclude mode="block" />

<<.macro-examples "tabs">>