EditorViewModel | API Reference | ArcGIS Maps SDK for JavaScript 4.33

Provides the logic for the Editor widget and component.

See also

Example

const editor = new Editor({
  viewModel: { // autocasts as new EditorViewModel
    layerInfos: [{
      layer: featureLayer,
      deleteEnabled: false // disables deleting features
    }]
  }
});

Constructors

EditorViewModel Constructor new EditorViewModel(properties)

Parameter

properties Object

optional

See the properties for a list of all the properties that may be passed into the constructor.

Property Overview

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

Show inherited properties

Hide inherited properties

Type	Summary	Class
CreateFeaturesWorkflow\|UpdateWorkflow\|UpdateFeaturesWorkflow\|null\|undefined	A property indicating the current active workflow.	EditorViewModel
AttachmentsViewModel	The AttachmentsViewModel for supporting the editor widget.	EditorViewModel
Boolean	Convenience property that indicates at least one layer supports a `create-features` workflow.	EditorViewModel
Boolean	Convenience property that indicates at least one layer supports a `update` workflow.	EditorViewModel
String	The name of the class.	Accessor
Collection<EditorItem>	A predominantly read-only collection of editor items that corresponds to the feature being updated.	EditorViewModel
Object []	An array of objects containing information specific to any failed editing operations.	EditorViewModel
FeatureFormViewModel\|null\|undefined	The FeatureFormViewModel for supporting the editor widget.	EditorViewModel
FeatureTemplatesViewModel	The FeatureTemplatesViewModel for supporting the editor widget.	EditorViewModel
BatchAttributeFormViewModel\|FeatureFormViewModel\|null\|undefined	The form's view model used to support the Editor widget.	EditorViewModel
SketchLabelOptions	Options to configure the labels shown next to each segment of the geometry being created or updated.	EditorViewModel
LayerInfo []\|null\|undefined	An array of editing configurations for individual layers.	EditorViewModel
SketchViewModel\|null\|undefined	The SketchViewModel for supporting the editor widget.	EditorViewModel
SnappingOptions	The SnappingOptions for sketching.	EditorViewModel
String	The widget's state.	EditorViewModel
Boolean	Indicates if there is at least one edit request being processed.	EditorViewModel
SketchTooltipOptions	Options to configure the tooltip shown next to the cursor when creating or updating graphics.	EditorViewModel
SketchValueOptions	Options to configure how values are displayed and input when creating or updating graphics.	EditorViewModel
MapView\|SceneView\|null\|undefined	A reference to the MapView or SceneView.	EditorViewModel

Property Details

activeWorkflow Property activeWorkflow CreateFeaturesWorkflow |UpdateWorkflow |UpdateFeaturesWorkflow |null |undefinedreadonly

A property indicating the current active workflow. This is either CreateFeaturesWorkflow, UpdateWorkflow, or UpdateFeaturesWorkflow.

See also

Sample - Popup with edit action

attachmentsViewModel Property attachmentsViewModel AttachmentsViewModelautocast

The AttachmentsViewModel for supporting the editor widget. Attachment editing is enabled by default if the layer has support for it.

canCreate Property canCreate Booleanreadonly

Convenience property that indicates at least one layer supports a create-features workflow.

canUpdate Property canUpdate Booleanreadonly

Convenience property that indicates at least one layer supports a update workflow. This includes the ability to delete features and modify attachments and/or related records.

declaredClass Inherited Property declaredClass Stringreadonly Inherited from Accessor

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

editorItems Property editorItems Collection<EditorItem>readonly Since: ArcGIS Maps SDK for JavaScript 4.29 EditorViewModel since 4.11, editorItems added at 4.29.

A predominantly read-only collection of editor items that corresponds to the feature being updated.

failures Property failures Object[]readonly

An array of objects containing information specific to any failed editing operations. In addition to the error(s), options to retry() or cancel() are provided.

Property: error Error

The read-only error message.

featureFormViewModel Property featureFormViewModel FeatureFormViewModel |null |undefinedreadonly

The FeatureFormViewModel for supporting the editor widget.

featureTemplatesViewModel Property featureTemplatesViewModel FeatureTemplatesViewModelautocast

The FeatureTemplatesViewModel for supporting the editor widget.

formViewModel Property formViewModel BatchAttributeFormViewModel |FeatureFormViewModel |null |undefinedreadonly Since: ArcGIS Maps SDK for JavaScript 4.33 EditorViewModel since 4.11, formViewModel added at 4.33.

