diff options
Diffstat (limited to 'contexts/data/lib/closure-library/closure/goog/ui/popup.js')
| -rw-r--r-- | contexts/data/lib/closure-library/closure/goog/ui/popup.js | 346 |
1 files changed, 0 insertions, 346 deletions
diff --git a/contexts/data/lib/closure-library/closure/goog/ui/popup.js b/contexts/data/lib/closure-library/closure/goog/ui/popup.js deleted file mode 100644 index 2965f52..0000000 --- a/contexts/data/lib/closure-library/closure/goog/ui/popup.js +++ /dev/null @@ -1,346 +0,0 @@ -// Copyright 2006 The Closure Library Authors. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"); -// you may not use this file except in compliance with the License. -// You may obtain a copy of the License at -// -// http://www.apache.org/licenses/LICENSE-2.0 -// -// Unless required by applicable law or agreed to in writing, software -// distributed under the License is distributed on an "AS-IS" BASIS, -// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -// See the License for the specific language governing permissions and -// limitations under the License. - -/** - * @fileoverview Definition of the Popup class. - * - * @see ../demos/popup.html - */ - -goog.provide('goog.ui.Popup'); -goog.provide('goog.ui.Popup.AbsolutePosition'); -goog.provide('goog.ui.Popup.AnchoredPosition'); -goog.provide('goog.ui.Popup.AnchoredViewPortPosition'); -goog.provide('goog.ui.Popup.ClientPosition'); -goog.provide('goog.ui.Popup.Corner'); -goog.provide('goog.ui.Popup.Overflow'); -goog.provide('goog.ui.Popup.ViewPortClientPosition'); -goog.provide('goog.ui.Popup.ViewPortPosition'); - -goog.require('goog.math.Box'); -goog.require('goog.positioning'); -goog.require('goog.positioning.AbsolutePosition'); -goog.require('goog.positioning.AnchoredPosition'); -goog.require('goog.positioning.AnchoredViewportPosition'); -goog.require('goog.positioning.ClientPosition'); -goog.require('goog.positioning.Corner'); -goog.require('goog.positioning.Overflow'); -goog.require('goog.positioning.OverflowStatus'); -goog.require('goog.positioning.ViewportClientPosition'); -goog.require('goog.positioning.ViewportPosition'); -goog.require('goog.style'); -goog.require('goog.ui.PopupBase'); - - - -/** - * The Popup class provides functionality for displaying an absolutely - * positioned element at a particular location in the window. It's designed to - * be used as the foundation for building controls like a menu or tooltip. The - * Popup class includes functionality for displaying a Popup near adjacent to - * an anchor element. - * - * This works cross browser and thus does not use IE's createPopup feature - * which supports extending outside the edge of the brower window. - * - * @param {Element=} opt_element A DOM element for the popup. - * @param {goog.positioning.AbstractPosition=} opt_position A positioning helper - * object. - * @constructor - * @extends {goog.ui.PopupBase} - */ -goog.ui.Popup = function(opt_element, opt_position) { - /** - * Corner of the popup to used in the positioning algorithm. - * - * @type {goog.positioning.Corner} - * @private - */ - this.popupCorner_ = goog.positioning.Corner.TOP_START; - - /** - * Positioning helper object. - * - * @type {goog.positioning.AbstractPosition|undefined} - * @protected - * @suppress {underscore} - */ - this.position_ = opt_position || undefined; - goog.ui.PopupBase.call(this, opt_element); -}; -goog.inherits(goog.ui.Popup, goog.ui.PopupBase); - - -/** - * Enum for representing an element corner for positioning the popup. - * - * @enum {number} - * - * @deprecated Use {@link goog.positioning.Corner} instead, this alias will be - * removed at the end of Q1 2009. - */ -goog.ui.Popup.Corner = goog.positioning.Corner; - - -/** - * Enum for representing position handling in cases where the element would be - * positioned outside the viewport. - * - * @enum {number} - * - * @deprecated Use {@link goog.positioning.Overflow} instead, this alias will be - * removed at the end of Q1 2009. - */ -goog.ui.Popup.Overflow = goog.positioning.Overflow; - - -/** - * Margin for the popup used in positioning algorithms. - * - * @type {goog.math.Box|undefined} - * @private - */ -goog.ui.Popup.prototype.margin_; - - -/** - * Returns the corner of the popup to used in the positioning algorithm. - * - * @return {goog.positioning.Corner} The popup corner used for positioning. - */ -goog.ui.Popup.prototype.getPinnedCorner = function() { - return this.popupCorner_; -}; - - -/** - * Sets the corner of the popup to used in the positioning algorithm. - * - * @param {goog.positioning.Corner} corner The popup corner used for - * positioning. - */ -goog.ui.Popup.prototype.setPinnedCorner = function(corner) { - this.popupCorner_ = corner; - if (this.isVisible()) { - this.reposition(); - } -}; - - -/** - * @return {goog.positioning.AbstractPosition} The position helper object - * associated with the popup. - */ -goog.ui.Popup.prototype.getPosition = function() { - return this.position_ || null; -}; - - -/** - * Sets the position helper object associated with the popup. - * - * @param {goog.positioning.AbstractPosition} position A position helper object. - */ -goog.ui.Popup.prototype.setPosition = function(position) { - this.position_ = position || undefined; - if (this.isVisible()) { - this.reposition(); - } -}; - - -/** - * Returns the margin to place around the popup. - * - * @return {goog.math.Box?} The margin. - */ -goog.ui.Popup.prototype.getMargin = function() { - return this.margin_ || null; -}; - - -/** - * Sets the margin to place around the popup. - * - * @param {goog.math.Box|number|null} arg1 Top value or Box. - * @param {number=} opt_arg2 Right value. - * @param {number=} opt_arg3 Bottom value. - * @param {number=} opt_arg4 Left value. - */ -goog.ui.Popup.prototype.setMargin = function(arg1, opt_arg2, opt_arg3, - opt_arg4) { - if (arg1 == null || arg1 instanceof goog.math.Box) { - this.margin_ = arg1; - } else { - this.margin_ = new goog.math.Box(arg1, - /** @type {number} */ (opt_arg2), - /** @type {number} */ (opt_arg3), - /** @type {number} */ (opt_arg4)); - } - if (this.isVisible()) { - this.reposition(); - } -}; - - -/** - * Repositions the popup according to the current state. - * @override - */ -goog.ui.Popup.prototype.reposition = function() { - if (!this.position_) { - return; - } - - var hideForPositioning = !this.isVisible() && - this.getType() != goog.ui.PopupBase.Type.MOVE_OFFSCREEN; - var el = this.getElement(); - if (hideForPositioning) { - el.style.visibility = 'hidden'; - goog.style.showElement(el, true); - } - - this.position_.reposition(el, this.popupCorner_, this.margin_); - - if (hideForPositioning) { - // NOTE(eae): The visibility property is reset to 'visible' by the show_ - // method in PopupBase. Resetting it here causes flickering in some - // situations, even if set to visible after the display property has been - // set to none by the call below. - goog.style.showElement(el, false); - } -}; - - - -/** - * Encapsulates a popup position where the popup is anchored at a corner of - * an element. - * - * When using AnchoredPosition, it is recommended that the popup element - * specified in the Popup constructor or Popup.setElement be absolutely - * positioned. - * - * @param {Element} element The element to anchor the popup at. - * @param {goog.positioning.Corner} corner The corner of the element to anchor - * the popup at. - * @constructor - * @extends {goog.positioning.AbstractPosition} - * - * @deprecated Use {@link goog.positioning.AnchoredPosition} instead, this - * alias will be removed at the end of Q1 2009. - */ -goog.ui.Popup.AnchoredPosition = goog.positioning.AnchoredPosition; - - - -/** - * Encapsulates a popup position where the popup is anchored at a corner of - * an element. The corners are swapped if dictated by the viewport. For instance - * if a popup is anchored with its top left corner to the bottom left corner of - * the anchor the popup is either displayed below the anchor (as specified) or - * above it if there's not enough room to display it below. - * - * When using AnchoredPosition, it is recommended that the popup element - * specified in the Popup constructor or Popup.setElement be absolutely - * positioned. - * - * @param {Element} element The element to anchor the popup at. - * @param {goog.positioning.Corner} corner The corner of the element to anchor - * the popup at. - * @param {boolean=} opt_adjust Whether the positioning should be adjusted until - * the element fits inside the viewport even if that means that the anchored - * corners are ignored. - * @constructor - * @extends {goog.ui.Popup.AnchoredPosition} - * - * @deprecated Use {@link goog.positioning.AnchoredViewportPosition} instead, - * this alias will be removed at the end of Q1 2009. - */ -goog.ui.Popup.AnchoredViewPortPosition = - goog.positioning.AnchoredViewportPosition; - - - -/** - * Encapsulates a popup position where the popup absolutely positioned by - * setting the left/top style elements directly to the specified values. - * The position is generally relative to the element's offsetParent. Normally, - * this is the document body, but can be another element if the popup element - * is scoped by an element with relative position. - * - * @param {number|!goog.math.Coordinate} arg1 Left position or coordinate. - * @param {number=} opt_arg2 Top position. - * @constructor - * @extends {goog.positioning.AbstractPosition} - * - * @deprecated Use {@link goog.positioning.AbsolutePosition} instead, this alias - * will be removed at the end of Q1 2009. - */ -goog.ui.Popup.AbsolutePosition = goog.positioning.AbsolutePosition; - - - -/** - * Encapsulates a popup position where the popup is positioned according to - * coordinates relative to the element's view port (page). This calculates the - * correct position to use even if the element is relatively positioned to some - * other element. - * - * @param {number|!goog.math.Coordinate} arg1 Left position or coordinate. - * @param {number=} opt_arg2 Top position. - * @constructor - * @extends {goog.ui.Popup.AbsolutePosition} - * - * @deprecated Use {@link goog.positioning.ViewPortPosition} instead, this alias - * will be removed at the end of Q1 2009. - */ -goog.ui.Popup.ViewPortPosition = goog.positioning.ViewportPosition; - - - -/** - * Encapsulates a popup position where the popup is positioned relative to the - * window (client) coordinates. This calculates the correct position to - * use even if the element is relatively positioned to some other element. This - * is for trying to position an element at the spot of the mouse cursor in - * a MOUSEMOVE event. Just use the event.clientX and event.clientY as the - * parameters. - * - * @param {number|!goog.math.Coordinate} arg1 Left position or coordinate. - * @param {number=} opt_arg2 Top position. - * @constructor - * @extends {goog.ui.Popup.AbsolutePosition} - * - * @deprecated Use {@link goog.positioning.ClientPosition} instead, this alias - * will be removed at the end of Q1 2009. - */ -goog.ui.Popup.ClientPosition = goog.positioning.ClientPosition; - - - -/** - * Encapsulates a popup position where the popup is positioned relative to the - * window (client) coordinates, and made to stay within the viewport. - * - * @param {number|!goog.math.Coordinate} arg1 Left position or coordinate. - * @param {number=} opt_arg2 Top position if arg1 is a number representing the - * left position, ignored otherwise. - * @constructor - * @extends {goog.ui.Popup.ClientPosition} - * - * @deprecated Use {@link goog.positioning.ViewPortClientPosition} instead, this - * alias will be removed at the end of Q1 2009. - */ -goog.ui.Popup.ViewPortClientPosition = goog.positioning.ViewportClientPosition; |