Files
librenms-librenms/docs/files/src_jquery.draggable.js.html
2012-07-26 10:00:00 +02:00

430 lines
13 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>src&#x2F;jquery.draggable.js</title>
<link rel="stylesheet" href="http:&#x2F;&#x2F;yui.yahooapis.com&#x2F;3.5.1&#x2F;build&#x2F;cssgrids&#x2F;cssgrids-min.css">
<link rel="stylesheet" href="..&#x2F;assets/vendor/prettify/prettify-min.css">
<link rel="stylesheet" href="..&#x2F;assets/css/main.css" id="site_styles">
<link rel="shortcut icon" type="image/png" href="..&#x2F;assets/favicon.png">
<script src="http:&#x2F;&#x2F;yui.yahooapis.com&#x2F;combo?3.5.1&#x2F;build&#x2F;yui&#x2F;yui-min.js"></script>
</head>
<body class="yui3-skin-sam">
<div id="doc">
<div id="hd" class="yui3-g header">
<div class="yui3-u-3-4">
<!-- <h1><img src="..&#x2F;assets/css/logo.png" title=""></h1> -->
<h1><img src="http://ducksboard.com/wp-content/themes/blog-theme-ducksboard/images/ducksboard.png" title=""></h1>
</div>
<div class="yui3-u-1-4 version">
<em>API Docs for: </em>
</div>
</div>
<div id="bd" class="yui3-g">
<div class="yui3-u-1-4">
<div id="docs-sidebar" class="sidebar apidocs">
<div id="api-list">
<h2 class="off-left">APIs</h2>
<div id="api-tabview" class="tabview">
<ul class="tabs">
<li><a href="#api-classes">Classes</a></li>
<li><a href="#api-modules">Modules</a></li>
</ul>
<div id="api-tabview-filter">
<input type="search" id="api-filter" placeholder="Type to filter APIs">
</div>
<div id="api-tabview-panel">
<ul id="api-classes" class="apis classes">
<li><a href="..&#x2F;classes/Collision.html">Collision</a></li>
<li><a href="..&#x2F;classes/Coords.html">Coords</a></li>
<li><a href="..&#x2F;classes/Draggable.html">Draggable</a></li>
<li><a href="..&#x2F;classes/Gridster.html">Gridster</a></li>
</ul>
<ul id="api-modules" class="apis modules">
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="yui3-u-3-4">
<div id="api-options">
Show:
<label for="api-show-inherited">
<input type="checkbox" id="api-show-inherited" checked>
Inherited
</label>
<label for="api-show-protected">
<input type="checkbox" id="api-show-protected">
Protected
</label>
<label for="api-show-private">
<input type="checkbox" id="api-show-private">
Private
</label>
<label for="api-show-deprecated">
<input type="checkbox" id="api-show-deprecated">
Deprecated
</label>
</div>
<div class="apidocs">
<div id="docs-main">
<div class="content">
<h1 class="file-heading">File: src&#x2F;jquery.draggable.js</h1>
<div class="file">
<pre class="code prettyprint linenums">
&#x2F;*
* jquery.draggable
* https:&#x2F;&#x2F;github.com&#x2F;ducksboard&#x2F;gridster.js
*
* Copyright (c) 2012 ducksboard
* Licensed under the MIT, GPL licenses.
*&#x2F;
;(function($, window, document, undefined){
var defaults = {
items: &#x27;.gs_w&#x27;,
distance: 1,
limit: true,
offset_left: 0,
autoscroll: true
&#x2F;&#x2F; ,drag: function(e){},
&#x2F;&#x2F; start : function(e, ui){},
&#x2F;&#x2F; stop : function(e){}
};
var $body = $(document.body);
var $window = $(window);
&#x2F;**
* Basic drag implementation for DOM elements inside a container.
* Provide start&#x2F;stop&#x2F;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 {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 &#x60;el&#x60;.
* @constructor
*&#x2F;
function Draggable(el, options) {
this.options = $.extend({}, defaults, options);
this.$container = $(el);
this.$dragitems = $(this.options.items, this.$container);
this.is_dragging = false;
this.player_min_left = 0 + this.options.offset_left;
this.init();
}
var fn = Draggable.prototype;
fn.init = function() {
this.calculate_positions();
this.$container.css(&#x27;position&#x27;, &#x27;relative&#x27;);
this.enable();
$(window).bind(&#x27;resize&#x27;,
throttle($.proxy(this.calculate_positions, this), 200));
};
fn.get_actual_pos = function($el) {
var pos = $el.position();
return pos;
};
fn.get_mouse_pos = function(e) {
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);
var top = Math.round(
this.el_init_offset.top + diff_y - this.baseY + this.scrollOffset);
if (this.options.limit) {
if (left &gt; this.player_max_left) {
left = this.player_max_left;
}else if(left &lt; this.player_min_left) {
left = this.player_min_left;
}
}
return {
left: left,
top: top,
mouse_left: mouse_actual_pos.left,
mouse_top: mouse_actual_pos.top
};
};
fn.manage_scroll = function(offset) {
&#x2F;* scroll document *&#x2F;
var nextScrollTop;
var scrollTop = $window.scrollTop();
var min_window_y = scrollTop;
var max_window_y = min_window_y + this.window_height;
var mouse_down_zone = max_window_y - 30;
var mouse_up_zone = min_window_y + 20;
var abs_mouse_left = offset.mouse_left;
var abs_mouse_top = min_window_y + offset.mouse_top;
var max_player_y = (this.doc_height - this.window_height +
this.player_height);
if (abs_mouse_top &gt;= mouse_down_zone) {
nextScrollTop = scrollTop + 10;
if (nextScrollTop &lt; max_player_y) {
$window.scrollTop(nextScrollTop);
this.scrollOffset = this.scrollOffset + 10;
}
};
if (abs_mouse_top &lt;= mouse_up_zone) {
nextScrollTop = scrollTop - 10;
if (nextScrollTop &gt; 0) {
$window.scrollTop(nextScrollTop);
this.scrollOffset = this.scrollOffset - 10;
}
};
}
fn.calculate_positions = function(e) {
this.window_height = $window.height();
}
fn.drag_handler = function(e) {
if (e.which !== 1) {
return false;
}
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;
$body.on(&#x27;mousemove.draggable&#x27;, 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 &gt; self.options.distance ||
diff_y &gt; 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;
});
return false;
};
fn.on_dragstart = function(e) {
e.preventDefault();
this.drag_start = true;
this.is_dragging = true;
var offset = this.$container.offset();
this.baseX = Math.round(offset.left);
this.baseY = Math.round(offset.top);
this.doc_height = $(document).height();
if (this.options.helper === &#x27;clone&#x27;) {
this.$helper = this.$player.clone()
.appendTo(this.$container).addClass(&#x27;helper&#x27;);
this.helper = true;
}else{
this.helper = false;
}
this.scrollOffset = 0;
this.el_init_offset = this.$player.offset();
this.player_width = this.$player.width();
this.player_height = this.$player.height();
this.player_max_left = (this.$container.width() - this.player_width +
this.options.offset_left);
if (this.options.start) {
this.options.start.call(this.$player, e, {
helper: this.helper ? this.$helper : this.$player
});
}
return false;
};
fn.on_dragmove = function(e) {
var offset = this.get_offset(e);
this.options.autoscroll &amp;&amp; this.manage_scroll(offset);
(this.helper ? this.$helper : this.$player).css({
&#x27;position&#x27;: &#x27;absolute&#x27;,
&#x27;left&#x27; : offset.left,
&#x27;top&#x27; : offset.top
});
var ui = {
&#x27;position&#x27;: {
&#x27;left&#x27;: offset.left,
&#x27;top&#x27;: offset.top
}
};
if (this.options.drag) {
this.options.drag.call(this.$player, e, ui);
}
return false;
};
fn.on_dragstop = function(e) {
var offset = this.get_offset(e);
this.drag_start = false;
var ui = {
&#x27;position&#x27;: {
&#x27;left&#x27;: offset.left,
&#x27;top&#x27;: offset.top
}
};
if (this.options.stop) {
this.options.stop.call(this.$player, e, ui);
}
if (this.helper) {
this.$helper.remove();
}
return false;
};
fn.enable = function(){
this.$container.on(&#x27;mousedown.draggable&#x27;, this.options.items, $.proxy(
this.drag_handler, this));
$body.on(&#x27;mouseup.draggable&#x27;, $.proxy(function(e) {
this.is_dragging = false;
$body.off(&#x27;mousemove.draggable&#x27;);
if (this.drag_start) {
this.on_dragstop(e);
}
}, this));
};
fn.disable = function(){
this.$container.off(&#x27;mousedown.draggable&#x27;);
$body.off(&#x27;mouseup.draggable&#x27;);
};
fn.destroy = function(){
this.disable();
$.removeData(this.$container, &#x27;draggable&#x27;);
};
&#x2F;&#x2F;jQuery adapter
$.fn.draggable = function ( options ) {
return this.each(function () {
if (!$.data(this, &#x27;draggable&#x27;)) {
$.data(this, &#x27;draggable&#x27;, new Draggable( this, options ));
}
});
};
}(jQuery, window, document));
</pre>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<script src="..&#x2F;assets/vendor/prettify/prettify-min.js"></script>
<script>prettyPrint();</script>
<script src="..&#x2F;assets/js/yui-prettify.js"></script>
<script src="..&#x2F;assets/../api.js"></script>
<script src="..&#x2F;assets/js/api-filter.js"></script>
<script src="..&#x2F;assets/js/api-list.js"></script>
<script src="..&#x2F;assets/js/api-search.js"></script>
<script src="..&#x2F;assets/js/apidocs.js"></script>
</body>
</html>