The form's view model used to support the Editor widget. This can be either the BatchAttributeFormViewModel or the FeatureFormViewModel and is dependent on the active workflow.

labelOptions Property labelOptions SketchLabelOptionsautocast Since: ArcGIS Maps SDK for JavaScript 4.24 EditorViewModel since 4.11, labelOptions added at 4.24.

Options to configure the labels shown next to each segment of the geometry being created or updated.

Known Limitation

Sketch labels are currently only supported when working with a SceneView.

layerInfos Property layerInfos LayerInfo[] |null |undefined

An array of editing configurations for individual layers.

For example, if you have an editable feature layer but do not want the end user to do any type of editing, you can limit this by setting the enabled property to false.

Example

const editorViewModel = new EditorViewModel({
  layerInfos: [{
    layer: featureLayer, // pass in the feature layer,
    formTemplate:  { // autocasts to FormTemplate
      elements: [
        { // autocasts to FieldElement
          type: "field",
          fieldName: "fulladdr",
          label: "Full Address"
        }
      ]
    },
    enabled: true, // default is true, set to false to disable editing functionality
    addEnabled: true, // default is true, set to false to disable the ability to add a new feature
    updateEnabled: false // default is true, set to false to disable the ability to edit an existing feature
    deleteEnabled: false // default is true, set to false to disable the ability to delete features
  }]
});

sketchViewModel Property sketchViewModel SketchViewModel |null |undefinedreadonly

The SketchViewModel for supporting the editor widget.

snappingOptions Property snappingOptions SnappingOptionsautocast Since: ArcGIS Maps SDK for JavaScript 4.19 EditorViewModel since 4.11, snappingOptions added at 4.19.

The SnappingOptions for sketching. It supports self and feature snapping.

state Property state Stringreadonly

The widget's state. Possible values are in the table below.

Value	Description
ready	Dependencies are met and has valid property values.
disabled	Dependencies are missing and cannot provide valid inputs.
editing-existing-feature	The Editor is currently editing an existing feature.
awaiting-update-feature-candidate	The period when the application is awaiting the user's input after clicking update and multiple features are returned. Specify the feature to update.
awaiting-feature-creation-info	This is the first step in the `create-features` workflow. A CreationInfo is required.
awaiting-feature-to-update	This is the first step in the `update` workflow. A feature is required.
awaiting-feature-to-create	The waiting period for when a feature is created before attribute/geometry edits can be performed.
adding-attachment	If currently `editing-existing-feature` and adding an attachment to an existing feature.
editing-attachment	If currently `editing-existing-feature` and updating an existing attachment to an existing feature.
creating-features	The Editor is currently creating multiple features.
viewing-selection-list	The Editor is displaying its selection list and not editing any features.

syncing Property syncing Booleanreadonly

Indicates if there is at least one edit request being processed.

tooltipOptions Property tooltipOptions SketchTooltipOptionsautocast Since: ArcGIS Maps SDK for JavaScript 4.24 EditorViewModel since 4.11, tooltipOptions added at 4.24.

Options to configure the tooltip shown next to the cursor when creating or updating graphics.

valueOptions Property valueOptions SketchValueOptionsautocast Since: ArcGIS Maps SDK for JavaScript 4.29 EditorViewModel since 4.11, valueOptions added at 4.29.

Options to configure how values are displayed and input when creating or updating graphics.

view Property view MapView |SceneView |null |undefined

A reference to the MapView or SceneView. This view provides the editable layers for the Editor widget and is required when instantiating the widget.

Method Overview

Show inherited methods

Hide inherited methods

Return Type	Summary	Class
	Adds one or more handles which are to be tied to the lifecycle of the object.	Accessor
Promise<void>	Cancels any active workflow.	EditorViewModel
Promise<void>	This is applicable if there is an active update workflow with an active child workflow.	EditorViewModel
Promise<void>	This is applicable if there is an active update workflow with an active child workflow.	EditorViewModel
Promise<void>	If the active workflow is an UpdateWorkflow or UpdateFeaturesWorkflow, this method deletes the feature(s) associated with the workflow.	EditorViewModel
Array<(FeatureTemplate\|SharedTemplateMetadata)>	Get all of the editing templates associated with a given layer.	EditorViewModel
Boolean	Returns true if a named group of handles exist.	Accessor
	Removes a group of handles owned by the object.	Accessor
