Provides the logic for the Home widget that animates the View to its initial Viewpoint or a previously defined viewpoint.
var homeWidget = new Home({
viewModel: { // autocasts as new HomeViewModel()
view: view
}
}, "homediv"); // References the DOM node used to place the widget
Constructors
new HomeViewModel(properties)
properties Object See the properties for a list of all the properties that may be passed into the constructor. |
Property Overview
Name | Type | Summary | |
---|---|---|---|
String | The name of the class. more details | more details | |
String | The current state of the widget. more details | more details | |
MapView | SceneView | The view associated with the widget instance. more details | more details | |
Viewpoint | The Viewpoint, or point of view, to zoom to when going home. more details | more details |
Property Details
declaredClassStringreadonly
The name of the class. The declared class name is formatted as
esri.folder.className
.stateStringreadonly
The current state of the widget.
Possible Values: disabled | ready | going-home
Default Value: disabledThe view associated with the widget instance.
viewpointViewpoint
The Viewpoint, or point of view, to zoom to when going home. The initial value is determined a few different ways:
Default Value: nullExample:// Creates a viewpoint centered on the extent of a polygon geometry var vp = new Viewpoint({ targetGeometry: geom.extent }); // Sets the model's viewpoint to the Viewpoint based on a polygon geometry home.ViewModel.viewpoint = vp;
Method Overview
Name | Return Type | Summary | |
---|---|---|---|
Animates the view to the initial Viewpoint of the view or the value of viewpoint. more details | more details | ||
Boolean | Indicates whether there is an event listener on the instance that matches the provided event name. more details | more details | |
Object | Registers an event handler on the instance. more details | more details |
Method Details
go()
hasEventListener(type){Boolean}
Indicates whether there is an event listener on the instance that matches the provided event name.
Parameter:type StringThe name of the event.
Returns:Type Description Boolean Returns true if the class supports the input event. on(type, listener){Object}
Registers an event handler on the instance. Call this method to hook an event with a listener. See the Events summary table for a list of listened events.
Parameters:type StringThe name of event to listen for.
listener FunctionThe function to call when the event is fired.
Returns:Type Description Object Returns an event handler with a remove()
method that can be called to stop listening for the event.Property Type Description remove Function When called, removes the listener from the event. - See also:
Example:view.on("click", function(event){ // event is the event handle returned after the event fires. console.log(event.mapPoint); });