altair.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 click.
  • "multi" – to select multiple discrete data value; 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.
bind : anyOf(Binding, Mapping(required=[]), LegendBinding)

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 false to disable.

Default value: dblclick.

See also: clear documentation.

empty : enum(‘all’, ‘none’)

By default, all data values are considered to lie within an empty selection. When set to none, empty selections contain no data values.

encodings : List(SingleDefUnitChannel)

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(FieldName)

An array of field names whose values must match for a data tuple to fall within the selection.

See also: fields documentation.

init : SelectionInitMapping

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(Stream, string)

A Vega event stream (object or selector) that triggers the selection. For interval selections, the event stream must specify a start and end.

resolve : SelectionResolution

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.