Promise<void>	Initiates the CreateFeaturesWorkflow by displaying the panel where feature creation begins.	EditorViewModel
Promise<void>	This method starts the CreateFeaturesWorkflow at the "creating-features" step with the provided feature.	EditorViewModel
Promise<void>	Initiates the CreateFeaturesWorkflow by displaying the FeatureTemplates panel.	EditorViewModel
Promise<void>	Starts an UpdateFeaturesWorkflow using the provided features.	EditorViewModel
Promise<void>	Starts the update workflow at the feature geometry and attribute editing panel.	EditorViewModel
Promise<void>	Starts the `update` workflow using the current selected feature.	EditorViewModel
Promise<void>	Starts the Editor workflow where it waits for multiple features to be selected.	EditorViewModel
	Toggles the `UpdateWorkflow`.	EditorViewModel

Method Details

addHandles Inherited Method addHandles(handleOrHandles, groupKey) Inherited from Accessor Since: ArcGIS Maps SDK for JavaScript 4.25 Accessor since 4.0, addHandles added at 4.25.

Adds one or more handles which are to be tied to the lifecycle of the object. The handles will be removed when the object is destroyed.

// Manually manage handles
const handle = reactiveUtils.when(
  () => !view.updating,
  () => {
    wkidSelect.disabled = false;
  },
  { once: true }
);

this.addHandles(handle);

// Destroy the object
this.destroy();

Parameters

handleOrHandles WatchHandle|WatchHandle []

Handles marked for removal once the object is destroyed.

groupKey *

optional

Key identifying the group to which the handles should be added. All the handles in the group can later be removed with Accessor.removeHandles(). If no key is provided the handles are added to a default group.

cancelWorkflow Method cancelWorkflow(){Promise<void>}

Cancels any active workflow.

Returns

Type	Description
Promise<void>	Resolves once the workflow is canceled.

deleteAssociationFromWorkflow Method deleteAssociationFromWorkflow(){Promise<void>}

This is applicable if there is an active update workflow with an active child workflow. This method deletes the utility network association involved with the active child workflow's feature.

Returns

Type	Description
Promise<void>	Resolves once the active UpdateWorkflow is deleted.

See also

UpdateWorkflow

deleteFeatureFromWorkflow Method deleteFeatureFromWorkflow(){Promise<void>} Deprecated since version 4.33. Use deleteFeatures instead.

This is applicable if there is an active update workflow with an active child workflow. In this case, this method deletes the feature associated with the active child workflow.

Returns

Type	Description
Promise<void>	Resolves once the active UpdateWorkflow is deleted.

See also

UpdateWorkflow

deleteFeatures Method deleteFeatures(){Promise<void>} Since: ArcGIS Maps SDK for JavaScript 4.33 EditorViewModel since 4.11, deleteFeatures added at 4.33.

If the active workflow is an UpdateWorkflow or UpdateFeaturesWorkflow, this method deletes the feature(s) associated with the workflow.

Returns

Type	Description
Promise<void>	Resolves once the features have been deleted.

See also

getTemplatesForLayer Method getTemplatesForLayer(layer){Array<(FeatureTemplate|SharedTemplateMetadata)>} Since: ArcGIS Maps SDK for JavaScript 4.32 EditorViewModel since 4.11, getTemplatesForLayer added at 4.32.

Get all of the editing templates associated with a given layer. The items in the resulting array will be SharedTemplateMetadata objects if there are any shared templates defined for the layer; otherwise, they will be standard FeatureTemplate objects.

Parameter

layer GeoJSONLayer|FeatureLayer|OrientedImageryLayer|SceneLayer|SubtypeSublayer

The layer whose templates should be retrieved.

Returns

Type	Description
Array<(FeatureTemplate\|SharedTemplateMetadata)>	An array of templates associated with the layer.

hasHandles Inherited Method hasHandles(groupKey){Boolean} Inherited from Accessor Since: ArcGIS Maps SDK for JavaScript 4.25 Accessor since 4.0, hasHandles added at 4.25.

Returns true if a named group of handles exist.

Parameter

groupKey *

optional

A group key.

Returns

Type	Description
Boolean	Returns `true` if a named group of handles exist.

Example

// Remove a named group of handles if they exist.
if (obj.hasHandles("watch-view-updates")) {
  obj.removeHandles("watch-view-updates");
}

