OpenLayers.Popup.Anchored

Inherits from

Summary
OpenLayers.Popup.Anchored
Properties
relativePosition{String} Relative position of the popup (“br”, “tr”, “tl” or “bl”).
keepInMap{Boolean} If panMapIfOutOfView is false, and this property is true, contrain the popup such that it always fits in the available map space.
anchor{Object} Object to which we’ll anchor the popup.
Constructor
OpenLayers.Popup.Anchored
Functions
destroy
showOverridden from Popup since user might hide popup and then show() it in a new location (meaning we might want to update the relative position on the show)
moveToSince the popup is moving to a new px, it might need also to be moved relative to where the marker is.
setSize
calculateRelativePosition
updateRelativePositionThe popup has been moved to a new relative location, so we may want to make some cosmetic adjustments to it.
calculateNewPx

Properties

relativePosition

{String} Relative position of the popup (“br”, “tr”, “tl” or “bl”).

keepInMap

{Boolean} If panMapIfOutOfView is false, and this property is true, contrain the popup such that it always fits in the available map space.  By default, this is set.  If you are creating popups that are near map edges and not allowing pannning, and especially if you have a popup which has a fixedRelativePosition, setting this to false may be a smart thing to do.

For anchored popups, default is true, since subclasses will usually want this functionality.

anchor

{Object} Object to which we’ll anchor the popup.  Must expose a ‘size’ (OpenLayers.Size) and ‘offset’ (OpenLayers.Pixel).

Constructor

OpenLayers.Popup.Anchored

Parameters

id{String}
lonlat{OpenLayers.LonLat}
contentSize{OpenLayers.Size}
contentHTML{String}
anchor{Object} Object which must expose a ‘size’ OpenLayers.Size and ‘offset’ OpenLayers.Pixel (generally an OpenLayers.Icon).
closeBox{Boolean}
closeBoxCallback{Function} Function to be called on closeBox click.

Functions

destroy

destroy: function()

show

show: function()

Overridden from Popup since user might hide popup and then show() it in a new location (meaning we might want to update the relative position on the show)

moveTo

moveTo: function(px)

Since the popup is moving to a new px, it might need also to be moved relative to where the marker is.  We first calculate the new relativePosition, and then we calculate the new px where we will put the popup, based on the new relative position.

If the relativePosition has changed, we must also call updateRelativePosition() to make any visual changes to the popup which are associated with putting it in a new relativePosition.

Parameters

px{OpenLayers.Pixel}

setSize

setSize:function(contentSize)

Parameters

contentSize{OpenLayers.Size} the new size for the popup’s contents div (in pixels).

calculateRelativePosition

calculateRelativePosition:function(px)

Parameters

px{OpenLayers.Pixel}

Returns

{String} The relative position (“br” “tr” “tl” “bl”) at which the popup should be placed.

updateRelativePosition

updateRelativePosition: function()

The popup has been moved to a new relative location, so we may want to make some cosmetic adjustments to it.

Note that in the classic Anchored popup, there is nothing to do here, since the popup looks exactly the same in all four positions.  Subclasses such as Framed, however, will want to do something special here.

calculateNewPx

calculateNewPx:function(px)

Parameters

px{OpenLayers.Pixel}

Returns

{OpenLayers.Pixel} The the new px position of the popup on the screen relative to the passed-in px.

destroy: function()
show: function()
Overridden from Popup since user might hide popup and then show() it in a new location (meaning we might want to update the relative position on the show)
moveTo: function(px)
Since the popup is moving to a new px, it might need also to be moved relative to where the marker is.
setSize:function(contentSize)
calculateRelativePosition:function(px)
updateRelativePosition: function()
The popup has been moved to a new relative location, so we may want to make some cosmetic adjustments to it.
calculateNewPx:function(px)
A popup is a small div that can opened and closed on the map.
Instances of this class represent a width/height pair
This class represents a screen coordinate, in x and y coordinates
This class represents a longitude and latitude pair
The icon represents a graphical icon on the screen.
Close