Variable
Represents a dynamic value derived from a data source, an iterator, an expression, or a custom constant. Variables can be used in Actions and ObjectStyles to drive dynamic behavior.
Schema
| Name | Type | Description | Default |
|---|---|---|---|
| id | string | A unique identifier for the variable. | — |
| name | string | A human-readable name for the variable. | Untitled Variable |
| type | "primitive""expression""interpolate-color""iterator""primitive-from-iterator""coords-from-data-source""coords-from-iterator""random""custom" | The type of variable, which determines how its value is calculated. | primitive |
| data_source_id | string | Reference to a Data Source if this variable depends on one. | — |
| iterator_id | string | Reference to an Iterator variable if this variable depends on it. | — |
| custom_value | string | Explicit value if type = "custom". | — |
| expression | string | Expression string if type = "expression". May include other variables. | — |
| data_path | object | Path within the Data Source response. Includes nodes, filters, and collapsed nodes. | { nodes: [], node_id: "", filters: [], collapsed_nodes: [] } |
| color_interpolation_range_start | number | Lower bound for color interpolation. | 0 |
| color_interpolation_range_end | number | Upper bound for color interpolation. | 100 |
| color_interpolation_factor_variable_id | string | Variable ID used as the interpolation factor. | — |
| color_interpolation_colors | string [] | List of colors used in interpolation. | |
| color_interpolation_smooth | boolean | Whether to smooth transitions between colors. | true |
| random_from | number | Lower bound for random values. | 0 |
| random_to | number | Upper bound for random values. | 1 |