removeHandles Inherited Method removeHandles(groupKey) Inherited from Accessor Since: ArcGIS Maps SDK for JavaScript 4.25 Accessor since 4.0, removeHandles added at 4.25.

Removes a group of handles owned by the object.

Parameter

groupKey *

optional

A group key or an array or collection of group keys to remove.

Example

obj.removeHandles(); // removes handles from default group

obj.removeHandles("handle-group");
obj.removeHandles("other-handle-group");

startCreateFeaturesWorkflowAtFeatureCreation Method startCreateFeaturesWorkflowAtFeatureCreation(creationInfo){Promise<void>} Since: ArcGIS Maps SDK for JavaScript 4.23 EditorViewModel since 4.11, startCreateFeaturesWorkflowAtFeatureCreation added at 4.23.

Initiates the CreateFeaturesWorkflow by displaying the panel where feature creation begins. This method takes a CreateFeaturesCreationInfo object containing the layer(s) and template(s) to use.

Parameter

creationInfo CreateFeaturesCreationInfo

An object containing information needed to create a new feature using the Editor widget. This object provides the feature template and layer for creating a new feature.

Returns

Type	Description
Promise<void>	Resolves when the CreateFeaturesWorkflow initiates and displays the panel where feature creation begins.

startCreateFeaturesWorkflowAtFeatureEdit Method startCreateFeaturesWorkflowAtFeatureEdit(params){Promise<void>} Since: ArcGIS Maps SDK for JavaScript 4.28 EditorViewModel since 4.11, startCreateFeaturesWorkflowAtFeatureEdit added at 4.28.

This method starts the CreateFeaturesWorkflow at the "creating-features" step with the provided feature.

Any CreateFeaturesWorkflow instance generated by this method will only support creating a single feature per operation, (ie. batch creation is disabled).

Parameters

params Object

Parameters object containing an initialFeature to use in the associated CreateFeaturesWorkflow.

Specification

initialFeature Graphic

The initial feature used when you begin creating features.

Returns

Type	Description
Promise<void>	Resolves once the CreateFeaturesWorkflow initiates and displays the panel where additional edits can be made to the provided feature.

See also

CreateFeaturesWorkflow

startCreateFeaturesWorkflowAtFeatureTypeSelection Method startCreateFeaturesWorkflowAtFeatureTypeSelection(){Promise<void>} Since: ArcGIS Maps SDK for JavaScript 4.23 EditorViewModel since 4.11, startCreateFeaturesWorkflowAtFeatureTypeSelection added at 4.23.

Initiates the CreateFeaturesWorkflow by displaying the FeatureTemplates panel.

Returns

Type	Description
Promise<void>	Resolves when the CreateFeaturesWorkflow is initiated and displays the FeatureTemplates panel.

startUpdateFeaturesWorkflow Method startUpdateFeaturesWorkflow(features){Promise<void>} Since: ArcGIS Maps SDK for JavaScript 4.33 EditorViewModel since 4.11, startUpdateFeaturesWorkflow added at 4.33.

Starts an UpdateFeaturesWorkflow using the provided features.

Parameter

features Graphic []

The features to be updated.

Returns

Type	Description
Promise<void>	Resolves once the UpdateFeaturesWorkflow is initiated.

startUpdateWorkflowAtFeatureEdit Method startUpdateWorkflowAtFeatureEdit(feature){Promise<void>}

Starts the update workflow at the feature geometry and attribute editing panel.

Parameter

feature Graphic

The feature to be updated.

Returns

Type	Description
Promise<void>	Resolves once the UpdateWorkflow initiates the feature geometry and attribute editing panel.

See also

UpdateWorkflow

startUpdateWorkflowAtFeatureSelection Method startUpdateWorkflowAtFeatureSelection(){Promise<void>}

Starts the update workflow using the current selected feature.

Returns

Type	Description
Promise<void>	Resolves once the UpdateWorkflow is initiated using the current selected feature.

See also

UpdateWorkflow

startUpdateWorkflowAtMultipleFeatureSelection Method startUpdateWorkflowAtMultipleFeatureSelection(candidates){Promise<void>}

Starts the Editor workflow where it waits for multiple features to be selected.

Parameter

candidates Graphic []

The selected feature candidates.

Returns

Type	Description
Promise<void>	Resolves once the UpdateWorkflow is initiated as it waits for multiple features to be selected.

See also

UpdateWorkflow

toggleUpdateWorkflow Method toggleUpdateWorkflow()

Toggles the UpdateWorkflow.

