Wind Direction Input State Variable Reference

Related documents

• State Variables Overview
• StateVar Reference
• Unit Input SV Type Reference
• Windspeed Input SV Type Reference

Table of contents

• Introduction
• Constructor
• Instance methods
  • Inherited methods
• Instance properties
  • Inherited properties
  • magVar
• Component attributes
  • Inherited attributes
  • valueOnly
  • showUnits
• DOM element properties

Introduction

Wind Direction Input (windDirInput) state variables represent user inputs for METAR-style wind direction strings (e.g., "010", "180V270" or "VRB"). It is a type of unitInput that can support directions in either true north ("T") or magnetic north ("M").

Like other unitInput state variables MVCS supports a physical or virtual keyboard, a popup keypad, or a thumbwheel input mechanism and selects the desired mechanism by referring to the set_numInputType state variable. See Standard Settings Page.

The standard keyboard mechanism will ignore invalid characters and automatically add a 'V' before the fourth typed number. The popup keypad is specialized so that only valid wind direction characters can be entered. The thumbwheel input is similarly specialized to quickly select valid wind direction strings. Invalid entries are ignored and will revert to the previous valid setting.

Here's a typical example of a page-specific wind direction and units:

ctl.createPage({
	...,
	stateVarInfo:[
		{id:'page_windDir', type:'windDirInput',
			unitClass:'page_windDir',
			magVar: 0,
			units: {M:{dflt:'010'}, T:{dflt:'010'}},
		},
		{id:'page_windDirUnit', type:'unitSelector',
			unitClass:'page_windDir',
			options: [
				{value:'M', text:'Mag.'},
				{value:'T', text:'True'},
			],
			dflt: 'M',
		},
	],
});

A unitSelector with the same unitClass will control which unit is displayed if the parent windDirInput is displayed. Here's an example:

ctl.create page({
	...,
	render () {
		return (tml`
			...
			<Cr> <Cl>Wind direction</> <Cv>{{page_windDir}} {{page_windDirUnit}}</> </Cr>
		`);
	}
});

This will display a wind direction input box and a selector for the units.

Constructor

• Type string: 'windDirInput', class: WindDirInputSv

Syntax

ctl.createPage({
	...,
	stateVarInfo:[
		{id:'page_windDir', type:'windDirInput',
			unitClass:'page_windDir',
			magVar: 0,
			units: {M:{dflt:'010'}, T:{dflt:'010'}},
		},
	],
})

Parameters

• info
  An object containing the state variable properties. The info object can contain the following properties, but subclasses of StateVar may have additional properties:

  • StateVar info properties.
  • Model SV type info properties.
  • Input SV type info properties.
  • magVar
    A magnetic variance in degrees. The magVar value is added to a magnetic north direction to convert to true north.
  • unitClass
    The unitClass string for the unitSelector that controls which unit sibling is current for this state variable.
  • units
    An object with one or more keys. Each key is a subName for a child state variable. The key value is a numeric input constructor info object.

  The object for each unit has the following keys:

  • dflt (optional)
    The default value for that unit. Only one unit need be specified as the others will be converted.

Instance methods

Inherited methods

• StateVar methods
• ModelValueSv methods
• InputSv methods

Instance properties

Inherited properties

• StateVar properties
• ModelValueSv properties
• InputSv properties

magVar

A magnetic variance in degrees. The magVar value is added to a magnetic north direction to convert to true north.

Value

A number in degrees.

Component attributes

Inherited attributes

• Component attributes

valueOnly

If true, the component renders the value as read-only text instead of an input.

Value

A Boolean.

showUnits

If true, the component renders the current unit label after the value.

Value

A Boolean.

The component has no inputType attribute. It selects its input mechanism from the set_numInputType state variable (see Standard Settings Page). The values are:

• 'keyboard'
  Use the standard physical or virtual keyboard. This is the default for any other value.
• 'keypad'
  Use a popup numeric keypad.
• 'thumbwheel'
  Use a popup thumbwheel selector.

DOM element properties

• Standard DOM element properties
• For the keyboard inputType, the component will render an <input type="text">.
• The value attribute will be synchronized with the current unit sibling value.
• A <span> element containing the windspeed text string.
• The <span> contents will be synchronized with the state variable value.
• The <input> element will have a className that contains windDir and svIo_windDirInput.
• For a popup inputType, the component will render a <span>.
• The <span> contents will be synchronized with the state variable value.