Normals

Object

aeris.wxblox.views.Normals

Data Usage

The Normals component displays the monthly climate normals for a single location.

Examples

Display the climate normals for Minneapolis, MN for May:

const view = new aeris.wxblox.views.Normals('#wxblox', {
    range: {
        from: '5/1/2017'
    }
});
view.load({
    p: 'minneapolis,mn'
});

Display the climate normals for Houston, TX for the month of December:

const view = new aeris.wxblox.views.Normals('#wxblox', {
    range: {
        from: '12/1/2017'
    }
});
view.load({
    p: 'houston,tx'
});

Configuration

The following configuration options are supported by this view:

Option	Description	Default
`range.from`	Type: `string` (undefined)The starting date to display observation history for in the format `MM/DD/YYYY`. For daily history, use the requested date. For monthly history, the first of the requested month is enforced (e.g. `6/1/2017`).	`{today_date}`
`range.to`	Type: `string` (undefined)(optional) The ending date to display observation history for in the format `MM/DD/YYYY`. This value is typically only used if you want to display a different range other than a single month or day. If `undefined`, this value is automatically calculated for a single month or day based on the value of summary	``
`enabled`	Type: `boolean` (undefined)Whether or not the view is enabled. If `false` then the view will not be rendered and data required for the view will not be requested. This option is typically only applicable for views contained within a parent layout.	`true`
`metric`	Type: `boolean` (undefined)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.	`false`
`renderNoData`	Type: `boolean` (undefined)Whether or not the view should be rendered if data was not returned or not available.	`true`
`request`	Type: `object` (undefined)An object containing the default 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.	``

Methods

The following methods are supported by instances of this view:

rendered()

show()

hide()

params()

setUnits(:number)

units()

enabled()

setMetric(:boolean)

load(:object)

refresh()

isMetric()

Events

The following events are triggered by instances of this view:

render

render:before

render:after

load:start

load:done

load:error

change:units

Views