ActionBase | References | ArcGIS Maps SDK for JavaScript

import ActionBase from "@arcgis/core/support/actions/ActionBase.js";

Inheritance:: ActionBase→Accessor

Subclasses:: ActionButton, ActionToggle

Since: ArcGIS Maps SDK for JavaScript 4.8

Actions are customizable behavior which can be executed in certain widgets such as Popups, a BasemapLayerList, or a LayerList.

The ActionBase class is a read-only base class which has no constructor.

See also

Properties

Any properties can be set, retrieved or listened to. See the Watch for changes topic.

Property	Type	Class
`active`	`boolean`
`className`	`string \| null \| undefined`
`declaredClass` readonly inherited	`string`	Accessor
`disabled`	`boolean`
`icon`	`Icon["icon"] \| null \| undefined`
`id`	`string \| null \| undefined`
`title`	`string \| null \| undefined`
`type`	`"button" \| "slider" \| "toggle" \| null \| undefined`
`uid` readonly inherited	`string`	IdentifiableMixin
`visible`	`boolean`

active

Property

Type: boolean

Set this property to true to display a spinner icon. You should do this if the action executes an async operation, such as a query, that requires letting the end user know that a process is ongoing in the background. Set the property back to false to communicate to the user that the process has finished.

Default value: false

className

Property

Type: string | null | undefined

This adds a CSS class to the ActionButton's node. It can be used in conjunction with its ActionButton.image property or by itself. Any icon font may be used in this property. The Esri Icon Font is automatically made available via the ArcGIS Maps SDK for JavaScript for you to use in styling custom actions. To use one of these provided icon fonts, you must prefix the class name with esri-. For example, the default zoom-to action in Popup uses the font esri-icon-zoom-in-magnifying-glass.

declaredClass

readonlyinherited Property

Type: string

Inherited from: Accessor

The name of the class. The declared class name is formatted as esri.folder.className.

disabled

Property

Type: boolean

Indicates whether this action is disabled.

Default value: false

icon

Property

Type: Icon["icon"] | null | undefined

Since: ArcGIS Maps SDK for JavaScript 4.27

Calcite icon used for the action.

See also

Calcite Icon Search

Example

// Create an action button to delete features
// using the 'trash' Calcite Icon.
const deleteAction = new ActionButton({
 id: "delete-feature",
 title: "Delete Feature",
 icon: "trash"
});

id

Property

Type: string | null | undefined

The name of the ID assigned to this action. This is used for differentiating actions when listening to the PopupViewModel.@trigger-action event.

title

Property

Type: string | null | undefined

The title of the action.

For popups: When space is limited, actions will display in the menu. Text is always shown next to the icon but long text is truncated. A tooltip with this title will display when hovering over it.

For LayerList: The first action is displayed in the layerlist with an icon. The layerlist has a menu that will display all actions with their titles.

type

Property

Type: "button" | "slider" | "toggle" | null | undefined

Specifies the type of action. Choose between "button" or "toggle".

uid

readonlyinherited Property

Type: string

Inherited from: IdentifiableMixin

Since: ArcGIS Maps SDK for JavaScript 4.33

An automatically generated unique identifier assigned to the instance. The unique id is generated each time the application is loaded.

visible

Property

Type: boolean

Indicates if the action is visible.

Default value: true

Methods

Method	Signature	Class
`clone`	`clone(): this`

clone

Method

Signature: clone (): this

Creates a deep clone of this object.

Returns: this
A clone of the new ActionBase instance.