EditorViewModel
require(["esri/widgets/Editor/EditorViewModel"], function(EditorVM) { /* code goes here */ });esri/widgets/Editor/EditorViewModelProvides the logic for the Editor widget.
- See also:
var editor = new Editor({
  viewModel: { // autocasts as new EditorViewModel
    layerInfos: [{
      layer: featureLayer,
      deleteEnabled: false // disables deleting features
    }]
  }
});Constructors
- new EditorViewModel(properties)
- Parameter:properties ObjectoptionalSee the properties for a list of all the properties that may be passed into the constructor. 
Property Overview
| Name | Type | Summary | Class | |
|---|---|---|---|---|
| Workflow | A property indicating the current active workflow.more details | more details | EditorViewModel | |
| String[] | An array of string values which specifies what end users are allowed edit.more details | more details | EditorViewModel | |
| Boolean | Convenience property that reads whether there are any editable layers that support the  | more details | EditorViewModel | |
| Boolean | Convenience property that reads whether there are any editable layers that support the  | more details | EditorViewModel | |
| String | The name of the class.more details | more details | Accessor | |
| Collection<EditableItem> | A collection of editable item objects that match the feature being updated.more details | more details | EditorViewModel | |
| Object[] | An array of objects containing information specific to any failed editing operations.more details | more details | EditorViewModel | |
| FeatureFormViewModel | The FeatureFormViewModel for supporting the editor widget.more details | more details | EditorViewModel | |
| FeatureTemplatesViewModel | The FeatureTemplatesViewModel for supporting the editor widget.more details | more details | EditorViewModel | |
| LayerInfo[] | An array of editing configurations for individual layers.more details | more details | EditorViewModel | |
| SketchViewModel | The SketchViewModel for supporting the editor widget.more details | more details | EditorViewModel | |
| String | The widget's state.more details | more details | EditorViewModel | |
| Boolean | When  | more details | EditorViewModel | |
| MapView | A reference to the MapView.more details | more details | EditorViewModel | 
Property Details
- activeWorkflow Workflowreadonly
- A property indicating the current active workflow. - See also:
 
- An array of string values which specifies what end users are allowed edit. For example, a feature layer with full editing privileges may be available. But you may only want the end user to have the ability to update existing features. Set the - allowedWorkflowsto only- update.- Possible Value - Description - create - Indicated in the widget via the - Add featureoption. This allows the end user to create new features in the feature service.- update - Indicated in the widget via the - Edit featureoption. This allows the end user to update and/or delete features in the feature service.- These workflows are only enabled if the feature service allows these operations. For example, if a feature service is only enabled to allow updates, 'Add features' is not enabled. 
- canCreate Booleanreadonly
- Convenience property that reads whether there are any editable layers that support the - createworkflow.
- canUpdate Booleanreadonly
- Convenience property that reads whether there are any editable layers that support the - updateworkflow.
- The name of the class. The declared class name is formatted as - esri.folder.className.
- editableItems Collection<EditableItem>readonly
- A collection of editable item objects that match the feature being updated. 
- 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 ErrorThe readonly error message. 
 
- featureFormViewModel FeatureFormViewModel
- The FeatureFormViewModel for supporting the editor widget. 
- featureTemplatesViewModel FeatureTemplatesViewModel
- The FeatureTemplatesViewModel for supporting the editor widget. 
- An array of editing configurations for individual layers. - 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 - enabledproperty to- false.Example:- const editor = new Editor({ layerInfos: [{ layer: featureLayer, // pass in the feature layer fieldConfig: [ // Specify which fields to configure { name: "fulladdr", label: "Full Address" }, { name: "neighborhood", label: "Neighborhood" }], 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 SketchViewModel
- The SketchViewModel for supporting the editor widget. 
- 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-new-feature - The Editor is currently editing (creating) a new feature. - 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 - createworkflow. A CreationInfo is required.- awaiting-feature-to-update - This is the first step in the - updateworkflow. A feature is required.- awaiting-feature-to-create - The waiting period for when a feature is created beforte attribute/geometry edits can be performed. - Default Value:disabled
 
- syncing Booleanreadonly
- When - true, there is at least one edit request being processed.
- view MapView
- A reference to the MapView. This view provides the editable layers for the Editor widget. 
Method Overview
| Name | Return Type | Summary | Class | |
|---|---|---|---|---|
| Cancels any active workflow.more details | more details | EditorViewModel | ||
| This is applicable if there is an active update workflow.more details | more details | EditorViewModel | ||
| Initiates the  | more details | EditorViewModel | ||
| This method starts the Editor workflow where it waits for the feature to be selected.more details | more details | EditorViewModel | ||
| Initiates the  | more details | EditorViewModel | ||
| Starts the update workflow at the feature geometry and attribute editing panel.more details | more details | EditorViewModel | ||
| Starts the  | more details | EditorViewModel | ||
| Starts the Editor workflow where it waits for multiple features to be selected.more details | more details | EditorViewModel | 
Method Details
- cancelWorkflow()
- Cancels any active workflow. 
- deleteFeatureFromWorkflow()
- This is applicable if there is an active update workflow. If so, this method deletes the workflow feature. 
- startCreateWorkflowAtFeatureCreation(creationInfo)
- Initiates the - createworkflow by displaying the panel where feature creation begins. This method takes a CreationInfo object containing the layer(s) and template(s) to use.Parameter:creationInfo CreationInfo- An object containing information needed to create a new feature using the Editor widget. 
- startCreateWorkflowAtFeatureEdit(feature)
- This method starts the Editor workflow where it waits for the feature to be selected. Parameter:feature Graphic- The feature to be updated. 
- startCreateWorkflowAtFeatureTypeSelection()
- Initiates the - createworkflow by displaying the FeatureTemplates panel.
- startUpdateWorkflowAtFeatureEdit(feature)
- Starts the update workflow at the feature geometry and attribute editing panel. Parameter:feature Graphic- The feature to be updated. 
- startUpdateWorkflowAtFeatureSelection()
- Starts the - updateworkflow using the current selected feature.
- startUpdateWorkflowAtMultipleFeatureSelection()
- Starts the Editor workflow where it waits for multiple features to be selected. 
Type Definitions
- EditableItem
- The editable item available within the map. - Properties:
- layer FeatureLayerRead-only The feature layer associated with the editable item. supports StringRead-only The workflow type that this item supports. Can be either, updateorcreate.