Radio

The <sdpi-radio> component provides a styled wrapper of <input type="radio">.

Example

Property Inspector HTML

<sdpi-item label="Radio">
    <sdpi-radio setting="fav_number" columns="3">
        <option value="1">One</option>
        <option value="2">Two</option>
        <option value="3">Three</option>
        <option value="4">Four</option>
        <option value="5">Five</option>
    </sdpi-radio>
</sdpi-item>

Result

value

The value of <sdpi-radio> can be represented as a boolean, number or string, based on the value-type; the default type is string.

{
    "value": true | 1 | "one"
}

Configuration

The component supports the following configuration.

Name	Type	Description
columns	number	The number of columns to render the inputs in; valid values are 1-6.
default	string	The default value; shown when the persisted value is undefined.
disabled	boolean	Determines whether the input is disabled.
value	boolean, number, or string	The value of the component, and the persisted setting.
value-type	'boolean', 'number', or 'string'	Optional, the preferred value type of the persisted setting; when 'boolean', 'false' and 0 will equate in false. Defaults to 'string'.

Data Source

tip

Optionally, this components options can be loaded dynamically using the datasource attribute. When specified, this loads the options from the plugin, read more.

Name	Type	Description
datasource	string	The optional remote data source.
hot-reload	boolean	When present, sendToPropertyInspector is actively monitored allowing for the plugin to update the items.
loading	string	When a datasource is specified, this text is shown whilst the items are loaded.

Persistence

The value of the component can be automatically persisted to the Stream Deck with the following configuration.

Name	Type	Description
global	boolean	When present, the value will be persisted to the global settings.
setting	string	The path of the property where the value should be persisted in the settings.

setting

The setting represents the path of a property. If required, this path can denote a nested property within the settings, e.g. if the setting were foo.bar.prop, the value would be saved to:

{
    "foo": {
        "bar": {
            "prop": <value>
        }
    }
}