ToolBar can be positioned anywhere on the page. If you need tabs specifically for top level navigation within your app, refer instead to the Header.
Assign data-ts="TabBar"
to a header
or footer
or
nav
to initialize it as a TabBar.
On this page, we've positioned the TabBar the
Panel
element so it stays fixed while scrolling. Please note that this
is for educational purposes only. Tabs for top level navigation should ordinarily
be assigned via the
Header API.
TabBar features are controlled through a JavaScript API. You can get a hold of the
component using a CSS selector and call the tabs
method like this.
If you omit the argument, you"ll get the current tabs (jQuery style).
You can use array methods like push
, pop
, shift
,
unshift
, splice
and so on to manage tabs, just note that the
tabs length
is a readonly property. Also note that tabs don"t do anything by
default, so what happens at onselect
is completely up to you.
Second level tabs
We supported two levels of tabs before. one is in the header, and use the normal tabs as the second level tabs. We remove the tabs in the header right now. If you want to have two levels of tabs, you can use the normal tabs as the first level, and use TabBox as the second level. Read more about boards
-
One
-
Two
-
Three
Updating tabs
We can at any time change what happens when a tab gets selected. We can also change the tab label if we like, although perhaps this could become confusing.
Selecting tabs
We can programatically select a tab using one of these approaches.
Querying tabs
This will all become a lot easier if we give all the tabs an
id
and use
tabs.get()
Tabs icons
You can add a tab with an icon if somehow that tab is special.
Tab counters
You can add a counter to the tabs for whatever reason you like.
When the counter reaches zero, it disappears.
Closeable tabs
You can create closeable tabs, but note that the tab must be selected before it can be
closed. You can return false
in the onclose
method to prevent
the tab from closing (if this would otherwise cause data loss).
New-Tab button
You can allow the user to create new tabs via a special button as seen in popular
browsers. Note that the button just triggers a callback and that the new tab must be
created manually. In the example below, the
selected
property also selects the tab.
If you regret this later on, you can also hide the button.
Here"s a summary of the tabs
collection and tab
model.
— and here's finally an overview of the TabBar.