class altair.TopLevelSelectionParameter(name=Undefined, select=Undefined, bind=Undefined, value=Undefined, views=Undefined, **kwds)#

TopLevelSelectionParameter schema wrapper

TopLevelSelectionParameter, Dict[required=[name, select]]

nameParameterName, str

Required. A unique name for the selection parameter. Selection names should be valid JavaScript identifiers: they should contain only alphanumeric characters (or “$”, or “_”) and may not start with a digit. Reserved keywords that may not be used as parameter names are “datum”, “event”, “item”, and “parent”.

selectIntervalSelectionConfig, Dict[required=[type]], PointSelectionConfig, Dict[required=[type]], SelectionType, Literal[‘point’, ‘interval’]

Determines the default event processing and data query for the selection. Vega-Lite currently supports two selection types:

  • "point" – to select multiple discrete data values; the first value is selected on click and additional values toggled on shift-click.

  • "interval" – to select a continuous range of data values on drag.

bindBindCheckbox, Dict[required=[input]], BindDirect, Dict[required=[element]], BindInput, Dict, BindRadioSelect, Dict[required=[input, options]], BindRange, Dict[required=[input]], Binding, LegendBinding, LegendStreamBinding, Dict[required=[legend]], str, Dict, str

When set, a selection is populated by input elements (also known as dynamic query widgets) or by interacting with the corresponding legend. Direct manipulation interaction is disabled by default; to re-enable it, set the selection’s on property.

Legend bindings are restricted to selections that only specify a single field or encoding.

Query widget binding takes the form of Vega’s input element binding definition or can be a mapping between projected field/encodings and binding definitions.

See also: bind documentation.

valueDateTime, Dict, PrimitiveValue, None, bool, float, str, SelectionInit, SelectionInitIntervalMapping, Dict, Sequence[SelectionInitMapping, Dict]

Initialize the selection with a mapping between projected channels or field names and initial values.

See also: init documentation.


By default, top-level selections are applied to every view in the visualization. If this property is specified, selections will only be applied to views with the given names.

__init__(name=Undefined, select=Undefined, bind=Undefined, value=Undefined, views=Undefined, **kwds)#


__init__([name, select, bind, value, views])

copy([deep, ignore])

Return a copy of the object

from_dict(dct[, validate, _wrapper_classes])

Construct class from a dictionary representation

from_json(json_string[, validate])

Instantiate the object from a valid JSON string


Resolve references in the context of this object's schema or root schema.

to_dict([validate, ignore, context])

Return a dictionary representation of the object

to_json([validate, indent, sort_keys, ...])

Emit the JSON representation for this object as a string.

validate(instance[, schema])

Validate the instance against the class schema in the context of the rootschema.

validate_property(name, value[, schema])

Validate a property against property schema in the context of the rootschema