fixes issues #1270 #1271 #1272, ESC key handling with popups

src/command/Menus.js

@@ -651,13 +651,14 @@ define(function (require, exports, module) {
         _insertInList($menubar, $newMenu, position, $relativeElement);
 
         // Install ESC key handling
-        PopUpManager.configurePopUp($popUp, closeAll);
+        PopUpManager.addPopUp($popUp, menu.close, false);
 
         // todo error handling
 
         return menu;
     }
 
+
     /**
      * @constructor
      * @extends {Menu}
@@ -689,7 +690,12 @@ define(function (require, exports, module) {
         // insert into DOM
         $("#context-menu-bar > ul").append($newMenu);
 
-        PopUpManager.configurePopUp($popUp, closeAll);
+        var self = this;
+        PopUpManager.addPopUp($popUp,
+            function () {
+                self.close();
+            },
+            false);
     }
     ContextMenu.prototype = new Menu();
     ContextMenu.prototype.constructor = ContextMenu;

src/widgets/PopUpManager.js

@@ -36,49 +36,42 @@ define(function (require, exports, module) {
     var _popUps = [];
 
     function _removePopUp($popUp, index, visible) {
-        var initiallyInDOM = $popUp.data("initiallyInDOM"),
-            removeHandler = $popUp.data("removeHandler");
+        var autoAddRemove = $popUp.data("PopUpManager-autoAddRemove"),
+            removeHandler = $popUp.data("PopUpManager-removeHandler");
 
         visible = visible || $popUp.find(":visible").length > 0;
 
         if (removeHandler && visible) {
             removeHandler();
         }
 
-        if (!initiallyInDOM) {
+        if (autoAddRemove) {
             $popUp.remove();
+            _popUps = _popUps.slice(index);
         }
-
-        _popUps = _popUps.slice(index);
     }
 
-    /**
-     * Add Esc key handling for pop-up DOM elements that persist in the DOM.
-     * These pop-up elements must handle appearance (i.e. opening) themselves.
-     *
-     * @param {!jQuery} $popUp jQuery object for the DOM element pop-up
-     * @param {function} removeHandler Pop-up specific remove (e.g. display:none or DOM removal)
-     */
-    function configurePopUp($popUp, removeHandler) {
-        _popUps.push($popUp[0]);
-
-        $popUp.data("initiallyInDOM", true);
-        $popUp.data("removeHandler", removeHandler);
-    }
+
 
     /**
-     * Add Esc key handling for transient DOM elements. Immediately adds
-     * the element to the DOM if it's not already attached.
+     * Add Esc key handling for a popup DOM element.
      *
      * @param {!jQuery} $popUp jQuery object for the DOM element pop-up
      * @param {function} removeHandler Pop-up specific remove (e.g. display:none or DOM removal)
+     * @param {?Boolean} autoAddRemove - Specify true to indicate the PopUPManager should 
+     *      add/remove the popup from the DOM when the popup is open/closed. Specifiy false
+     *      when the popup is either always persistant in the DOM or the add/remove is handled 
+     *      external to the PopupManager 
+     *      
      */
-    function addPopUp($popUp, removeHandler) {
-        var initiallyInDOM = $popUp.parent().length === 1;
+    function addPopUp($popUp, removeHandler, autoAddRemove) {
+        autoAddRemove = autoAddRemove || false;
 
-        configurePopUp($popUp, removeHandler, initiallyInDOM);
+        _popUps.push($popUp[0]);
+        $popUp.data("PopUpManager-autoAddRemove", autoAddRemove);
+        $popUp.data("PopUpManager-removeHandler", removeHandler);
 
-        if (!initiallyInDOM) {
+        if (autoAddRemove) {
             $(window.document.body).append($popUp);
         }
     }
@@ -91,16 +84,15 @@ define(function (require, exports, module) {
      */
     function removePopUp($popUp) {
         var index = _popUps.indexOf($popUp[0]),
-            initiallyInDOM = $popUp.data("initiallyInDOM"),
-            removeHandler = $popUp.data("removeHandler");
+            removeHandler = $popUp.data("PopUpManager-removeHandler");
 
         if (index >= 0) {
             _removePopUp($popUp, index);
         }
     }
 
     function _keydownCaptureListener(keyEvent) {
-        if (keyEvent.keyCode !== 27) {
+        if (keyEvent.keyCode !== 27) { // escape key
             return;
         }
 
@@ -132,5 +124,4 @@ define(function (require, exports, module) {
 
     exports.addPopUp        = addPopUp;
     exports.removePopUp     = removePopUp;
-    exports.configurePopUp  = configurePopUp;
 });