pandorafms/pandora_console/include/javascript/gridstack.js

2658 lines
76 KiB
JavaScript
Raw Normal View History

2020-03-26 12:29:38 +01:00
/**
2020-12-02 14:26:20 +01:00
* gridstack.js 1.2.1
* https://gridstackjs.com/
* (c) 2014-2020 Alain Dumesny, Dylan Weiss, Pavel Reznikov
2020-03-26 12:29:38 +01:00
* gridstack.js may be freely distributed under the MIT license.
* @preserve
*/
(function(factory) {
if (typeof define === "function" && define.amd) {
2020-12-02 14:26:20 +01:00
define(["jquery", "exports"], factory);
2020-03-26 12:29:38 +01:00
} else if (typeof exports !== "undefined") {
2020-12-02 14:26:20 +01:00
var jQueryModule;
2020-03-26 12:29:38 +01:00
try {
2020-12-02 14:26:20 +01:00
jQueryModule = require("jquery");
2020-03-26 12:29:38 +01:00
} catch (e) {}
2020-12-02 14:26:20 +01:00
factory(jQueryModule || window.jQuery, exports);
2020-03-26 12:29:38 +01:00
} else {
2020-12-02 14:26:20 +01:00
factory(window.jQuery, window);
2020-03-26 12:29:38 +01:00
}
2020-12-02 14:26:20 +01:00
})(function($, scope) {
// checks for obsolete method names
var obsolete = function(f, oldName, newName, rev) {
2020-03-26 12:29:38 +01:00
var wrapper = function() {
console.warn(
"gridstack.js: Function `" +
oldName +
2020-12-02 14:26:20 +01:00
"` is deprecated in " +
rev +
" and has been replaced " +
2020-03-26 12:29:38 +01:00
"with `" +
newName +
2020-12-02 14:26:20 +01:00
"`. It will be **completely** removed in v1.0"
2020-03-26 12:29:38 +01:00
);
return f.apply(this, arguments);
};
wrapper.prototype = f.prototype;
return wrapper;
};
2020-12-02 14:26:20 +01:00
// checks for obsolete grid options (can be used for any fields, but msg is about options)
var obsoleteOpts = function(opts, oldName, newName, rev) {
if (opts[oldName] !== undefined) {
opts[newName] = opts[oldName];
console.warn(
"gridstack.js: Option `" +
oldName +
"` is deprecated in " +
rev +
" and has been replaced with `" +
newName +
"`. It will be **completely** removed in v1.0"
);
}
};
// checks for obsolete grid options which are gone
var obsoleteOptsDel = function(opts, oldName, rev, info) {
if (opts[oldName] !== undefined) {
console.warn(
"gridstack.js: Option `" + oldName + "` is deprecated in " + rev + info
);
}
};
// checks for obsolete Jquery element attributes
var obsoleteAttr = function(el, oldName, newName, rev) {
var oldAttr = el.attr(oldName);
if (oldAttr !== undefined) {
el.attr(newName, oldAttr);
console.warn(
"gridstack.js: attribute `" +
oldName +
"`=" +
oldAttr +
" is deprecated on this object in " +
rev +
" and has been replaced with `" +
newName +
"`. It will be **completely** removed in v1.0"
);
}
2020-03-26 12:29:38 +01:00
};
var Utils = {
isIntercepted: function(a, b) {
return !(
a.x + a.width <= b.x ||
b.x + b.width <= a.x ||
a.y + a.height <= b.y ||
b.y + b.height <= a.y
);
},
2020-12-02 14:26:20 +01:00
sort: function(nodes, dir, column) {
if (!column) {
var widths = nodes.map(function(node) {
return node.x + node.width;
});
column = Math.max.apply(Math, widths);
}
if (dir === -1)
return Utils.sortBy(nodes, function(n) {
return -(n.x + n.y * column);
});
else
return Utils.sortBy(nodes, function(n) {
return n.x + n.y * column;
});
2020-03-26 12:29:38 +01:00
},
2020-12-02 14:26:20 +01:00
createStylesheet: function(id, parent) {
2020-03-26 12:29:38 +01:00
var style = document.createElement("style");
style.setAttribute("type", "text/css");
style.setAttribute("data-gs-style-id", id);
if (style.styleSheet) {
style.styleSheet.cssText = "";
} else {
style.appendChild(document.createTextNode(""));
}
2020-12-02 14:26:20 +01:00
if (!parent) {
parent = document.getElementsByTagName("head")[0];
} // default to head
parent.insertBefore(style, parent.firstChild);
2020-03-26 12:29:38 +01:00
return style.sheet;
},
removeStylesheet: function(id) {
$("STYLE[data-gs-style-id=" + id + "]").remove();
},
insertCSSRule: function(sheet, selector, rules, index) {
if (typeof sheet.insertRule === "function") {
sheet.insertRule(selector + "{" + rules + "}", index);
} else if (typeof sheet.addRule === "function") {
sheet.addRule(selector, rules, index);
}
},
toBool: function(v) {
2020-12-02 14:26:20 +01:00
if (typeof v === "boolean") {
2020-03-26 12:29:38 +01:00
return v;
}
2020-12-02 14:26:20 +01:00
if (typeof v === "string") {
2020-03-26 12:29:38 +01:00
v = v.toLowerCase();
2020-12-02 14:26:20 +01:00
return !(v === "" || v === "no" || v === "false" || v === "0");
2020-03-26 12:29:38 +01:00
}
return Boolean(v);
},
_collisionNodeCheck: function(n) {
2020-12-02 14:26:20 +01:00
return n !== this.node && Utils.isIntercepted(n, this.nn);
2020-03-26 12:29:38 +01:00
},
_didCollide: function(bn) {
return Utils.isIntercepted(
{
x: this.n.x,
y: this.newY,
width: this.n.width,
height: this.n.height
},
bn
);
},
_isAddNodeIntercepted: function(n) {
return Utils.isIntercepted(
{
x: this.x,
y: this.y,
width: this.node.width,
height: this.node.height
},
n
);
},
parseHeight: function(val) {
var height = val;
var heightUnit = "px";
2020-12-02 14:26:20 +01:00
if (height && typeof height === "string") {
2020-03-26 12:29:38 +01:00
var match = height.match(
2020-12-02 14:26:20 +01:00
/^(-[0-9]+\.[0-9]+|[0-9]*\.[0-9]+|-[0-9]+|[0-9]+)(px|em|rem|vh|vw|%)?$/
2020-03-26 12:29:38 +01:00
);
if (!match) {
throw new Error("Invalid height");
}
heightUnit = match[2] || "px";
height = parseFloat(match[1]);
}
return { height: height, unit: heightUnit };
2020-12-02 14:26:20 +01:00
},
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
without: function(array, item) {
var index = array.indexOf(item);
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
if (index !== -1) {
array = array.slice(0);
array.splice(index, 1);
}
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
return array;
},
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
sortBy: function(array, getter) {
return array.slice(0).sort(function(left, right) {
var valueLeft = getter(left);
var valueRight = getter(right);
if (valueRight === valueLeft) {
return 0;
}
return valueLeft > valueRight ? 1 : -1;
});
},
defaults: function(target) {
var sources = Array.prototype.slice.call(arguments, 1);
sources.forEach(function(source) {
for (var prop in source) {
if (
Object.prototype.hasOwnProperty.call(source, prop) &&
(!Object.prototype.hasOwnProperty.call(target, prop) ||
target[prop] === undefined)
) {
target[prop] = source[prop];
}
}
});
return target;
},
clone: function(target) {
return $.extend({}, target);
},
throttle: function(callback, delay) {
var isWaiting = false;
return function() {
if (!isWaiting) {
callback.apply(this, arguments);
isWaiting = true;
setTimeout(function() {
isWaiting = false;
}, delay);
}
};
},
removePositioningStyles: function(el) {
var style = el[0].style;
if (style.position) {
style.removeProperty("position");
}
if (style.left) {
style.removeProperty("left");
}
if (style.top) {
style.removeProperty("top");
}
if (style.width) {
style.removeProperty("width");
}
if (style.height) {
style.removeProperty("height");
}
},
getScrollParent: function(el) {
var returnEl;
if (el === null) {
returnEl = null;
} else if (el.scrollHeight > el.clientHeight) {
returnEl = el;
} else {
returnEl = Utils.getScrollParent(el.parentNode);
}
return returnEl;
},
updateScrollPosition: function(el, ui, distance) {
// is widget in view?
var rect = el.getBoundingClientRect();
var innerHeightOrClientHeight =
window.innerHeight || document.documentElement.clientHeight;
if (rect.top < 0 || rect.bottom > innerHeightOrClientHeight) {
// set scrollTop of first parent that scrolls
// if parent is larger than el, set as low as possible
// to get entire widget on screen
var offsetDiffDown = rect.bottom - innerHeightOrClientHeight;
var offsetDiffUp = rect.top;
var scrollEl = Utils.getScrollParent(el);
if (scrollEl !== null) {
var prevScroll = scrollEl.scrollTop;
if (rect.top < 0 && distance < 0) {
// moving up
if (el.offsetHeight > innerHeightOrClientHeight) {
scrollEl.scrollTop += distance;
} else {
scrollEl.scrollTop +=
Math.abs(offsetDiffUp) > Math.abs(distance)
? distance
: offsetDiffUp;
}
} else if (distance > 0) {
// moving down
if (el.offsetHeight > innerHeightOrClientHeight) {
scrollEl.scrollTop += distance;
} else {
scrollEl.scrollTop +=
offsetDiffDown > distance ? distance : offsetDiffDown;
}
}
// move widget y by amount scrolled
ui.position.top += scrollEl.scrollTop - prevScroll;
}
}
}
};
2020-03-26 12:29:38 +01:00
/**
* @class GridStackDragDropPlugin
* Base class for drag'n'drop plugin.
*/
function GridStackDragDropPlugin(grid) {
this.grid = grid;
}
GridStackDragDropPlugin.registeredPlugins = [];
GridStackDragDropPlugin.registerPlugin = function(pluginClass) {
GridStackDragDropPlugin.registeredPlugins.push(pluginClass);
};
GridStackDragDropPlugin.prototype.resizable = function(el, opts) {
return this;
};
GridStackDragDropPlugin.prototype.draggable = function(el, opts) {
return this;
};
GridStackDragDropPlugin.prototype.droppable = function(el, opts) {
return this;
};
GridStackDragDropPlugin.prototype.isDroppable = function(el) {
return false;
};
GridStackDragDropPlugin.prototype.on = function(el, eventName, callback) {
return this;
};
var idSeq = 0;
2020-12-02 14:26:20 +01:00
var GridStackEngine = function(column, onchange, float, maxRow, items) {
this.column = column || 12;
this.float = float || false;
this.maxRow = maxRow || 0;
2020-03-26 12:29:38 +01:00
this.nodes = items || [];
this.onchange = onchange || function() {};
this._addedNodes = [];
this._removedNodes = [];
2020-12-02 14:26:20 +01:00
this._batchMode = false;
2020-03-26 12:29:38 +01:00
};
GridStackEngine.prototype.batchUpdate = function() {
2020-12-02 14:26:20 +01:00
if (this._batchMode) return;
this._batchMode = true;
this._prevFloat = this.float;
this.float = true; // let things go anywhere for now... commit() will restore and possibly reposition
2020-03-26 12:29:38 +01:00
};
GridStackEngine.prototype.commit = function() {
2020-12-02 14:26:20 +01:00
if (!this._batchMode) return;
this._batchMode = false;
this.float = this._prevFloat;
delete this._prevFloat;
this._packNodes();
this._notify();
2020-03-26 12:29:38 +01:00
};
2020-12-02 14:26:20 +01:00
// For Meteor support: https://github.com/gridstack/gridstack.js/pull/272
2020-03-26 12:29:38 +01:00
GridStackEngine.prototype.getNodeDataByDOMEl = function(el) {
2020-12-02 14:26:20 +01:00
return this.nodes.find(function(node) {
return el === node.el;
2020-03-26 12:29:38 +01:00
});
};
GridStackEngine.prototype._fixCollisions = function(node) {
var self = this;
this._sortNodes(-1);
var nn = node;
var hasLocked = Boolean(
2020-12-02 14:26:20 +01:00
this.nodes.find(function(n) {
2020-03-26 12:29:38 +01:00
return n.locked;
})
);
if (!this.float && !hasLocked) {
2020-12-02 14:26:20 +01:00
nn = { x: 0, y: node.y, width: this.column, height: node.height };
2020-03-26 12:29:38 +01:00
}
while (true) {
2020-12-02 14:26:20 +01:00
var collisionNode = this.nodes.find(Utils._collisionNodeCheck, {
node: node,
nn: nn
});
if (!collisionNode) {
2020-03-26 12:29:38 +01:00
return;
}
2020-12-02 14:26:20 +01:00
var moved;
if (collisionNode.locked) {
// if colliding with a locked item, move ourself instead
moved = this.moveNode(
node,
node.x,
collisionNode.y + collisionNode.height,
node.width,
node.height,
true
);
} else {
moved = this.moveNode(
collisionNode,
collisionNode.x,
node.y + node.height,
collisionNode.width,
collisionNode.height,
true
);
}
if (!moved) {
return;
} // break inf loop if we couldn't move after all (ex: maxRow, fixed)
2020-03-26 12:29:38 +01:00
}
};
GridStackEngine.prototype.isAreaEmpty = function(x, y, width, height) {
var nn = { x: x || 0, y: y || 0, width: width || 1, height: height || 1 };
2020-12-02 14:26:20 +01:00
var collisionNode = this.nodes.find(function(n) {
return Utils.isIntercepted(n, nn);
});
return !collisionNode;
2020-03-26 12:29:38 +01:00
};
GridStackEngine.prototype._sortNodes = function(dir) {
2020-12-02 14:26:20 +01:00
this.nodes = Utils.sort(this.nodes, dir, this.column);
2020-03-26 12:29:38 +01:00
};
GridStackEngine.prototype._packNodes = function() {
this._sortNodes();
if (this.float) {
2020-12-02 14:26:20 +01:00
this.nodes.forEach(function(n, i) {
if (n._updating || n._packY === undefined || n.y === n._packY) {
return;
}
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
var newY = n.y;
while (newY >= n._packY) {
var collisionNode = this.nodes
.slice(0, i)
.find(Utils._didCollide, { n: n, newY: newY });
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
if (!collisionNode) {
n._dirty = true;
n.y = newY;
2020-03-26 12:29:38 +01:00
}
2020-12-02 14:26:20 +01:00
--newY;
}
}, this);
2020-03-26 12:29:38 +01:00
} else {
2020-12-02 14:26:20 +01:00
this.nodes.forEach(function(n, i) {
if (n.locked) {
return;
}
while (n.y > 0) {
var newY = n.y - 1;
var canBeMoved = i === 0;
if (i > 0) {
var collisionNode = this.nodes
.slice(0, i)
.find(Utils._didCollide, { n: n, newY: newY });
canBeMoved = collisionNode === undefined;
2020-03-26 12:29:38 +01:00
}
2020-12-02 14:26:20 +01:00
if (!canBeMoved) {
break;
2020-03-26 12:29:38 +01:00
}
2020-12-02 14:26:20 +01:00
// Note: must be dirty (from last position) for GridStack::OnChange CB to update positions
// and move items back. The user 'change' CB should detect changes from the original
// starting position instead.
n._dirty = n.y !== newY;
n.y = newY;
}
}, this);
2020-03-26 12:29:38 +01:00
}
};
GridStackEngine.prototype._prepareNode = function(node, resizing) {
2020-12-02 14:26:20 +01:00
node = node || {};
// if we're missing position, have the grid position us automatically (before we set them to 0,0)
if (
node.x === undefined ||
node.y === undefined ||
node.x === null ||
node.y === null
) {
node.autoPosition = true;
}
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
// assign defaults for missing required fields
var defaults = { width: 1, height: 1, x: 0, y: 0 };
node = Utils.defaults(node, defaults);
// convert any strings over
node.x = parseInt(node.x);
node.y = parseInt(node.y);
node.width = parseInt(node.width);
node.height = parseInt(node.height);
2020-03-26 12:29:38 +01:00
node.autoPosition = node.autoPosition || false;
node.noResize = node.noResize || false;
node.noMove = node.noMove || false;
2020-12-02 14:26:20 +01:00
// check for NaN (in case messed up strings were passed. can't do parseInt() || defaults.x above as 0 is valid #)
if (Number.isNaN(node.x)) {
node.x = defaults.x;
node.autoPosition = true;
}
if (Number.isNaN(node.y)) {
node.y = defaults.y;
node.autoPosition = true;
}
if (Number.isNaN(node.width)) {
node.width = defaults.width;
}
if (Number.isNaN(node.height)) {
node.height = defaults.height;
}
if (node.maxWidth !== undefined) {
node.width = Math.min(node.width, node.maxWidth);
}
if (node.maxHeight !== undefined) {
node.height = Math.min(node.height, node.maxHeight);
}
if (node.minWidth !== undefined) {
node.width = Math.max(node.width, node.minWidth);
}
if (node.minHeight !== undefined) {
node.height = Math.max(node.height, node.minHeight);
}
if (node.width > this.column) {
node.width = this.column;
2020-03-26 12:29:38 +01:00
} else if (node.width < 1) {
node.width = 1;
}
2020-12-02 14:26:20 +01:00
if (this.maxRow && node.height > this.maxRow) {
node.height = this.maxRow;
} else if (node.height < 1) {
2020-03-26 12:29:38 +01:00
node.height = 1;
}
if (node.x < 0) {
node.x = 0;
}
2020-12-02 14:26:20 +01:00
if (node.y < 0) {
node.y = 0;
}
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
if (node.x + node.width > this.column) {
2020-03-26 12:29:38 +01:00
if (resizing) {
2020-12-02 14:26:20 +01:00
node.width = this.column - node.x;
2020-03-26 12:29:38 +01:00
} else {
2020-12-02 14:26:20 +01:00
node.x = this.column - node.width;
2020-03-26 12:29:38 +01:00
}
}
2020-12-02 14:26:20 +01:00
if (this.maxRow && node.y + node.height > this.maxRow) {
if (resizing) {
node.height = this.maxRow - node.y;
} else {
node.y = this.maxRow - node.height;
}
2020-03-26 12:29:38 +01:00
}
return node;
};
GridStackEngine.prototype._notify = function() {
2020-12-02 14:26:20 +01:00
if (this._batchMode) {
2020-03-26 12:29:38 +01:00
return;
}
2020-12-02 14:26:20 +01:00
var args = Array.prototype.slice.call(arguments, 0);
args[0] =
args[0] === undefined ? [] : Array.isArray(args[0]) ? args[0] : [args[0]];
args[1] = args[1] === undefined ? true : args[1];
var dirtyNodes = args[0].concat(this.getDirtyNodes());
this.onchange(dirtyNodes, args[1]);
2020-03-26 12:29:38 +01:00
};
GridStackEngine.prototype.cleanNodes = function() {
2020-12-02 14:26:20 +01:00
if (this._batchMode) {
2020-03-26 12:29:38 +01:00
return;
}
2020-12-02 14:26:20 +01:00
this.nodes.forEach(function(n) {
delete n._dirty;
2020-03-26 12:29:38 +01:00
});
};
2020-12-02 14:26:20 +01:00
GridStackEngine.prototype.getDirtyNodes = function(verify) {
// compare original X,Y,W,H (or entire node?) instead as _dirty can be a temporary state
if (verify) {
var dirtNodes = [];
this.nodes.forEach(function(n) {
if (n._dirty) {
if (
n.y === n._origY &&
n.x === n._origX &&
n.width === n._origW &&
n.height === n._origH
) {
delete n._dirty;
} else {
dirtNodes.push(n);
}
}
});
return dirtNodes;
}
return this.nodes.filter(function(n) {
2020-03-26 12:29:38 +01:00
return n._dirty;
});
};
GridStackEngine.prototype.addNode = function(node, triggerAddEvent) {
node = this._prepareNode(node);
2020-12-02 14:26:20 +01:00
node._id = node._id || ++idSeq;
2020-03-26 12:29:38 +01:00
if (node.autoPosition) {
this._sortNodes();
for (var i = 0; ; ++i) {
2020-12-02 14:26:20 +01:00
var x = i % this.column;
var y = Math.floor(i / this.column);
if (x + node.width > this.column) {
2020-03-26 12:29:38 +01:00
continue;
}
if (
2020-12-02 14:26:20 +01:00
!this.nodes.find(Utils._isAddNodeIntercepted, {
x: x,
y: y,
node: node
})
2020-03-26 12:29:38 +01:00
) {
node.x = x;
node.y = y;
2020-12-02 14:26:20 +01:00
delete node.autoPosition; // found our slot
2020-03-26 12:29:38 +01:00
break;
}
}
}
this.nodes.push(node);
2020-12-02 14:26:20 +01:00
if (triggerAddEvent) {
this._addedNodes.push(node);
2020-03-26 12:29:38 +01:00
}
this._fixCollisions(node);
this._packNodes();
this._notify();
return node;
};
GridStackEngine.prototype.removeNode = function(node, detachNode) {
2020-12-02 14:26:20 +01:00
detachNode = detachNode === undefined ? true : detachNode;
this._removedNodes.push(node);
node._id = null; // hint that node is being removed
this.nodes = Utils.without(this.nodes, node);
2020-03-26 12:29:38 +01:00
this._packNodes();
this._notify(node, detachNode);
};
2020-12-02 14:26:20 +01:00
GridStackEngine.prototype.removeAll = function(detachNode) {
delete this._layouts;
if (this.nodes.length === 0) {
return;
}
detachNode = detachNode === undefined ? true : detachNode;
this.nodes.forEach(function(n) {
n._id = null;
}); // hint that node is being removed
this._removedNodes = this.nodes;
this.nodes = [];
this._notify(this._removedNodes, detachNode);
};
2020-03-26 12:29:38 +01:00
GridStackEngine.prototype.canMoveNode = function(node, x, y, width, height) {
if (!this.isNodeChangedPosition(node, x, y, width, height)) {
return false;
}
var hasLocked = Boolean(
2020-12-02 14:26:20 +01:00
this.nodes.find(function(n) {
2020-03-26 12:29:38 +01:00
return n.locked;
})
);
2020-12-02 14:26:20 +01:00
if (!this.maxRow && !hasLocked) {
2020-03-26 12:29:38 +01:00
return true;
}
var clonedNode;
var clone = new GridStackEngine(
2020-12-02 14:26:20 +01:00
this.column,
2020-03-26 12:29:38 +01:00
null,
this.float,
0,
2020-12-02 14:26:20 +01:00
this.nodes.map(function(n) {
if (n === node) {
2020-03-26 12:29:38 +01:00
clonedNode = $.extend({}, n);
return clonedNode;
}
return $.extend({}, n);
})
);
2020-12-02 14:26:20 +01:00
if (!clonedNode) {
2020-03-26 12:29:38 +01:00
return true;
}
clone.moveNode(clonedNode, x, y, width, height);
var res = true;
if (hasLocked) {
res &= !Boolean(
2020-12-02 14:26:20 +01:00
clone.nodes.find(function(n) {
return n !== clonedNode && Boolean(n.locked) && Boolean(n._dirty);
2020-03-26 12:29:38 +01:00
})
);
}
2020-12-02 14:26:20 +01:00
if (this.maxRow) {
res &= clone.getRow() <= this.maxRow;
2020-03-26 12:29:38 +01:00
}
return res;
};
GridStackEngine.prototype.canBePlacedWithRespectToHeight = function(node) {
2020-12-02 14:26:20 +01:00
if (!this.maxRow) {
2020-03-26 12:29:38 +01:00
return true;
}
var clone = new GridStackEngine(
2020-12-02 14:26:20 +01:00
this.column,
2020-03-26 12:29:38 +01:00
null,
this.float,
0,
2020-12-02 14:26:20 +01:00
this.nodes.map(function(n) {
2020-03-26 12:29:38 +01:00
return $.extend({}, n);
})
);
clone.addNode(node);
2020-12-02 14:26:20 +01:00
return clone.getRow() <= this.maxRow;
2020-03-26 12:29:38 +01:00
};
GridStackEngine.prototype.isNodeChangedPosition = function(
node,
x,
y,
width,
height
) {
2020-12-02 14:26:20 +01:00
if (typeof x !== "number") {
2020-03-26 12:29:38 +01:00
x = node.x;
}
2020-12-02 14:26:20 +01:00
if (typeof y !== "number") {
2020-03-26 12:29:38 +01:00
y = node.y;
}
2020-12-02 14:26:20 +01:00
if (typeof width !== "number") {
2020-03-26 12:29:38 +01:00
width = node.width;
}
2020-12-02 14:26:20 +01:00
if (typeof height !== "number") {
2020-03-26 12:29:38 +01:00
height = node.height;
}
2020-12-02 14:26:20 +01:00
if (node.maxWidth !== undefined) {
2020-03-26 12:29:38 +01:00
width = Math.min(width, node.maxWidth);
}
2020-12-02 14:26:20 +01:00
if (node.maxHeight !== undefined) {
2020-03-26 12:29:38 +01:00
height = Math.min(height, node.maxHeight);
}
2020-12-02 14:26:20 +01:00
if (node.minWidth !== undefined) {
2020-03-26 12:29:38 +01:00
width = Math.max(width, node.minWidth);
}
2020-12-02 14:26:20 +01:00
if (node.minHeight !== undefined) {
2020-03-26 12:29:38 +01:00
height = Math.max(height, node.minHeight);
}
if (
2020-12-02 14:26:20 +01:00
node.x === x &&
node.y === y &&
node.width === width &&
node.height === height
2020-03-26 12:29:38 +01:00
) {
return false;
}
return true;
};
GridStackEngine.prototype.moveNode = function(
node,
x,
y,
width,
height,
noPack
) {
2020-12-02 14:26:20 +01:00
if (node.locked) {
return null;
2020-03-26 12:29:38 +01:00
}
2020-12-02 14:26:20 +01:00
if (typeof x !== "number") {
2020-03-26 12:29:38 +01:00
x = node.x;
}
2020-12-02 14:26:20 +01:00
if (typeof y !== "number") {
2020-03-26 12:29:38 +01:00
y = node.y;
}
2020-12-02 14:26:20 +01:00
if (typeof width !== "number") {
2020-03-26 12:29:38 +01:00
width = node.width;
}
2020-12-02 14:26:20 +01:00
if (typeof height !== "number") {
2020-03-26 12:29:38 +01:00
height = node.height;
}
2020-12-02 14:26:20 +01:00
// constrain the passed in values and check if we're still changing our node
var resizing = node.width !== width || node.height !== height;
var nn = {
x: x,
y: y,
width: width,
height: height,
maxWidth: node.maxWidth,
maxHeight: node.maxHeight,
minWidth: node.minWidth,
minHeight: node.minHeight
};
nn = this._prepareNode(nn, resizing);
2020-03-26 12:29:38 +01:00
if (
2020-12-02 14:26:20 +01:00
node.x === nn.x &&
node.y === nn.y &&
node.width === nn.width &&
node.height === nn.height
2020-03-26 12:29:38 +01:00
) {
2020-12-02 14:26:20 +01:00
return null;
2020-03-26 12:29:38 +01:00
}
node._dirty = true;
2020-12-02 14:26:20 +01:00
node.x = node.lastTriedX = nn.x;
node.y = node.lastTriedY = nn.y;
node.width = node.lastTriedWidth = nn.width;
node.height = node.lastTriedHeight = nn.height;
2020-03-26 12:29:38 +01:00
this._fixCollisions(node);
if (!noPack) {
this._packNodes();
this._notify();
}
return node;
};
2020-12-02 14:26:20 +01:00
GridStackEngine.prototype.getRow = function() {
return this.nodes.reduce(function(memo, n) {
return Math.max(memo, n.y + n.height);
}, 0);
2020-03-26 12:29:38 +01:00
};
GridStackEngine.prototype.beginUpdate = function(node) {
2020-12-02 14:26:20 +01:00
if (node._updating) return;
2020-03-26 12:29:38 +01:00
node._updating = true;
2020-12-02 14:26:20 +01:00
this.nodes.forEach(function(n) {
n._packY = n.y;
});
2020-03-26 12:29:38 +01:00
};
GridStackEngine.prototype.endUpdate = function() {
2020-12-02 14:26:20 +01:00
var n = this.nodes.find(function(n) {
2020-03-26 12:29:38 +01:00
return n._updating;
});
if (n) {
n._updating = false;
2020-12-02 14:26:20 +01:00
this.nodes.forEach(function(n) {
delete n._packY;
});
2020-03-26 12:29:38 +01:00
}
};
2020-12-02 14:26:20 +01:00
/**
* Construct a grid item from the given element and options
* @param {GridStackElement} el
* @param {GridstackOptions} opts
*/
2020-03-26 12:29:38 +01:00
var GridStack = function(el, opts) {
var self = this;
2020-12-02 14:26:20 +01:00
var oneColumnMode, _prevColumn, isAutoCellHeight;
2020-03-26 12:29:38 +01:00
opts = opts || {};
2020-12-02 14:26:20 +01:00
this.$el = $(el); // TODO: legacy code
this.el = this.$el.get(0); // exposed HTML element to the user
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
obsoleteOpts(opts, "width", "column", "v0.5.3");
obsoleteOpts(opts, "height", "maxRow", "v0.5.3");
obsoleteOptsDel(
opts,
"oneColumnModeClass",
"v0.6.3",
". Use class `.grid-stack-1` instead"
);
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
// container attributes
obsoleteAttr(this.$el, "data-gs-width", "data-gs-column", "v0.5.3");
obsoleteAttr(this.$el, "data-gs-height", "data-gs-max-row", "v0.5.3");
obsoleteAttr(
this.$el,
"data-gs-current-height",
"data-gs-current-row",
"v1.0.0"
);
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
opts.itemClass = opts.itemClass || "grid-stack-item";
var isNested = this.$el.closest("." + opts.itemClass).length > 0;
// if row property exists, replace minRow and maxRow instead
if (opts.row) {
opts.minRow = opts.maxRow = opts.row;
delete opts.row;
}
var rowAttr = parseInt(this.$el.attr("data-gs-row"));
// elements attributes override any passed options (like CSS style) - merge the two together
this.opts = Utils.defaults(opts, {
column: parseInt(this.$el.attr("data-gs-column")) || 12,
minRow: rowAttr
? rowAttr
: parseInt(this.$el.attr("data-gs-min-row")) || 0,
maxRow: rowAttr
? rowAttr
: parseInt(this.$el.attr("data-gs-max-row")) || 0,
2020-03-26 12:29:38 +01:00
itemClass: "grid-stack-item",
placeholderClass: "grid-stack-placeholder",
placeholderText: "",
handle: ".grid-stack-item-content",
handleClass: null,
2020-12-02 14:26:20 +01:00
styleInHead: false,
2020-03-26 12:29:38 +01:00
cellHeight: 60,
verticalMargin: 20,
auto: true,
minWidth: 768,
float: false,
staticGrid: false,
_class: "grid-stack-instance-" + (Math.random() * 10000).toFixed(0),
2020-12-02 14:26:20 +01:00
animate: Boolean(this.$el.attr("data-gs-animate")) || false,
2020-03-26 12:29:38 +01:00
alwaysShowResizeHandle: opts.alwaysShowResizeHandle || false,
2020-12-02 14:26:20 +01:00
resizable: Utils.defaults(opts.resizable || {}, {
2020-03-26 12:29:38 +01:00
autoHide: !(opts.alwaysShowResizeHandle || false),
handles: "se"
}),
2020-12-02 14:26:20 +01:00
draggable: Utils.defaults(opts.draggable || {}, {
2020-03-26 12:29:38 +01:00
handle:
(opts.handleClass
? "." + opts.handleClass
: opts.handle
? opts.handle
: "") || ".grid-stack-item-content",
scroll: false,
appendTo: "body"
}),
disableDrag: opts.disableDrag || false,
disableResize: opts.disableResize || false,
rtl: "auto",
removable: false,
2020-12-02 14:26:20 +01:00
removableOptions: Utils.defaults(opts.removableOptions || {}, {
accept: "." + opts.itemClass
}),
2020-03-26 12:29:38 +01:00
removeTimeout: 2000,
verticalMarginUnit: "px",
cellHeightUnit: "px",
disableOneColumnMode: opts.disableOneColumnMode || false,
2020-12-02 14:26:20 +01:00
oneColumnModeDomSort: opts.oneColumnModeDomSort,
2020-03-26 12:29:38 +01:00
ddPlugin: null
});
if (this.opts.ddPlugin === false) {
this.opts.ddPlugin = GridStackDragDropPlugin;
} else if (this.opts.ddPlugin === null) {
this.opts.ddPlugin =
2020-12-02 14:26:20 +01:00
GridStackDragDropPlugin.registeredPlugins[0] || GridStackDragDropPlugin;
2020-03-26 12:29:38 +01:00
}
this.dd = new this.opts.ddPlugin(this);
if (this.opts.rtl === "auto") {
2020-12-02 14:26:20 +01:00
this.opts.rtl = this.$el.css("direction") === "rtl";
2020-03-26 12:29:38 +01:00
}
if (this.opts.rtl) {
2020-12-02 14:26:20 +01:00
this.$el.addClass("grid-stack-rtl");
2020-03-26 12:29:38 +01:00
}
this.opts.isNested = isNested;
isAutoCellHeight = this.opts.cellHeight === "auto";
if (isAutoCellHeight) {
2020-12-02 14:26:20 +01:00
// make the cell square initially
2020-03-26 12:29:38 +01:00
self.cellHeight(self.cellWidth(), true);
} else {
this.cellHeight(this.opts.cellHeight, true);
}
this.verticalMargin(this.opts.verticalMargin, true);
2020-12-02 14:26:20 +01:00
this.$el.addClass(this.opts._class);
2020-03-26 12:29:38 +01:00
this._setStaticClass();
if (isNested) {
2020-12-02 14:26:20 +01:00
this.$el.addClass("grid-stack-nested");
2020-03-26 12:29:38 +01:00
}
this._initStyles();
2020-12-02 14:26:20 +01:00
this.engine = new GridStackEngine(
this.opts.column,
2020-03-26 12:29:38 +01:00
function(nodes, detachNode) {
2020-12-02 14:26:20 +01:00
detachNode = detachNode === undefined ? true : detachNode;
2020-03-26 12:29:38 +01:00
var maxHeight = 0;
2020-12-02 14:26:20 +01:00
this.nodes.forEach(function(n) {
maxHeight = Math.max(maxHeight, n.y + n.height);
});
nodes.forEach(function(n) {
2020-03-26 12:29:38 +01:00
if (detachNode && n._id === null) {
if (n.el) {
2020-12-02 14:26:20 +01:00
$(n.el).remove();
2020-03-26 12:29:38 +01:00
}
} else {
2020-12-02 14:26:20 +01:00
$(n.el)
2020-03-26 12:29:38 +01:00
.attr("data-gs-x", n.x)
.attr("data-gs-y", n.y)
.attr("data-gs-width", n.width)
.attr("data-gs-height", n.height);
}
});
self._updateStyles(maxHeight + 10);
},
this.opts.float,
2020-12-02 14:26:20 +01:00
this.opts.maxRow
2020-03-26 12:29:38 +01:00
);
if (this.opts.auto) {
var elements = [];
var _this = this;
2020-12-02 14:26:20 +01:00
this.$el
2020-03-26 12:29:38 +01:00
.children(
"." +
this.opts.itemClass +
":not(." +
this.opts.placeholderClass +
")"
)
.each(function(index, el) {
el = $(el);
2020-12-02 14:26:20 +01:00
var x = parseInt(el.attr("data-gs-x"));
var y = parseInt(el.attr("data-gs-y"));
2020-03-26 12:29:38 +01:00
elements.push({
2020-12-02 14:26:20 +01:00
el: el.get(0),
// if x,y are missing (autoPosition) add them to end of list - but keep their respective DOM order
2020-03-26 12:29:38 +01:00
i:
2020-12-02 14:26:20 +01:00
(Number.isNaN(x) ? 1000 : x) +
(Number.isNaN(y) ? 1000 : y) * _this.opts.column
2020-03-26 12:29:38 +01:00
});
});
2020-12-02 14:26:20 +01:00
Utils.sortBy(elements, function(x) {
return x.i;
}).forEach(function(item) {
this._prepareElement(item.el);
}, this);
2020-03-26 12:29:38 +01:00
}
2020-12-02 14:26:20 +01:00
this.engine._saveInitial(); // initial start of items
2020-03-26 12:29:38 +01:00
this.setAnimation(this.opts.animate);
this.placeholder = $(
'<div class="' +
this.opts.placeholderClass +
" " +
this.opts.itemClass +
'">' +
'<div class="placeholder-content">' +
this.opts.placeholderText +
"</div></div>"
).hide();
this._updateContainerHeight();
2020-12-02 14:26:20 +01:00
this._updateHeightsOnResize = Utils.throttle(function() {
2020-03-26 12:29:38 +01:00
self.cellHeight(self.cellWidth(), false);
}, 100);
2020-12-02 14:26:20 +01:00
/**
* called when we are being resized - check if the one Column Mode needs to be turned on/off
* and remember the prev columns we used.
*/
2020-03-26 12:29:38 +01:00
this.onResizeHandler = function() {
if (isAutoCellHeight) {
self._updateHeightsOnResize();
}
2020-12-02 14:26:20 +01:00
if (
!self.opts.disableOneColumnMode &&
(window.innerWidth ||
document.documentElement.clientWidth ||
document.body.clientWidth) <= self.opts.minWidth
) {
if (self.oneColumnMode) {
2020-03-26 12:29:38 +01:00
return;
}
2020-12-02 14:26:20 +01:00
self.oneColumnMode = true;
self.column(1);
2020-03-26 12:29:38 +01:00
} else {
2020-12-02 14:26:20 +01:00
if (!self.oneColumnMode) {
2020-03-26 12:29:38 +01:00
return;
}
2020-12-02 14:26:20 +01:00
self.oneColumnMode = false;
self.column(self._prevColumn);
2020-03-26 12:29:38 +01:00
}
};
$(window).resize(this.onResizeHandler);
this.onResizeHandler();
if (!self.opts.staticGrid && typeof self.opts.removable === "string") {
var trashZone = $(self.opts.removable);
if (!this.dd.isDroppable(trashZone)) {
2020-12-02 14:26:20 +01:00
this.dd.droppable(trashZone, self.opts.removableOptions);
2020-03-26 12:29:38 +01:00
}
this.dd
.on(trashZone, "dropover", function(event, ui) {
var el = $(ui.draggable);
var node = el.data("_gridstack_node");
2020-12-02 14:26:20 +01:00
if (!node || node._grid !== self) {
2020-03-26 12:29:38 +01:00
return;
}
2020-12-02 14:26:20 +01:00
el.data("inTrashZone", true);
2020-03-26 12:29:38 +01:00
self._setupRemovingTimeout(el);
})
.on(trashZone, "dropout", function(event, ui) {
var el = $(ui.draggable);
var node = el.data("_gridstack_node");
2020-12-02 14:26:20 +01:00
if (!node || node._grid !== self) {
2020-03-26 12:29:38 +01:00
return;
}
2020-12-02 14:26:20 +01:00
el.data("inTrashZone", false);
2020-03-26 12:29:38 +01:00
self._clearRemovingTimeout(el);
});
}
if (!self.opts.staticGrid && self.opts.acceptWidgets) {
var draggingElement = null;
var onDrag = function(event, ui) {
var el = draggingElement;
var node = el.data("_gridstack_node");
2020-12-02 14:26:20 +01:00
var pos = self.getCellFromPixel(
{ left: event.pageX, top: event.pageY },
true
);
2020-03-26 12:29:38 +01:00
var x = Math.max(0, pos.x);
var y = Math.max(0, pos.y);
if (!node._added) {
node._added = true;
2020-12-02 14:26:20 +01:00
node.el = el.get(0);
node.autoPosition = true;
2020-03-26 12:29:38 +01:00
node.x = x;
node.y = y;
2020-12-02 14:26:20 +01:00
self.engine.cleanNodes();
self.engine.beginUpdate(node);
self.engine.addNode(node);
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
self.$el.append(self.placeholder);
2020-03-26 12:29:38 +01:00
self.placeholder
.attr("data-gs-x", node.x)
.attr("data-gs-y", node.y)
.attr("data-gs-width", node.width)
.attr("data-gs-height", node.height)
.show();
2020-12-02 14:26:20 +01:00
node.el = self.placeholder.get(0);
2020-03-26 12:29:38 +01:00
node._beforeDragX = node.x;
node._beforeDragY = node.y;
self._updateContainerHeight();
}
2020-12-02 14:26:20 +01:00
if (!self.engine.canMoveNode(node, x, y)) {
return;
}
self.engine.moveNode(node, x, y);
self._updateContainerHeight();
2020-03-26 12:29:38 +01:00
};
this.dd
2020-12-02 14:26:20 +01:00
.droppable(self.$el, {
2020-03-26 12:29:38 +01:00
accept: function(el) {
el = $(el);
var node = el.data("_gridstack_node");
if (node && node._grid === self) {
return false;
}
return el.is(
self.opts.acceptWidgets === true
? ".grid-stack-item"
: self.opts.acceptWidgets
);
}
})
2020-12-02 14:26:20 +01:00
.on(self.$el, "dropover", function(event, ui) {
2020-03-26 12:29:38 +01:00
var el = $(ui.draggable);
2020-12-02 14:26:20 +01:00
var width, height;
// see if we already have a node with widget/height and check for attributes
2020-03-26 12:29:38 +01:00
var origNode = el.data("_gridstack_node");
2020-12-02 14:26:20 +01:00
if (!origNode || !origNode.width || !origNode.height) {
var w = parseInt(el.attr("data-gs-width"));
if (w > 0) {
origNode = origNode || {};
origNode.width = w;
}
var h = parseInt(el.attr("data-gs-height"));
if (h > 0) {
origNode = origNode || {};
origNode.height = h;
}
}
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
// if not calculate the grid size based on element outer size
// height: Each row is cellHeight + verticalMargin, until last one which has no margin below
var cellWidth = self.cellWidth();
var cellHeight = self.cellHeight();
var verticalMargin = self.opts.verticalMargin;
width =
origNode && origNode.width
? origNode.width
: Math.ceil(el.outerWidth() / cellWidth);
height =
origNode && origNode.height
? origNode.height
: Math.round(
(el.outerHeight() + verticalMargin) /
(cellHeight + verticalMargin)
);
2020-03-26 12:29:38 +01:00
draggingElement = el;
2020-12-02 14:26:20 +01:00
var node = self.engine._prepareNode({
2020-03-26 12:29:38 +01:00
width: width,
height: height,
_added: false,
_temporary: true
});
2020-12-02 14:26:20 +01:00
node.isOutOfGrid = true;
2020-03-26 12:29:38 +01:00
el.data("_gridstack_node", node);
el.data("_gridstack_node_orig", origNode);
el.on("drag", onDrag);
2020-12-02 14:26:20 +01:00
return false; // prevent parent from receiving msg (which may be grid as well)
2020-03-26 12:29:38 +01:00
})
2020-12-02 14:26:20 +01:00
.on(self.$el, "dropout", function(event, ui) {
// jquery-ui bug. Must verify widget is being dropped out
// check node variable that gets set when widget is out of grid
2020-03-26 12:29:38 +01:00
var el = $(ui.draggable);
2020-12-02 14:26:20 +01:00
if (!el.data("_gridstack_node")) {
return;
}
2020-03-26 12:29:38 +01:00
var node = el.data("_gridstack_node");
2020-12-02 14:26:20 +01:00
if (!node.isOutOfGrid) {
return;
}
el.unbind("drag", onDrag);
2020-03-26 12:29:38 +01:00
node.el = null;
2020-12-02 14:26:20 +01:00
self.engine.removeNode(node);
2020-03-26 12:29:38 +01:00
self.placeholder.detach();
self._updateContainerHeight();
el.data("_gridstack_node", el.data("_gridstack_node_orig"));
2020-12-02 14:26:20 +01:00
return false; // prevent parent from receiving msg (which may be grid as well)
2020-03-26 12:29:38 +01:00
})
2020-12-02 14:26:20 +01:00
.on(self.$el, "drop", function(event, ui) {
2020-03-26 12:29:38 +01:00
self.placeholder.detach();
var node = $(ui.draggable).data("_gridstack_node");
2020-12-02 14:26:20 +01:00
node.isOutOfGrid = false;
2020-03-26 12:29:38 +01:00
node._grid = self;
var el = $(ui.draggable).clone(false);
el.data("_gridstack_node", node);
var originalNode = $(ui.draggable).data("_gridstack_node_orig");
2020-12-02 14:26:20 +01:00
if (originalNode !== undefined && originalNode._grid !== undefined) {
2020-03-26 12:29:38 +01:00
originalNode._grid._triggerRemoveEvent();
}
2020-12-02 14:26:20 +01:00
$(ui.helper).remove();
node.el = el.get(0);
2020-03-26 12:29:38 +01:00
self.placeholder.hide();
2020-12-02 14:26:20 +01:00
Utils.removePositioningStyles(el);
el.find("div.ui-resizable-handle").remove();
2020-03-26 12:29:38 +01:00
el.attr("data-gs-x", node.x)
.attr("data-gs-y", node.y)
.attr("data-gs-width", node.width)
.attr("data-gs-height", node.height)
.addClass(self.opts.itemClass)
.enableSelection()
.removeData("draggable")
.removeClass(
"ui-draggable ui-draggable-dragging ui-draggable-disabled"
)
.unbind("drag", onDrag);
2020-12-02 14:26:20 +01:00
self.$el.append(el);
2020-03-26 12:29:38 +01:00
self._prepareElementsByNode(el, node);
self._updateContainerHeight();
2020-12-02 14:26:20 +01:00
self.engine._addedNodes.push(node);
2020-03-26 12:29:38 +01:00
self._triggerAddEvent();
self._triggerChangeEvent();
2020-12-02 14:26:20 +01:00
self.engine.endUpdate();
$(ui.draggable).unbind("drag", onDrag);
$(ui.draggable).removeData("_gridstack_node");
$(ui.draggable).removeData("_gridstack_node_orig");
self.$el.trigger("dropped", [originalNode, node]);
return false; // prevent parent from receiving msg (which may be grid as well)
2020-03-26 12:29:38 +01:00
});
}
};
2020-12-02 14:26:20 +01:00
GridStack.prototype._triggerChangeEvent = function(/*forceTrigger*/) {
if (this.engine._batchMode) {
return;
2020-03-26 12:29:38 +01:00
}
2020-12-02 14:26:20 +01:00
var elements = this.engine.getDirtyNodes(true); // verify they really changed
if (elements && elements.length) {
this.engine._layoutsNodesChange(elements);
this._triggerEvent("change", elements);
2020-03-26 12:29:38 +01:00
}
2020-12-02 14:26:20 +01:00
this.engine._saveInitial(); // we called, now reset initial values & dirty flags
2020-03-26 12:29:38 +01:00
};
GridStack.prototype._triggerAddEvent = function() {
2020-12-02 14:26:20 +01:00
if (this.engine._batchMode) {
return;
}
if (this.engine._addedNodes && this.engine._addedNodes.length > 0) {
this.engine._layoutsNodesChange(this.engine._addedNodes);
// prevent added nodes from also triggering 'change' event (which is called next)
this.engine._addedNodes.forEach(function(n) {
delete n._dirty;
});
this._triggerEvent("added", this.engine._addedNodes);
this.engine._addedNodes = [];
2020-03-26 12:29:38 +01:00
}
};
GridStack.prototype._triggerRemoveEvent = function() {
2020-12-02 14:26:20 +01:00
if (this.engine._batchMode) {
return;
2020-03-26 12:29:38 +01:00
}
2020-12-02 14:26:20 +01:00
if (this.engine._removedNodes && this.engine._removedNodes.length > 0) {
this._triggerEvent("removed", this.engine._removedNodes);
this.engine._removedNodes = [];
}
};
GridStack.prototype._triggerEvent = function(name, data) {
var event = new CustomEvent(name, { detail: data });
this.el.dispatchEvent(event);
2020-03-26 12:29:38 +01:00
};
GridStack.prototype._initStyles = function() {
if (this._stylesId) {
Utils.removeStylesheet(this._stylesId);
}
this._stylesId = "gridstack-style-" + (Math.random() * 100000).toFixed();
2020-12-02 14:26:20 +01:00
var styleLocation = this.opts.styleInHead ? undefined : this.el.parentNode;
// if styleInHead === false insert style to parent to support WebComponent
this._styles = Utils.createStylesheet(this._stylesId, styleLocation);
2020-03-26 12:29:38 +01:00
if (this._styles !== null) {
this._styles._max = 0;
}
};
GridStack.prototype._updateStyles = function(maxHeight) {
2020-12-02 14:26:20 +01:00
if (this._styles === null || this._styles === undefined) {
2020-03-26 12:29:38 +01:00
return;
}
var prefix = "." + this.opts._class + " ." + this.opts.itemClass;
var self = this;
var getHeight;
2020-12-02 14:26:20 +01:00
if (maxHeight === undefined) {
2020-03-26 12:29:38 +01:00
maxHeight = this._styles._max;
}
2020-12-02 14:26:20 +01:00
2020-03-26 12:29:38 +01:00
this._initStyles();
this._updateContainerHeight();
if (!this.opts.cellHeight) {
// The rest will be handled by CSS
return;
}
if (this._styles._max !== 0 && maxHeight <= this._styles._max) {
2020-12-02 14:26:20 +01:00
// Keep this._styles._max increasing
2020-03-26 12:29:38 +01:00
return;
}
if (
!this.opts.verticalMargin ||
this.opts.cellHeightUnit === this.opts.verticalMarginUnit
) {
getHeight = function(nbRows, nbMargins) {
return (
self.opts.cellHeight * nbRows +
self.opts.verticalMargin * nbMargins +
self.opts.cellHeightUnit
);
};
} else {
getHeight = function(nbRows, nbMargins) {
if (!nbRows || !nbMargins) {
return (
self.opts.cellHeight * nbRows +
self.opts.verticalMargin * nbMargins +
self.opts.cellHeightUnit
);
}
return (
"calc(" +
(self.opts.cellHeight * nbRows + self.opts.cellHeightUnit) +
" + " +
(self.opts.verticalMargin * nbMargins +
self.opts.verticalMarginUnit) +
")"
);
};
}
if (this._styles._max === 0) {
Utils.insertCSSRule(
this._styles,
prefix,
"min-height: " + getHeight(1, 0) + ";",
0
);
}
if (maxHeight > this._styles._max) {
for (var i = this._styles._max; i < maxHeight; ++i) {
Utils.insertCSSRule(
this._styles,
prefix + '[data-gs-height="' + (i + 1) + '"]',
"height: " + getHeight(i + 1, i) + ";",
i
);
Utils.insertCSSRule(
this._styles,
prefix + '[data-gs-min-height="' + (i + 1) + '"]',
"min-height: " + getHeight(i + 1, i) + ";",
i
);
Utils.insertCSSRule(
this._styles,
prefix + '[data-gs-max-height="' + (i + 1) + '"]',
"max-height: " + getHeight(i + 1, i) + ";",
i
);
Utils.insertCSSRule(
this._styles,
prefix + '[data-gs-y="' + i + '"]',
"top: " + getHeight(i, i) + ";",
i
);
}
this._styles._max = maxHeight;
}
};
GridStack.prototype._updateContainerHeight = function() {
2020-12-02 14:26:20 +01:00
if (this.engine._batchMode) {
2020-03-26 12:29:38 +01:00
return;
}
2020-12-02 14:26:20 +01:00
var row = this.engine.getRow();
if (row < this.opts.minRow) {
row = this.opts.minRow;
}
// check for css min height. Each row is cellHeight + verticalMargin, until last one which has no margin below
var cssMinHeight = parseInt(this.$el.css("min-height"));
if (cssMinHeight > 0) {
var verticalMargin = this.opts.verticalMargin;
var minRow = Math.round(
(cssMinHeight + verticalMargin) / (this.cellHeight() + verticalMargin)
);
if (row < minRow) {
row = minRow;
}
}
this.$el.attr("data-gs-current-row", row);
2020-03-26 12:29:38 +01:00
if (!this.opts.cellHeight) {
return;
}
if (!this.opts.verticalMargin) {
2020-12-02 14:26:20 +01:00
this.$el.css(
2020-03-26 12:29:38 +01:00
"height",
2020-12-02 14:26:20 +01:00
row * this.opts.cellHeight + this.opts.cellHeightUnit
2020-03-26 12:29:38 +01:00
);
} else if (this.opts.cellHeightUnit === this.opts.verticalMarginUnit) {
2020-12-02 14:26:20 +01:00
this.$el.css(
2020-03-26 12:29:38 +01:00
"height",
2020-12-02 14:26:20 +01:00
row * (this.opts.cellHeight + this.opts.verticalMargin) -
2020-03-26 12:29:38 +01:00
this.opts.verticalMargin +
this.opts.cellHeightUnit
);
} else {
2020-12-02 14:26:20 +01:00
this.$el.css(
2020-03-26 12:29:38 +01:00
"height",
"calc(" +
2020-12-02 14:26:20 +01:00
(row * this.opts.cellHeight + this.opts.cellHeightUnit) +
2020-03-26 12:29:38 +01:00
" + " +
2020-12-02 14:26:20 +01:00
(row * (this.opts.verticalMargin - 1) +
2020-03-26 12:29:38 +01:00
this.opts.verticalMarginUnit) +
")"
);
}
};
GridStack.prototype._setupRemovingTimeout = function(el) {
var self = this;
var node = $(el).data("_gridstack_node");
if (node._removeTimeout || !self.opts.removable) {
return;
}
node._removeTimeout = setTimeout(function() {
el.addClass("grid-stack-item-removing");
node._isAboutToRemove = true;
}, self.opts.removeTimeout);
};
GridStack.prototype._clearRemovingTimeout = function(el) {
var node = $(el).data("_gridstack_node");
if (!node._removeTimeout) {
return;
}
clearTimeout(node._removeTimeout);
node._removeTimeout = null;
el.removeClass("grid-stack-item-removing");
node._isAboutToRemove = false;
};
GridStack.prototype._prepareElementsByNode = function(el, node) {
var self = this;
var cellWidth;
2020-12-02 14:26:20 +01:00
var cellFullHeight; // internal cellHeight + v-margin
2020-03-26 12:29:38 +01:00
var dragOrResize = function(event, ui) {
var x = Math.round(ui.position.left / cellWidth);
2020-12-02 14:26:20 +01:00
var y = Math.floor(
(ui.position.top + cellFullHeight / 2) / cellFullHeight
);
2020-03-26 12:29:38 +01:00
var width;
var height;
2020-12-02 14:26:20 +01:00
if (event.type === "drag") {
var distance = ui.position.top - node._prevYPix;
node._prevYPix = ui.position.top;
Utils.updateScrollPosition(el[0], ui, distance);
2020-03-26 12:29:38 +01:00
if (
2020-12-02 14:26:20 +01:00
el.data("inTrashZone") ||
2020-03-26 12:29:38 +01:00
x < 0 ||
2020-12-02 14:26:20 +01:00
x >= self.engine.column ||
2020-03-26 12:29:38 +01:00
y < 0 ||
2020-12-02 14:26:20 +01:00
(!self.engine.float && y > self.engine.getRow())
2020-03-26 12:29:38 +01:00
) {
if (!node._temporaryRemoved) {
if (self.opts.removable === true) {
self._setupRemovingTimeout(el);
}
x = node._beforeDragX;
y = node._beforeDragY;
self.placeholder.detach();
self.placeholder.hide();
2020-12-02 14:26:20 +01:00
self.engine.removeNode(node);
2020-03-26 12:29:38 +01:00
self._updateContainerHeight();
node._temporaryRemoved = true;
2020-12-02 14:26:20 +01:00
} else {
return;
2020-03-26 12:29:38 +01:00
}
} else {
self._clearRemovingTimeout(el);
if (node._temporaryRemoved) {
2020-12-02 14:26:20 +01:00
self.engine.addNode(node);
2020-03-26 12:29:38 +01:00
self.placeholder
.attr("data-gs-x", x)
.attr("data-gs-y", y)
.attr("data-gs-width", width)
.attr("data-gs-height", height)
.show();
2020-12-02 14:26:20 +01:00
self.$el.append(self.placeholder);
node.el = self.placeholder.get(0);
2020-03-26 12:29:38 +01:00
node._temporaryRemoved = false;
}
}
2020-12-02 14:26:20 +01:00
} else if (event.type === "resize") {
if (x < 0) return;
width = Math.round(ui.size.width / cellWidth);
height = Math.round(
(ui.size.height + self.verticalMargin()) / cellFullHeight
);
2020-03-26 12:29:38 +01:00
}
// width and height are undefined if not resizing
2020-12-02 14:26:20 +01:00
var lastTriedWidth = width !== undefined ? width : node.lastTriedWidth;
2020-03-26 12:29:38 +01:00
var lastTriedHeight =
2020-12-02 14:26:20 +01:00
height !== undefined ? height : node.lastTriedHeight;
2020-03-26 12:29:38 +01:00
if (
2020-12-02 14:26:20 +01:00
!self.engine.canMoveNode(node, x, y, width, height) ||
2020-03-26 12:29:38 +01:00
(node.lastTriedX === x &&
node.lastTriedY === y &&
node.lastTriedWidth === lastTriedWidth &&
node.lastTriedHeight === lastTriedHeight)
) {
return;
}
node.lastTriedX = x;
node.lastTriedY = y;
node.lastTriedWidth = width;
node.lastTriedHeight = height;
2020-12-02 14:26:20 +01:00
self.engine.moveNode(node, x, y, width, height);
2020-03-26 12:29:38 +01:00
self._updateContainerHeight();
2020-12-02 14:26:20 +01:00
if (event.type === "resize") {
$(event.target).trigger("gsresize", node);
}
2020-03-26 12:29:38 +01:00
};
var onStartMoving = function(event, ui) {
2020-12-02 14:26:20 +01:00
self.$el.append(self.placeholder);
2020-03-26 12:29:38 +01:00
var o = $(this);
2020-12-02 14:26:20 +01:00
self.engine.cleanNodes();
self.engine.beginUpdate(node);
2020-03-26 12:29:38 +01:00
cellWidth = self.cellWidth();
2020-12-02 14:26:20 +01:00
var strictCellHeight = self.cellHeight(); // heigh without v-margin
// compute height with v-margin (Note: we add 1 margin as last row is missing it)
cellFullHeight =
(self.$el.height() + self.verticalMargin()) /
parseInt(self.$el.attr("data-gs-current-row"));
2020-03-26 12:29:38 +01:00
self.placeholder
.attr("data-gs-x", o.attr("data-gs-x"))
.attr("data-gs-y", o.attr("data-gs-y"))
.attr("data-gs-width", o.attr("data-gs-width"))
.attr("data-gs-height", o.attr("data-gs-height"))
.show();
2020-12-02 14:26:20 +01:00
node.el = self.placeholder.get(0);
2020-03-26 12:29:38 +01:00
node._beforeDragX = node.x;
node._beforeDragY = node.y;
2020-12-02 14:26:20 +01:00
node._prevYPix = ui.position.top;
var minHeight = node.minHeight || 1;
var verticalMargin = self.opts.verticalMargin;
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
// mineHeight - Each row is cellHeight + verticalMargin, until last one which has no margin below
2020-03-26 12:29:38 +01:00
self.dd.resizable(
el,
"option",
"minWidth",
cellWidth * (node.minWidth || 1)
);
self.dd.resizable(
el,
"option",
"minHeight",
2020-12-02 14:26:20 +01:00
strictCellHeight * minHeight + (minHeight - 1) * verticalMargin
2020-03-26 12:29:38 +01:00
);
2020-12-02 14:26:20 +01:00
if (event.type === "resizestart") {
2020-03-26 12:29:38 +01:00
o.find(".grid-stack-item").trigger("resizestart");
}
};
var onEndMoving = function(event, ui) {
var o = $(this);
if (!o.data("_gridstack_node")) {
return;
}
2020-12-02 14:26:20 +01:00
// var forceNotify = false; what is the point of calling 'change' event with no data, when the 'removed' event is already called ?
2020-03-26 12:29:38 +01:00
self.placeholder.detach();
2020-12-02 14:26:20 +01:00
node.el = o.get(0);
2020-03-26 12:29:38 +01:00
self.placeholder.hide();
if (node._isAboutToRemove) {
2020-12-02 14:26:20 +01:00
// forceNotify = true;
2020-03-26 12:29:38 +01:00
var gridToNotify = el.data("_gridstack_node")._grid;
gridToNotify._triggerRemoveEvent();
el.removeData("_gridstack_node");
el.remove();
} else {
self._clearRemovingTimeout(el);
if (!node._temporaryRemoved) {
2020-12-02 14:26:20 +01:00
Utils.removePositioningStyles(o);
2020-03-26 12:29:38 +01:00
o.attr("data-gs-x", node.x)
.attr("data-gs-y", node.y)
.attr("data-gs-width", node.width)
2020-12-02 14:26:20 +01:00
.attr("data-gs-height", node.height);
2020-03-26 12:29:38 +01:00
} else {
2020-12-02 14:26:20 +01:00
Utils.removePositioningStyles(o);
2020-03-26 12:29:38 +01:00
o.attr("data-gs-x", node._beforeDragX)
.attr("data-gs-y", node._beforeDragY)
.attr("data-gs-width", node.width)
2020-12-02 14:26:20 +01:00
.attr("data-gs-height", node.height);
2020-03-26 12:29:38 +01:00
node.x = node._beforeDragX;
node.y = node._beforeDragY;
2020-12-02 14:26:20 +01:00
node._temporaryRemoved = false;
self.engine.addNode(node);
2020-03-26 12:29:38 +01:00
}
}
self._updateContainerHeight();
2020-12-02 14:26:20 +01:00
self._triggerChangeEvent(/*forceNotify*/);
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
self.engine.endUpdate();
2020-03-26 12:29:38 +01:00
var nestedGrids = o.find(".grid-stack");
2020-12-02 14:26:20 +01:00
if (nestedGrids.length && event.type === "resizestop") {
2020-03-26 12:29:38 +01:00
nestedGrids.each(function(index, el) {
2020-12-02 14:26:20 +01:00
el.gridstack.onResizeHandler();
2020-03-26 12:29:38 +01:00
});
o.find(".grid-stack-item").trigger("resizestop");
o.find(".grid-stack-item").trigger("gsresizestop");
}
2020-12-02 14:26:20 +01:00
if (event.type === "resizestop") {
self.$el.trigger("gsresizestop", o);
2020-03-26 12:29:38 +01:00
}
};
this.dd
.draggable(el, {
start: onStartMoving,
stop: onEndMoving,
drag: dragOrResize
})
.resizable(el, {
start: onStartMoving,
stop: onEndMoving,
resize: dragOrResize
});
2020-12-02 14:26:20 +01:00
if (node.noMove || this.opts.disableDrag || this.opts.staticGrid) {
2020-03-26 12:29:38 +01:00
this.dd.draggable(el, "disable");
}
2020-12-02 14:26:20 +01:00
if (node.noResize || this.opts.disableResize || this.opts.staticGrid) {
2020-03-26 12:29:38 +01:00
this.dd.resizable(el, "disable");
}
2020-12-02 14:26:20 +01:00
this._writeAttr(el, node);
2020-03-26 12:29:38 +01:00
};
GridStack.prototype._prepareElement = function(el, triggerAddEvent) {
2020-12-02 14:26:20 +01:00
triggerAddEvent = triggerAddEvent !== undefined ? triggerAddEvent : false;
2020-03-26 12:29:38 +01:00
var self = this;
el = $(el);
el.addClass(this.opts.itemClass);
2020-12-02 14:26:20 +01:00
var node = this._readAttr(el, { el: el.get(0), _grid: self });
node = self.engine.addNode(node, triggerAddEvent);
2020-03-26 12:29:38 +01:00
el.data("_gridstack_node", node);
this._prepareElementsByNode(el, node);
};
2020-12-02 14:26:20 +01:00
/** call to write any default attributes back to element */
GridStack.prototype._writeAttr = function(el, node) {
if (!node) {
return;
}
el = $(el);
// Note: passing null removes the attr in jquery
if (node.x !== undefined) {
el.attr("data-gs-x", node.x);
}
if (node.y !== undefined) {
el.attr("data-gs-y", node.y);
}
if (node.width !== undefined) {
el.attr("data-gs-width", node.width);
}
if (node.height !== undefined) {
el.attr("data-gs-height", node.height);
}
if (node.autoPosition !== undefined) {
el.attr("data-gs-auto-position", node.autoPosition ? true : null);
}
if (node.minWidth !== undefined) {
el.attr("data-gs-min-width", node.minWidth);
}
if (node.maxWidth !== undefined) {
el.attr("data-gs-max-width", node.maxWidth);
}
if (node.minHeight !== undefined) {
el.attr("data-gs-min-height", node.minHeight);
}
if (node.maxHeight !== undefined) {
el.attr("data-gs-max-height", node.maxHeight);
}
if (node.noResize !== undefined) {
el.attr("data-gs-no-resize", node.noResize ? true : null);
}
if (node.noMove !== undefined) {
el.attr("data-gs-no-move", node.noMove ? true : null);
}
if (node.locked !== undefined) {
el.attr("data-gs-locked", node.locked ? true : null);
}
if (node.resizeHandles !== undefined) {
el.attr("data-gs-resize-handles", node.resizeHandles);
}
if (node.id !== undefined) {
el.attr("data-gs-id", node.id);
}
};
/** call to read any default attributes back to element */
GridStack.prototype._readAttr = function(el, node) {
el = $(el);
node = node || {};
node.x = el.attr("data-gs-x");
node.y = el.attr("data-gs-y");
node.width = el.attr("data-gs-width");
node.height = el.attr("data-gs-height");
node.autoPosition = Utils.toBool(el.attr("data-gs-auto-position"));
node.maxWidth = el.attr("data-gs-max-width");
node.minWidth = el.attr("data-gs-min-width");
node.maxHeight = el.attr("data-gs-max-height");
node.minHeight = el.attr("data-gs-min-height");
node.noResize = Utils.toBool(el.attr("data-gs-no-resize"));
node.noMove = Utils.toBool(el.attr("data-gs-no-move"));
node.locked = Utils.toBool(el.attr("data-gs-locked"));
node.resizeHandles = el.attr("data-gs-resize-handles");
node.id = el.attr("data-gs-id");
return node;
};
2020-03-26 12:29:38 +01:00
GridStack.prototype.setAnimation = function(enable) {
if (enable) {
2020-12-02 14:26:20 +01:00
this.$el.addClass("grid-stack-animate");
2020-03-26 12:29:38 +01:00
} else {
2020-12-02 14:26:20 +01:00
this.$el.removeClass("grid-stack-animate");
2020-03-26 12:29:38 +01:00
}
};
GridStack.prototype.addWidget = function(
el,
2020-12-02 14:26:20 +01:00
opt,
2020-03-26 12:29:38 +01:00
y,
width,
height,
autoPosition,
minWidth,
maxWidth,
minHeight,
maxHeight,
id
) {
2020-12-02 14:26:20 +01:00
// new way of calling with an object - make sure all items have been properly initialized
if (opt === undefined || typeof opt === "object") {
// Tempting to initialize the passed in opt with default and valid values, but this break knockout demos
// as the actual value are filled in when _prepareElement() calls el.attr('data-gs-xyz) before adding the node.
// opt = this.engine._prepareNode(opt);
} else {
// old legacy way of calling with items spelled out - call us back with single object instead (so we can properly initialized values)
return this.addWidget(el, {
x: opt,
y: y,
width: width,
height: height,
autoPosition: autoPosition,
minWidth: minWidth,
maxWidth: maxWidth,
minHeight: minHeight,
maxHeight: maxHeight,
id: id
});
2020-03-26 12:29:38 +01:00
}
2020-12-02 14:26:20 +01:00
el = $(el);
if (opt) {
// see knockout above
// make sure we load any DOM attributes that are not specified in passed in options (which override)
var domAttr = this._readAttr(el);
Utils.defaults(opt, domAttr);
this.engine._prepareNode(opt);
}
this._writeAttr(el, opt);
this.$el.append(el);
return this.makeWidget(el);
2020-03-26 12:29:38 +01:00
};
GridStack.prototype.makeWidget = function(el) {
el = $(el);
this._prepareElement(el, true);
this._updateContainerHeight();
2020-12-02 14:26:20 +01:00
this._triggerAddEvent();
this._triggerChangeEvent(true); // trigger any other changes
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
return el.get(0);
2020-03-26 12:29:38 +01:00
};
GridStack.prototype.willItFit = function(x, y, width, height, autoPosition) {
var node = {
x: x,
y: y,
width: width,
height: height,
autoPosition: autoPosition
};
2020-12-02 14:26:20 +01:00
return this.engine.canBePlacedWithRespectToHeight(node);
2020-03-26 12:29:38 +01:00
};
GridStack.prototype.removeWidget = function(el, detachNode) {
el = $(el);
var node = el.data("_gridstack_node");
2020-12-02 14:26:20 +01:00
// For Meteor support: https://github.com/gridstack/gridstack.js/pull/272
2020-03-26 12:29:38 +01:00
if (!node) {
2020-12-02 14:26:20 +01:00
node = this.engine.getNodeDataByDOMEl(el.get(0));
2020-03-26 12:29:38 +01:00
}
2020-12-02 14:26:20 +01:00
if (!node || node.el.parentElement !== this.el) return; // not our child!
// remove our DOM data (circular link) and drag&drop permanently
2020-03-26 12:29:38 +01:00
el.removeData("_gridstack_node");
2020-12-02 14:26:20 +01:00
this.dd.draggable(el, "destroy").resizable(el, "destroy");
this.engine.removeNode(node, detachNode);
2020-03-26 12:29:38 +01:00
this._triggerRemoveEvent();
2020-12-02 14:26:20 +01:00
this._triggerChangeEvent(true); // trigger any other changes
2020-03-26 12:29:38 +01:00
};
GridStack.prototype.removeAll = function(detachNode) {
2020-12-02 14:26:20 +01:00
// always remove our DOM data (circular link) before list gets emptied and drag&drop permanently
this.engine.nodes.forEach(function(node) {
var el = $(node.el);
el.removeData("_gridstack_node");
this.dd.draggable(el, "destroy").resizable(el, "destroy");
}, this);
this.engine.removeAll(detachNode);
this._triggerRemoveEvent();
2020-03-26 12:29:38 +01:00
};
GridStack.prototype.destroy = function(detachGrid) {
$(window).off("resize", this.onResizeHandler);
2020-12-02 14:26:20 +01:00
if (detachGrid === false) {
2020-03-26 12:29:38 +01:00
this.removeAll(false);
2020-12-02 14:26:20 +01:00
this.$el.removeClass(this.opts._class);
delete this.$el.get(0).gridstack;
2020-03-26 12:29:38 +01:00
} else {
2020-12-02 14:26:20 +01:00
this.$el.remove();
2020-03-26 12:29:38 +01:00
}
Utils.removeStylesheet(this._stylesId);
2020-12-02 14:26:20 +01:00
if (this.engine) {
this.engine = null;
2020-03-26 12:29:38 +01:00
}
};
GridStack.prototype.resizable = function(el, val) {
var self = this;
el = $(el);
el.each(function(index, el) {
el = $(el);
var node = el.data("_gridstack_node");
2020-12-02 14:26:20 +01:00
if (!node) {
2020-03-26 12:29:38 +01:00
return;
}
node.noResize = !(val || false);
2020-12-02 14:26:20 +01:00
if (node.noResize) {
2020-03-26 12:29:38 +01:00
self.dd.resizable(el, "disable");
} else {
self.dd.resizable(el, "enable");
}
});
return this;
};
GridStack.prototype.movable = function(el, val) {
var self = this;
el = $(el);
el.each(function(index, el) {
el = $(el);
var node = el.data("_gridstack_node");
2020-12-02 14:26:20 +01:00
if (!node) {
2020-03-26 12:29:38 +01:00
return;
}
node.noMove = !(val || false);
2020-12-02 14:26:20 +01:00
if (node.noMove) {
2020-03-26 12:29:38 +01:00
self.dd.draggable(el, "disable");
el.removeClass("ui-draggable-handle");
} else {
self.dd.draggable(el, "enable");
el.addClass("ui-draggable-handle");
}
});
return this;
};
GridStack.prototype.enableMove = function(doEnable, includeNewWidgets) {
2020-12-02 14:26:20 +01:00
this.movable(this.$el.children("." + this.opts.itemClass), doEnable);
2020-03-26 12:29:38 +01:00
if (includeNewWidgets) {
this.opts.disableDrag = !doEnable;
}
};
GridStack.prototype.enableResize = function(doEnable, includeNewWidgets) {
2020-12-02 14:26:20 +01:00
this.resizable(this.$el.children("." + this.opts.itemClass), doEnable);
2020-03-26 12:29:38 +01:00
if (includeNewWidgets) {
this.opts.disableResize = !doEnable;
}
};
GridStack.prototype.disable = function() {
2020-12-02 14:26:20 +01:00
this.movable(this.$el.children("." + this.opts.itemClass), false);
this.resizable(this.$el.children("." + this.opts.itemClass), false);
this.$el.trigger("disable");
2020-03-26 12:29:38 +01:00
};
GridStack.prototype.enable = function() {
2020-12-02 14:26:20 +01:00
this.movable(this.$el.children("." + this.opts.itemClass), true);
this.resizable(this.$el.children("." + this.opts.itemClass), true);
this.$el.trigger("enable");
2020-03-26 12:29:38 +01:00
};
GridStack.prototype.locked = function(el, val) {
el = $(el);
el.each(function(index, el) {
el = $(el);
var node = el.data("_gridstack_node");
2020-12-02 14:26:20 +01:00
if (!node) {
2020-03-26 12:29:38 +01:00
return;
}
node.locked = val || false;
el.attr("data-gs-locked", node.locked ? "yes" : null);
});
return this;
};
GridStack.prototype.maxHeight = function(el, val) {
el = $(el);
el.each(function(index, el) {
el = $(el);
var node = el.data("_gridstack_node");
2020-12-02 14:26:20 +01:00
if (!node) {
2020-03-26 12:29:38 +01:00
return;
}
if (!isNaN(val)) {
node.maxHeight = val || false;
el.attr("data-gs-max-height", val);
}
});
return this;
};
GridStack.prototype.minHeight = function(el, val) {
el = $(el);
el.each(function(index, el) {
el = $(el);
var node = el.data("_gridstack_node");
2020-12-02 14:26:20 +01:00
if (!node) {
2020-03-26 12:29:38 +01:00
return;
}
if (!isNaN(val)) {
node.minHeight = val || false;
el.attr("data-gs-min-height", val);
}
});
return this;
};
GridStack.prototype.maxWidth = function(el, val) {
el = $(el);
el.each(function(index, el) {
el = $(el);
var node = el.data("_gridstack_node");
2020-12-02 14:26:20 +01:00
if (!node) {
2020-03-26 12:29:38 +01:00
return;
}
if (!isNaN(val)) {
node.maxWidth = val || false;
el.attr("data-gs-max-width", val);
}
});
return this;
};
GridStack.prototype.minWidth = function(el, val) {
el = $(el);
el.each(function(index, el) {
el = $(el);
var node = el.data("_gridstack_node");
2020-12-02 14:26:20 +01:00
if (!node) {
2020-03-26 12:29:38 +01:00
return;
}
if (!isNaN(val)) {
node.minWidth = val || false;
el.attr("data-gs-min-width", val);
}
});
return this;
};
GridStack.prototype._updateElement = function(el, callback) {
el = $(el).first();
var node = el.data("_gridstack_node");
2020-12-02 14:26:20 +01:00
if (!node) {
2020-03-26 12:29:38 +01:00
return;
}
var self = this;
2020-12-02 14:26:20 +01:00
self.engine.cleanNodes();
self.engine.beginUpdate(node);
2020-03-26 12:29:38 +01:00
callback.call(this, el, node);
self._updateContainerHeight();
self._triggerChangeEvent();
2020-12-02 14:26:20 +01:00
self.engine.endUpdate();
2020-03-26 12:29:38 +01:00
};
GridStack.prototype.resize = function(el, width, height) {
this._updateElement(el, function(el, node) {
2020-12-02 14:26:20 +01:00
width = width !== null && width !== undefined ? width : node.width;
height = height !== null && height !== undefined ? height : node.height;
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
this.engine.moveNode(node, node.x, node.y, width, height);
2020-03-26 12:29:38 +01:00
});
};
GridStack.prototype.move = function(el, x, y) {
this._updateElement(el, function(el, node) {
2020-12-02 14:26:20 +01:00
x = x !== null && x !== undefined ? x : node.x;
y = y !== null && y !== undefined ? y : node.y;
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
this.engine.moveNode(node, x, y, node.width, node.height);
2020-03-26 12:29:38 +01:00
});
};
GridStack.prototype.update = function(el, x, y, width, height) {
this._updateElement(el, function(el, node) {
2020-12-02 14:26:20 +01:00
x = x !== null && x !== undefined ? x : node.x;
y = y !== null && y !== undefined ? y : node.y;
width = width !== null && width !== undefined ? width : node.width;
height = height !== null && height !== undefined ? height : node.height;
this.engine.moveNode(node, x, y, width, height);
2020-03-26 12:29:38 +01:00
});
};
2020-12-02 14:26:20 +01:00
/**
* relayout grid items to reclaim any empty space
*/
GridStack.prototype.compact = function() {
if (this.engine.nodes.length === 0) {
return;
}
this.batchUpdate();
this.engine._sortNodes();
var nodes = this.engine.nodes;
this.engine.nodes = []; // pretend we have no nodes to conflict layout to start with...
nodes.forEach(function(node) {
if (!node.noMove && !node.locked) {
node.autoPosition = true;
}
this.engine.addNode(node, false); // 'false' for add event trigger
node._dirty = true; // force attr update
}, this);
this.commit();
};
2020-03-26 12:29:38 +01:00
GridStack.prototype.verticalMargin = function(val, noUpdate) {
2020-12-02 14:26:20 +01:00
if (val === undefined) {
2020-03-26 12:29:38 +01:00
return this.opts.verticalMargin;
}
var heightData = Utils.parseHeight(val);
if (
this.opts.verticalMarginUnit === heightData.unit &&
2020-12-02 14:26:20 +01:00
this.opts.maxRow === heightData.height
2020-03-26 12:29:38 +01:00
) {
return;
}
this.opts.verticalMarginUnit = heightData.unit;
this.opts.verticalMargin = heightData.height;
if (!noUpdate) {
this._updateStyles();
}
};
2020-12-02 14:26:20 +01:00
/** set/get the current cell height value */
2020-03-26 12:29:38 +01:00
GridStack.prototype.cellHeight = function(val, noUpdate) {
2020-12-02 14:26:20 +01:00
// getter - returns the opts stored height else compute it...
if (val === undefined) {
if (this.opts.cellHeight && this.opts.cellHeight !== "auto") {
2020-03-26 12:29:38 +01:00
return this.opts.cellHeight;
}
2020-12-02 14:26:20 +01:00
// compute the height taking margin into account (each row has margin other than last one)
var o = this.$el.children("." + this.opts.itemClass).first();
var height = o.attr("data-gs-height");
var verticalMargin = this.opts.verticalMargin;
return Math.round(
(o.outerHeight() - (height - 1) * verticalMargin) / height
);
2020-03-26 12:29:38 +01:00
}
2020-12-02 14:26:20 +01:00
// setter - updates the cellHeight value if they changed
var heightData = Utils.parseHeight(val);
2020-03-26 12:29:38 +01:00
if (
2020-12-02 14:26:20 +01:00
this.opts.cellHeightUnit === heightData.unit &&
this.opts.cellHeight === heightData.height
2020-03-26 12:29:38 +01:00
) {
return;
}
this.opts.cellHeightUnit = heightData.unit;
this.opts.cellHeight = heightData.height;
if (!noUpdate) {
this._updateStyles();
}
};
GridStack.prototype.cellWidth = function() {
2020-12-02 14:26:20 +01:00
// TODO: take margin into account ($horizontal_padding in .scss) to make cellHeight='auto' square ? (see 810-many-columns.html)
return Math.round(this.$el.outerWidth() / this.opts.column);
2020-03-26 12:29:38 +01:00
};
GridStack.prototype.getCellFromPixel = function(position, useOffset) {
var containerPos =
2020-12-02 14:26:20 +01:00
useOffset !== undefined && useOffset
? this.$el.offset()
: this.$el.position();
2020-03-26 12:29:38 +01:00
var relativeLeft = position.left - containerPos.left;
var relativeTop = position.top - containerPos.top;
2020-12-02 14:26:20 +01:00
var columnWidth = Math.floor(this.$el.width() / this.opts.column);
2020-03-26 12:29:38 +01:00
var rowHeight = Math.floor(
2020-12-02 14:26:20 +01:00
this.$el.height() / parseInt(this.$el.attr("data-gs-current-row"))
2020-03-26 12:29:38 +01:00
);
return {
x: Math.floor(relativeLeft / columnWidth),
y: Math.floor(relativeTop / rowHeight)
};
};
GridStack.prototype.batchUpdate = function() {
2020-12-02 14:26:20 +01:00
this.engine.batchUpdate();
2020-03-26 12:29:38 +01:00
};
GridStack.prototype.commit = function() {
2020-12-02 14:26:20 +01:00
this.engine.commit();
this._triggerRemoveEvent();
this._triggerAddEvent();
this._triggerChangeEvent();
2020-03-26 12:29:38 +01:00
};
GridStack.prototype.isAreaEmpty = function(x, y, width, height) {
2020-12-02 14:26:20 +01:00
return this.engine.isAreaEmpty(x, y, width, height);
2020-03-26 12:29:38 +01:00
};
GridStack.prototype.setStatic = function(staticValue) {
this.opts.staticGrid = staticValue === true;
this.enableMove(!staticValue);
this.enableResize(!staticValue);
this._setStaticClass();
};
GridStack.prototype._setStaticClass = function() {
var staticClassName = "grid-stack-static";
if (this.opts.staticGrid === true) {
2020-12-02 14:26:20 +01:00
this.$el.addClass(staticClassName);
2020-03-26 12:29:38 +01:00
} else {
2020-12-02 14:26:20 +01:00
this.$el.removeClass(staticClassName);
2020-03-26 12:29:38 +01:00
}
};
2020-12-02 14:26:20 +01:00
/** called whenever a node is added or moved - updates the cached layouts */
GridStackEngine.prototype._layoutsNodesChange = function(nodes) {
if (!this._layouts || this._ignoreLayoutsNodeChange) return;
// remove smaller layouts - we will re-generate those on the fly... larger ones need to update
this._layouts.forEach(function(layout, column) {
if (!layout || column === this.column) return;
if (column < this.column) {
this._layouts[column] = undefined;
} else {
// we save the original x,y,w (h isn't cached) to see what actually changed to propagate better.
// Note: we don't need to check against out of bound scaling/moving as that will be done when using those cache values.
nodes.forEach(function(node) {
var n = layout.find(function(l) {
return l._id === node._id;
});
if (!n) return; // no cache for new nodes. Will use those values.
var ratio = column / this.column;
// Y changed, push down same amount
// TODO: detect doing item 'swaps' will help instead of move (especially in 1 column mode)
if (node.y !== node._origY) {
n.y += node.y - node._origY;
}
// X changed, scale from new position
if (node.x !== node._origX) {
n.x = Math.round(node.x * ratio);
}
// width changed, scale from new width
if (node.width !== node._origW) {
n.width = Math.round(node.width * ratio);
}
// ...height always carries over from cache
}, this);
}
}, this);
};
/**
* Called to scale the widget width & position up/down based on the column change.
* Note we store previous layouts (especially original ones) to make it possible to go
* from say 12 -> 1 -> 12 and get back to where we were.
*
* oldColumn: previous number of columns
* column: new column number
* nodes?: different sorted list (ex: DOM order) instead of current list
*/
GridStackEngine.prototype._updateNodeWidths = function(
oldColumn,
column,
nodes
) {
if (!this.nodes.length || oldColumn === column) {
return;
2020-03-26 12:29:38 +01:00
}
2020-12-02 14:26:20 +01:00
// cache the current layout in case they want to go back (like 12 -> 1 -> 12) as it requires original data
var copy = [this.nodes.length];
this.nodes.forEach(function(n, i) {
copy[i] = { x: n.x, y: n.y, width: n.width, _id: n._id };
}); // only thing we change is x,y,w and id to find it back
this._layouts = this._layouts || []; // use array to find larger quick
this._layouts[oldColumn] = copy;
// if we're going to 1 column and using DOM order rather than default sorting, then generate that layout
if (column === 1 && nodes && nodes.length) {
var top = 0;
nodes.forEach(function(n) {
n.x = 0;
n.width = 1;
n.y = Math.max(n.y, top);
top = n.y + n.height;
});
} else {
nodes = Utils.sort(this.nodes, -1, oldColumn); // current column reverse sorting so we can insert last to front (limit collision)
}
// see if we have cached previous layout.
var cacheNodes = this._layouts[column] || [];
// if not AND we are going up in size start with the largest layout as down-scaling is more accurate
var lastIndex = this._layouts.length - 1;
if (cacheNodes.length === 0 && column > oldColumn && column < lastIndex) {
cacheNodes = this._layouts[lastIndex] || [];
if (cacheNodes.length) {
// pretend we came from that larger column by assigning those values as starting point
oldColumn = lastIndex;
cacheNodes.forEach(function(cacheNode) {
var j = nodes.findIndex(function(n) {
return n && n._id === cacheNode._id;
});
if (j !== -1) {
// still current, use cache info positions
nodes[j].x = cacheNode.x;
nodes[j].y = cacheNode.y;
nodes[j].width = cacheNode.width;
}
});
cacheNodes = []; // we still don't have new column cached data... will generate from larger one.
}
}
// if we found cache re-use those nodes that are still current
var newNodes = [];
cacheNodes.forEach(function(cacheNode) {
var j = nodes.findIndex(function(n) {
return n && n._id === cacheNode._id;
});
if (j !== -1) {
// still current, use cache info positions
nodes[j].x = cacheNode.x;
nodes[j].y = cacheNode.y;
nodes[j].width = cacheNode.width;
newNodes.push(nodes[j]);
nodes[j] = null; // erase it so we know what's left
}
});
// ...and add any extra non-cached ones
var ratio = column / oldColumn;
nodes.forEach(function(node) {
if (!node) return;
node.x = column === 1 ? 0 : Math.round(node.x * ratio);
node.width =
column === 1 || oldColumn === 1
? 1
: Math.round(node.width * ratio) || 1;
newNodes.push(node);
});
// finally relayout them in reverse order (to get correct placement)
newNodes = Utils.sort(newNodes, -1, column);
this._ignoreLayoutsNodeChange = true;
this.batchUpdate();
this.nodes = []; // pretend we have no nodes to start with (we use same structures) to simplify layout
newNodes.forEach(function(node) {
this.addNode(node, false); // 'false' for add event trigger
node._dirty = true; // force attr update
}, this);
this.commit();
delete this._ignoreLayoutsNodeChange;
};
/** called to save initial position/size */
GridStackEngine.prototype._saveInitial = function() {
this.nodes.forEach(function(n) {
n._origX = n.x;
n._origY = n.y;
n._origW = n.width;
n._origH = n.height;
delete n._dirty;
});
2020-03-26 12:29:38 +01:00
};
2020-12-02 14:26:20 +01:00
/**
* set/get number of columns in the grid. Will attempt to update existing widgets
* to conform to new number of columns. Requires `gridstack-extra.css` or `gridstack-extra.min.css` for [2-11],
* else you will need to generate correct CSS (see https://github.com/gridstack/gridstack.js#change-grid-columns)
* @param column - Integer > 0 (default 12).
* @param doNotPropagate if true existing widgets will not be updated (optional)
*/
GridStack.prototype.column = function(column, doNotPropagate) {
// getter - returns the opts stored mode
if (column === undefined) {
return this.opts.column;
}
// setter
if (this.opts.column === column) {
return;
}
var oldColumn = this.opts.column;
// if we go into 1 column mode (which happens if we're sized less than minWidth unless disableOneColumnMode is on)
// then remember the original columns so we can restore.
if (column === 1) {
this._prevColumn = oldColumn;
} else {
delete this._prevColumn;
}
this.$el.removeClass("grid-stack-" + oldColumn);
this.$el.addClass("grid-stack-" + column);
this.opts.column = this.engine.column = column;
if (doNotPropagate === true) {
return;
}
// update the items now - see if the dom order nodes should be passed instead (else default to current list)
var domNodes;
if (this.opts.oneColumnModeDomSort && column === 1) {
domNodes = [];
this.$el.children("." + this.opts.itemClass).each(function(index, el) {
var node = $(el).data("_gridstack_node");
if (node) {
domNodes.push(node);
}
});
if (!domNodes.length) {
domNodes = undefined;
}
}
this.engine._updateNodeWidths(oldColumn, column, domNodes);
// and trigger our event last...
this.engine._ignoreLayoutsNodeChange = true;
this._triggerChangeEvent();
delete this.engine._ignoreLayoutsNodeChange;
};
GridStack.prototype.float = function(val) {
// getter - returns the opts stored mode
if (val === undefined) {
return this.opts.float || false;
}
// setter - updates the mode and relayout if gravity is back on
if (this.opts.float === val) {
return;
}
this.opts.float = this.engine.float = val || false;
if (!val) {
this.engine._packNodes();
this.engine._notify();
this._triggerChangeEvent();
}
};
GridStack.prototype.getRow = function() {
return this.engine.getRow();
};
/** Event handler that extracts our CustomEvent data out automatically for receiving custom
* notifications (see doc for supported events)
*/
GridStack.prototype.on = function(eventName, callback) {
// check for array of names being passed instead
if (eventName.indexOf(" ") !== -1) {
var names = eventName.split(" ");
names.forEach(function(name) {
this.on(name, callback);
}, this);
return;
}
if (
eventName === "change" ||
eventName === "added" ||
eventName === "removed"
) {
// native CustomEvent handlers - cash the generic handlers so we can remove
this._gsEventHandler = this._gsEventHandler || {};
this._gsEventHandler[eventName] = function(event) {
callback(event, event.detail);
};
this.el.addEventListener(eventName, this._gsEventHandler[eventName]);
} else {
// still JQuery events
this.$el.on(eventName, callback);
}
};
/** unsubscribe from the 'on' event */
GridStack.prototype.off = function(eventName) {
// check for array of names being passed instead
if (eventName.indexOf(" ") !== -1) {
var names = eventName.split(" ");
names.forEach(function(name) {
this.off(name, callback);
}, this);
return;
}
if (
eventName === "change" ||
eventName === "added" ||
eventName === "removed"
) {
// remove native CustomEvent handlers
if (this._gsEventHandler && this._gsEventHandler[eventName]) {
this.el.removeEventListener(eventName, this._gsEventHandler[eventName]);
delete this._gsEventHandler[eventName];
}
} else {
// still JQuery events
this.$el.off(eventName);
}
};
// legacy method renames
GridStack.prototype.setGridWidth = obsolete(
GridStack.prototype.column,
"setGridWidth",
"column",
"v0.5.3"
2020-03-26 12:29:38 +01:00
);
2020-12-02 14:26:20 +01:00
GridStack.prototype.setColumn = obsolete(
GridStack.prototype.column,
"setColumn",
"column",
"v0.6.4"
2020-03-26 12:29:38 +01:00
);
2020-12-02 14:26:20 +01:00
GridStackEngine.prototype.getGridHeight = obsolete(
GridStackEngine.prototype.getRow,
"getGridHeight",
"getRow",
"v1.0.0"
2020-03-26 12:29:38 +01:00
);
2020-12-02 14:26:20 +01:00
scope.GridStack = GridStack;
scope.GridStack.Utils = Utils;
scope.GridStack.Engine = GridStackEngine;
scope.GridStack.DragDropPlugin = GridStackDragDropPlugin;
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
/**
* initializing the HTML element, or selector string, into a grid will return the grid. Calling it again will
* simply return the existing instance (ignore any passed options).
*/
GridStack.init = function(opts, elOrString) {
if (!elOrString) {
elOrString = ".grid-stack";
}
var el = $(elOrString).get(0);
if (!el) return;
if (!el.gridstack) {
el.gridstack = new GridStack(el, Utils.clone(opts));
}
return el.gridstack;
};
2020-03-26 12:29:38 +01:00
2020-12-02 14:26:20 +01:00
/**
* Will initialize a list of elements (given a selector) and return an array of grids.
*/
GridStack.initAll = function(opts, selector) {
if (!selector) {
selector = ".grid-stack";
}
var grids = [];
$(selector).each(function(index, el) {
if (!el.gridstack) {
el.gridstack = new GridStack(el, Utils.clone(opts));
2020-03-26 12:29:38 +01:00
}
2020-12-02 14:26:20 +01:00
grids.push(el.gridstack);
2020-03-26 12:29:38 +01:00
});
2020-12-02 14:26:20 +01:00
return grids;
2020-03-26 12:29:38 +01:00
};
2020-12-02 14:26:20 +01:00
return scope.GridStack;
2020-03-26 12:29:38 +01:00
});