Publish Vulpes Preview 15 sources for desktop, Android and Tundra

Share Gaia assets and adapters, keep private profiles and development documents local, and update both public READMEs.

gaia/shared/elements/gaia_grid/js/items/placeholder.js

@@ -0,0 +1,73 @@
+'use strict';
+/* global GaiaGrid */
+
+(function(exports) {
+
+  /**
+   * The placeholder represents an empty place on the grid.
+   * This is generally used to detect distance from an empty spot on the grid.
+   */
+  function Placeholder() {
+    this.detail = {
+      type: 'placeholder',
+      index: 0
+    };
+  }
+
+  Placeholder.prototype = {
+
+    __proto__: GaiaGrid.GridItem.prototype,
+
+    /**
+     * Returns the height in pixels of each icon.
+     */
+    get pixelHeight() {
+      return this.grid.layout.gridItemHeight;
+    },
+
+    /**
+     * When the placeholder is rendered in the last row, for group creation
+     * purposes, there is special handling required for height.
+     */
+    createsGroupOnDrop: false,
+
+    /**
+     * Width in grid units for each icon.
+     */
+    gridWidth: 1,
+
+    /**
+     * Placeholders do not save. They are re-generated on render calls.
+     */
+    persistToDB: false,
+
+    get name() {
+      return '';
+    },
+
+    /**
+     * Renders a transparent placeholder.
+     */
+    render: function() {
+      // Generate an element if we need to
+      if (!this.element) {
+        var tile = document.createElement('div');
+        tile.className = 'icon placeholder';
+        tile.style.height = this.pixelHeight + 'px';
+        this.element = tile;
+        this.grid.element.appendChild(tile);
+      }
+
+      this.transform(this.x, this.y, this.grid.layout.percent);
+    },
+
+    remove: function() {
+      if (this.element) {
+        this.element.parentNode.removeChild(this.element);
+      }
+    }
+  };
+
+  exports.GaiaGrid.Placeholder = Placeholder;
+
+}(window));