ViewAnimation
require(["esri/views/ViewAnimation"], function(ViewAnimation) { /* code goes here */ });
esri/views/ViewAnimation
Contains a state property used for checking the state of the animation. The view animation is resolved when the animation has finished
and is rejected if it is stopped
.
watchUtils.when(view, "animation", function(animation) {
console.log(animation.state); // prints out "running"
animation.when(function(animation) {
console.log(animation.state); // prints out "finished"
})
.catch(function(animation) {
console.log(animation.state); // prints out "stopped"
});
});
Alternatively the state property can be watched for changes:
var animation = view.goTo(target, { speedFactor: 0.1 });
animation.watch("state", function(state) {
switch (state) {
case "finished":
console.log("Animation finished.");
break;
case "stopped":
console.log("Animation stopped.");
break;
}
});
- See also:
Constructors
- new ViewAnimation(properties)
- Parameter:properties Objectoptional
See the properties for a list of all the properties that may be passed into the constructor.
Property Overview
Name | Type | Summary | Class | |
---|---|---|---|---|
String | The name of the class. more details | more details | Accessor | |
String | The state of the animation. more details | more details | ViewAnimation | |
Viewpoint | The target of the animation. more details | more details | ViewAnimation |
Property Details
- Since: ArcGIS API for JavaScript 4.7
The name of the class. The declared class name is formatted as
esri.folder.className
.
- stateStringreadonly
The state of the animation.
The animation terminates when the state is either
finished
orstopped
and cannot transition again torunning
. Thefinished
state indicates the animation has successfully ended, while thestopped
state indicates that the animation was interrupted before it reached its final target.Possible Values: running | finished | stopped
- Default Value:running
- targetViewpoint
The target of the animation.
Method Overview
Name | Return Type | Summary | Class | |
---|---|---|---|---|
Finishes the view animation by immediately going to the target and sets the state of the animation to | more details | ViewAnimation | ||
Boolean |
| more details | ViewAnimation | |
Boolean |
| more details | ViewAnimation | |
Boolean |
| more details | ViewAnimation | |
Stops the view animation at its current state and sets the state of the animation to | more details | ViewAnimation | ||
Promise |
| more details | ViewAnimation |
Method Details
- finish()
Finishes the view animation by immediately going to the target and sets the state of the animation to
finished
.
- isFulfilled(){Boolean}
isFulfilled()
may be used to verify if creating an instance of the class is fulfilled (either resolved or rejected). If it is fulfilled,true
will be returned.Returns:Type Description Boolean Indicates whether creating an instance of the class has been fulfilled (either resolved or rejected).
- isRejected(){Boolean}
isRejected()
may be used to verify if creating an instance of the class is rejected. If it is rejected,true
will be returned.Returns:Type Description Boolean Indicates whether creating an instance of the class has been rejected.
- isResolved(){Boolean}
isResolved()
may be used to verify if creating an instance of the class is resolved. If it is resolved,true
will be returned.Returns:Type Description Boolean Indicates whether creating an instance of the class has been resolved.
- stop()
Stops the view animation at its current state and sets the state of the animation to
stopped
.
- when(callback, errback){Promise}Since: ArcGIS API for JavaScript 4.6
when()
may be leveraged once an instance of the class is created. This method takes two input parameters: acallback
function and anerrback
function. Thecallback
executes when the instance of the class loads. Theerrback
executes if the instance of the class fails to load.Parameters:callback FunctionoptionalThe function to call when the promise resolves.
errback FunctionoptionalThe function to execute when the promise fails.
Returns:Type Description Promise Returns a new promise for the result of callback
that may be used to chain additional functions.Example:// Although this example uses MapView, any class instance that is a promise may use then() in the same way var view = new MapView(); view.when(function(){ // This function will execute once the promise is resolved }, function(error){ // This function will execute if the promise is rejected due to an error });