Update wmts-hidpi, add nicer-api-docs

nicer-api-docs/closure-library/closure/goog/positioning/menuanchoredposition.js

@@ -0,0 +1,71 @@
+// 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 Anchored viewport positioning class with both adjust and
+ *     resize options for the popup.
+ *
+ * @author eae@google.com (Emil A Eklund)
+ * @author tildahl@google.com (Michael Tildahl)
+ */
+
+goog.provide('goog.positioning.MenuAnchoredPosition');
+
+goog.require('goog.math.Box');
+goog.require('goog.math.Size');
+goog.require('goog.positioning');
+goog.require('goog.positioning.AnchoredViewportPosition');
+goog.require('goog.positioning.Corner');
+goog.require('goog.positioning.Overflow');
+
+
+
+/**
+ * Encapsulates a popup position where the popup is anchored at a corner of
+ * an element.  The positioning behavior changes based on the values of
+ * opt_adjust and opt_resize.
+ *
+ * When using this positioning object it's recommended that the movable element
+ * be absolutely positioned.
+ *
+ * @param {Element} anchorElement Element the movable element should be
+ *     anchored against.
+ * @param {goog.positioning.Corner} corner Corner of anchored element the
+ *     movable element should be positioned 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.
+ * @param {boolean=} opt_resize Whether the positioning should be adjusted until
+ *     the element fits inside the viewport on the X axis and its height is
+ *     resized so if fits in the viewport. This take precedence over opt_adjust.
+ * @constructor
+ * @extends {goog.positioning.AnchoredViewportPosition}
+ */
+goog.positioning.MenuAnchoredPosition = function(anchorElement,
+                                                 corner,
+                                                 opt_adjust,
+                                                 opt_resize) {
+  goog.positioning.AnchoredViewportPosition.call(this, anchorElement, corner,
+                                                 opt_adjust || opt_resize);
+
+  if (opt_adjust || opt_resize) {
+    var overflowX = goog.positioning.Overflow.ADJUST_X_EXCEPT_OFFSCREEN;
+    var overflowY = opt_resize ?
+        goog.positioning.Overflow.RESIZE_HEIGHT :
+        goog.positioning.Overflow.ADJUST_Y_EXCEPT_OFFSCREEN;
+    this.setLastResortOverflow(overflowX | overflowY);
+  }
+};
+goog.inherits(goog.positioning.MenuAnchoredPosition,
+              goog.positioning.AnchoredViewportPosition);