Skip to content
import BasemapLayerListViewModel from "@arcgis/core/widgets/BasemapLayerList/BasemapLayerListViewModel.js";
Inheritance:
BasemapLayerListViewModelAccessor
Since
ArcGIS Maps SDK for JavaScript 4.13

Provides logic for the BasemapLayerList widget and component.

See also

Constructors

Constructor

Constructor
Parameters
ParameterTypeDescriptionRequired
properties
See the properties table for a list of all the properties that may be passed into the constructor.

Properties

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

baseItems

readonly Property
Type
Collection<ListItem>

A collection of ListItems representing the Basemap.baseLayers.

baseListItemCreatedFunction

Property
Type
ListItemModifier | null | undefined

Specifies a function that accesses each ListItem. Each list item can be modified according to its modifiable properties. Actions can be added to list items using the ListItem.actionsSections.

basemapTitle

Property
Type
string | null | undefined

The current basemap's title.

checkPublishStatusEnabled

Property
Type
boolean
Since
ArcGIS Maps SDK for JavaScript 4.25

Whether to provide an indication if a layer is being published in the BasemapLayerList. When a layer is publishing, a rotating square will appear to the right of the list item title. The list item ListItem.publishing property will be false if checkPublishStatusEnabled is false.

Default value
false

declaredClass

readonlyinherited Property
Type
string
Inherited from: Accessor

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

listModeDisabled

Property
Type
boolean
Since
ArcGIS Maps SDK for JavaScript 4.30

Specifies whether to ignore the Layer.listMode property of the layers to display all layers. A common use case for listModeDisabled is when you want to use the BasemapLayerList to manage and configure a layer's listMode value.

See also
Default value
false

referenceItems

readonly Property
Type
Collection<ListItem>

A collection of ListItems representing the Basemap.referenceLayers.

referenceListItemCreatedFunction

Property
Type
ListItemModifier | null | undefined

Specifies a function that accesses each ListItem representing reference layers.

state

readonly Property
Type
BasemapLayerListState

The view model's state.

Default value
"disabled"

view

Property
Type
MapViewOrSceneView | null | undefined

A reference to the MapView or SceneView. Set this to link the widget to a specific view.

Methods

MethodSignatureClass
emit
inherited
emit<Type extends EventNames<this>>(type: Type, event?: this["@eventTypes"][Type]): boolean
hasEventListener
inherited
hasEventListener<Type extends EventNames<this>>(type: Type): boolean
on
inherited
on<Type extends EventNames<this>>(type: Type, listener: EventedCallback<this["@eventTypes"][Type]>): ResourceHandle
triggerAction(action: Action, item: ListItem): void

emit

inherited Method
Signature
emit <Type extends EventNames<this>>(type: Type, event?: this["@eventTypes"][Type]): boolean
Type parameters
<Type extends EventNames<this>>
Inherited from: EventedMixin

Emits an event on the instance. This method should only be used when creating subclasses of this class.

Parameters
ParameterTypeDescriptionRequired
type
Type

The name of the event.

event
this["@eventTypes"][Type]

The event payload.

Returns
boolean

true if a listener was notified

hasEventListener

inherited Method
Signature
hasEventListener <Type extends EventNames<this>>(type: Type): boolean
Type parameters
<Type extends EventNames<this>>
Inherited from: EventedMixin

Indicates whether there is an event listener on the instance that matches the provided event name.

Parameters
ParameterTypeDescriptionRequired
type
Type

The name of the event.

Returns
boolean

Returns true if the class supports the input event.

on

inherited Method
Signature
on <Type extends EventNames<this>>(type: Type, listener: EventedCallback<this["@eventTypes"][Type]>): ResourceHandle
Type parameters
<Type extends EventNames<this>>
Inherited from: EventedMixin

Registers an event handler on the instance. Call this method to hook an event with a listener.

Parameters
ParameterTypeDescriptionRequired
type
Type

An event or an array of events to listen for.

listener
EventedCallback<this["@eventTypes"][Type]>

The function to call when the event fires.

Returns
ResourceHandle

Returns an event handler with a remove() method that should be called to stop listening for the event(s).

PropertyTypeDescription
removeFunctionWhen called, removes the listener from the event.
Example
view.on("click", function(event){
// event is the event handle returned after the event fires.
console.log(event.mapPoint);
});

triggerAction

Method
Signature
triggerAction (action: Action, item: ListItem): void

Triggers the BasemapLayerList.@trigger-action event and executes the given action or action toggle.

Parameters
ParameterTypeDescriptionRequired
action

The action to execute.

item

An item associated with the action.

Returns
void

Type definitions