A MapController view displays a single MapViewer instance with additional animation and timeline controls for adjusting a map's animation range and current time offsets.
Use our wizard to customize this view
JavaScript: | aeris.wxblox.views.MapController |
Server Path: | /views/maps/controller |
Data API/AMP Usage: | AMP usage based on size of map and total layers. Refer to the Map Units documentation for details. |
Supported Plans | AMP Developer,  AMP Basic,  AMP Premium |
The following configuration options are supported by this view:
Option | Default | Description |
---|---|---|
viewer |
|
(object) Configuration for the internal MapViewer component |
timeline |
|
(object) Configuration for the internal Timeline element |
range |
|
(object) Configuration for the internal Range element |
selectors |
|
(object) An object containing the DOM selectors to use when querying for render targets within the rendered component |
selectors.viewer | .awxs-mapviewer |
(string) The DOM target where the MapViewer component will be rendered |
selectors.timeline | .awxs-timeline |
(string) The DOM target where the Timeline will be rendered |
selectors.range | .awxs-timeline-range |
(string) The DOM target where the RangeControl will be rendered |
selectors.btnAnimate | .btn-animate |
(string) The DOM target for the MapViewer's playback toggle control |
enabled | true |
(boolean) Whether or not this view is enabled. If false then the view will not be rendered and it's required data will not be requested. This option is typically only applicable for views contained within a parent layout. |
metric | false |
(boolean) Whether or not to display units in metric. The method setUnits() can be used at runtime once a view has rendered to change the units currently displayed. |
renderNoData | true |
(boolean) Whether or not the view should be rendered if data was not returned or not available |
request | undefined |
(object) An object containing the default Aeris Weather API request options to use for the views's data request where applicable. These parameters can also be overriden in the load(:params) method when rendering the view using the JavaScript method. |
The following methods are supported by instances of this view (JavaScript method only):
viewer() |
The internal MapViewer instance |
timeline() |
The internal Timeline instance |
range() |
The internal RangeControl instance |
enabled() |
[boolean] Whether or not the component is currently enabled. When false, the component will not be rendered and data required for the component will not be requested. |
hide() |
Hides the component's DOM element. |
isMetric() |
[boolean] Whether or not the component is currently displaying Metric units. |
load(:object) |
Requests data required by the component and renders the result. For components that don't require remote data requests, this method will call render() immediately. An optional object of request parameters can be provided to use for the request. |
params() |
[object] Returns the latest request parameters used when loading data. |
refresh() |
Re-renders the component using the cached data that was previously loaded. |
rendered() |
[boolean] Whether or not the component has rendered. |
setMetric(:boolean) |
Convenience method for setUnits() to toggle Metric units, where true sets the component's units to Metric and false uses Imperial. |
setUnits(:number) |
Updates the unit type being displayed by the component, where 0 is Imperial and 1 is Metric. |
show() |
Shows the component's DOM element. |
units() |
[number] The current unit type being displayed, where 0 is Imperial and 1 is Metric. |
The following events are triggered by instances of this view (JavaScript method only):
change:units |
Triggered when the component's unit type has changed (e.g. metric or imperial). |
load:done |
Triggered after the component's data has loaded but before rendering the component. |
load:error |
Triggered when an error occurs while requesting the component's data. |
load:start |
Triggered immediately before the component's data request begins loading. |
render |
Alias for render:after. |
render:after |
Triggered after the component has rendered and any additional DOM elements and/or events have been setup as needed for the component. |
render:before |
Triggered immediately before the component is rendered, allowing you to access and modify the data used in the template before getting rendered. |
Last modified: November 11, 2019