Skip to main content

Configuration

Close buttons for tabs#

Related sample: Tabbar. Close Button

You can equip each Tabbar tab with a close button to make it easily closable via interface. To enable close buttons in all tabs at once, make use of the closable configuration property:

var tabbar = new dhx.Tabbar("tabbar_container", {    closable:true});

You can also add close buttons for separate tabs by setting an array with ids of the tabs as a value for the closable property:

var tabbar = new dhx.Tabbar("tabbar", {    closable: ["paris", "london"]});

Disabled tabs#

By default, all tabs in Tabbar are enabled. It is possible to make one or several tabs disabled using the disabled configuration property:

// make one tab disabledvar tabbar = new dhx.Tabbar("tabbar_container", {    disabled: "London"}); // make several tabs disabledvar tabbar = new dhx.Tabbar("tabbar_container", {    disabled: ["Paris", "Rome"]});

Related sample: Tabbar. Disabled Tab

Position of tabbar#

Related sample: Tabbar. Mode

When initialized with default settings, Tabbar is located at the top of a page. You can locate dhtmlxTabbar at any desired side of your application by using any other value of the mode property. Besides "top", it can also take "bottom","left" or "right" values. e.g.:

var tabbar = new dhx.Tabbar("tabbar_container", {    mode: "left"});

Size of tabs#

dhtmlxTabbar allows you to control the height and width of tabs with the help of appropriate configuration options - tabWidth and tabHeight. By default, they are set to 200px and 45px, correspondingly. This is how you can change the default settings:

var tabbar = new dhx.Tabbar("tabbar_container", {    tabWidth: 190,    tabHeight: 50});

Related sample: Tabbar. Tab Size

Structure of tabs#

The structure of Tabbar should be defined during initialization of the component. It is set within the views property. Each tab is an object with attributes, which are:

  • id - the id of a tab
  • tab - the name of a tab
  • tabCss - the name of the CSS class used for a tab
  • css - the name of the CSS class used for a cell
  • header - the header of a cell
  • html - HTML content for a tab
  • padding - the distance between the content of a cell and the border of tabbar
  • tabWidth - the width of a tab (for more information, see views)
  • tabHeight - the height of a tab (for more information, see views)
var tabbar = new dhx.Tabbar("tabbar_container", {    views:[        { tab: "left", css:"panel flex", header:"Left"},        { tab: "west", css:"panel flex", header:"West"},        { tab: "east", css:"panel flex", header:"East"},        { tab: "right", css:"panel flex", header:"Right" }    ]});

Related sample: Tabbar. Tab size

Autosize for tabs#

When the width or height of tabs are not specified, you can configure the tabs so that their width/height would automatically adjust to the size of the container of Tabbar. For this purpose, make use of the tabAutoWidth/tabAutoHeight properties of Tabbar.

var tabbar = new dhx.Tabbar("tabbar_container", {    views:[        { tab: "left", css:"panel flex", header:"Left"},        { tab: "west", css:"panel flex", header:"West"},        { tab: "east", css:"panel flex", header:"East"},        { tab: "right", css:"panel flex", header:"Right" }    ],    tabAutoWidth: true,    mode: "top"});

Related sample: Tabbar. Tab auto width

Related sample: Tabbar. Tab auto height

note

The tabAutoWidth configuration option is used when mode is set to "top" or "bottom", whereas tabAutoHeight is applied when mode is set to "right" or "left".

Tabs without content#

It is possible to render a tabbar without any content. Use the noContent option for this purpose:

var tabbar = new dhx.Tabbar("tabbar_container", {    noContent:true});

Related sample: Tabbar. Without Content

Alignment#

Starting from v7.0, there is the ability to set alignment for tabs via the tabAlign configuration option of Tabbar:

var tabbar = new dhx.Tabbar("tabbar_container", {    views:[        { tab: "left", css:"panel flex", header:"Left"},        { tab: "west", css:"panel flex", header:"West"},        { tab: "east", css:"panel flex", header:"East"},        { tab: "right", css:"panel flex", header:"Right" }    ],    tabAlign: "center" /*!*/});

Related sample: Tabbar. Tab align

The available values of the option are "left" | "start", "center" | "middle", "right" | "end".