More actions
m (borrowing this as a template very briefly) |
m (Text replacement - "recognised" to "recognized") |
||
(One intermediate revision by one other user not shown) | |||
Line 1: | Line 1: | ||
This page contains documentation and demos for the tabs extension. | This page contains documentation and demos for the tabs extension. | ||
Paste this text on a wiki article with the tabs extension installed | Paste this text on a wiki article with the tabs extension installed | ||
Line 319: | Line 318: | ||
|<code style="color: green;"><nowiki>{{#tab:name1/#1, name2/#2, etc|content 1|content 2|etc}}</nowiki></code> | |<code style="color: green;"><nowiki>{{#tab:name1/#1, name2/#2, etc|content 1|content 2|etc}}</nowiki></code> | ||
|Each of the defined names will be set as <code>name</code> or <code>index</code> attributes, respectively. | |Each of the defined names will be set as <code>name</code> or <code>index</code> attributes, respectively. | ||
*All values that are prefixed with <code>#</code>, and are numbers only will be | *All values that are prefixed with <code>#</code>, and are numbers only will be recognized as indices. For indices, surrounding whitespace is allowed, but internal whitespace or any non-number characters such as decimal points aren't. | ||
*If these condtions are not met, the entered value is interpreted as a name. | *If these condtions are not met, the entered value is interpreted as a name. | ||
*If the entered value contains only whitespace or is left empty, the index of that tab is automatically calculated. | *If the entered value contains only whitespace or is left empty, the index of that tab is automatically calculated. | ||
Line 471: | Line 470: | ||
In some cases, it is possible to put multiple of these boxes inside each other. For this to work however, the <code>#tag:tabs</code>, <code>#tag:tab</code> or <code>#tab:</code> parser functions will have to be used whenever two of the same tags are used anywhere within each other. This is required because otherwise the wikicode parser will recognise the closing tag for the nested tag as the closing tag for the outer tag, and skip the rest of the content, which could cause problems. | In some cases, it is possible to put multiple of these boxes inside each other. For this to work however, the <code>#tag:tabs</code>, <code>#tag:tab</code> or <code>#tab:</code> parser functions will have to be used whenever two of the same tags are used anywhere within each other. This is required because otherwise the wikicode parser will recognise the closing tag for the nested tag as the closing tag for the outer tag, and skip the rest of the content, which could cause problems. | ||
For the <code>#tag:</code> parser function, even boolean attributes (such as <code>dropdown</code> or <code>inline</code>) need to have a value defined for them, otherwise they are not | For the <code>#tag:</code> parser function, even boolean attributes (such as <code>dropdown</code> or <code>inline</code>) need to have a value defined for them, otherwise they are not recognized as attributes. For example, <code><nowiki>{{#tag:tab|Dropdown contents|dropdown}}</nowiki></code> will not work (it will show a toggle box instead of a dropdown), while <code><nowiki>{{#tag:tab|Dropdown contents|dropdown=true}}</nowiki></code> will show a dropdown box. | ||
All combinations of nesting multiple tags will work, except for nesting ''any'' tab menus inside other tab menus. | All combinations of nesting multiple tags will work, except for nesting ''any'' tab menus inside other tab menus. | ||
Line 551: | Line 550: | ||
==== Toggle boxes and dropdowns in tab boxes ==== | ==== Toggle boxes and dropdowns in tab boxes ==== | ||
If you want to place a toggle box or a dropdown inside a tab navigation, and want the toggle box to show up for every tab as opposed to just the tab it's nested in, first a parent <code><tab></code> tab must be made, with <code>index="*"</code>, so that the toggle box won't be | If you want to place a toggle box or a dropdown inside a tab navigation, and want the toggle box to show up for every tab as opposed to just the tab it's nested in, first a parent <code><tab></code> tab must be made, with <code>index="*"</code>, so that the toggle box won't be recognized as a seperate tab content. | ||
If you want to place a toggle box or dropdown menu inside a tab menu, you can simply place a <code><tab></code> tag inside the <code><tab></code> tag that functions as a tab. This will restrict toggle boxes and dropdowns to visibility in just one tab though. So, if you want to have a toggle box or dropdown that's visible in every tab, encase it in a <code><tab></code> tag with an <code>index="*"</code> set to it. | If you want to place a toggle box or dropdown menu inside a tab menu, you can simply place a <code><tab></code> tag inside the <code><tab></code> tag that functions as a tab. This will restrict toggle boxes and dropdowns to visibility in just one tab though. So, if you want to have a toggle box or dropdown that's visible in every tab, encase it in a <code><tab></code> tag with an <code>index="*"</code> set to it. | ||
That way, the outer <code><tab></code> tag will be | That way, the outer <code><tab></code> tag will be recognized as a tab container, and the inner one will be recognized as a toggle box or dropdown menu, as desired. The toggle box or dropdown must then also use the [[#Nested combinations|parser function syntax]]. | ||
If you want the contents of the toggle box inside the tab menu to be able to change depending on the selected tab, you should use the <code>nested="true"</code> attribute on the tag. This can be done by setting the very last argument of the <code>#tab:</code> parser function or the <code>#tag:tab</code> parser function to <code>nested=true</code>. | If you want the contents of the toggle box inside the tab menu to be able to change depending on the selected tab, you should use the <code>nested="true"</code> attribute on the tag. This can be done by setting the very last argument of the <code>#tab:</code> parser function or the <code>#tag:tab</code> parser function to <code>nested=true</code>. | ||
Line 622: | Line 621: | ||
{{#tag:tab|Here's a dropdown inside a dropdown, but not in any list|dropdown=true}} | {{#tag:tab|Here's a dropdown inside a dropdown, but not in any list|dropdown=true}} | ||
</tab> | </tab> | ||
Latest revision as of 22:33, 22 January 2021
This page contains documentation and demos for the tabs extension. Paste this text on a wiki article with the tabs extension installed to view these demos.
Installation
Configuration
This extension has no configuration options in LocalSettings.php
, but it does have the MediaWiki:tabs-dropdown-bgcolor message associated with it, which is not meant to be translated. This message contains the default value for the background-color
style for dropdown menus. This needs to be a valid background-color
value.
It also has the following internationalisation messages associated with it:
- MediaWiki:tabs-tab-label - The default label for a tab. The
$1
stands for the index of the tab. - MediaWiki:tabs-toggle-open - The default opening label for toggle boxes.
- MediaWiki:tabs-toggle-close - The default closing label for toggle boxes.
- MediaWiki:tabs-dropdown-label - The default label for a dropdown menu.
Usage
General usage information
Note: - This extension uses the bgcolor
attribute for dropdown menus. This is in no way meant as encouragement for the use of this deprecated attribute anywhere other than this tag.
For both the <tab>
and <tabs>
tags, parser functions can be used within the content of the tag, but not in the attributes. To use parser functions within the attributes, the #tag:tabs
or #tag:tab
parser functions should be used. The #tab
parser function will also work, but since the only attributes it can define are the index
and name
attributes, these don't allow complete support.
For example, this will not work:
<tabs style="color:{{#if:{{{1|}}}|green|red}}"> <tab name="{{{1|}}}">Foo</tab> <tab name="{{{2|}}}">Bar</tab> </tabs>
But this will work:
{{#tag:tabs| {{#tag:tab|Foo|name={{{1|}}}}} {{#tab:{{{2|}}}|Bar}} |style=color:{{#if:{{{1|}}}|green|red}} }}
Hotlinking tabs
It is possible to hotlink tabs the same way as hotlinking sections on pages. Simply put the tab label in the URL, and the page will automatically scroll to the top of the tab, and open the selected tab. This will always open only the very first tab that has the specified tab label (for example, if there are two tab boxes that both have a tab labelled "Tab 1", putting #Tab_1
in the URL will scroll to the first one on the page). If there is already another element on the page that could be scrolled to, such as a page section, that other element will have priority, and the tab will not be focused.
Toggle box
Documentation
You can create a simple collapsible box by enclosing some content between <tab> ... </tab>
. All content within the tags will be displayed within the toggle box.
Available attributes:
collapsed
- If this attribute is set, the toggle box will appear collapsed when the page loads. Otherwise it will be opened.inline
- If this attribute is set, the toggle box can be placed within text without interrupting the flow of the text.dropdown
- See #Dropdown menus.- Name attributes:
openname
- The label for the toggle box that indicates that clicking it will close the box. Default value is stored in the MediaWiki:tabs-toggle-open page.closename
- Same asopenname
, but for closing the toggle box. Default is stored in MediaWiki:tabs-toggle-close.name
- If neither theopenname
andclosename
is defined, this value will be used for both states.- If only one of the
openname
orclosename
attributes is defined, the other will take its value. If neither is defined, and thename
attribute is also not defined, the default values are taken from the respective MediaWiki pages.
container
- Use this attribute to define any styles for the toggle box container. Styles defined here will only affect the content of the toggle box, not the label.- Default HTML attributes:
Toggle box demos
Plain toggle box
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tab>This toggle box has no attributes assigned to it.</tab>
</tab>
<tab>This toggle box has no attributes assigned to it.</tab>
Toggle box attributes
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tab collapsed openname="Toggle" style="font-weight:bold;width:500px;" container="font-style:italic;" title="Example tooltip"> This toggle box has the following attributes defined: *<code>collapsed</code> - By default, it is closed. *<code>openname="Toggle"</code> - The label will show "Toggle" when it can be clicked to open the box. Since no <code>closename</code> attribute is defined, it defaults to "Toggle" too. *<code>style="font-weight:bold;width:500px;"</code> - The whole toggle box will be bold, and have a width of 500px. *<code>container="font-style:italic;"</code> - Only the contents of the toggle box will be italic. *<code>title="Example tooltip"</code> - The tooltip that shows when hovering over this tab is defined via the <code>title</code> attribute. </tab>
</tab>
<tab collapsed openname="Toggle" style="font-weight:bold;width:500px;" container="font-style:italic;" title="Example tooltip"> This toggle box has the following attributes defined:
collapsed
- By default, it is closed.openname="Toggle"
- The label will show "Toggle" when it can be clicked to open the box. Since noclosename
attribute is defined, it defaults to "Toggle" too.style="font-weight:bold;width:500px;"
- The whole toggle box will be bold, and have a width of 500px.container="font-style:italic;"
- Only the contents of the toggle box will be italic.title="Example tooltip"
- The tooltip that shows when hovering over this tab is defined via thetitle
attribute.
</tab>
Inline toggle boxes
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tab inline collapsed openname="Show" closename="Hide">
</tab>
Here is an example of an inline toggle box. <tab inline collapsed openname="Show" closename="Hide">This togglebox is inline
and collapsed
</tab> This toggle box has the attributes openname="Show"
and closename="Hide"
to change the default label text.
Documentation
Dropdown menus are made by simply defining the dropdown
attribute on a toggle box. They can be opened by either hovering over the label, or by clicking on the label to keep it opened even after moving away the cursor. Dropdown menus have an opening delay of 0.2 seconds built in to prevent accidental opening when hovering over the label, and to prevent accidental closing when accidentally moving the cursor off the dropdown. This delay is enough to prevent accidents like those, but is not enough to be bothersome.
Dropdown menus are heavily based on the code for toggle boxes, so will also resemble them in many ways. There are a couple of quite distinct differences though.
Since dropdown menus use the <menu>
tag for their content, it is permitted to use <li>
tags directly within the dropdown menu's contents. Any other content is also allowed.
Dropdown menus will convert all list items and links placed within to specially styled list items. The only exception is that links only show as they normally do when placed within unordered lists (any line starting with *
). In ordered lists, or outside list items, they take up the full list item. This is also the only difference between ordered and unordered lists.
Any nested lists will be rendered as sub-menus in the dropdown menu. Nested lists are created by starting a line with multiple *
or #
characters. There is one limitation with this however: Individual nested lists can not alternate between ordered and unordered lists. Seperate levels can, however. For example, this is not allowed:
*Menu item 1 *Menu item 2 **Sub-menu item 1 *#Sub-menu item 2
But this is:
*Menu item 1 #Menu item 2 #*Sub-menu item 1 #*Sub-menu item 2 #*#Sub-sub-menu item 1
Available attributes:
- All attributes that are available for toggle boxes
dropdown
- Must be defined for the toggle box to become a dropdown menu.openname
andclosename
- These attributes are identical to thename
attribute in dropdown menus. It is not possible to let the dropdown switch between 2 values. If theopenname
attribute is set, that value will be used as label, otherwise theclosename
value is used, and if neither of those values is set, thename
value is used.bgcolor
- Because of how the background-color styling for dropdown works (background styles are applied to all items within dropdowns, otherwise they would become transparent), background colors need to be defined seperately. This must be done in thebgcolor
attribute. This attribute works exactly the same as thebackground-color
style in CSS. This defaults to the value defined in MediaWiki:tabs-dropdown-bgcolor.
Dropdown demos
Dropdown without lists
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tab dropdown style="width:300pt" openname="Click/hover to show" closename="Showing..."> This dropdown contains no lists, so it will not have any of the styling designed for dropdowns. It does work as it normally would though. This dropdown also has its <code>style</code> attribute set to <code>style="width:300pt"</code>. It also has different <code>openname</code> and <code>closename</code> attributes, so it defaults to the <code>openname</code> value. </tab>
</tab>
<tab dropdown style="width:300pt" openname="Click/hover to show" closename="Showing..."> This dropdown contains no lists, so it will not have any of the styling designed for dropdowns. It does work as it normally would though.
This dropdown also has its style
attribute set to style="width:300pt"
. It also has different openname
and closename
attributes, so it defaults to the openname
value.
</tab>
Background-color for dropdowns
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tab dropdown bgcolor="salmon}body{font-weight:bold;"> This tab has a its <code>bgcolor</code> attribute set to <code>bgcolor="salmon"</code>. Just defining a <code>background-color</code> style would not work. </tab>
</tab>
<tab dropdown bgcolor="salmon}body{font-weight:bold;">
This tab has a its bgcolor
attribute set to bgcolor="salmon"
.
Just defining a background-color
style would not work.
</tab>
Lists and links
Here you can see the difference between unordered and ordered lists within dropdowns. The appearance of both does not change, but the behaviour of links within them does.
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tab dropdown> #The first 2 items use ordered lists, which will show links as list items too. #[[#Dropdown demos|Example link]] *From here on this dropdown uses ordered lists, so links are shown within text. *See this [[#Dropdown demos|example link]]. *Any links in dropdown menus placed outside lists will also be rendered as list items, like the following link: [[#Dropdown demos|Example link]] </tab>
</tab>
<tab dropdown>
- The first 2 items use ordered lists, which will show links as list items too.
- Example link
- From here on this dropdown uses ordered lists, so links are shown within text.
- See this example link.
- Any links in dropdown menus placed outside lists will also be rendered as list items, like the following link:
Example link </tab>
Inline dropdowns
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tab dropdown inline> *You can do anything you'd normally do in a dropdown *This box will fit in with the text. </tab>
</tab>
It is also possible to create inline dropdowns: <tab dropdown inline>
- You can do anything you'd normally do in a dropdown
- This box will fit in with the text.
</tab>. This will also not interrupt the flow of the text.
Nested lists
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tab dropdown> *This dropdown menu demonstrates dropdown menus with multiple levels. *Hovering over a list item with further lists nested within it will cause the next level to show up *Hover over this item to see **This list now shows up. **Nested lists can also contain even more lists **See this item for example ***This is a third level menu **This can go on for any amount of levels. *Multiple sub-menus are also allowed **Such as this one. </tab>
</tab>
<tab dropdown>
- This dropdown menu demonstrates dropdown menus with multiple levels.
- Hovering over a list item with further lists nested within it will cause the next level to show up
- Hover over this item to see
- This list now shows up.
- Nested lists can also contain even more lists
- See this item for example
- This is a third level menu
- This can go on for any amount of levels.
- Multiple sub-menus are also allowed
- Such as this one.
</tab>
Alternating ordered and unordered lists
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tab dropdown> *It is possible to alternate between ordered and unordered lists, but not within sub-menus. *The first 2 items are unordered list items #And this is an ordered list item #*This is an unordered list item again #*This also ''has'' to be an unordered list item #*#This can be an ordered list item again though #*#But then this also has to be ordered. #*Within an individual sub-menu, it is not possible to change between ordered and unordered list items </tab>
</tab>
<tab dropdown>
- It is possible to alternate between ordered and unordered lists, but not within sub-menus.
- The first 2 items are unordered list items
- And this is an ordered list item
- This is an unordered list item again
- This also has to be an unordered list item
- This can be an ordered list item again though
- But then this also has to be ordered.
- Within an individual sub-menu, it is not possible to change between ordered and unordered list items
</tab>
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tab dropdown> *This item is in an unordered list, so it allows [[#Dropdown demos|in-line linking]]. #This item and the next one are in an ordered list, so they turn links into list-items #[[#Dropdown demos|List-item links]] #*...with a sub-menu that uses unordered lists again, so allows [[#Dropdown demos|in-line linking]] again. #*#And this sub-menu again creates... #*#[[#Dropdown demos|...list-item links]] </tab>
</tab>
<tab dropdown>
- This item is in an unordered list, so it allows in-line linking.
- This item and the next one are in an ordered list, so they turn links into list-items
- List-item links
- ...with a sub-menu that uses unordered lists again, so allows in-line linking again.
- And this sub-menu again creates...
- ...list-item links
- ...with a sub-menu that uses unordered lists again, so allows in-line linking again.
</tab>
Documentation
Tab menus can be used to make it possible to switch between different layouts. Anything within <tabs> ... </tabs>
tags is rendered as a tab menu. Individual tabs are then defined via a <tab>
tag.
Available attributes
<tabs>
container
- Use this attribute to define any styles for the tabs container. Styles defined here will only affect the container of the tabs, not the labels.plain
- If this attribute is set, the tab interface will be a much more plain layout, without a border around the container, and with the tab labels just being buttons above it, instead of the typical tab layout. This can be used to get more freedom in styling the interface.
<tab>
inline
- If this attribute is set, the tab's contents can be placed within text without interrupting the flow of the text. The difference between this and the default state ofdisplay:inline-block
is that withinline-block
, the tab's contents are forced to a new line when placed at the end of a new line, when not the whole of the tab's contents fit on the same line.inline
tabs however will use up any space that's left at the end of the line, and fit in with the normal flow of the text just like normal text.block
- Converts the tab's contents to a block element. This can be used to assure the tab's contents will be displayed as a block instead of an inline-block, in cases where the tab's contents should not be placed within a line of text. When both theblock
andinline
attributes are available, theinline
attribute will be ignored.- Name attributes:
index
- This will determine the index of the tab. This only works if the entered index is already the index of a defined tab. Otherwise, this attribute is ignored. If no valid index or matching name attributes are defined, the index is automatically set to be the next in the list of tabs.name
- This attribute is used to define the text the label shows for the tab. If the entered name already exists within the tab, the contents of the<tab>
tag are automatically assigned to the existing tab. This also means no two tabs can have an identical label. This attribute will be ignored if theindex
attribute already refers to an existing tab. Whitespace is automatically removed from the start and end of this attribute's value.
- Both
- Default HTML attributes:
Self-closing tabs
Self-closing tabs can be used to define a list of tabs at the top of the tab menu, for later use via the index
attribute. Self-closing tabs only have an effect when a name is defined, and no (valid) index is defined. The syntax for self-closing tabs is <tab name="name" />
Parser function
As an alternative for the tab tag, the {{#tab:}}
parser function can also be used to simplify the syntax for tabs. The syntax for this parser function allows the following syntaxes:
Code | Description |
---|---|
{{#tab:name1/#1, name2/#2, etc|content 1|content 2|etc}}
|
Each of the defined names will be set as name or index attributes, respectively.
|
{{#tab:|content 1|content 2|etc}}
|
No indices or names are defined here, so the indices of the tabs within the parser functions are automatically assigned as index. |
{{#tab:name1/#1, , name3/#3, name4/#4|content 1|content 2| |content 4}}
|
The second tab will automatically get index="2" , and the third tab will have no content:
|
{{#tab:name1, name2, name3...}}
|
This will define three tabs, "name1", "name2" and "name3" using the self-closing syntax. |
{{#tab:#3, #5|content 3|content 5}}
|
This will add "content 3" to the rest of the contents of tab 3, and "content 5" to the rest of the content of tab 5. |
{{#tab:name1/#1, etc|content 1|$1}}
|
When the content of a tab is $n (where n is the place of the tab in the parser function), the contents of that tab are copied over to the tab that has $n in it. For this to work, the following conditions must be met:
|
{{#tab:|3=content 3| 5 = content 5}}
|
You can also refer to the tab index (so not the tab name) by putting the tab index before an equals sign (= ) in the parameter. This will not work for tab names, to prevent unwanted effects caused by equals signs inside the tab (which then would cause all of the preceding text to be interpreted as a tab name). This syntax will override an index or name specified using the syntax of the above code examples.
|
Demos
Naming and reusing tabs, and default text
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tabs> <tab name="First" style="border:1px solid black;">This tab has a defined <code>name</code>. It also has a <code>style</code> attribute set to <code>style="border:1px solid black;"</code>.</tab> <tab name="Second" style="background:salmon;">This tab also has a defined <code>name</code> attribute, and its <code>style</code> attribute set to <code>style="background:salmon;"</code>.</tab> <tab>This tab has no attributes defined. Its name is automatically generated based on its position.</tab> <tab index="1">This is a seperate tab. It has a defined <code>index</code> attribute with value "1". This makes it also show when the first tab is selected.</tab> <tab name="Second">This is a seperate tab. It has a defined <code>name</code> attribute, with a value equal to that of the second tab ("Second"). It therefore also shows when the second tab is opened.</tab> ---- This line of text will show for every tab you view. It is not placed within <code><tab> tags, and can be used as default content for the tab menu. </tabs>
</tab>
<tabs>
<tab name="First" style="border:1px solid black;">This tab has a defined name
. It also has a style
attribute set to style="border:1px solid black;"
.</tab>
<tab name="Second" style="background:salmon;">This tab also has a defined name
attribute, and its style
attribute set to style="background:salmon;"
.</tab>
<tab>This tab has no attributes defined. Its name is automatically generated based on its position.</tab>
<tab index="1">This is a seperate tab. It has a defined index
attribute with value "1". This makes it also show when the first tab is selected.</tab>
<tab name="Second">This is a seperate tab. It has a defined name
attribute, with a value equal to that of the second tab ("Second"). It therefore also shows when the second tab is opened.</tab>
This line of text will show for every tab you view. It is not placed within <tab> tags, and can be used as default content for the tab menu.
</tabs>
block
and inline
tabs
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tabs>
<tab name="Default 1" style="background:lightgreen;">First tab.</tab>
<tab name="Default 2" style="background:lightgreen;">Second tab.</tab>
<tab name="Inline" style="background:salmon;">Third tab.</tab>
<tab name="Block" style="background:royalblue;">Fourth tab.</tab>
<tab index="1">This is a seperate tab. It demonstrates what happens if a tab has no <code>inline</code> or <code>block</code> attributes defined. If the tab contains a lot of text, it will automatically be forced to a new line, despite extra space being available at the end of the previous line.</tab>
<tab index="2">This seperate tab isn't forced to a new line, since it's short enough.</tab>
<tab index="3" inline>This is a seperate tab that has an <code>inline</code> attribute defined. It will fit in with the text as normal text would, and it fills up any space that is left available after the previous line. This makes tabs with <code>inline</code> attributes a bit better at fitting in with the flow of text.</tab>
<tab index="4" block>Despite fitting on the previous line, the <code>block</code> attribute forces this seperate tab to a new line</tab>
</tabs>
</tab>
<tabs>
<tab name="Default 1" style="background:lightgreen;">First tab.</tab>
<tab name="Default 2" style="background:lightgreen;">Second tab.</tab>
<tab name="Inline" style="background:salmon;">Third tab.</tab>
<tab name="Block" style="background:royalblue;">Fourth tab.</tab>
<tab index="1">This is a seperate tab. It demonstrates what happens if a tab has no inline
or block
attributes defined. If the tab contains a lot of text, it will automatically be forced to a new line, despite extra space being available at the end of the previous line.</tab>
<tab index="2">This seperate tab isn't forced to a new line, since it's short enough.</tab>
<tab index="3" inline>This is a seperate tab that has an inline
attribute defined. It will fit in with the text as normal text would, and it fills up any space that is left available after the previous line. This makes tabs with inline
attributes a bit better at fitting in with the flow of text.</tab>
<tab index="4" block>Despite fitting on the previous line, the block
attribute forces this seperate tab to a new line</tab>
</tabs>
plain
tab interfaces
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tabs plain style="width:250px;">
<tab>This tab interface doesn't have a box surrounding it, but just has buttons above it.</tab>
<tab>This makes it a bit easier to customise the box</tab>
<tab>It is also more useful for storing tabbed tables in</tab>
</tabs>
</tab>
<tabs plain style="width:250px;">
<tab>This tab interface doesn't have a box surrounding it, but just has buttons above it.</tab>
<tab>This makes it a bit easier to customise the box</tab>
<tab>It is also more useful for storing tabbed tables in</tab>
</tabs>
Inline switching parts
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tabs>
This line of text contains <tab name="Exaggerating">over 9000</tab><tab name="Truth">a couple of</tab> switching parts. The <tab index="1">biggest by far</tab><tab index="2">main</tab> part of this tab's contents is placed outside any <tab index="1">awesome</tab> <code><tab></code> tags.
The switching <tab index="1">epicness</tab><tab index="2">parts</tab> are made by putting <code><tab></code> tags within the flow of the text.
</tabs>
</tab>
This tab menu uses the regular syntax using the <tab>
tag.
<tabs>
This line of text contains <tab name="Exaggerating">over 9000</tab><tab name="Truth">a couple of</tab> switching parts. The <tab index="1">biggest by far</tab><tab index="2">main</tab> part of this tab's contents is placed outside any <tab index="1">awesome</tab> <tab>
tags.
The switching <tab index="1">epicness</tab><tab index="2">parts</tab> are made by putting <tab>
tags within the flow of the text.
</tabs>
This tab menu looks exactly the same, but uses the parser function {{#tab:name1, name2|content1|content2}}
or {{#tab: #1, #2|content1|content2}}
. This makes the code a bit shorter.
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tabs>
This line of text contains {{#tab:Exagerrating,Truth|over 9000|a couple of}} switching parts. The {{#tab:|very biggest|main}} part of this tab's contents is placed outside any {{#tab:|awesome}} <code><tab></code> tags.
The switching {{#tab:|epicness|parts}} are made by putting <code><tab></code> tags within the flow of the text.
</tabs>
</tab>
<tabs>
This line of text contains {{#tab:Exagerrating,Truth|over 9000|a couple of}} switching parts. The {{#tab:|very biggest|main}} part of this tab's contents is placed outside any {{#tab:|awesome}} <tab>
tags.
The switching {{#tab:|epicness|parts}} are made by putting <tab>
tags within the flow of the text.
</tabs>
Predefining tabs and reference syntax
Tabs can be predefined via either self-closing tabs or the parser function. This tab menu's third tab also uses the reference syntax for the parser function.
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tabs>
<tab name="First"/>{{#tab:Second,Third}}
The {{#tab:|first|second|third}} tab is predefined via ''{{#tab:|a self-closing <code><tab /></code> tag|the parser-function syntax|$2}}''.
<tab index="3">The italic text in the above line is defined via a <code>$2</code> reference. This automatically inserts the contents for the second value entered into the third tab too.
</tab>
</tabs>
</tab>
<tabs>
<tab name="First"/>{{#tab:Second,Third}}
The {{#tab:|first|second|third}} tab is predefined via {{#tab:|a self-closing <tab />
tag|the parser-function syntax|$2}}.
<tab index="3">The italic text in the above line is defined via a $2
reference. This automatically inserts the contents for the second value entered into the third tab too.
</tab>
</tabs>
Nested combinations
In some cases, it is possible to put multiple of these boxes inside each other. For this to work however, the #tag:tabs
, #tag:tab
or #tab:
parser functions will have to be used whenever two of the same tags are used anywhere within each other. This is required because otherwise the wikicode parser will recognise the closing tag for the nested tag as the closing tag for the outer tag, and skip the rest of the content, which could cause problems.
For the #tag:
parser function, even boolean attributes (such as dropdown
or inline
) need to have a value defined for them, otherwise they are not recognized as attributes. For example, {{#tag:tab|Dropdown contents|dropdown}}
will not work (it will show a toggle box instead of a dropdown), while {{#tag:tab|Dropdown contents|dropdown=true}}
will show a dropdown box.
All combinations of nesting multiple tags will work, except for nesting any tab menus inside other tab menus.
Inside toggle boxes
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tab>
This tab contains a tab menu:
<tabs>
{{#tab:First, Second|These tabs use the <code>#tab:</code> parser function to create the nested tabs.|Placing <code><tab></code> tags inside another <code><tab></code> tag will cause the parser to recognise the inner closing tag as the closing tag for the outer tag, which messes it up.}}
</tabs>
</tab>
</tab>
<tab>
This tab contains a tab menu:
<tabs>
{{#tab:First, Second|These tabs use the #tab:
parser function to create the nested tabs.|Placing <tab>
tags inside another <tab>
tag will cause the parser to recognise the inner closing tag as the closing tag for the outer tag, which messes it up.}}
</tabs>
</tab>
Inside dropdowns
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tab dropdown>
And here is another tab menu:
<tabs>
{{#tag:tab|These tabs are generated via the <code>#tag:tab</code> parser function|name="First"}}
{{#tag:tab|This is required, for the same reason as explained in the Second tab in the toggle box example above.|name="Second"}}
</tabs>
</tab>
</tab>
<tab dropdown>
And here is another tab menu:
<tabs>
<tab name="First">These tabs are generated via the #tag:tab
parser function</tab>
<tab name="Second">This is required, for the same reason as explained in the Second tab in the toggle box example above.</tab>
</tabs>
</tab>
Nested toggle/dropdown boxes
Toggle boxes in toggle boxes
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tab>
This toggle box has another toggle box nested inside it.
{{#tag:tab|This tab is generated by the <code>#tag:tab</code> parser function.|openname=Show|closename="Hide"}}
</tab>
</tab>
<tab>
This toggle box has another toggle box nested inside it.
<tab openname="Show" closename="Hide">This tab is generated by the #tag:tab
parser function.</tab>
</tab>
Toggle boxes in dropdowns
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
{{#tag:tab|
It is also possible to use the <code>#tag:tab</code> parser function for the outer tab.
<tab collapsed>
This inner toggle box is made via the <code><tag></code> syntax.
</tab>
|dropdown=true}}
</tab>
<tab dropdown="true">
It is also possible to use the #tag:tab
parser function for the outer tab.
<tab collapsed>
This inner toggle box is made via the <tag>
syntax.
</tab>
</tab>
Toggle boxes and dropdowns in tab boxes
If you want to place a toggle box or a dropdown inside a tab navigation, and want the toggle box to show up for every tab as opposed to just the tab it's nested in, first a parent <tab>
tab must be made, with index="*"
, so that the toggle box won't be recognized as a seperate tab content.
If you want to place a toggle box or dropdown menu inside a tab menu, you can simply place a <tab>
tag inside the <tab>
tag that functions as a tab. This will restrict toggle boxes and dropdowns to visibility in just one tab though. So, if you want to have a toggle box or dropdown that's visible in every tab, encase it in a <tab>
tag with an index="*"
set to it.
That way, the outer <tab>
tag will be recognized as a tab container, and the inner one will be recognized as a toggle box or dropdown menu, as desired. The toggle box or dropdown must then also use the parser function syntax.
If you want the contents of the toggle box inside the tab menu to be able to change depending on the selected tab, you should use the nested="true"
attribute on the tag. This can be done by setting the very last argument of the #tab:
parser function or the #tag:tab
parser function to nested=true
.
See this demo for an example of how to make this work:
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tabs>
<tab name="Toggle box">
This first tab has a toggle box nested inside it
{{#tab:Toggle|This toggle box is made via the <code>#tab:</code> parser function.}}
</tab>
<tab name="Dropdown">
This second tab has a dropdown nested inside it
{{#tag:tab|This dropdown is created via the <code>#tag:tab</code> parser function, since it's not possible to define attributes such as <code>dropdown</code> via the <code>#tab:</code> parser function.|dropdown=true}}
</tab>
<tab index="*" block>
{{#tag:tab|This toggle box shows up inside {{#tab:|every|each of the|nested=true}} tab{{#tag:tab|s|index=2|nested=true}}, because the containing tab tag has got its index attribute set to <code>index="*"</code>. It also has a <code>block</code> attribute.|openname=Open|closename=Close}}
</tab>
</tabs>
</tab>
<tabs>
<tab name="Toggle box">
This first tab has a toggle box nested inside it
{{#tab:Toggle|This toggle box is made via the #tab:
parser function.}}
</tab>
<tab name="Dropdown">
This second tab has a dropdown nested inside it
<tab dropdown="true">This dropdown is created via the #tag:tab
parser function, since it's not possible to define attributes such as dropdown
via the #tab:
parser function.</tab>
</tab>
<tab index="*" block>
<tab openname="Open" closename="Close">This toggle box shows up inside {{#tab:|every|each of the|nested=true}} tab<tab index="2" nested="true">s</tab>, because the containing tab tag has got its index attribute set to index="*"
. It also has a block
attribute.</tab>
</tab>
</tabs>
Toggle boxes in dropdowns
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tab dropdown name="nested toggle boxes" style="width:250px">
This dropdown has a nested toggle box that has <code>inline</code> and <code>collapsed</code> attributes filled in: {{#tag:tab|You can do the same things with nested boxes as you'd normally do outside other tags.|inline=true|collapsed=true}}
</tab>
</tab>
<tab dropdown name="nested toggle boxes" style="width:250px">
This dropdown has a nested toggle box that has inline
and collapsed
attributes filled in: <tab inline="true" collapsed="true">You can do the same things with nested boxes as you'd normally do outside other tags.</tab>
</tab>
Dropdowns in dropdowns
<tab openname="Show code" closename="Hide code" collapsed block style="max-width:100%;">
<tab dropdown name="nested dropdowns">
*It is even possible to have a dropdown inside a list item in another dropdown box
*{{#tag:tab|This a dropdown inside a list in the outer dropdown menu|dropdown=true}}
*And it is even possible to have a dropdown inside sub-menus in the dropdown...
**{{#tag:tab|It also works normally in sub-menus, although <code>style="width:186px;"</code> would be recommended. Although making the encasing <code><tab></code> wider using <code>style="width:214px;"</code> would work just as well.|dropdown=true|style=width:186px;}}
Or if you want, you can place it outside lists too.
{{#tag:tab|Here's a dropdown inside a dropdown, but not in any list|dropdown=true}}
</tab>
</tab>
<tab dropdown name="nested dropdowns">
- It is even possible to have a dropdown inside a list item in another dropdown box
- <tab dropdown="true">This a dropdown inside a list in the outer dropdown menu</tab>
- And it is even possible to have a dropdown inside sub-menus in the dropdown...
- <tab dropdown="true" style="width:186px;">It also works normally in sub-menus, although
style="width:186px;"
would be recommended. Although making the encasing <tab>
wider using style="width:214px;"
would work just as well.</tab>
Or if you want, you can place it outside lists too.
<tab dropdown="true">Here's a dropdown inside a dropdown, but not in any list</tab>
</tab>