You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@chukwa.apache.org by ey...@apache.org on 2015/05/26 02:12:45 UTC
[10/19] chukwa git commit: CHUKWA-746. Redesigned Chukwa dashboard.
(Eric Yang)
http://git-wip-us.apache.org/repos/asf/chukwa/blob/dfe84a2c/src/main/web/hicc/home/js/jquery.gridster.with-extras.js
----------------------------------------------------------------------
diff --git a/src/main/web/hicc/home/js/jquery.gridster.with-extras.js b/src/main/web/hicc/home/js/jquery.gridster.with-extras.js
new file mode 100755
index 0000000..d8e8e1f
--- /dev/null
+++ b/src/main/web/hicc/home/js/jquery.gridster.with-extras.js
@@ -0,0 +1,4163 @@
+/*! gridster.js - v0.5.6 - 2014-09-25
+* http://gridster.net/
+* Copyright (c) 2014 ducksboard; Licensed MIT */
+
+;(function(root, factory) {
+
+ if (typeof define === 'function' && define.amd) {
+ define('gridster-coords', ['jquery'], factory);
+ } else {
+ root.GridsterCoords = factory(root.$ || root.jQuery);
+ }
+
+}(this, function($) {
+ /**
+ * Creates objects with coordinates (x1, y1, x2, y2, cx, cy, width, height)
+ * to simulate DOM elements on the screen.
+ * Coords is used by Gridster to create a faux grid with any DOM element can
+ * collide.
+ *
+ * @class Coords
+ * @param {HTMLElement|Object} obj The jQuery HTMLElement or a object with: left,
+ * top, width and height properties.
+ * @return {Object} Coords instance.
+ * @constructor
+ */
+ function Coords(obj) {
+ if (obj[0] && $.isPlainObject(obj[0])) {
+ this.data = obj[0];
+ }else {
+ this.el = obj;
+ }
+
+ this.isCoords = true;
+ this.coords = {};
+ this.init();
+ return this;
+ }
+
+
+ var fn = Coords.prototype;
+
+
+ fn.init = function(){
+ this.set();
+ this.original_coords = this.get();
+ };
+
+
+ fn.set = function(update, not_update_offsets) {
+ var el = this.el;
+
+ if (el && !update) {
+ this.data = el.offset();
+ this.data.width = el.width();
+ this.data.height = el.height();
+ }
+
+ if (el && update && !not_update_offsets) {
+ var offset = el.offset();
+ this.data.top = offset.top;
+ this.data.left = offset.left;
+ }
+
+ var d = this.data;
+
+ typeof d.left === 'undefined' && (d.left = d.x1);
+ typeof d.top === 'undefined' && (d.top = d.y1);
+
+ this.coords.x1 = d.left;
+ this.coords.y1 = d.top;
+ this.coords.x2 = d.left + d.width;
+ this.coords.y2 = d.top + d.height;
+ this.coords.cx = d.left + (d.width / 2);
+ this.coords.cy = d.top + (d.height / 2);
+ this.coords.width = d.width;
+ this.coords.height = d.height;
+ this.coords.el = el || false ;
+
+ return this;
+ };
+
+
+ fn.update = function(data){
+ if (!data && !this.el) {
+ return this;
+ }
+
+ if (data) {
+ var new_data = $.extend({}, this.data, data);
+ this.data = new_data;
+ return this.set(true, true);
+ }
+
+ this.set(true);
+ return this;
+ };
+
+
+ fn.get = function(){
+ return this.coords;
+ };
+
+ fn.destroy = function() {
+ this.el.removeData('coords');
+ delete this.el;
+ };
+
+ //jQuery adapter
+ $.fn.coords = function() {
+ if (this.data('coords') ) {
+ return this.data('coords');
+ }
+
+ var ins = new Coords(this, arguments[0]);
+ this.data('coords', ins);
+ return ins;
+ };
+
+ return Coords;
+
+}));
+
+;(function(root, factory) {
+
+ if (typeof define === 'function' && define.amd) {
+ define('gridster-collision', ['jquery', 'gridster-coords'], factory);
+ } else {
+ root.GridsterCollision = factory(root.$ || root.jQuery,
+ root.GridsterCoords);
+ }
+
+}(this, function($, Coords) {
+
+ var defaults = {
+ colliders_context: document.body,
+ overlapping_region: 'C'
+ // ,on_overlap: function(collider_data){},
+ // on_overlap_start : function(collider_data){},
+ // on_overlap_stop : function(collider_data){}
+ };
+
+
+ /**
+ * Detects collisions between a DOM element against other DOM elements or
+ * Coords objects.
+ *
+ * @class Collision
+ * @uses Coords
+ * @param {HTMLElement} el The jQuery wrapped HTMLElement.
+ * @param {HTMLElement|Array} colliders Can be a jQuery collection
+ * of HTMLElements or an Array of Coords instances.
+ * @param {Object} [options] An Object with all options you want to
+ * overwrite:
+ * @param {String} [options.overlapping_region] Determines when collision
+ * is valid, depending on the overlapped area. Values can be: 'N', 'S',
+ * 'W', 'E', 'C' or 'all'. Default is 'C'.
+ * @param {Function} [options.on_overlap_start] Executes a function the first
+ * time each `collider ` is overlapped.
+ * @param {Function} [options.on_overlap_stop] Executes a function when a
+ * `collider` is no longer collided.
+ * @param {Function} [options.on_overlap] Executes a function when the
+ * mouse is moved during the collision.
+ * @return {Object} Collision instance.
+ * @constructor
+ */
+ function Collision(el, colliders, options) {
+ this.options = $.extend(defaults, options);
+ this.$element = el;
+ this.last_colliders = [];
+ this.last_colliders_coords = [];
+ this.set_colliders(colliders);
+
+ this.init();
+ }
+
+ Collision.defaults = defaults;
+
+ var fn = Collision.prototype;
+
+
+ fn.init = function() {
+ this.find_collisions();
+ };
+
+
+ fn.overlaps = function(a, b) {
+ var x = false;
+ var y = false;
+
+ if ((b.x1 >= a.x1 && b.x1 <= a.x2) ||
+ (b.x2 >= a.x1 && b.x2 <= a.x2) ||
+ (a.x1 >= b.x1 && a.x2 <= b.x2)
+ ) { x = true; }
+
+ if ((b.y1 >= a.y1 && b.y1 <= a.y2) ||
+ (b.y2 >= a.y1 && b.y2 <= a.y2) ||
+ (a.y1 >= b.y1 && a.y2 <= b.y2)
+ ) { y = true; }
+
+ return (x && y);
+ };
+
+
+ fn.detect_overlapping_region = function(a, b){
+ var regionX = '';
+ var regionY = '';
+
+ if (a.y1 > b.cy && a.y1 < b.y2) { regionX = 'N'; }
+ if (a.y2 > b.y1 && a.y2 < b.cy) { regionX = 'S'; }
+ if (a.x1 > b.cx && a.x1 < b.x2) { regionY = 'W'; }
+ if (a.x2 > b.x1 && a.x2 < b.cx) { regionY = 'E'; }
+
+ return (regionX + regionY) || 'C';
+ };
+
+
+ fn.calculate_overlapped_area_coords = function(a, b){
+ var x1 = Math.max(a.x1, b.x1);
+ var y1 = Math.max(a.y1, b.y1);
+ var x2 = Math.min(a.x2, b.x2);
+ var y2 = Math.min(a.y2, b.y2);
+
+ return $({
+ left: x1,
+ top: y1,
+ width : (x2 - x1),
+ height: (y2 - y1)
+ }).coords().get();
+ };
+
+
+ fn.calculate_overlapped_area = function(coords){
+ return (coords.width * coords.height);
+ };
+
+
+ fn.manage_colliders_start_stop = function(new_colliders_coords, start_callback, stop_callback){
+ var last = this.last_colliders_coords;
+
+ for (var i = 0, il = last.length; i < il; i++) {
+ if ($.inArray(last[i], new_colliders_coords) === -1) {
+ start_callback.call(this, last[i]);
+ }
+ }
+
+ for (var j = 0, jl = new_colliders_coords.length; j < jl; j++) {
+ if ($.inArray(new_colliders_coords[j], last) === -1) {
+ stop_callback.call(this, new_colliders_coords[j]);
+ }
+
+ }
+ };
+
+
+ fn.find_collisions = function(player_data_coords){
+ var self = this;
+ var overlapping_region = this.options.overlapping_region;
+ var colliders_coords = [];
+ var colliders_data = [];
+ var $colliders = (this.colliders || this.$colliders);
+ var count = $colliders.length;
+ var player_coords = self.$element.coords()
+ .update(player_data_coords || false).get();
+
+ while(count--){
+ var $collider = self.$colliders ?
+ $($colliders[count]) : $colliders[count];
+ var $collider_coords_ins = ($collider.isCoords) ?
+ $collider : $collider.coords();
+ var collider_coords = $collider_coords_ins.get();
+ var overlaps = self.overlaps(player_coords, collider_coords);
+
+ if (!overlaps) {
+ continue;
+ }
+
+ var region = self.detect_overlapping_region(
+ player_coords, collider_coords);
+
+ //todo: make this an option
+ if (region === overlapping_region || overlapping_region === 'all') {
+
+ var area_coords = self.calculate_overlapped_area_coords(
+ player_coords, collider_coords);
+ var area = self.calculate_overlapped_area(area_coords);
+ var collider_data = {
+ area: area,
+ area_coords : area_coords,
+ region: region,
+ coords: collider_coords,
+ player_coords: player_coords,
+ el: $collider
+ };
+
+ if (self.options.on_overlap) {
+ self.options.on_overlap.call(this, collider_data);
+ }
+ colliders_coords.push($collider_coords_ins);
+ colliders_data.push(collider_data);
+ }
+ }
+
+ if (self.options.on_overlap_stop || self.options.on_overlap_start) {
+ this.manage_colliders_start_stop(colliders_coords,
+ self.options.on_overlap_start, self.options.on_overlap_stop);
+ }
+
+ this.last_colliders_coords = colliders_coords;
+
+ return colliders_data;
+ };
+
+
+ fn.get_closest_colliders = function(player_data_coords){
+ var colliders = this.find_collisions(player_data_coords);
+
+ colliders.sort(function(a, b) {
+ /* if colliders are being overlapped by the "C" (center) region,
+ * we have to set a lower index in the array to which they are placed
+ * above in the grid. */
+ if (a.region === 'C' && b.region === 'C') {
+ if (a.coords.y1 < b.coords.y1 || a.coords.x1 < b.coords.x1) {
+ return - 1;
+ }else{
+ return 1;
+ }
+ }
+
+ if (a.area < b.area) {
+ return 1;
+ }
+
+ return 1;
+ });
+ return colliders;
+ };
+
+
+ fn.set_colliders = function(colliders) {
+ if (typeof colliders === 'string' || colliders instanceof $) {
+ this.$colliders = $(colliders,
+ this.options.colliders_context).not(this.$element);
+ }else{
+ this.colliders = $(colliders);
+ }
+ };
+
+
+ //jQuery adapter
+ $.fn.collision = function(collider, options) {
+ return new Collision( this, collider, options );
+ };
+
+ return Collision;
+
+}));
+
+;(function(window, undefined) {
+
+ /* Delay, debounce and throttle functions taken from underscore.js
+ *
+ * Copyright (c) 2009-2013 Jeremy Ashkenas, DocumentCloud and
+ * Investigative Reporters & Editors
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+ window.delay = function(func, wait) {
+ var args = Array.prototype.slice.call(arguments, 2);
+ return setTimeout(function(){ return func.apply(null, args); }, wait);
+ };
+
+ window.debounce = function(func, wait, immediate) {
+ var timeout;
+ return function() {
+ var context = this, args = arguments;
+ var later = function() {
+ timeout = null;
+ if (!immediate) func.apply(context, args);
+ };
+ if (immediate && !timeout) func.apply(context, args);
+ clearTimeout(timeout);
+ timeout = setTimeout(later, wait);
+ };
+ };
+
+ window.throttle = function(func, wait) {
+ var context, args, timeout, throttling, more, result;
+ var whenDone = debounce(
+ function(){ more = throttling = false; }, wait);
+ return function() {
+ context = this; args = arguments;
+ var later = function() {
+ timeout = null;
+ if (more) func.apply(context, args);
+ whenDone();
+ };
+ if (!timeout) timeout = setTimeout(later, wait);
+ if (throttling) {
+ more = true;
+ } else {
+ result = func.apply(context, args);
+ }
+ whenDone();
+ throttling = true;
+ return result;
+ };
+ };
+
+})(window);
+
+;(function(root, factory) {
+
+ if (typeof define === 'function' && define.amd) {
+ define('gridster-draggable', ['jquery'], factory);
+ } else {
+ root.GridsterDraggable = factory(root.$ || root.jQuery);
+ }
+
+}(this, function($) {
+
+ var defaults = {
+ items: 'li',
+ distance: 1,
+ limit: true,
+ offset_left: 0,
+ autoscroll: true,
+ ignore_dragging: ['INPUT', 'TEXTAREA', 'SELECT', 'BUTTON'], // or function
+ handle: null,
+ container_width: 0, // 0 == auto
+ move_element: true,
+ helper: false, // or 'clone'
+ remove_helper: true
+ // drag: function(e) {},
+ // start : function(e, ui) {},
+ // stop : function(e) {}
+ };
+
+ var $window = $(window);
+ var dir_map = { x : 'left', y : 'top' };
+ var isTouch = !!('ontouchstart' in window);
+
+ var capitalize = function(str) {
+ return str.charAt(0).toUpperCase() + str.slice(1);
+ };
+
+ var idCounter = 0;
+ var uniqId = function() {
+ return ++idCounter + '';
+ }
+
+ /**
+ * Basic drag implementation for DOM elements inside a container.
+ * Provide start/stop/drag callbacks.
+ *
+ * @class Draggable
+ * @param {HTMLElement} el The HTMLelement that contains all the widgets
+ * to be dragged.
+ * @param {Object} [options] An Object with all options you want to
+ * overwrite:
+ * @param {HTMLElement|String} [options.items] Define who will
+ * be the draggable items. Can be a CSS Selector String or a
+ * collection of HTMLElements.
+ * @param {Number} [options.distance] Distance in pixels after mousedown
+ * the mouse must move before dragging should start.
+ * @param {Boolean} [options.limit] Constrains dragging to the width of
+ * the container
+ * @param {Object|Function} [options.ignore_dragging] Array of node names
+ * that sould not trigger dragging, by default is `['INPUT', 'TEXTAREA',
+ * 'SELECT', 'BUTTON']`. If a function is used return true to ignore dragging.
+ * @param {offset_left} [options.offset_left] Offset added to the item
+ * that is being dragged.
+ * @param {Number} [options.drag] Executes a callback when the mouse is
+ * moved during the dragging.
+ * @param {Number} [options.start] Executes a callback when the drag
+ * starts.
+ * @param {Number} [options.stop] Executes a callback when the drag stops.
+ * @return {Object} Returns `el`.
+ * @constructor
+ */
+ function Draggable(el, options) {
+ this.options = $.extend({}, defaults, options);
+ this.$document = $(document);
+ this.$container = $(el);
+ this.$dragitems = $(this.options.items, this.$container);
+ this.is_dragging = false;
+ this.player_min_left = 0 + this.options.offset_left;
+ this.id = uniqId();
+ this.ns = '.gridster-draggable-' + this.id;
+ this.init();
+ }
+
+ Draggable.defaults = defaults;
+
+ var fn = Draggable.prototype;
+
+ fn.init = function() {
+ var pos = this.$container.css('position');
+ this.calculate_dimensions();
+ this.$container.css('position', pos === 'static' ? 'relative' : pos);
+ this.disabled = false;
+ this.events();
+
+ $(window).bind(this.nsEvent('resize'),
+ throttle($.proxy(this.calculate_dimensions, this), 200));
+ };
+
+ fn.nsEvent = function(ev) {
+ return (ev || '') + this.ns;
+ };
+
+ fn.events = function() {
+ this.pointer_events = {
+ start: this.nsEvent('touchstart') + ' ' + this.nsEvent('mousedown'),
+ move: this.nsEvent('touchmove') + ' ' + this.nsEvent('mousemove'),
+ end: this.nsEvent('touchend') + ' ' + this.nsEvent('mouseup'),
+ };
+
+ this.$container.on(this.nsEvent('selectstart'),
+ $.proxy(this.on_select_start, this));
+
+ this.$container.on(this.pointer_events.start, this.options.items,
+ $.proxy(this.drag_handler, this));
+
+ this.$document.on(this.pointer_events.end, $.proxy(function(e) {
+ this.is_dragging = false;
+ if (this.disabled) { return; }
+ this.$document.off(this.pointer_events.move);
+ if (this.drag_start) {
+ this.on_dragstop(e);
+ }
+ }, this));
+ };
+
+ fn.get_actual_pos = function($el) {
+ var pos = $el.position();
+ return pos;
+ };
+
+
+ fn.get_mouse_pos = function(e) {
+ if (e.originalEvent && e.originalEvent.touches) {
+ var oe = e.originalEvent;
+ e = oe.touches.length ? oe.touches[0] : oe.changedTouches[0];
+ }
+
+ return {
+ left: e.clientX,
+ top: e.clientY
+ };
+ };
+
+
+ fn.get_offset = function(e) {
+ e.preventDefault();
+ var mouse_actual_pos = this.get_mouse_pos(e);
+ var diff_x = Math.round(
+ mouse_actual_pos.left - this.mouse_init_pos.left);
+ var diff_y = Math.round(mouse_actual_pos.top - this.mouse_init_pos.top);
+
+ var left = Math.round(this.el_init_offset.left +
+ diff_x - this.baseX + $(window).scrollLeft() - this.win_offset_x);
+ var top = Math.round(this.el_init_offset.top +
+ diff_y - this.baseY + $(window).scrollTop() - this.win_offset_y);
+
+ if (this.options.limit) {
+ if (left > this.player_max_left) {
+ left = this.player_max_left;
+ } else if(left < this.player_min_left) {
+ left = this.player_min_left;
+ }
+ }
+
+ return {
+ position: {
+ left: left,
+ top: top
+ },
+ pointer: {
+ left: mouse_actual_pos.left,
+ top: mouse_actual_pos.top,
+ diff_left: diff_x + ($(window).scrollLeft() - this.win_offset_x),
+ diff_top: diff_y + ($(window).scrollTop() - this.win_offset_y)
+ }
+ };
+ };
+
+
+ fn.get_drag_data = function(e) {
+ var offset = this.get_offset(e);
+ offset.$player = this.$player;
+ offset.$helper = this.helper ? this.$helper : this.$player;
+
+ return offset;
+ };
+
+
+ fn.set_limits = function(container_width) {
+ container_width || (container_width = this.$container.width());
+ this.player_max_left = (container_width - this.player_width +
+ - this.options.offset_left);
+
+ this.options.container_width = container_width;
+
+ return this;
+ };
+
+
+ fn.scroll_in = function(axis, data) {
+ var dir_prop = dir_map[axis];
+
+ var area_size = 50;
+ var scroll_inc = 30;
+
+ var is_x = axis === 'x';
+ var window_size = is_x ? this.window_width : this.window_height;
+ var doc_size = is_x ? $(document).width() : $(document).height();
+ var player_size = is_x ? this.$player.width() : this.$player.height();
+
+ var next_scroll;
+ var scroll_offset = $window['scroll' + capitalize(dir_prop)]();
+ var min_window_pos = scroll_offset;
+ var max_window_pos = min_window_pos + window_size;
+
+ var mouse_next_zone = max_window_pos - area_size; // down/right
+ var mouse_prev_zone = min_window_pos + area_size; // up/left
+
+ var abs_mouse_pos = min_window_pos + data.pointer[dir_prop];
+
+ var max_player_pos = (doc_size - window_size + player_size);
+
+ if (abs_mouse_pos >= mouse_next_zone) {
+ next_scroll = scroll_offset + scroll_inc;
+ if (next_scroll < max_player_pos) {
+ $window['scroll' + capitalize(dir_prop)](next_scroll);
+ this['scroll_offset_' + axis] += scroll_inc;
+ }
+ }
+
+ if (abs_mouse_pos <= mouse_prev_zone) {
+ next_scroll = scroll_offset - scroll_inc;
+ if (next_scroll > 0) {
+ $window['scroll' + capitalize(dir_prop)](next_scroll);
+ this['scroll_offset_' + axis] -= scroll_inc;
+ }
+ }
+
+ return this;
+ };
+
+
+ fn.manage_scroll = function(data) {
+ this.scroll_in('x', data);
+ this.scroll_in('y', data);
+ };
+
+
+ fn.calculate_dimensions = function(e) {
+ this.window_height = $window.height();
+ this.window_width = $window.width();
+ };
+
+
+ fn.drag_handler = function(e) {
+ var node = e.target.nodeName;
+ // skip if drag is disabled, or click was not done with the mouse primary button
+ if (this.disabled || e.which !== 1 && !isTouch) {
+ return;
+ }
+
+ if (this.ignore_drag(e)) {
+ return;
+ }
+
+ var self = this;
+ var first = true;
+ this.$player = $(e.currentTarget);
+
+ this.el_init_pos = this.get_actual_pos(this.$player);
+ this.mouse_init_pos = this.get_mouse_pos(e);
+ this.offsetY = this.mouse_init_pos.top - this.el_init_pos.top;
+
+ this.$document.on(this.pointer_events.move, function(mme) {
+ var mouse_actual_pos = self.get_mouse_pos(mme);
+ var diff_x = Math.abs(
+ mouse_actual_pos.left - self.mouse_init_pos.left);
+ var diff_y = Math.abs(
+ mouse_actual_pos.top - self.mouse_init_pos.top);
+ if (!(diff_x > self.options.distance ||
+ diff_y > self.options.distance)
+ ) {
+ return false;
+ }
+
+ if (first) {
+ first = false;
+ self.on_dragstart.call(self, mme);
+ return false;
+ }
+
+ if (self.is_dragging === true) {
+ self.on_dragmove.call(self, mme);
+ }
+
+ return false;
+ });
+
+ if (!isTouch) { return false; }
+ };
+
+
+ fn.on_dragstart = function(e) {
+ e.preventDefault();
+
+ if (this.is_dragging) { return this; }
+
+ this.drag_start = this.is_dragging = true;
+ var offset = this.$container.offset();
+ this.baseX = Math.round(offset.left);
+ this.baseY = Math.round(offset.top);
+ this.initial_container_width = this.options.container_width || this.$container.width();
+
+ if (this.options.helper === 'clone') {
+ this.$helper = this.$player.clone()
+ .appendTo(this.$container).addClass('helper');
+ this.helper = true;
+ } else {
+ this.helper = false;
+ }
+
+ this.win_offset_y = $(window).scrollTop();
+ this.win_offset_x = $(window).scrollLeft();
+ this.scroll_offset_y = 0;
+ this.scroll_offset_x = 0;
+ this.el_init_offset = this.$player.offset();
+ this.player_width = this.$player.width();
+ this.player_height = this.$player.height();
+
+ this.set_limits(this.options.container_width);
+
+ if (this.options.start) {
+ this.options.start.call(this.$player, e, this.get_drag_data(e));
+ }
+ return false;
+ };
+
+
+ fn.on_dragmove = function(e) {
+ var data = this.get_drag_data(e);
+
+ this.options.autoscroll && this.manage_scroll(data);
+
+ if (this.options.move_element) {
+ (this.helper ? this.$helper : this.$player).css({
+ 'position': 'absolute',
+ 'left' : data.position.left,
+ 'top' : data.position.top
+ });
+ }
+
+ var last_position = this.last_position || data.position;
+ data.prev_position = last_position;
+
+ if (this.options.drag) {
+ this.options.drag.call(this.$player, e, data);
+ }
+
+ this.last_position = data.position;
+ return false;
+ };
+
+
+ fn.on_dragstop = function(e) {
+ var data = this.get_drag_data(e);
+ this.drag_start = false;
+
+ if (this.options.stop) {
+ this.options.stop.call(this.$player, e, data);
+ }
+
+ if (this.helper && this.options.remove_helper) {
+ this.$helper.remove();
+ }
+
+ return false;
+ };
+
+ fn.on_select_start = function(e) {
+ if (this.disabled) { return; }
+
+ if (this.ignore_drag(e)) {
+ return;
+ }
+
+ return false;
+ };
+
+ fn.enable = function() {
+ this.disabled = false;
+ };
+
+ fn.disable = function() {
+ this.disabled = true;
+ };
+
+ fn.destroy = function() {
+ this.disable();
+
+ this.$container.off(this.ns);
+ this.$document.off(this.ns);
+ $(window).off(this.ns);
+
+ $.removeData(this.$container, 'drag');
+ };
+
+ fn.ignore_drag = function(event) {
+ if (this.options.handle) {
+ return !$(event.target).is(this.options.handle);
+ }
+
+ if ($.isFunction(this.options.ignore_dragging)) {
+ return this.options.ignore_dragging(event);
+ }
+
+ return $(event.target).is(this.options.ignore_dragging.join(', '));
+ };
+
+ //jQuery adapter
+ $.fn.drag = function ( options ) {
+ return new Draggable(this, options);
+ };
+
+ return Draggable;
+
+}));
+
+;(function(root, factory) {
+
+ if (typeof define === 'function' && define.amd) {
+ define(['jquery', 'gridster-draggable', 'gridster-collision'], factory);
+ } else {
+ root.Gridster = factory(root.$ || root.jQuery, root.GridsterDraggable,
+ root.GridsterCollision);
+ }
+
+ }(this, function($, Draggable, Collision) {
+
+ var defaults = {
+ namespace: '',
+ widget_selector: 'li',
+ widget_margins: [10, 10],
+ widget_base_dimensions: [400, 225],
+ extra_rows: 0,
+ extra_cols: 0,
+ min_cols: 1,
+ max_cols: Infinity,
+ min_rows: 15,
+ max_size_x: false,
+ autogrow_cols: false,
+ autogenerate_stylesheet: true,
+ avoid_overlapped_widgets: true,
+ auto_init: true,
+ serialize_params: function($w, wgd) {
+ return {
+ col: wgd.col,
+ row: wgd.row,
+ size_x: wgd.size_x,
+ size_y: wgd.size_y
+ };
+ },
+ collision: {},
+ draggable: {
+ items: '.gs-w',
+ distance: 4,
+ ignore_dragging: Draggable.defaults.ignore_dragging.slice(0)
+ },
+ resize: {
+ enabled: false,
+ axes: ['both'],
+ handle_append_to: '',
+ handle_class: 'gs-resize-handle',
+ max_size: [Infinity, Infinity],
+ min_size: [1, 1]
+ }
+ };
+
+ /**
+ * @class Gridster
+ * @uses Draggable
+ * @uses Collision
+ * @param {HTMLElement} el The HTMLelement that contains all the widgets.
+ * @param {Object} [options] An Object with all options you want to
+ * overwrite:
+ * @param {HTMLElement|String} [options.widget_selector] Define who will
+ * be the draggable widgets. Can be a CSS Selector String or a
+ * collection of HTMLElements
+ * @param {Array} [options.widget_margins] Margin between widgets.
+ * The first index for the horizontal margin (left, right) and
+ * the second for the vertical margin (top, bottom).
+ * @param {Array} [options.widget_base_dimensions] Base widget dimensions
+ * in pixels. The first index for the width and the second for the
+ * height.
+ * @param {Number} [options.extra_cols] Add more columns in addition to
+ * those that have been calculated.
+ * @param {Number} [options.extra_rows] Add more rows in addition to
+ * those that have been calculated.
+ * @param {Number} [options.min_cols] The minimum required columns.
+ * @param {Number} [options.max_cols] The maximum columns possible (set to null
+ * for no maximum).
+ * @param {Number} [options.min_rows] The minimum required rows.
+ * @param {Number} [options.max_size_x] The maximum number of columns
+ * that a widget can span.
+ * @param {Boolean} [options.autogenerate_stylesheet] If true, all the
+ * CSS required to position all widgets in their respective columns
+ * and rows will be generated automatically and injected to the
+ * `<head>` of the document. You can set this to false, and write
+ * your own CSS targeting rows and cols via data-attributes like so:
+ * `[data-col="1"] { left: 10px; }`
+ * @param {Boolean} [options.avoid_overlapped_widgets] Avoid that widgets loaded
+ * from the DOM can be overlapped. It is helpful if the positions were
+ * bad stored in the database or if there was any conflict.
+ * @param {Boolean} [options.auto_init] Automatically call gridster init
+ * method or not when the plugin is instantiated.
+ * @param {Function} [options.serialize_params] Return the data you want
+ * for each widget in the serialization. Two arguments are passed:
+ * `$w`: the jQuery wrapped HTMLElement, and `wgd`: the grid
+ * coords object (`col`, `row`, `size_x`, `size_y`).
+ * @param {Object} [options.collision] An Object with all options for
+ * Collision class you want to overwrite. See Collision docs for
+ * more info.
+ * @param {Object} [options.draggable] An Object with all options for
+ * Draggable class you want to overwrite. See Draggable docs for more
+ * info.
+ * @param {Object|Function} [options.draggable.ignore_dragging] Note that
+ * if you use a Function, and resize is enabled, you should ignore the
+ * resize handlers manually (options.resize.handle_class).
+ * @param {Object} [options.resize] An Object with resize config options.
+ * @param {Boolean} [options.resize.enabled] Set to true to enable
+ * resizing.
+ * @param {Array} [options.resize.axes] Axes in which widgets can be
+ * resized. Possible values: ['x', 'y', 'both'].
+ * @param {String} [options.resize.handle_append_to] Set a valid CSS
+ * selector to append resize handles to.
+ * @param {String} [options.resize.handle_class] CSS class name used
+ * by resize handles.
+ * @param {Array} [options.resize.max_size] Limit widget dimensions
+ * when resizing. Array values should be integers:
+ * `[max_cols_occupied, max_rows_occupied]`
+ * @param {Array} [options.resize.min_size] Limit widget dimensions
+ * when resizing. Array values should be integers:
+ * `[min_cols_occupied, min_rows_occupied]`
+ * @param {Function} [options.resize.start] Function executed
+ * when resizing starts.
+ * @param {Function} [otions.resize.resize] Function executed
+ * during the resizing.
+ * @param {Function} [options.resize.stop] Function executed
+ * when resizing stops.
+ *
+ * @constructor
+ */
+ function Gridster(el, options) {
+ this.options = $.extend(true, {}, defaults, options);
+ this.$el = $(el);
+ this.$wrapper = this.$el.parent();
+ this.$widgets = this.$el.children(
+ this.options.widget_selector).addClass('gs-w');
+ this.widgets = [];
+ this.$changed = $([]);
+ this.wrapper_width = this.$wrapper.width();
+ this.min_widget_width = (this.options.widget_margins[0] * 2) +
+ this.options.widget_base_dimensions[0];
+ this.min_widget_height = (this.options.widget_margins[1] * 2) +
+ this.options.widget_base_dimensions[1];
+
+ this.generated_stylesheets = [];
+ this.$style_tags = $([]);
+
+ this.options.auto_init && this.init();
+ }
+
+ Gridster.defaults = defaults;
+ Gridster.generated_stylesheets = [];
+
+
+ /**
+ * Sorts an Array of grid coords objects (representing the grid coords of
+ * each widget) in ascending way.
+ *
+ * @method sort_by_row_asc
+ * @param {Array} widgets Array of grid coords objects
+ * @return {Array} Returns the array sorted.
+ */
+ Gridster.sort_by_row_asc = function(widgets) {
+ widgets = widgets.sort(function(a, b) {
+ if (!a.row) {
+ a = $(a).coords().grid;
+ b = $(b).coords().grid;
+ }
+
+ if (a.row > b.row) {
+ return 1;
+ }
+ return -1;
+ });
+
+ return widgets;
+ };
+
+
+ /**
+ * Sorts an Array of grid coords objects (representing the grid coords of
+ * each widget) placing first the empty cells upper left.
+ *
+ * @method sort_by_row_and_col_asc
+ * @param {Array} widgets Array of grid coords objects
+ * @return {Array} Returns the array sorted.
+ */
+ Gridster.sort_by_row_and_col_asc = function(widgets) {
+ widgets = widgets.sort(function(a, b) {
+ if (a.row > b.row || a.row === b.row && a.col > b.col) {
+ return 1;
+ }
+ return -1;
+ });
+
+ return widgets;
+ };
+
+
+ /**
+ * Sorts an Array of grid coords objects by column (representing the grid
+ * coords of each widget) in ascending way.
+ *
+ * @method sort_by_col_asc
+ * @param {Array} widgets Array of grid coords objects
+ * @return {Array} Returns the array sorted.
+ */
+ Gridster.sort_by_col_asc = function(widgets) {
+ widgets = widgets.sort(function(a, b) {
+ if (a.col > b.col) {
+ return 1;
+ }
+ return -1;
+ });
+
+ return widgets;
+ };
+
+
+ /**
+ * Sorts an Array of grid coords objects (representing the grid coords of
+ * each widget) in descending way.
+ *
+ * @method sort_by_row_desc
+ * @param {Array} widgets Array of grid coords objects
+ * @return {Array} Returns the array sorted.
+ */
+ Gridster.sort_by_row_desc = function(widgets) {
+ widgets = widgets.sort(function(a, b) {
+ if (a.row + a.size_y < b.row + b.size_y) {
+ return 1;
+ }
+ return -1;
+ });
+ return widgets;
+ };
+
+
+
+ /** Instance Methods **/
+
+ var fn = Gridster.prototype;
+
+ fn.init = function() {
+ this.options.resize.enabled && this.setup_resize();
+ this.generate_grid_and_stylesheet();
+ this.get_widgets_from_DOM();
+ this.set_dom_grid_height();
+ this.set_dom_grid_width();
+ this.$wrapper.addClass('ready');
+ this.draggable();
+ this.options.resize.enabled && this.resizable();
+
+ $(window).bind('resize.gridster', throttle(
+ $.proxy(this.recalculate_faux_grid, this), 200));
+ };
+
+
+ /**
+ * Disables dragging.
+ *
+ * @method disable
+ * @return {Class} Returns the instance of the Gridster Class.
+ */
+ fn.disable = function() {
+ this.$wrapper.find('.player-revert').removeClass('player-revert');
+ this.drag_api.disable();
+ return this;
+ };
+
+
+ /**
+ * Enables dragging.
+ *
+ * @method enable
+ * @return {Class} Returns the instance of the Gridster Class.
+ */
+ fn.enable = function() {
+ this.drag_api.enable();
+ return this;
+ };
+
+
+
+ /**
+ * Disables drag-and-drop widget resizing.
+ *
+ * @method disable
+ * @return {Class} Returns instance of gridster Class.
+ */
+ fn.disable_resize = function() {
+ this.$el.addClass('gs-resize-disabled');
+ this.resize_api.disable();
+ return this;
+ };
+
+
+ /**
+ * Enables drag-and-drop widget resizing.
+ *
+ * @method enable
+ * @return {Class} Returns instance of gridster Class.
+ */
+ fn.enable_resize = function() {
+ this.$el.removeClass('gs-resize-disabled');
+ this.resize_api.enable();
+ return this;
+ };
+
+
+ /**
+ * Add a new widget to the grid.
+ *
+ * @method add_widget
+ * @param {String|HTMLElement} html The string representing the HTML of the widget
+ * or the HTMLElement.
+ * @param {Number} [size_x] The nº of rows the widget occupies horizontally.
+ * @param {Number} [size_y] The nº of columns the widget occupies vertically.
+ * @param {Number} [col] The column the widget should start in.
+ * @param {Number} [row] The row the widget should start in.
+ * @param {Array} [max_size] max_size Maximun size (in units) for width and height.
+ * @param {Array} [min_size] min_size Minimum size (in units) for width and height.
+ * @return {HTMLElement} Returns the jQuery wrapped HTMLElement representing.
+ * the widget that was just created.
+ */
+ fn.add_widget = function(html, size_x, size_y, col, row, max_size, min_size) {
+ var pos;
+ size_x || (size_x = 1);
+ size_y || (size_y = 1);
+
+ if (!col & !row) {
+ pos = this.next_position(size_x, size_y);
+ } else {
+ pos = {
+ col: col,
+ row: row,
+ size_x: size_x,
+ size_y: size_y
+ };
+
+ this.empty_cells(col, row, size_x, size_y);
+ }
+
+ var $w = $(html).attr({
+ 'data-col': pos.col,
+ 'data-row': pos.row,
+ 'data-sizex' : size_x,
+ 'data-sizey' : size_y
+ }).addClass('gs-w').appendTo(this.$el).hide();
+
+ this.$widgets = this.$widgets.add($w);
+
+ this.register_widget($w);
+
+ this.add_faux_rows(pos.size_y);
+ //this.add_faux_cols(pos.size_x);
+
+ if (max_size) {
+ this.set_widget_max_size($w, max_size);
+ }
+
+ if (min_size) {
+ this.set_widget_min_size($w, min_size);
+ }
+
+ this.set_dom_grid_width();
+ this.set_dom_grid_height();
+
+ this.drag_api.set_limits(this.cols * this.min_widget_width);
+
+ return $w.fadeIn();
+ };
+
+
+ /**
+ * Change widget size limits.
+ *
+ * @method set_widget_min_size
+ * @param {HTMLElement|Number} $widget The jQuery wrapped HTMLElement
+ * representing the widget or an index representing the desired widget.
+ * @param {Array} min_size Minimum size (in units) for width and height.
+ * @return {HTMLElement} Returns instance of gridster Class.
+ */
+ fn.set_widget_min_size = function($widget, min_size) {
+ $widget = typeof $widget === 'number' ?
+ this.$widgets.eq($widget) : $widget;
+
+ if (!$widget.length) { return this; }
+
+ var wgd = $widget.data('coords').grid;
+ wgd.min_size_x = min_size[0];
+ wgd.min_size_y = min_size[1];
+
+ return this;
+ };
+
+
+ /**
+ * Change widget size limits.
+ *
+ * @method set_widget_max_size
+ * @param {HTMLElement|Number} $widget The jQuery wrapped HTMLElement
+ * representing the widget or an index representing the desired widget.
+ * @param {Array} max_size Maximun size (in units) for width and height.
+ * @return {HTMLElement} Returns instance of gridster Class.
+ */
+ fn.set_widget_max_size = function($widget, max_size) {
+ $widget = typeof $widget === 'number' ?
+ this.$widgets.eq($widget) : $widget;
+
+ if (!$widget.length) { return this; }
+
+ var wgd = $widget.data('coords').grid;
+ wgd.max_size_x = max_size[0];
+ wgd.max_size_y = max_size[1];
+
+ return this;
+ };
+
+
+ /**
+ * Append the resize handle into a widget.
+ *
+ * @method add_resize_handle
+ * @param {HTMLElement} $widget The jQuery wrapped HTMLElement
+ * representing the widget.
+ * @return {HTMLElement} Returns instance of gridster Class.
+ */
+ fn.add_resize_handle = function($w) {
+ var append_to = this.options.resize.handle_append_to;
+ $(this.resize_handle_tpl).appendTo( append_to ? $(append_to, $w) : $w);
+
+ return this;
+ };
+
+
+ /**
+ * Change the size of a widget. Width is limited to the current grid width.
+ *
+ * @method resize_widget
+ * @param {HTMLElement} $widget The jQuery wrapped HTMLElement
+ * representing the widget.
+ * @param {Number} size_x The number of columns that will occupy the widget.
+ * By default <code>size_x</code> is limited to the space available from
+ * the column where the widget begins, until the last column to the right.
+ * @param {Number} size_y The number of rows that will occupy the widget.
+ * @param {Function} [callback] Function executed when the widget is removed.
+ * @return {HTMLElement} Returns $widget.
+ */
+ fn.resize_widget = function($widget, size_x, size_y, callback) {
+ var wgd = $widget.coords().grid;
+ var col = wgd.col;
+ var max_cols = this.options.max_cols;
+ var old_size_y = wgd.size_y;
+ var old_col = wgd.col;
+ var new_col = old_col;
+
+ size_x || (size_x = wgd.size_x);
+ size_y || (size_y = wgd.size_y);
+
+ if (max_cols !== Infinity) {
+ size_x = Math.min(size_x, max_cols - col + 1);
+ }
+
+ if (size_y > old_size_y) {
+ this.add_faux_rows(Math.max(size_y - old_size_y, 0));
+ }
+
+ var player_rcol = (col + size_x - 1);
+ if (player_rcol > this.cols) {
+ this.add_faux_cols(player_rcol - this.cols);
+ }
+
+ var new_grid_data = {
+ col: new_col,
+ row: wgd.row,
+ size_x: size_x,
+ size_y: size_y
+ };
+
+ this.mutate_widget_in_gridmap($widget, wgd, new_grid_data);
+
+ this.set_dom_grid_height();
+ this.set_dom_grid_width();
+
+ if (callback) {
+ callback.call(this, new_grid_data.size_x, new_grid_data.size_y);
+ }
+
+ return $widget;
+ };
+
+
+ /**
+ * Mutate widget dimensions and position in the grid map.
+ *
+ * @method mutate_widget_in_gridmap
+ * @param {HTMLElement} $widget The jQuery wrapped HTMLElement
+ * representing the widget to mutate.
+ * @param {Object} wgd Current widget grid data (col, row, size_x, size_y).
+ * @param {Object} new_wgd New widget grid data.
+ * @return {HTMLElement} Returns instance of gridster Class.
+ */
+ fn.mutate_widget_in_gridmap = function($widget, wgd, new_wgd) {
+ var old_size_x = wgd.size_x;
+ var old_size_y = wgd.size_y;
+
+ var old_cells_occupied = this.get_cells_occupied(wgd);
+ var new_cells_occupied = this.get_cells_occupied(new_wgd);
+
+ var empty_cols = [];
+ $.each(old_cells_occupied.cols, function(i, col) {
+ if ($.inArray(col, new_cells_occupied.cols) === -1) {
+ empty_cols.push(col);
+ }
+ });
+
+ var occupied_cols = [];
+ $.each(new_cells_occupied.cols, function(i, col) {
+ if ($.inArray(col, old_cells_occupied.cols) === -1) {
+ occupied_cols.push(col);
+ }
+ });
+
+ var empty_rows = [];
+ $.each(old_cells_occupied.rows, function(i, row) {
+ if ($.inArray(row, new_cells_occupied.rows) === -1) {
+ empty_rows.push(row);
+ }
+ });
+
+ var occupied_rows = [];
+ $.each(new_cells_occupied.rows, function(i, row) {
+ if ($.inArray(row, old_cells_occupied.rows) === -1) {
+ occupied_rows.push(row);
+ }
+ });
+
+ this.remove_from_gridmap(wgd);
+
+ if (occupied_cols.length) {
+ var cols_to_empty = [
+ new_wgd.col, new_wgd.row, new_wgd.size_x, Math.min(old_size_y, new_wgd.size_y), $widget
+ ];
+ this.empty_cells.apply(this, cols_to_empty);
+ }
+
+ if (occupied_rows.length) {
+ var rows_to_empty = [new_wgd.col, new_wgd.row, new_wgd.size_x, new_wgd.size_y, $widget];
+ this.empty_cells.apply(this, rows_to_empty);
+ }
+
+ // not the same that wgd = new_wgd;
+ wgd.col = new_wgd.col;
+ wgd.row = new_wgd.row;
+ wgd.size_x = new_wgd.size_x;
+ wgd.size_y = new_wgd.size_y;
+
+ this.add_to_gridmap(new_wgd, $widget);
+
+ $widget.removeClass('player-revert');
+
+ //update coords instance attributes
+ $widget.data('coords').update({
+ width: (new_wgd.size_x * this.options.widget_base_dimensions[0] +
+ ((new_wgd.size_x - 1) * this.options.widget_margins[0]) * 2),
+ height: (new_wgd.size_y * this.options.widget_base_dimensions[1] +
+ ((new_wgd.size_y - 1) * this.options.widget_margins[1]) * 2)
+ });
+
+ $widget.attr({
+ 'data-col': new_wgd.col,
+ 'data-row': new_wgd.row,
+ 'data-sizex': new_wgd.size_x,
+ 'data-sizey': new_wgd.size_y
+ });
+
+ if (empty_cols.length) {
+ var cols_to_remove_holes = [
+ empty_cols[0], new_wgd.row,
+ empty_cols.length,
+ Math.min(old_size_y, new_wgd.size_y),
+ $widget
+ ];
+
+ this.remove_empty_cells.apply(this, cols_to_remove_holes);
+ }
+
+ if (empty_rows.length) {
+ var rows_to_remove_holes = [
+ new_wgd.col, new_wgd.row, new_wgd.size_x, new_wgd.size_y, $widget
+ ];
+ this.remove_empty_cells.apply(this, rows_to_remove_holes);
+ }
+
+ this.move_widget_up($widget);
+
+ return this;
+ };
+
+
+ /**
+ * Move down widgets in cells represented by the arguments col, row, size_x,
+ * size_y
+ *
+ * @method empty_cells
+ * @param {Number} col The column where the group of cells begin.
+ * @param {Number} row The row where the group of cells begin.
+ * @param {Number} size_x The number of columns that the group of cells
+ * occupy.
+ * @param {Number} size_y The number of rows that the group of cells
+ * occupy.
+ * @param {HTMLElement} $exclude Exclude widgets from being moved.
+ * @return {Class} Returns the instance of the Gridster Class.
+ */
+ fn.empty_cells = function(col, row, size_x, size_y, $exclude) {
+ var $nexts = this.widgets_below({
+ col: col,
+ row: row - size_y,
+ size_x: size_x,
+ size_y: size_y
+ });
+
+ $nexts.not($exclude).each($.proxy(function(i, w) {
+ var wgd = $(w).coords().grid;
+ if ( !(wgd.row <= (row + size_y - 1))) { return; }
+ var diff = (row + size_y) - wgd.row;
+ this.move_widget_down($(w), diff);
+ }, this));
+
+ this.set_dom_grid_height();
+
+ return this;
+ };
+
+
+ /**
+ * Move up widgets below cells represented by the arguments col, row, size_x,
+ * size_y.
+ *
+ * @method remove_empty_cells
+ * @param {Number} col The column where the group of cells begin.
+ * @param {Number} row The row where the group of cells begin.
+ * @param {Number} size_x The number of columns that the group of cells
+ * occupy.
+ * @param {Number} size_y The number of rows that the group of cells
+ * occupy.
+ * @param {HTMLElement} exclude Exclude widgets from being moved.
+ * @return {Class} Returns the instance of the Gridster Class.
+ */
+ fn.remove_empty_cells = function(col, row, size_x, size_y, exclude) {
+ var $nexts = this.widgets_below({
+ col: col,
+ row: row,
+ size_x: size_x,
+ size_y: size_y
+ });
+
+ $nexts.not(exclude).each($.proxy(function(i, widget) {
+ this.move_widget_up( $(widget), size_y );
+ }, this));
+
+ this.set_dom_grid_height();
+
+ return this;
+ };
+
+
+ /**
+ * Get the most left column below to add a new widget.
+ *
+ * @method next_position
+ * @param {Number} size_x The nº of rows the widget occupies horizontally.
+ * @param {Number} size_y The nº of columns the widget occupies vertically.
+ * @return {Object} Returns a grid coords object representing the future
+ * widget coords.
+ */
+ fn.next_position = function(size_x, size_y) {
+ size_x || (size_x = 1);
+ size_y || (size_y = 1);
+ var ga = this.gridmap;
+ var cols_l = ga.length;
+ var valid_pos = [];
+ var rows_l;
+
+ for (var c = 1; c < cols_l; c++) {
+ rows_l = ga[c].length;
+ for (var r = 1; r <= rows_l; r++) {
+ var can_move_to = this.can_move_to({
+ size_x: size_x,
+ size_y: size_y
+ }, c, r);
+
+ if (can_move_to) {
+ valid_pos.push({
+ col: c,
+ row: r,
+ size_y: size_y,
+ size_x: size_x
+ });
+ }
+ }
+ }
+
+ if (valid_pos.length) {
+ return Gridster.sort_by_row_and_col_asc(valid_pos)[0];
+ }
+ return false;
+ };
+
+
+ /**
+ * Remove a widget from the grid.
+ *
+ * @method remove_widget
+ * @param {HTMLElement} el The jQuery wrapped HTMLElement you want to remove.
+ * @param {Boolean|Function} silent If true, widgets below the removed one
+ * will not move up. If a Function is passed it will be used as callback.
+ * @param {Function} callback Function executed when the widget is removed.
+ * @return {Class} Returns the instance of the Gridster Class.
+ */
+ fn.remove_widget = function(el, silent, callback) {
+ var $el = el instanceof $ ? el : $(el);
+ var wgd = $el.coords().grid;
+
+ // if silent is a function assume it's a callback
+ if ($.isFunction(silent)) {
+ callback = silent;
+ silent = false;
+ }
+
+ this.cells_occupied_by_placeholder = {};
+ this.$widgets = this.$widgets.not($el);
+
+ var $nexts = this.widgets_below($el);
+
+ this.remove_from_gridmap(wgd);
+
+ $el.fadeOut($.proxy(function() {
+ $el.remove();
+
+ if (!silent) {
+ $nexts.each($.proxy(function(i, widget) {
+ this.move_widget_up( $(widget), wgd.size_y );
+ }, this));
+ }
+
+ this.set_dom_grid_height();
+
+ if (callback) {
+ callback.call(this, el);
+ }
+ }, this));
+
+ return this;
+ };
+
+
+ /**
+ * Remove all widgets from the grid.
+ *
+ * @method remove_all_widgets
+ * @param {Function} callback Function executed for each widget removed.
+ * @return {Class} Returns the instance of the Gridster Class.
+ */
+ fn.remove_all_widgets = function(callback) {
+ this.$widgets.each($.proxy(function(i, el){
+ this.remove_widget(el, true, callback);
+ }, this));
+
+ return this;
+ };
+
+
+ /**
+ * Returns a serialized array of the widgets in the grid.
+ *
+ * @method serialize
+ * @param {HTMLElement} [$widgets] The collection of jQuery wrapped
+ * HTMLElements you want to serialize. If no argument is passed all widgets
+ * will be serialized.
+ * @return {Array} Returns an Array of Objects with the data specified in
+ * the serialize_params option.
+ */
+ fn.serialize = function($widgets) {
+ $widgets || ($widgets = this.$widgets);
+
+ return $widgets.map($.proxy(function(i, widget) {
+ var $w = $(widget);
+ return this.options.serialize_params($w, $w.coords().grid);
+ }, this)).get();
+ };
+
+
+ /**
+ * Returns a serialized array of the widgets that have changed their
+ * position.
+ *
+ * @method serialize_changed
+ * @return {Array} Returns an Array of Objects with the data specified in
+ * the serialize_params option.
+ */
+ fn.serialize_changed = function() {
+ return this.serialize(this.$changed);
+ };
+
+
+ /**
+ * Convert widgets from DOM elements to "widget grid data" Objects.
+ *
+ * @method dom_to_coords
+ * @param {HTMLElement} $widget The widget to be converted.
+ */
+ fn.dom_to_coords = function($widget) {
+ return {
+ 'col': parseInt($widget.attr('data-col'), 10),
+ 'row': parseInt($widget.attr('data-row'), 10),
+ 'size_x': parseInt($widget.attr('data-sizex'), 10) || 1,
+ 'size_y': parseInt($widget.attr('data-sizey'), 10) || 1,
+ 'max_size_x': parseInt($widget.attr('data-max-sizex'), 10) || false,
+ 'max_size_y': parseInt($widget.attr('data-max-sizey'), 10) || false,
+ 'min_size_x': parseInt($widget.attr('data-min-sizex'), 10) || false,
+ 'min_size_y': parseInt($widget.attr('data-min-sizey'), 10) || false,
+ 'el': $widget
+ };
+ };
+
+
+ /**
+ * Creates the grid coords object representing the widget an add it to the
+ * mapped array of positions.
+ *
+ * @method register_widget
+ * @param {HTMLElement|Object} $el jQuery wrapped HTMLElement representing
+ * the widget, or an "widget grid data" Object with (col, row, el ...).
+ * @return {Boolean} Returns true if the widget final position is different
+ * than the original.
+ */
+ fn.register_widget = function($el) {
+ var isDOM = $el instanceof jQuery;
+ var wgd = isDOM ? this.dom_to_coords($el) : $el;
+ var posChanged = false;
+ isDOM || ($el = wgd.el);
+
+ var empty_upper_row = this.can_go_widget_up(wgd);
+ if (empty_upper_row) {
+ wgd.row = empty_upper_row;
+ $el.attr('data-row', empty_upper_row);
+ this.$el.trigger('gridster:positionchanged', [wgd]);
+ posChanged = true;
+ }
+
+ if (this.options.avoid_overlapped_widgets &&
+ !this.can_move_to(
+ {size_x: wgd.size_x, size_y: wgd.size_y}, wgd.col, wgd.row)
+ ) {
+ $.extend(wgd, this.next_position(wgd.size_x, wgd.size_y));
+ $el.attr({
+ 'data-col': wgd.col,
+ 'data-row': wgd.row,
+ 'data-sizex': wgd.size_x,
+ 'data-sizey': wgd.size_y
+ });
+ posChanged = true;
+ }
+
+ // attach Coord object to player data-coord attribute
+ $el.data('coords', $el.coords());
+ // Extend Coord object with grid position info
+ $el.data('coords').grid = wgd;
+
+ this.add_to_gridmap(wgd, $el);
+
+ this.options.resize.enabled && this.add_resize_handle($el);
+
+ return posChanged;
+ };
+
+
+ /**
+ * Update in the mapped array of positions the value of cells represented by
+ * the grid coords object passed in the `grid_data` param.
+ *
+ * @param {Object} grid_data The grid coords object representing the cells
+ * to update in the mapped array.
+ * @param {HTMLElement|Boolean} value Pass `false` or the jQuery wrapped
+ * HTMLElement, depends if you want to delete an existing position or add
+ * a new one.
+ * @method update_widget_position
+ * @return {Class} Returns the instance of the Gridster Class.
+ */
+ fn.update_widget_position = function(grid_data, value) {
+ this.for_each_cell_occupied(grid_data, function(col, row) {
+ if (!this.gridmap[col]) { return this; }
+ this.gridmap[col][row] = value;
+ });
+ return this;
+ };
+
+
+ /**
+ * Remove a widget from the mapped array of positions.
+ *
+ * @method remove_from_gridmap
+ * @param {Object} grid_data The grid coords object representing the cells
+ * to update in the mapped array.
+ * @return {Class} Returns the instance of the Gridster Class.
+ */
+ fn.remove_from_gridmap = function(grid_data) {
+ return this.update_widget_position(grid_data, false);
+ };
+
+
+ /**
+ * Add a widget to the mapped array of positions.
+ *
+ * @method add_to_gridmap
+ * @param {Object} grid_data The grid coords object representing the cells
+ * to update in the mapped array.
+ * @param {HTMLElement|Boolean} value The value to set in the specified
+ * position .
+ * @return {Class} Returns the instance of the Gridster Class.
+ */
+ fn.add_to_gridmap = function(grid_data, value) {
+ this.update_widget_position(grid_data, value || grid_data.el);
+
+ if (grid_data.el) {
+ var $widgets = this.widgets_below(grid_data.el);
+ $widgets.each($.proxy(function(i, widget) {
+ this.move_widget_up( $(widget));
+ }, this));
+ }
+ };
+
+
+ /**
+ * Make widgets draggable.
+ *
+ * @uses Draggable
+ * @method draggable
+ * @return {Class} Returns the instance of the Gridster Class.
+ */
+ fn.draggable = function() {
+ var self = this;
+ var draggable_options = $.extend(true, {}, this.options.draggable, {
+ offset_left: this.options.widget_margins[0],
+ offset_top: this.options.widget_margins[1],
+ container_width: this.cols * this.min_widget_width,
+ limit: true,
+ start: function(event, ui) {
+ self.$widgets.filter('.player-revert')
+ .removeClass('player-revert');
+
+ self.$player = $(this);
+ self.$helper = $(ui.$helper);
+
+ self.helper = !self.$helper.is(self.$player);
+
+ self.on_start_drag.call(self, event, ui);
+ self.$el.trigger('gridster:dragstart');
+ },
+ stop: function(event, ui) {
+ self.on_stop_drag.call(self, event, ui);
+ self.$el.trigger('gridster:dragstop');
+ },
+ drag: throttle(function(event, ui) {
+ self.on_drag.call(self, event, ui);
+ self.$el.trigger('gridster:drag');
+ }, 60)
+ });
+
+ this.drag_api = this.$el.drag(draggable_options);
+ return this;
+ };
+
+
+ /**
+ * Bind resize events to get resize working.
+ *
+ * @method resizable
+ * @return {Class} Returns instance of gridster Class.
+ */
+ fn.resizable = function() {
+ this.resize_api = this.$el.drag({
+ items: '.' + this.options.resize.handle_class,
+ offset_left: this.options.widget_margins[0],
+ container_width: this.container_width,
+ move_element: false,
+ resize: true,
+ limit: this.options.autogrow_cols ? false : true,
+ start: $.proxy(this.on_start_resize, this),
+ stop: $.proxy(function(event, ui) {
+ delay($.proxy(function() {
+ this.on_stop_resize(event, ui);
+ }, this), 120);
+ }, this),
+ drag: throttle($.proxy(this.on_resize, this), 60)
+ });
+
+ return this;
+ };
+
+
+ /**
+ * Setup things required for resizing. Like build templates for drag handles.
+ *
+ * @method setup_resize
+ * @return {Class} Returns instance of gridster Class.
+ */
+ fn.setup_resize = function() {
+ this.resize_handle_class = this.options.resize.handle_class;
+ var axes = this.options.resize.axes;
+ var handle_tpl = '<span class="' + this.resize_handle_class + ' ' +
+ this.resize_handle_class + '-{type}" />';
+
+ this.resize_handle_tpl = $.map(axes, function(type) {
+ return handle_tpl.replace('{type}', type);
+ }).join('');
+
+ if ($.isArray(this.options.draggable.ignore_dragging)) {
+ this.options.draggable.ignore_dragging.push(
+ '.' + this.resize_handle_class);
+ }
+
+ return this;
+ };
+
+
+ /**
+ * This function is executed when the player begins to be dragged.
+ *
+ * @method on_start_drag
+ * @param {Event} event The original browser event
+ * @param {Object} ui A prepared ui object with useful drag-related data
+ */
+ fn.on_start_drag = function(event, ui) {
+ this.$helper.add(this.$player).add(this.$wrapper).addClass('dragging');
+
+ this.highest_col = this.get_highest_occupied_cell().col;
+
+ this.$player.addClass('player');
+ this.player_grid_data = this.$player.coords().grid;
+ this.placeholder_grid_data = $.extend({}, this.player_grid_data);
+
+ this.set_dom_grid_height(this.$el.height() +
+ (this.player_grid_data.size_y * this.min_widget_height));
+
+ this.set_dom_grid_width(this.cols);
+
+ var pgd_sizex = this.player_grid_data.size_x;
+ var cols_diff = this.cols - this.highest_col;
+
+ if (this.options.autogrow_cols && cols_diff <= pgd_sizex) {
+ this.add_faux_cols(Math.min(pgd_sizex - cols_diff, 1));
+ }
+
+ var colliders = this.faux_grid;
+ var coords = this.$player.data('coords').coords;
+
+ this.cells_occupied_by_player = this.get_cells_occupied(
+ this.player_grid_data);
+ this.cells_occupied_by_placeholder = this.get_cells_occupied(
+ this.placeholder_grid_data);
+
+ this.last_cols = [];
+ this.last_rows = [];
+
+ // see jquery.collision.js
+ this.collision_api = this.$helper.collision(
+ colliders, this.options.collision);
+
+ this.$preview_holder = $('<' + this.$player.get(0).tagName + ' />', {
+ 'class': 'preview-holder',
+ 'data-row': this.$player.attr('data-row'),
+ 'data-col': this.$player.attr('data-col'),
+ css: {
+ width: coords.width,
+ height: coords.height
+ }
+ }).appendTo(this.$el);
+
+ if (this.options.draggable.start) {
+ this.options.draggable.start.call(this, event, ui);
+ }
+ };
+
+
+ /**
+ * This function is executed when the player is being dragged.
+ *
+ * @method on_drag
+ * @param {Event} event The original browser event
+ * @param {Object} ui A prepared ui object with useful drag-related data
+ */
+ fn.on_drag = function(event, ui) {
+ //break if dragstop has been fired
+ if (this.$player === null) {
+ return false;
+ }
+
+ var abs_offset = {
+ left: ui.position.left + this.baseX,
+ top: ui.position.top + this.baseY
+ };
+
+ // auto grow cols
+ if (this.options.autogrow_cols) {
+ var prcol = this.placeholder_grid_data.col +
+ this.placeholder_grid_data.size_x - 1;
+
+ // "- 1" due to adding at least 1 column in on_start_drag
+ if (prcol >= this.cols - 1 && this.options.max_cols >= this.cols + 1) {
+ this.add_faux_cols(1);
+ this.set_dom_grid_width(this.cols + 1);
+ this.drag_api.set_limits(this.container_width);
+ }
+
+ this.collision_api.set_colliders(this.faux_grid);
+ }
+
+ this.colliders_data = this.collision_api.get_closest_colliders(
+ abs_offset);
+
+ this.on_overlapped_column_change(
+ this.on_start_overlapping_column, this.on_stop_overlapping_column);
+
+ this.on_overlapped_row_change(
+ this.on_start_overlapping_row, this.on_stop_overlapping_row);
+
+
+ if (this.helper && this.$player) {
+ this.$player.css({
+ 'left': ui.position.left,
+ 'top': ui.position.top
+ });
+ }
+
+ if (this.options.draggable.drag) {
+ this.options.draggable.drag.call(this, event, ui);
+ }
+ };
+
+
+ /**
+ * This function is executed when the player stops being dragged.
+ *
+ * @method on_stop_drag
+ * @param {Event} event The original browser event
+ * @param {Object} ui A prepared ui object with useful drag-related data
+ */
+ fn.on_stop_drag = function(event, ui) {
+ this.$helper.add(this.$player).add(this.$wrapper)
+ .removeClass('dragging');
+
+ ui.position.left = ui.position.left + this.baseX;
+ ui.position.top = ui.position.top + this.baseY;
+ this.colliders_data = this.collision_api.get_closest_colliders(
+ ui.position);
+
+ this.on_overlapped_column_change(
+ this.on_start_overlapping_column,
+ this.on_stop_overlapping_column
+ );
+
+ this.on_overlapped_row_change(
+ this.on_start_overlapping_row,
+ this.on_stop_overlapping_row
+ );
+
+ this.$player.addClass('player-revert').removeClass('player')
+ .attr({
+ 'data-col': this.placeholder_grid_data.col,
+ 'data-row': this.placeholder_grid_data.row
+ }).css({
+ 'left': '',
+ 'top': ''
+ });
+
+ this.$changed = this.$changed.add(this.$player);
+
+ this.cells_occupied_by_player = this.get_cells_occupied(
+ this.placeholder_grid_data);
+ this.set_cells_player_occupies(
+ this.placeholder_grid_data.col, this.placeholder_grid_data.row);
+
+ this.$player.coords().grid.row = this.placeholder_grid_data.row;
+ this.$player.coords().grid.col = this.placeholder_grid_data.col;
+
+ if (this.options.draggable.stop) {
+ this.options.draggable.stop.call(this, event, ui);
+ }
+
+ this.$preview_holder.remove();
+
+ this.$player = null;
+ this.$helper = null;
+ this.placeholder_grid_data = {};
+ this.player_grid_data = {};
+ this.cells_occupied_by_placeholder = {};
+ this.cells_occupied_by_player = {};
+
+ this.set_dom_grid_height();
+ this.set_dom_grid_width();
+
+ if (this.options.autogrow_cols) {
+ this.drag_api.set_limits(this.cols * this.min_widget_width);
+ }
+ };
+
+
+ /**
+ * This function is executed every time a widget starts to be resized.
+ *
+ * @method on_start_resize
+ * @param {Event} event The original browser event
+ * @param {Object} ui A prepared ui object with useful drag-related data
+ */
+ fn.on_start_resize = function(event, ui) {
+ this.$resized_widget = ui.$player.closest('.gs-w');
+ this.resize_coords = this.$resized_widget.coords();
+ this.resize_wgd = this.resize_coords.grid;
+ this.resize_initial_width = this.resize_coords.coords.width;
+ this.resize_initial_height = this.resize_coords.coords.height;
+ this.resize_initial_sizex = this.resize_coords.grid.size_x;
+ this.resize_initial_sizey = this.resize_coords.grid.size_y;
+ this.resize_initial_col = this.resize_coords.grid.col;
+ this.resize_last_sizex = this.resize_initial_sizex;
+ this.resize_last_sizey = this.resize_initial_sizey;
+
+ this.resize_max_size_x = Math.min(this.resize_wgd.max_size_x ||
+ this.options.resize.max_size[0],
+ this.options.max_cols - this.resize_initial_col + 1);
+ this.resize_max_size_y = this.resize_wgd.max_size_y ||
+ this.options.resize.max_size[1];
+
+ this.resize_min_size_x = (this.resize_wgd.min_size_x ||
+ this.options.resize.min_size[0] || 1);
+ this.resize_min_size_y = (this.resize_wgd.min_size_y ||
+ this.options.resize.min_size[1] || 1);
+
+ this.resize_initial_last_col = this.get_highest_occupied_cell().col;
+
+ this.set_dom_grid_width(this.cols);
+
+ this.resize_dir = {
+ right: ui.$player.is('.' + this.resize_handle_class + '-x'),
+ bottom: ui.$player.is('.' + this.resize_handle_class + '-y')
+ };
+
+ this.$resized_widget.css({
+ 'min-width': this.options.widget_base_dimensions[0],
+ 'min-height': this.options.widget_base_dimensions[1]
+ });
+
+ var nodeName = this.$resized_widget.get(0).tagName;
+ this.$resize_preview_holder = $('<' + nodeName + ' />', {
+ 'class': 'preview-holder resize-preview-holder',
+ 'data-row': this.$resized_widget.attr('data-row'),
+ 'data-col': this.$resized_widget.attr('data-col'),
+ 'css': {
+ 'width': this.resize_initial_width,
+ 'height': this.resize_initial_height
+ }
+ }).appendTo(this.$el);
+
+ this.$resized_widget.addClass('resizing');
+
+ if (this.options.resize.start) {
+ this.options.resize.start.call(this, event, ui, this.$resized_widget);
+ }
+
+ this.$el.trigger('gridster:resizestart');
+ };
+
+
+ /**
+ * This function is executed every time a widget stops being resized.
+ *
+ * @method on_stop_resize
+ * @param {Event} event The original browser event
+ * @param {Object} ui A prepared ui object with useful drag-related data
+ */
+ fn.on_stop_resize = function(event, ui) {
+ this.$resized_widget
+ .removeClass('resizing')
+ .css({
+ 'width': '',
+ 'height': ''
+ });
+
+ delay($.proxy(function() {
+ this.$resize_preview_holder
+ .remove()
+ .css({
+ 'min-width': '',
+ 'min-height': ''
+ });
+
+ if (this.options.resize.stop) {
+ this.options.resize.stop.call(this, event, ui, this.$resized_widget);
+ }
+
+ this.$el.trigger('gridster:resizestop');
+ }, this), 300);
+
+ this.set_dom_grid_width();
+
+ if (this.options.autogrow_cols) {
+ this.drag_api.set_limits(this.cols * this.min_widget_width);
+ }
+ };
+
+
+ /**
+ * This function is executed when a widget is being resized.
+ *
+ * @method on_resize
+ * @param {Event} event The original browser event
+ * @param {Object} ui A prepared ui object with useful drag-related data
+ */
+ fn.on_resize = function(event, ui) {
+ var rel_x = (ui.pointer.diff_left);
+ var rel_y = (ui.pointer.diff_top);
+ var wbd_x = this.options.widget_base_dimensions[0];
+ var wbd_y = this.options.widget_base_dimensions[1];
+ var margin_x = this.options.widget_margins[0];
+ var margin_y = this.options.widget_margins[1];
+ var max_size_x = this.resize_max_size_x;
+ var min_size_x = this.resize_min_size_x;
+ var max_size_y = this.resize_max_size_y;
+ var min_size_y = this.resize_min_size_y;
+ var autogrow = this.options.autogrow_cols;
+ var width;
+ var max_width = Infinity;
+ var max_height = Infinity;
+
+ var inc_units_x = Math.ceil((rel_x / (wbd_x + margin_x * 2)) - 0.2);
+ var inc_units_y = Math.ceil((rel_y / (wbd_y + margin_y * 2)) - 0.2);
+
+ var size_x = Math.max(1, this.resize_initial_sizex + inc_units_x);
+ var size_y = Math.max(1, this.resize_initial_sizey + inc_units_y);
+
+ var max_cols = (this.container_width / this.min_widget_width) -
+ this.resize_initial_col + 1;
+ var limit_width = ((max_cols * this.min_widget_width) - margin_x * 2);
+
+ size_x = Math.max(Math.min(size_x, max_size_x), min_size_x);
+ size_x = Math.min(max_cols, size_x);
+ width = (max_size_x * wbd_x) + ((size_x - 1) * margin_x * 2);
+ max_width = Math.min(width, limit_width);
+ min_width = (min_size_x * wbd_x) + ((size_x - 1) * margin_x * 2);
+
+ size_y = Math.max(Math.min(size_y, max_size_y), min_size_y);
+ max_height = (max_size_y * wbd_y) + ((size_y - 1) * margin_y * 2);
+ min_height = (min_size_y * wbd_y) + ((size_y - 1) * margin_y * 2);
+
+ if (this.resize_dir.right) {
+ size_y = this.resize_initial_sizey;
+ } else if (this.resize_dir.bottom) {
+ size_x = this.resize_initial_sizex;
+ }
+
+ if (autogrow) {
+ var last_widget_col = this.resize_initial_col + size_x - 1;
+ if (autogrow && this.resize_initial_last_col <= last_widget_col) {
+ this.set_dom_grid_width(Math.max(last_widget_col + 1, this.cols));
+
+ if (this.cols < last_widget_col) {
+ this.add_faux_cols(last_widget_col - this.cols);
+ }
+ }
+ }
+
+ var css_props = {};
+ !this.resize_dir.bottom && (css_props.width = Math.max(Math.min(
+ this.resize_initial_width + rel_x, max_width), min_width));
+ !this.resize_dir.right && (css_props.height = Math.max(Math.min(
+ this.resize_initial_height + rel_y, max_height), min_height));
+
+ this.$resized_widget.css(css_props);
+
+ if (size_x !== this.resize_last_sizex ||
+ size_y !== this.resize_last_sizey) {
+
+ this.resize_widget(this.$resized_widget, size_x, size_y);
+ this.set_dom_grid_width(this.cols);
+
+ this.$resize_preview_holder.css({
+ 'width': '',
+ 'height': ''
+ }).attr({
+ 'data-row': this.$resized_widget.attr('data-row'),
+ 'data-sizex': size_x,
+ 'data-sizey': size_y
+ });
+ }
+
+ if (this.options.resize.resize) {
+ this.options.resize.resize.call(this, event, ui, this.$resized_widget);
+ }
+
+ this.$el.trigger('gridster:resize');
+
+ this.resize_last_sizex = size_x;
+ this.resize_last_sizey = size_y;
+ };
+
+
+ /**
+ * Executes the callbacks passed as arguments when a column begins to be
+ * overlapped or stops being overlapped.
+ *
+ * @param {Function} start_callback Function executed when a new column
+ * begins to be overlapped. The column is passed as first argument.
+ * @param {Function} stop_callback Function executed when a column stops
+ * being overlapped. The column is passed as first argument.
+ * @method on_overlapped_column_change
+ * @return {Class} Returns the instance of the Gridster Class.
+ */
+ fn.on_overlapped_column_change = function(start_callback, stop_callback) {
+ if (!this.colliders_data.length) {
+ return this;
+ }
+ var cols = this.get_targeted_columns(
+ this.colliders_data[0].el.data.col);
+
+ var last_n_cols = this.last_cols.length;
+ var n_cols = cols.length;
+ var i;
+
+ for (i = 0; i < n_cols; i++) {
+ if ($.inArray(cols[i], this.last_cols) === -1) {
+ (start_callback || $.noop).call(this, cols[i]);
+ }
+ }
+
+ for (i = 0; i< last_n_cols; i++) {
+ if ($.inArray(this.last_cols[i], cols) === -1) {
+ (stop_callback || $.noop).call(this, this.last_cols[i]);
+ }
+ }
+
+ this.last_cols = cols;
+
+ return this;
+ };
+
+
+ /**
+ * Executes the callbacks passed as arguments when a row starts to be
+ * overlapped or stops being overlapped.
+ *
+ * @param {Function} start_callback Function executed when a new row begins
+ * to be overlapped. The row is passed as first argument.
+ * @param {Function} end_callback Function executed when a row stops being
+ * overlapped. The row is passed as first argument.
+ * @method on_overlapped_row_change
+ * @return {Class} Returns the instance of the Gridster Class.
+ */
+ fn.on_overlapped_row_change = function(start_callback, end_callback) {
+ if (!this.colliders_data.length) {
+ return this;
+ }
+ var rows = this.get_targeted_rows(this.colliders_data[0].el.data.row);
+ var last_n_rows = this.last_rows.length;
+ var n_rows = rows.length;
+ var i;
+
+ for (i = 0; i < n_rows; i++) {
+ if ($.inArray(rows[i], this.last_rows) === -1) {
+ (start_callback || $.noop).call(this, rows[i]);
+ }
+ }
+
+ for (i = 0; i < last_n_rows; i++) {
+ if ($.inArray(this.last_rows[i], rows) === -1) {
+ (end_callback || $.noop).call(this, this.last_rows[i]);
+ }
+ }
+
+ this.last_rows = rows;
+ };
+
+
+ /**
+ * Sets the current position of the player
+ *
+ * @param {Number} col
+ * @param {Number} row
+ * @param {Boolean} no_player
+ * @method set_player
+ * @return {object}
+ */
+ fn.set_player = function(col, row, no_player) {
+ var self = this;
+ if (!no_player) {
+ this.empty_cells_player_occupies();
+ }
+ var cell = !no_player ? self.colliders_data[0].el.data : {col: col};
+ var to_col = cell.col;
+ var to_row = row || cell.row;
+
+ this.player_grid_data = {
+ col: to_col,
+ row: to_row,
+ size_y : this.player_grid_data.size_y,
+ size_x : this.player_grid_data.size_x
+ };
+
+ this.cells_occupied_by_player = this.get_cells_occupied(
+ this.player_grid_data);
+
+ var $overlapped_widgets = this.get_widgets_overlapped(
+ this.player_grid_data);
+
+ var constraints = this.widgets_constraints($overlapped_widgets);
+
+ this.manage_movements(constraints.can_go_up, to_col, to_row);
+ this.manage_movements(constraints.can_not_go_up, to_col, to_row);
+
+ /* if there is not widgets overlapping in the new player position,
+ * update the new placeholder position. */
+ if (!$overlapped_widgets.length) {
+ var pp = this.can_go_player_up(this.player_grid_data);
+ if (pp !== false) {
+ to_row = pp;
+ }
+ this.set_placeholder(to_col, to_row);
+ }
+
+ return {
+ col: to_col,
+ row: to_row
+ };
+ };
+
+
+ /**
+ * See which of the widgets in the $widgets param collection can go to
+ * a upper row and which not.
+ *
+ * @method widgets_contraints
+ * @param {jQuery} $widgets A jQuery wrapped collection of
+ * HTMLElements.
+ * @return {object} Returns a literal Object with two keys: `can_go_up` &
+ * `can_not_go_up`. Each contains a set of HTMLElements.
+ */
+ fn.widgets_constraints = function($widgets) {
+ var $widgets_can_go_up = $([]);
+ var $widgets_can_not_go_up;
+ var wgd_can_go_up = [];
+ var wgd_can_not_go_up = [];
+
+ $widgets.each($.proxy(function(i, w) {
+ var $w = $(w);
+ var wgd = $w.coords().grid;
+ if (this.can_go_widget_up(wgd)) {
+ $widgets_can_go_up = $widgets_can_go_up.add($w);
+ wgd_can_go_up.push(wgd);
+ } else {
+ wgd_can_not_go_up.push(wgd);
+ }
+ }, this));
+
+ $widgets_can_not_go_up = $widgets.not($widgets_can_go_up);
+
+ return {
+ can_go_up: Gridster.sort_by_row_asc(wgd_can_go_up),
+ can_not_go_up: Gridster.sort_by_row_desc(wgd_can_not_go_up)
+ };
+ };
+
+
+ /**
+ * Sorts an Array of grid coords objects (representing the grid coords of
+ * each widget) in descending way.
+ *
+ * @method manage_movements
+ * @param {jQuery} $widgets A jQuery collection of HTMLElements
+ * representing the widgets you want to move.
+ * @param {Number} to_col The column to which we want to move the widgets.
+ * @param {Number} to_row The row to which we want to move the widgets.
+ * @return {Class} Returns the instance of the Gridster Class.
+ */
+ fn.manage_movements = function($widgets, to_col, to_row) {
+ $.each($widgets, $.proxy(function(i, w) {
+ var wgd = w;
+ var $w = wgd.el;
+
+ var can_go_widget_up = this.can_go_widget_up(wgd);
+
+ if (can_go_widget_up) {
+ //target CAN go up
+ //so move widget up
+ this.move_widget_to($w, can_go_widget_up);
+ this.set_placeholder(to_col, can_go_widget_up + wgd.size_y);
+
+ } else {
+ //target can't go up
+ var can_go_player_up = this.can_go_player_up(
+ this.player_grid_data);
+
+ if (!can_go_player_up) {
+ // target can't go up
+ // player cant't go up
+ // so we need to move widget down to a position that dont
+ // overlaps player
+ var y = (to_row + this.player_grid_data.size_y) - wgd.row;
+
+ this.move_widget_down($w, y);
+ this.set_placeholder(to_col, to_row);
+ }
+ }
+ }, this));
+
+ return this;
+ };
+
+ /**
+ * Determines if there is a widget in the row and col given. Or if the
+ * HTMLElement passed as first argument is the player.
+ *
+ * @method is_player
+ * @param {Number|HTMLElement} col_or_el A jQuery wrapped collection of
+ * HTMLElements.
+ * @param {Number} [row] The column to which we want to move the widgets.
+ * @return {Boolean} Returns true or false.
+ */
+ fn.is_player = function(col_or_el, row) {
+ if (row && !this.gridmap[col_or_el]) { return false; }
+ var $w = row ? this.gridmap[col_or_el][row] : col_or_el;
+ return $w && ($w.is(this.$player) || $w.is(this.$helper));
+ };
+
+
+ /**
+ * Determines if the widget that is being dragged is currently over the row
+ * and col given.
+ *
+ * @method is_player_in
+ * @param {Number} col The column to check.
+ * @param {Number} row The row to check.
+ * @return {Boolean} Returns true or false.
+ */
+ fn.is_player_in = function(col, row) {
+ var c = this.cells_occupied_by_player || {};
+ return $.inArray(col, c.cols) >= 0 && $.inArray(row, c.rows) >= 0;
+ };
+
+
+ /**
+ * Determines if the placeholder is currently over the row and col given.
+ *
+ * @method is_placeholder_in
+ * @param {Number} col The column to check.
+ * @param {Number} row The row to check.
+ * @return {Boolean} Returns true or false.
+ */
+ fn.is_placeholder_in = function(col, row) {
+ var c = this.cells_occupied_by_placeholder || {};
+ return this.is_placeholder_in_col(col) && $.inArray(row, c.rows) >= 0;
+ };
+
+
+ /**
+ * Determines if the placeholder is currently over the column given.
+ *
+ * @method is_placeholder_in_col
+ * @param {Number} col The column to check.
+ * @return {Boolean} Returns true or false.
+ */
+ fn.is_placeholder_in_col = function(col) {
+ var c = this.cells_occupied_by_placeholder || [];
+ return $.inArray(col, c.cols) >= 0;
+ };
+
+
+ /**
+ * Determines if the cell represented by col and row params is empty.
+ *
+ * @method is_empty
+ * @param {Number} col The column to check.
+ * @param {Number} row The row to check.
+ * @return {Boolean} Returns true or false.
+ */
+ fn.is_empty = function(col, row) {
+ if (typeof this.gridmap[col] !== 'undefined') {
+ if(typeof this.gridmap[col][row] !== 'undefined' &&
+ this.gridmap[col][row] === false
+ ) {
+ return true;
+ }
+ return false;
+ }
+ return true;
+ };
+
+
+ /**
+ * Determines if the cell represented by col and row params is occupied.
+ *
+ * @method is_occupied
+ * @param {Number} col The column to check.
+ * @param {Number} row The row to check.
+ * @return {Boolean} Returns true or false.
+ */
+ fn.is_occupied = function(col, row) {
+ if (!this.gridmap[col]) {
+ return false;
+ }
+
+ if (this.gridmap[col][row]) {
+ return true;
+ }
+ return false;
+ };
+
+
+ /**
+ * Determines if there is a widget in the cell represented by col/row params.
+ *
+ * @method is_widget
+ * @param {Number} col The column to check.
+ * @param {Number} row The row to check.
+ * @return {Boolean|HTMLElement} Returns false if there is no widget,
+ * else returns the jQuery HTMLElement
+ */
+ fn.is_widget = function(col, row) {
+ var cell = this.gridmap[col];
+ if (!cell) {
+ return false;
+ }
+
+ cell = cell[row];
+
+ if (cell) {
+ return cell;
+ }
+
+ return false;
+ };
+
+
+ /**
+ * Determines if there is a widget in the cell represented by col/row
+ * params and if this is under the widget that is being dragged.
+ *
+ * @method is_widget_under_player
+ * @param {Number} col The column to check.
+ * @param {Number} row The row to check.
+ * @return {Boolean} Returns true or false.
+ */
+ fn.is_widget_under_player = function(col, row) {
+ if (this.is_widget(col, row)) {
+ return this.is_player_in(col, row);
+ }
+ return false;
+ };
+
+
+ /**
+ * Get widgets overlapping with the player or with the object passed
+ * representing the grid cells.
+ *
+ * @method get_widgets_under_player
+ * @return {HTMLElement} Returns a jQuery collection of HTMLElements
+ */
+ fn.get_widgets_under_player = function(cells) {
+ cells || (cells = this.cells_occupied_by_player || {cols: [], rows: []});
+ var $widgets = $([]);
+
+ $.each(cells.cols, $.proxy(function(i, col) {
+ $.each(cells.rows, $.proxy(function(i, row) {
+ if(this.is_widget(col, row)) {
+ $widgets = $widgets.add(this.gridmap[col][row]);
+ }
+ }, this));
+ }, this));
+
+ return $widgets;
+ };
+
+
+ /**
+ * Put placeholder at the row and column specified.
+ *
+ * @method set_placeholder
+ * @param {Number} col The column to which we want to move the
+ * placeholder.
+ * @param {Number} row The row to which we want to move the
+ * placeholder.
+ * @return {Class} Returns the instance of the Gridster Class.
+ */
+ fn.set_placeholder = function(col, row) {
+ var phgd = $.extend({}, this.placeholder_grid_data);
+ var $nexts = this.widgets_below({
+ col: phgd.col,
+ row: phgd.row,
+ size_y: phgd.size_y,
+ size_x: phgd.size_x
+ });
+
+ // Prevents widgets go out of the grid
+ var right_col = (col + phgd.size_x - 1);
+ if (right_col > this.cols) {
+ col = col - (right_col - col);
+ }
+
+ var moved_down = this.placeholder_grid_data.row < row;
+ var changed_column = this.placeholder_grid_data.col !== col;
+
+ this.placeholder_grid_data.col = col;
+ this.placeholder_grid_da
<TRUNCATED>