Index: lib/OpenLayers/Map.js =================================================================== --- lib/OpenLayers/Map.js (revisión: 10354) +++ lib/OpenLayers/Map.js (copia de trabajo) @@ -77,6 +77,10 @@ * - *clearmarkers* triggered after markers have been cleared * - *mouseover* triggered after mouseover the map * - *mouseout* triggered after mouseout the map + * - *mapmouseover* triggered after mouseover the map except for + * div using event listeners. + * - *mapmouseout* triggered after mouseout the map and mouseover + * in div using event listeners. * - *mousemove* triggered after mousemove the map * - *dragstart* Does not work. Register for movestart instead. * - *drag* Does not work. Register for move instead. @@ -88,9 +92,45 @@ "move", "moveend", "zoomend", "popupopen", "popupclose", "addmarker", "removemarker", "clearmarkers", "mouseover", "mouseout", "mousemove", "dragstart", "drag", "dragend", - "changebaselayer"], + "changebaselayer", "mapmouseover", "mapmouseout"], /** + * Property: outMapMouseIsOver + * {Boolean} For manage "mapmouseover" & "mapmouseout" events, true when + * mouse is over the map, is read only. See method. + */ + outMapMouseIsOver: false, + + /** + * Property: outMapMouseIsAsOutMap + * {Boolean} For manage "mapmouseover" & "mapmouseout" events, true when + * mouse is over a div as outMap, is read only. See + * method. + */ + outMapMouseIsAsOutMap: false, + + /** + * Property: outMapEventsTimeout + * {Number} Timeout id of trigger for manage "mapmouseover" & "mapmouseout" + * events. + */ + outMapEventsTimeout: null, + + /** + * Property: eventListenersOutMap + * {Object} For manage "mapmouseover" & "mapmouseout", this object is used + * by map.events.on and map.events.un methods. See the + * method. + */ + eventListenersOutMap: null, + + /** + * Property: eventsOutMapLaunched + * {Boolean} It is true after calling the method . + */ + eventsOutMapLaunched: false, + + /** * Property: id * {String} Unique identifier for the map */ @@ -683,6 +723,16 @@ } this.viewPortDiv = null; + if (this.eventsOutMapLaunched) { + this.outMapEventsTimeoutClear(); + if (this.eventListenersOutMap) { + this.events.un(this.eventListenersOutMap); + this.eventListenersOutMap = null; + } + this.eventsOutMapLaunched = false; + this.outMapMouseIsOver = false; + this.outMapMouseIsAsOutMap = false; + } if(this.eventListeners) { this.events.un(this.eventListeners); this.eventListeners = null; @@ -2373,6 +2423,106 @@ return this.getLayerPxFromViewPortPx(px); }, + /********************************************************/ + /* */ + /* Management outMap events */ + /* */ + /********************************************************/ + + /** + * Method: startEventsOutMap + * Start works for trigger events "mapmouseover" and "mapmouseout". + * + * This events are similar that "mouseover" and "mouseout" with the + * following differences: + * - "mouseout" immediately followed by "mouseover" are ignored (less that + * 100 milliseconds between mouseout and mouseover) this is for + * trigger efficiency. + * - Allows to select a div into the map to generate the events as an + * out map div, see function. + * + * Events are not managed until this method is called. + */ + startEventsOutMap: function() { + if (this.eventsOutMapLaunched) { return; } + this.eventListenersOutMap ={ + mouseover: function(evt) { + this.outMapEventsTimeoutClear(); + if (this.outMapMouseIsOver) { return; } + if (this.outMapMouseIsAsOutMap) { return; } + this.outMapMouseIsOver = true; + this.events.triggerEvent("mapmouseover"); + }, + mouseout: function(evt) { + if (!this.outMapEventsTimeout) { + this.outMapEventsTimeout = window.setTimeout( + OpenLayers.Function.bind(function() { + this.outMapEventsTimeout = null; + if (!this.outMapMouseIsOver) { return; } + this.outMapMouseIsOver = false; + this.events.triggerEvent("mapmouseout"); + }, this), + 100 + ); + } + }, + scope: this + }; + this.events.on(this.eventListenersOutMap); + this.eventsOutMapLaunched = true; + }, + + /** + * Function: getListenersAsOutMap + * Returns returns eventListeners object for register events that let a div + * as outMap. + * + * Example usage: + * To set as outMap the div on a control. + * (code) + * var control = new OpenLayers.Control.Xxxxxxxx(); + * map.addControl(control); + * var newDivEvents = new OpenLayers.Events(control, control.div, null, + * true); // If do not want to alter the behavior of mouseover in + * // map.events is necessary set fallThrough parameter + * // to true. + * newDivEvents.on(control.map.getListenersAsOutMap()); // set to outMap + * (end) + * + * Returns: + * {Object} For use in and + * methods. + */ + getListenersAsOutMap: function() { + return { + mouseover: function(evt) { + this.outMapMouseIsAsOutMap = true; + this.outMapEventsTimeoutClear(); + if (!this.outMapMouseIsOver) { return; } + this.outMapMouseIsOver = false; + this.events.triggerEvent("mapmouseout"); + //OpenLayers.Event.stop(evt, false); + return true; + }, + mouseout: function() { + this.outMapMouseIsAsOutMap = false; + }, + scope: this + }; + }, + + /** + * Method: outMapEventsTimeoutClear + * To clean the timeout created by the event in + * property. + */ + outMapEventsTimeoutClear: function() { + if(this.outMapEventsTimeout) { + window.clearTimeout(this.outMapEventsTimeout); + this.outMapEventsTimeout = null; + } + }, + CLASS_NAME: "OpenLayers.Map" }); Index: examples/outmap-events.html =================================================================== --- examples/outmap-events.html (revisión: 0) +++ examples/outmap-events.html (revisión: 0) @@ -0,0 +1,138 @@ + + + Example of how use outMap events + + + + + + + + + +

Example of use of outMap events: "mapmouseover" + & "mapmouseout"

+

+ Events: "mapmouseover" & "mapmouseout" + allows some div on the map they behave as if they were outside. + And has a more efficient trigger that "mouseover" & + "mouseout".

+
+
+

See efficient trigger of "mapmouse..." events

+ log1: + Clear logs + "mouseover" + & "mouseout" events.
(try to move + mouse over PanZoom) +
+ log2: "mapmouseover" + & "mapmouseout" events. +
+
+
+
State of mouse events: + (for put mouse state)
+
State of outMap events: + (for put outMap state)
+
+

Features of outMap events:

+
    +
  • Allows some div on the map that they behave as if they + were outside (see popup and overview map + in this example)
    • +
  • More efficient trigger that "mouseover" & + "mouseout" (see differences between log1 and + log2)
    • +
+

Description of events:

+
    +
  • mapmouseover: triggered after + mouseover the map except for div using + getListenersAsOutMap() eventListeners.
    • +
  • mapmouseout: triggered after mouseout + the map and mouseover div using getListenersAsOutMap() + eventListeners.
    • +
  • It is necessary to start events outMap managing with + map.startEventsOutMap method.
    • +
  • map.getListenersAsOutMap() function + eventListeners object for register events that let a + div as outMap.
    • +
+
+
+ +