selection_single(self, type=Undefined, bind=Undefined, clear=Undefined, empty=Undefined, encodings=Undefined, fields=Undefined, init=Undefined, nearest=Undefined, on=Undefined, resolve=Undefined, **kwds)¶
Create a selection with type=’single’ Mapping(required=[type])
- type : enum(‘single’)
Determines the default event processing and data query for the selection. Vega-Lite currently supports three selection types:
"single"– to select a single discrete data value on
"multi"– to select multiple discrete data value; the first value is selected on
clickand additional values toggled on shift-
"interval"– to select a continuous range of data values on
- bind : anyOf(
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.
- clear : anyOf(
Stream, string, boolean)
Clears the selection, emptying it of all values. Can be a Event Stream or
See also: clear documentation.
- empty : enum(‘all’, ‘none’)
alldata values are considered to lie within an empty selection. When set to
none, empty selections contain no data values.
- encodings : List(
An array of encoding channels. The corresponding data field values must match for a data tuple to fall within the selection.
See also: encodings documentation.
- fields : List(
An array of field names whose values must match for a data tuple to fall within the selection.
See also: fields documentation.
- init :
Initialize the selection with a mapping between projected channels or field names and initial values.
See also: init documentation.
- nearest : boolean
When true, an invisible voronoi diagram is computed to accelerate discrete selection. The data value nearest the mouse cursor is added to the selection.
See also: nearest documentation.
- on : anyOf(
- resolve :
With layered and multi-view displays, a strategy that determines how selections’ data queries are resolved when applied in a filter transform, conditional encoding rule, or scale domain.
See also: resolve documentation.