ol. ol.Overlay

new Overlay

An element to show on top of the map, such as for a popup.

Example:

var popup = new ol.Overlay({
  map: map,
  element: document.getElementById('popup')
});
popup.setPosition(coordinate);
Parameters:
Name Type Description
options ol.OverlayOptions

Overlay options.

Source:
  • overlay.js, line 54

Extends

Methods

bindTo

Binds a View to a Model.

Parameters:
Name Type Argument Description
key string

Key.

target ol.Object

Target.

targetKey string <optional>
(Optional)

Target key.

noNotify boolean <optional>
(Optional)

No notify.

Inherited From:
Source:
  • object.js, line 147

get

Gets a value.

Parameters:
Name Type Description
key string

Key.

Inherited From:
Source:
  • object.js, line 170
Returns:

Value.

Type
*

getElement

Get the DOM element of this overlay.

Source:
  • overlay.js, line 125
Returns:

Element.

Type
Element | undefined

getMap

Get the map associated with this overlay.

Source:
  • overlay.js, line 139
Returns:

Map.

Type
ol.Map | undefined

getPosition

Get the current position of this overlay.

Source:
  • overlay.js, line 153
Returns:

Position.

Type
ol.Coordinate | undefined

getPositioning

Get the current positioning of this overlay.

Source:
  • overlay.js, line 167
Returns:

Positioning.

Type
ol.OverlayPositioning | undefined

notify

Notify all observers of a change on this property. This notifies both objects that are bound to the object's property as well as the object that it is bound to.

Parameters:
Name Type Description
key string

Key.

Inherited From:
Source:
  • object.js, line 208

on

Listen for a certain type of event.

Parameters:
Name Type Argument Description
type string | Array.<string>

The event type or array of event types.

listener Function

The listener function.

scope Object <optional>
(Optional)

Object is whose scope to call the listener.

Inherited From:
Source:
  • object.js, line 240
Returns:

Unique key for the listener.

Type
goog.events.Key

once

Listen once for a certain type of event.

Parameters:
Name Type Argument Description
type string | Array.<string>

The event type or array of event types.

listener Function

The listener function.

scope Object <optional>
(Optional)

Object is whose scope to call the listener.

Inherited From:
Source:
  • object.js, line 253
Returns:

Unique key for the listener.

Type
goog.events.Key

set

Sets a value.

Parameters:
Name Type Description
key string

Key.

value *

Value.

Inherited From:
Source:
  • object.js, line 263

setElement

Set the DOM element to be associated with this overlay.

Parameters:
Name Type Description
element Element | undefined

Element.

Source:
  • overlay.js, line 237

setMap

Set the map to be associated with this overlay.

Parameters:
Name Type Description
map ol.Map | undefined

Map.

Source:
  • overlay.js, line 250

setPosition

Set the position for this overlay.

Parameters:
Name Type Description
position ol.Coordinate | undefined

Position.

Source:
  • overlay.js, line 263

setValues

Sets a collection of key-value pairs.

Parameters:
Name Type Description
values Object.<string, *>

Values.

Inherited From:
Source:
  • object.js, line 286

un

Unlisten for a certain type of event.

Parameters:
Name Type Argument Description
type string | Array.<string>

The event type or array of event types.

listener Function

The listener function.

scope Object <optional>
(Optional)

Object is whose scope to call the listener.

Inherited From:
Source:
  • object.js, line 326

unbind

Removes a binding. Unbinding will set the unbound property to the current value. The object will not be notified, as the value has not changed.

Parameters:
Name Type Description
key string

Key.

Inherited From:
Source:
  • object.js, line 305

unbindAll

Removes all bindings.

Inherited From:
Source:
  • object.js, line 344

unByKey

Removes an event listener which was added with listen() by the key returned by on().

Parameters:
Name Type Argument Description
key number <nullable>

Key.

Inherited From:
Source:
  • object.js, line 336