mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-12-28 19:10:28 +00:00
2f21cbc971
Adding how to deal with transclusions inside the tabs itself. It is not weird that you want use tabs on a set of tiddlers that transclude other tiddlers using their own title. If you don't understand well the consequences of of what the sentence `currentTiddler variable is not affected...` this can be quite frustrating.
38 lines
1.8 KiB
Plaintext
38 lines
1.8 KiB
Plaintext
caption: tabs
|
|
created: 20131228162203521
|
|
modified: 20150221211706000
|
|
tags: Macros [[Core Macros]]
|
|
title: tabs Macro
|
|
type: text/vnd.tiddlywiki
|
|
|
|
The <<.def tabs>> [[macro|Macros]] presents a [[selection of tiddlers|Title Selection]] as a set of tabs that the user can switch between.
|
|
|
|
The tabs display the <<.field caption>> field of a tiddler if it has one, or the tiddler's title otherwise. If specified, the tabs display the <<.field 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 <<.param class>> parameter to <<.value tc-vertical>>.
|
|
|
|
!! Parameters
|
|
|
|
;tabsList
|
|
: A [[filter|Filters]] selecting which tiddlers to include
|
|
;default
|
|
: The title of the tiddler whose tab is to be selected by default
|
|
;state
|
|
: The prefix for the title of a [[state tiddler|StateMechanism]] for noting the currently selected tab, defaulting to `$:/state/tab`. It is recommended that this be a [[system tiddler|SystemTiddlers]]
|
|
;class
|
|
: Additional [[CSS|Cascading Style Sheets]] classes for the generated `div` elements. Multiple classes can be separated with spaces
|
|
;template
|
|
: Optionally, the title of a tiddler to use as a [[template|TemplateTiddlers]] for transcluding the content of the selected tab
|
|
|
|
Within the template, the title of the selected tab is available in the <<.var currentTab>> variable.
|
|
|
|
The <<.vlink currentTiddler>> variable is not affected by the <<.var tabs>> macro. This can put you in trouble if the list of tabs includes tiddlers that depend on the value of the <<.vlink currentTiddler>>, for example tiddlers listing children based on its own name. To overcome this problem you can use a [[TemplateTiddler|TemplateTiddlers]] like the following:
|
|
|
|
```
|
|
<$tiddler tiddler=<<currentTab>>>
|
|
<$transclude mode="block" />
|
|
</$tiddler>
|
|
```
|
|
|
|
<<.macro-examples "tabs">>
|