Event Overview

Name	Type	Summary	Class
	{type: "sketch-create",layer: FeatureLayer\|SceneLayer\|SubtypeSublayer,detail: Object,detail.graphic: Graphic,detail.state: "start"\|"active"\|"complete"\|"cancel",detail.tool: "point"\|"multipoint"\|"polyline"\|"polygon"\|"circle"\|"rectangle"\|"mesh",detail.toolEventInfo: CreateToolEventInfo,detail.type: "create"}	Fires when a user starts drawing a feature, is actively drawing a feature, and completes drawing a feature.	EditorViewModel
	{type: "sketch-update",layer: FeatureLayer\|SceneLayer\|SubtypeSublayer,detail: Object,detail.aborted: Boolean,detail.graphics: Graphic [],detail.state: "start"\|"active"\|"complete",detail.tool: "move"\|"transform"\|"reshape",toolEventInfo: UpdateToolEventInfo,detail.type: "update"}	Fires when a user starts updating a feature's geometry, is actively updating a feature's geometry, and completes updating a feature's geometry.	EditorViewModel

Event Details

sketch-create Event sketch-create Since: ArcGIS Maps SDK for JavaScript 4.29 EditorViewModel since 4.11, sketch-create added at 4.29.

Fires when a user starts drawing a feature, is actively drawing a feature, and completes drawing a feature.

Properties

type String

The value is always "sketch-create".

layer FeatureLayer|SceneLayer|SubtypeSublayer

The layer currently being edited.

detail Object

Detailed information returned within the "sketch-create" event.

Specification: graphic Graphic

The feature being created.

state String

The current state of the event.

Value Description

start State changes to start when the first vertex is created. Not applicable when creating points.

active State is active while feature is being created. Not applicable when creating points.

complete State changes to complete after the complete() method is called, when the user double clicks, presses the Enter key or clicks the first vertex of the polygon while creating a feature. When point is created, the a single sketch-create event is fired with the complete state.

cancel State changes to cancel if the user presses the escape key or the create() or cancel() methods are called during the create operation and before the state changes to complete.

Possible Values:"start"|"active"|"complete"|"cancel"

tool String

Name of the create tool.

Possible Values:"point"|"multipoint"|"polyline"|"polygon"|"circle"|"rectangle"|"mesh"

toolEventInfo CreateToolEventInfo

Returns additional information associated with the create operation.

type String

The value is always "create".

Example

// Listen to EditorViewModel's create event.
editorViewModel.on("sketch-create", function(evt) {
  const { graphic, tool } = evt.detail;

  // Check if the tool used is a 'polyline'
  if (tool === "polyline") {
    // Set the active polyline symbol to white while drawing
    graphic.symbol.color = "#ffffff";
  }
});

sketch-update Event sketch-update Since: ArcGIS Maps SDK for JavaScript 4.29 EditorViewModel since 4.11, sketch-update added at 4.29.

Fires when a user starts updating a feature's geometry, is actively updating a feature's geometry, and completes updating a feature's geometry.

Properties

type String

The value is always "sketch-update".

layer FeatureLayer|SceneLayer|SubtypeSublayer

The layer currently being edited.

detail Object

Detailed information returned within the "sketch-update" event.

Specification: aborted Boolean

Indicates if the update operation was aborted. Returns true if the user pressed the esc key, or when the update(), create() or cancel() method is called before the update event's state changes to complete.

graphics Graphic []

An array of features that are being updated.

state String

The state of the event.

Value Description

start State changes to start when a feature is selected to update.

active State is active while features are being updated and toolEventInfo parameter is not null.

complete State changes to complete after features are updated.

Possible Values:"start"|"active"|"complete"

tool String

Name of the update operation tool.

Possible Values:"move"|"transform"|"reshape"

toolEventInfo UpdateToolEventInfo

Update operation tool info. Returns additional information associated with the update operation that is taking place for selected feature and what stage it is at. Value of this parameter changes to null when the update event's state changes to complete.

detail.type String

The value is always "update".

Example

// Listen to EditorViewModel's update event.
editorViewModel.on("sketch-update", function(evt) {
  const { tool, graphics } = evt.detail;

// Check if the layer's geometryType is a 'polyline'
  if (evt.layer?.geometryType === "polyline") {
    // For every feature, update the line symbol
    // width to emphasize the feature being updated
    graphics.forEach((graphic) => graphic.symbol.width = 5);
  }
});