Class: Select

ol/interaction/Select~Select


import Select from 'ol/interaction/Select';

Interaction for selecting vector features. By default, selected features are styled differently, so this interaction can be used for visual highlighting, as well as selecting features for other actions, such as modification or output. There are three ways of controlling which features are selected: using the browser event as defined by the condition and optionally the toggle, add/remove, and multi options; a layers filter; and a further feature filter using the filter option.

Selected features are added to an internal unmanaged layer.

new Select(opt_options)

interaction/Select.js, line 157
Name Type Description
options

Options.

Name Type Default Description
addCondition module:ol/events/condition~Condition

A function that takes an module:ol/MapBrowserEvent~MapBrowserEvent and returns a boolean to indicate whether that event should be handled. By default, this is module:ol/events/condition~never. Use this if you want to use different events for add and remove instead of toggle.

condition module:ol/events/condition~Condition

A function that takes an module:ol/MapBrowserEvent~MapBrowserEvent and returns a boolean to indicate whether that event should be handled. This is the event for the selected features as a whole. By default, this is module:ol/events/condition~singleClick. Clicking on a feature selects that feature and removes any that were in the selection. Clicking outside any feature removes all from the selection. See toggle, add, remove options for adding/removing extra features to/ from the selection.

layers Array.<module:ol/layer/Layer~Layer> | function

A list of layers from which features should be selected. Alternatively, a filter function can be provided. The function will be called for each layer in the map and should return true for layers that you want to be selectable. If the option is absent, all visible layers will be considered selectable.

style module:ol/style/Style~Style | Array.<module:ol/style/Style~Style> | module:ol/style/Style~StyleFunction

Style for the selected features. By default the default edit style is used (see module:ol/style).

removeCondition module:ol/events/condition~Condition

A function that takes an module:ol/MapBrowserEvent~MapBrowserEvent and returns a boolean to indicate whether that event should be handled. By default, this is module:ol/events/condition~never. Use this if you want to use different events for add and remove instead of toggle.

toggleCondition module:ol/events/condition~Condition

A function that takes an module:ol/MapBrowserEvent~MapBrowserEvent and returns a boolean to indicate whether that event should be handled. This is in addition to the condition event. By default, module:ol/events/condition~shiftKeyOnly, i.e. pressing shift as well as the condition event, adds that feature to the current selection if it is not currently selected, and removes it if it is. See add and remove if you want to use different events instead of a toggle.

multi boolean false

A boolean that determines if the default behaviour should select only single features or all (overlapping) features at the clicked map position. The default of false means single select.

features module:ol/Collection~Collection.<module:ol/Feature~Feature>

Collection where the interaction will place selected features. Optional. If not set the interaction will create a collection. In any case the collection used by the interaction is returned by module:ol/interaction/Select~Select#getFeatures.

filter module:ol/interaction/Select~FilterFunction

A function that takes an module:ol/Feature and an module:ol/layer/Layer and returns true if the feature may be selected or false otherwise.

wrapX boolean true

Wrap the world horizontally on the selection overlay.

hitTolerance number 0

Hit-detection tolerance. Pixels inside the radius around the given position will be checked for features. This only works for the canvas renderer and not for WebGL.

Fires:
  • select - Triggered when feature(s) has been (de)selected.

Methods

getFeatures(){module:ol/Collection~Collection.<module:ol/Feature~Feature>}

interaction/Select.js, line 280

Get the selected features.

Returns:
Features collection.

getHitTolerance(){number}

interaction/Select.js, line 289

Returns the Hit-detection tolerance.

Returns:
Hit tolerance in pixels.

getLayer(feature){module:ol/layer/Vector~VectorLayer}

interaction/Select.js, line 302

Returns the associated vectorlayer of the (last) selected feature. Note that this will not work with any programmatic method like pushing features to collection.

Name Type Description
feature module:ol/Feature~Feature | module:ol/render/Feature~RenderFeature

Feature

Returns:
Layer.

getOverlay(){module:ol/layer/Vector~VectorLayer}

interaction/Select.js, line 314

Get the overlay layer that this interaction renders selected features to.

Returns:
Overlay layer.

setHitTolerance(hitTolerance)

interaction/Select.js, line 325

Hit-detection tolerance. Pixels inside the radius around the given position will be checked for features. This only works for the canvas renderer and not for WebGL.

Name Type Description
hitTolerance number

Hit tolerance in pixels.

setMap(map)

interaction/Select.js, line 336

Remove the interaction from its current map, if any, and attach it to a new map, if any. Pass null to just remove the interaction from the current map.

Name Type Description
map module:ol/PluggableMap~PluggableMap

Map.