View States
The main.js and app.css files are available in the ViewState folder of projects.zip.
Most properties can be bound to a view state. If configured, onSettingsChange will pass the value of the view state to the component. If the view state is updated elsewhere in KX Dashboards, the updated value will be passed to the component via onSettingsChange.
To set the value of the view states use setProperty.
See onSettingsChange.
setProperty
Set a value in the property inspector.
api.setProperty(path, value);
Parameters
path
The path of the property. If that property has been bound to a view state by the user, then the value of that view state will be set instead.
value
The value to set the property to.
Example
api.setProperty('Basics.Selected', 'new selected value');
Response
None.
getProperty
onSettingsChange will keep a component updated with changes to its properties, including changes to any underlying bound view states, so usage of getProperty is normally not necessary. However, if needed, a component can retrieve the current value of a property using getProperty.
api.getProperty(path);
See onSettingsChange.
Parameters
path
The path of the property.
Example
api.getProperty('Basics.Selected');
Response
Value of the property. If the property is bound to a view state, the value of the view state will be returned instead.
getPropertyMeta
If further information about a property is required, use getPropertyMeta.
api.getPropertyMeta(path);
Parameters
path
The path of the property.
Example
api.getPropertyMeta('Basics.Selected');
Response
An object containing information about the property, and if applicable, its bindings. Responses will differ depending on the value set in the property.
Generic properties are:
| Property | Description |
|---|---|
| path | Path to the property. |
| type | Type of binding — data if bound to a data source, viewstate if bound to a view state, or null if no binding (simple property). |
If the property is a simple property or is bound to a view state, the object will also contain:
| Property | Description |
|---|---|
| value | Value of the property. |
If the property is bound to a view state, the object will also contain:
| Property | Description |
|---|---|
| viewstateType | The kdb type of the view state. |
| defaultValue | The default value of the view state. |