Form.addTab(options)

Method Description

Adds a tab to a form.

Note:

To enable your tab to appear on your form, there must be at least one object assigned to the tab. Otherwise, the tab will not appear.

Note:

If you have less than two tabs on your form, the tab will not appear. Instead the fields assigned to the tab will appear at the bottom of the form.

Returns

serverWidget.Tab object

Supported Script Types

Suitelets

User event scripts -beforeLoad entry point

For more information, see SuiteScript 2.x Script Types.

Governance

None

Module

N/ui/serverWidget Module

Since

2015.2

Parameters

Note:

The options parameter is a JavaScript object.

Parameter	Type	Required / Optional	Description	Since
`options.id`	string	required	The internal ID name of the tab. The internal ID must be in lowercase and contain no spaces. If you are adding the tab to an existing page, include the prefix `custpage`. For example, if you add a subtab that appears as Purchase Details, the subtab internal ID should be something similar to `custpage_purchasedetails` or `custpage_purchase_details`.	2015.2
`options.label`	string	required	The label for this tab.	2015.2

Parameter

Type

Required / Optional

Description

Since

options.id

string

required

The internal ID name of the tab.

The internal ID must be in lowercase and contain no spaces. If you are adding the tab to an existing page, include the prefix custpage. For example, if you add a subtab that appears as Purchase Details, the subtab internal ID should be something similar to custpage_purchasedetails or custpage_purchase_details.

2015.2

options.label

string

required

The label for this tab.

2015.2

Syntax

Important:

The following code sample shows the syntax for this member. It is not a functional example. For a complete script example, see N/ui/serverWidget Module Script Samples.

          //Add additional code 
...
var form = serverWidget.createForm({
    title : 'Simple Form'
});
var tab = form.addTab({
    id : 'tabid',
    label : 'Tab'
});
...
//Add additional code

Parameters

Syntax

Related Topics