icon Tab control

The Tab container organizes form content in tabs.

Tabs preview

You can add as many tabs as you need. To add a new tab, simply click on the plus symbol:

Add a tab

This page contains a detailed description of the container properties and JavaScript samples that you can use with this container.

Properties

Here you can find properties specifically related to the Tabs container.

Name

A unique identifier for the container.

Name property

JavaScript

The Name property allows to work with the container via JavaScript code, like this:

fd.spRendered(function(){
   //hide container
   fd.container('Tab1').hidden = true;
});

Orientation

The property defines tabs position relative to the content inside.

Orientation property

Select tabs position form the dropdown:

  • Top:

    Top orientation

  • Left:

    Left orientation

  • Bottom:

    Bottom orientation

Width

The property defines the width of the container in pixels.

If left blank, the container takes up the entire available width in the current grid cell.

Width property

JavaScript framework

In this section, you can find basic examples of how to work with the containers using JavaScript.

If you are not familiar with the JavaScript framework, get started with the JavaScript basics.

Note

The container is only accessible once the form is rendered, so all calls to the containers must be inside fd.spRendered event:

fd.spRendered(function(){
    //hide the container
    fd.container('Container1').hidden = true;
    //show the container
    fd.container('Container1').hidden = false;
});

Get HTML element

Access HTML element inside the container.

//access container's HTML
var htmlcontainer = fd.container('Container1').$el;

Hide container

Hide a container from a user.

//hide container
fd.container('Container1').hidden = true;

//show container
fd.container('Container1').hidden = false;

Tabs

The property holds tabs of the container as an array of objects. Can be used to get tabs and their properties.

fd.container('Container1').tabs

Disable tab

Disable or enable a tab:

//disable the second tab
fd.container('Container1').tabs[1].disabled = true;

//enable the second tab
fd.container('Container1').tabs[1].disabled = true;

The disabled tab can also be hidden with CSS:

.tabset .disabled{
    display: none; /* hide disabled tabs */
}

Current tab

Get the index of the currently opened tab:

//returns integer
fd.container('Container1').currentTab;

Next/Previous tab

Open the next or previous tab:

//open next tab
fd.container('Container1').nextTab();

//open previous tab
fd.container('Container1').previousTab();

Open tab

Open a tab by index:

//open the first tab
fd.container('Container1').setTab(0);

//oepn the last tab
fd.container('Container1').setTab(
    fd.container('Container1').tabs.length -1
);

Tabs orientation

Get or set tabs position:

//returns the current tabs position
fd.container('Container1').orientation;

//set tabs position
fd.container('Container1').orientation = 'left';