Configuration

This section describes configuration options used to create a command.

action

Specifies an action performed when the execute() method of the command is called.

Type: function(e)|String|Object
Function parameters:

Provides function parameters.

Object structure:
component: Object

Returns the command instance.

element: jQuery

Returns an HTML element representing the command.

model: Object

Provides access to the data that is available for binding against the element.

Default Value: null

Assign a function to perform a custom action when the command is executed.

You can assign a URL to which the browser will navigate when the widget is clicked. Alternatively, assign an object whose fields represent parameters for the URL to be navigated to.

For details on all these forms of actions, refer to the Actions article.

disabled

Indicates whether or not the widget that displays this command is disabled.

Type: Boolean
Default Value: false

icon

Specifies the name of the icon shown inside the widget associated with this command.

Type: String
Default Value: ""

This option can take on the name of an icon from the built-in icon library.

iconSrc

A URL pointing to the icon shown inside the widget associated with this command.

Type: String
Default Value: ""

id

The identifier of the command.

Type: String
Default Value: null

Setting this option is mandatory, since a command identifier is required when defining an application's command mapping. The identifier should be unique throughout the entire application.

title

Specifies the title of the widget associated with this command.

Type: String
Default Value: ""

type

Specifies the type of the button, if the command is rendered as a dxButton widget.

Type: String
Default Value: undefined

See the dxButton's type option description for information on accepted values.

visible

A Boolean value specifying whether or not the widget associated with this command is visible.

Type: Boolean
Default Value: true