Extension:TabberNeue
TabberNeue Release status: stable |
|
---|---|
Implementation | Parser function |
Description | Create pages with "Tabs" to dynamically switch between content |
Author(s) | alistair3149, Eric Fortin, Alexia E. Smith, Ciencia Al Poder |
Compatibility policy | Master maintains backward compatibility. |
MediaWiki | 1.39+ |
License | GNU General Public License 3.0 or later |
Download | GitHub: Note: |
The TabberNeue extension allows wikis to create tabs within a page. It is a forked and rewritten version of Extension:Tabber. It includes multiple improvements such as page transclusion, responsive layout support, ARIA support, and conform to Wikimedia UI. TabberNeue is a complete replacement of Tabber, please disable or remove Tabber before enabling TabberNeue.
Installation
edit- Download and place the file(s) in a directory called
TabberNeue
in yourextensions/
folder. - Add the following code at the bottom of your LocalSettings.php file:
wfLoadExtension( 'TabberNeue' );
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
Configuration
editName | Description | Values | Default |
---|---|---|---|
$wgTabberNeueEnableAnimation
|
Enable or disable smooth scroll animation | true - enable; false - disable
|
true
|
$wgTabberNeueParseTabName
|
Parse tab name as wikitext. This can have a performance impact and cause unexpected behaviors. | true - enable; false - disable
|
false
|
$wgTabberNeueUpdateLocationOnTabChange
|
If enabled, when a tab is selected, the URL displayed on the browser changes. Opening this URL makes that tab initially selected | true - enable; false - disable
|
true
|
$wgTabberNeueUseCodex
|
Use Codex to render Tabber. It is experimental and many features might not work as expected | true - enable; false - disable
|
false
|
$wgTabberNeueUseLegacyTabIds
|
If enabled, tabpanel IDs will not be prepended with "tabber-tabpanel-". This provides better compatibility with the old Tabber extension, but will cause issues if there are headings with the same name as an existing tab | true - enable; false - disable
|
false
|
Usage
editTabberNeue uses the exact same syntax as Tabber.
Simple tabbers
editTabs are created with tabName=tabBody
, and separated by |-|
. You can use any wikitext within your tabs, including templates and images.
<tabber>
|-|First Tab Title=
First tab content goes here.
|-|Second Tab Title=
Second tab content goes here.
|-|Third Tab Title=
Third tab content goes here.
</tabber>
Nested tabbers
editNested tabbers need to be written as parser functions. Instead of the <tabber/>
tags, they are wrapped with {{#tag:tabber|}}
and separated by {{!}}-{{!}}
. It is useful when creating nested tabber.
<tabber>
|-| First Tab Title =
{{#tag:tabber
| Tab Title A = Tab content A goes here.
{{!}}-{{!}} Tab Title B = Tab content B goes here.
{{!}}-{{!}} Tab Title C = Tab content C goes here.
}}
|-| Second Tab Title =
{{#tag:tabber
| Tab Title D = Tab content D goes here.
{{!}}-{{!}} Tab Title E = Tab content E goes here.
{{!}}-{{!}} Tab Title F = Tab content F goes here.
}}
|-| Third Tab Title =
{{#tag:tabber
| Tab Title G = Tab content G goes here.
{{!}}-{{!}} Tab Title H = Tab content H goes here.
{{!}}-{{!}} Tab Title I = Tab content I goes here.
}}
</tabber>
Transclusion
editWith the transclusion mode, the syntax is different, and it's more similar to <gallery>
syntax.
The contents of the page of the first tab will be transcluded. Other tabs will be transcluded on-demand with AJAX, performing a request to the MediaWiki api. Once requested, they won't be fetched again until the page is reloaded. Note that Tabbers on the transcluded page will not be rendered.
Tabs are created with pageName|tabName
, and separated by a new line.
<tabbertransclude>
First Page Name|First Tab Title
Second Page Name|Second Tab Title
Third Page Name|Third Tab Title
</tabbertransclude>
Screenshot
edit-
TabberNeue on Skin:Vector
See also
edit- Extension:Tabber - original version of this extension
- Extension:Header Tabs
This extension is included in the following wiki farms/hosts and/or packages: This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |