List.addButton(options)

Method Description

Adds a button to a list.

Returns

serverWidget.Button object

Supported Script Types

SuiteScript 2.x Suitelet Script Type

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 of the button. The internal ID must be in lowercase, contain no spaces, and include the prefix `custpage` if you are adding the button to an existing page. For example, if you add a button that appears as Update Order, the button internal ID should be something similar to `custpage_updateorder`.	2015.2
`options.label`	string	required	The label for this button.	2015.2
`options.functionName`	string	optional	The function name to call when clicking this button. The function name must be the name of the method defined in a custom module client script. For examples, see N/currentRecord Samples. The function name must not be a client script entry point. For the list of client script entry points, see SuiteScript 2.x Client Script Entry Points and API. Important: Custom module client scripts with the specified function must be attached to the list. To learn more, see List.clientScriptModulePath and List.clientScriptFileId.	2015.2

Parameter

Type

Required / Optional

Description

Since

options.id

string

required

The internal ID of the button.

The internal ID must be in lowercase, contain no spaces, and include the prefix custpage if you are adding the button to an existing page. For example, if you add a button that appears as Update Order, the button internal ID should be something similar to custpage_updateorder.

2015.2

options.label

string

required

The label for this button.

2015.2

options.functionName

string

optional

The function name to call when clicking this button.

The function name must be the name of the method defined in a custom module client script. For examples, see N/currentRecord Samples.

The function name must not be a client script entry point. For the list of client script entry points, see SuiteScript 2.x Client Script Entry Points and API.

Important:

Custom module client scripts with the specified function must be attached to the list. To learn more, see List.clientScriptModulePath and List.clientScriptFileId.

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 list = serverWidget.createList({
    title : 'Simple List'
});
list.addButton({
    id : 'buttonid',
    label : 'Test'
});
...
//Add additional code

Parameters

Syntax

Related Topics