12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237 |
- /*
- * jsPlumb 1.2.5-RC1
- *
- * Provides a way to visually connect elements on an HTML page.
- *
- * http://jsplumb.org
- * http://code.google.com/p/jsPlumb
- *
- * Dual licensed under MIT and GPL2.
- */
- (function() {
-
- var jsPlumbInstance = function() {
-
- /**
- * helper class for objects that generate events
- */
- var EventGenerator = function() {
- var _listeners = {};
- this.bind = function(event, listener) {
- var doOne = function(e, l) { _addToList(_listeners, e, l); };
- if (event.constructor == Array)
- for ( var i = 0; i < event.length; i++) doOne(event[i], listener);
- else
- doOne(event, listener);
- };
- this.fireUpdate = function(event, value) {
- if (_listeners[event]) {
- for ( var i = 0; i < _listeners[event].length; i++) {
- try {
- _listeners[event][i][event](value);
- } catch (e) {
- _log("jsPlumb: fireUpdate failed for event "
- + event + ";not fatal.");
- }
- }
- }
- };
- this.clearListeners = function() {
- delete _listeners;
- _listeners = {};
- };
- };
- var _currentInstance = this;
- var ie = !!!document.createElement('canvas').getContext;
- var log = null;
- var repaintFunction = function() {
- jsPlumb.repaintEverything();
- };
- var automaticRepaint = true;
- function repaintEverything() {
- if (automaticRepaint)
- repaintFunction();
- };
- var resizeTimer = null;
- /**
- * map of element id -> endpoint lists. an element can have an arbitrary
- * number of endpoints on it, and not all of them have to be connected
- * to anything.
- */
- var endpointsByElement = {};
- var endpointsByUUID = {};
- var connectionsByScope = {};
- var offsets = {};
- var offsetTimestamps = {};
- var floatingConnections = {};
- var draggableStates = {};
- var _draggableByDefault = true;
- var sizes = [];
- var listeners = {}; // a map: keys are event types, values are lists of listeners.
- var DEFAULT_SCOPE = 'DEFAULT';
- var DEFAULT_NEW_CANVAS_SIZE = 1200; // only used for IE; a canvas needs a size before the init call to excanvas (for some reason. no idea why.)
- var _findIndex = function(a, v, b, s) {
- var _eq = function(o1, o2) {
- if (o1 === o2)
- return true;
- else if (typeof o1 == 'object' && typeof o2 == 'object') {
- var same = true;
- for ( var propertyName in o1) {
- if (!_eq(o1[propertyName], o2[propertyName])) {
- same = false;
- break;
- }
- }
- for ( var propertyName in o2) {
- if (!_eq(o2[propertyName], o1[propertyName])) {
- same = false;
- break;
- }
- }
- return same;
- }
- };
- for ( var i = +b || 0, l = a.length; i < l; i++) {
- if (_eq(a[i], v))
- return i;
- }
- return -1;
- };
- /**
- * helper method to add an item to a list, creating the list if it does
- * not yet exist.
- */
- var _addToList = function(map, key, value) {
- var l = map[key];
- if (l == null) {
- l = [];
- map[key] = l;
- }
- l.push(value);
- return l;
- };
- /**
- * appends an element to the given parent, or the document body if no
- * parent given.
- */
- var _appendElement = function(canvas, parent) {
- if (!parent)
- document.body.appendChild(canvas);
- else
- jsPlumb.CurrentLibrary.appendElement(canvas, parent);
- };
- /**
- * creates a timestamp, using milliseconds since 1970, but as a string.
- */
- var _timestamp = function() { return "" + (new Date()).getTime(); };
- /**
- * Draws an endpoint and its connections.
- *
- * @param element element to draw (of type library specific element object)
- * @param ui UI object from current library's event system. optional.
- * @param timestamp timestamp for this paint cycle. used to speed things up a little by cutting down the amount of offset calculations we do.
- */
- var _draw = function(element, ui, timestamp) {
- var id = _getAttribute(element, "id");
- var endpoints = endpointsByElement[id];
- if (!timestamp) timestamp = _timestamp();
- if (endpoints) {
- _updateOffset( { elId : id, offset : ui, recalc : false, timestamp : timestamp }); // timestamp is checked against last update cache; it is
- // valid for one paint cycle.
- var myOffset = offsets[id], myWH = sizes[id];
- for ( var i = 0; i < endpoints.length; i++) {
- endpoints[i].paint( { timestamp : timestamp, offset : myOffset, dimensions : myWH });
- var l = endpoints[i].connections;
- for ( var j = 0; j < l.length; j++) {
- l[j].paint( { elId : id, ui : ui, recalc : false, timestamp : timestamp }); // ...paint each connection.
- // then, check for dynamic endpoint; need to repaint it.
- var oIdx = l[j].endpoints[0] == endpoints[i] ? 1 : 0;
- if (l[j].endpoints[oIdx].anchor.isDynamic && !l[j].endpoints[oIdx].isFloating()) {
- var oId = oIdx == 0 ? l[j].sourceId : l[j].targetId;
- var oOffset = offsets[oId], oWH = sizes[oId];
- // TODO i still want to make this faster.
- var anchorLoc = l[j].endpoints[oIdx].anchor.compute( {
- xy : [ oOffset.left, oOffset.top ],
- wh : oWH,
- element : l[j].endpoints[oIdx],
- txy : [ myOffset.left, myOffset.top ],
- twh : myWH,
- tElement : endpoints[i]
- });
- l[j].endpoints[oIdx].paint({ anchorLoc : anchorLoc });
- }
- }
- }
- }
- };
- /**
- * executes the given function against the given element if the first
- * argument is an object, or the list of elements, if the first argument
- * is a list. the function passed in takes (element, elementId) as
- * arguments.
- */
- var _elementProxy = function(element, fn) {
- var retVal = null;
- if (element.constructor == Array) {
- retVal = [];
- for ( var i = 0; i < element.length; i++) {
- var el = _getElementObject(element[i]), id = _getAttribute(el, "id");
- retVal.push(fn(el, id)); // append return values to what we will return
- }
- } else {
- var el = _getElementObject(element), id = _getAttribute(el, "id");
- retVal = fn(el, id);
- }
- return retVal;
- };
- /**
- *
- */
- var _log = function(msg) {
- if (_currentInstance.logEnabled && typeof console != "undefined")
- console.log(msg);
- };
-
- var _getAttribute = function(el, attName) { return jsPlumb.CurrentLibrary.getAttribute(_getElementObject(el), attName); };
- var _setAttribute = function(el, attName, attValue) { jsPlumb.CurrentLibrary.setAttribute(_getElementObject(el), attName, attValue); };
- var _addClass = function(el, clazz) { jsPlumb.CurrentLibrary.addClass(_getElementObject(el), clazz); };
- var _removeClass = function(el, clazz) { jsPlumb.CurrentLibrary.removeClass(_getElementObject(el), clazz); };
- var _getElementObject = function(el) { return jsPlumb.CurrentLibrary.getElementObject(el); };
- var _getOffset = function(el) { return jsPlumb.CurrentLibrary.getOffset(_getElementObject(el)); };
- var _getSize = function(el) { return jsPlumb.CurrentLibrary.getSize(_getElementObject(el)); };
- /**
- * gets an id for the given element, creating and setting one if
- * necessary.
- */
- var _getId = function(element, uuid) {
- var ele = _getElementObject(element);
- var id = _getAttribute(ele, "id");
- if (!id || id == "undefined") {
- // check if fixed uuid parameter is given
- if (arguments.length == 2 && arguments[1] != undefined)
- id = uuid;
- else
- id = "jsPlumb_" + _timestamp();
- _setAttribute(ele, "id", id);
- }
- return id;
- };
- /**
- * gets an Endpoint by uuid.
- */
- var _getEndpoint = function(uuid) { return endpointsByUUID[uuid]; };
- /**
- * inits a draggable if it's not already initialised.
- */
- var _initDraggableIfNecessary = function(element, isDraggable, dragOptions) {
- var draggable = isDraggable == null ? _draggableByDefault : isDraggable;
- if (draggable) {
- if (jsPlumb.CurrentLibrary.isDragSupported(element) && !jsPlumb.CurrentLibrary.isAlreadyDraggable(element)) {
- var options = dragOptions || _currentInstance.Defaults.DragOptions || jsPlumb.Defaults.DragOptions;
- options = jsPlumb.extend( {}, options); // make a copy.
- var dragEvent = jsPlumb.CurrentLibrary.dragEvents['drag'];
- var stopEvent = jsPlumb.CurrentLibrary.dragEvents['stop'];
- options[dragEvent] = _wrap(options[dragEvent], function() {
- var ui = jsPlumb.CurrentLibrary.getUIPosition(arguments);
- _draw(element, ui);
- _addClass(element, "jsPlumb_dragged");
- });
- options[stopEvent] = _wrap(options[stopEvent], function() {
- var ui = jsPlumb.CurrentLibrary.getUIPosition(arguments);
- _draw(element, ui);
- _removeClass(element, "jsPlumb_dragged");
- });
- var draggable = draggableStates[_getId(element)];
- options.disabled = draggable == null ? false : !draggable;
- jsPlumb.CurrentLibrary.initDraggable(element, options);
- }
- }
- };
- /**
- * helper to create a canvas.
- *
- * @param clazz
- * optional class name for the canvas.
- */
- var _newCanvas = function(clazz, parent, uuid) {
- var canvas = document.createElement("canvas");
- _appendElement(canvas, parent);
- canvas.style.position = "absolute";
- if (clazz) canvas.className = clazz;
- // set an id. if no id on the element and if uuid was supplied it
- // will be used, otherwise we'll create one.
- _getId(canvas, uuid);
- if (ie) {
- // for IE we have to set a big canvas size. actually you can
- // override this, too, if 1200 pixels
- // is not big enough for the biggest connector/endpoint canvas
- // you have at startup.
- jsPlumb.sizeCanvas(canvas, 0, 0, DEFAULT_NEW_CANVAS_SIZE, DEFAULT_NEW_CANVAS_SIZE);
- canvas = G_vmlCanvasManager.initElement(canvas);
- }
- return canvas;
- };
- /**
- * performs the given function operation on all the connections found
- * for the given element id; this means we find all the endpoints for
- * the given element, and then for each endpoint find the connectors
- * connected to it. then we pass each connection in to the given
- * function.
- */
- var _operation = function(elId, func) {
- var endpoints = endpointsByElement[elId];
- if (endpoints && endpoints.length) {
- for ( var i = 0; i < endpoints.length; i++) {
- for ( var j = 0; j < endpoints[i].connections.length; j++) {
- var retVal = func(endpoints[i].connections[j]);
- // if the function passed in returns true, we exit.
- // most functions return false.
- if (retVal) return;
- }
- }
- }
- };
- /**
- * perform an operation on all elements.
- */
- var _operationOnAll = function(func) {
- for ( var elId in endpointsByElement) {
- _operation(elId, func);
- }
- };
- /**
- * helper to remove an element from the DOM.
- */
- var _removeElement = function(element, parent) {
- if (element != null) {
- if (!parent) {
- try {
- document.body.removeChild(element);
- } catch (e) {
- }
- } else {
- jsPlumb.CurrentLibrary.removeElement(element, parent);
- }
- }
- };
- /**
- * helper to remove a list of elements from the DOM.
- */
- var _removeElements = function(elements, parent) {
- for ( var i = 0; i < elements.length; i++)
- _removeElement(elements[i], parent);
- };
- /**
- * helper method to remove an item from a list.
- */
- var _removeFromList = function(map, key, value) {
- if (key != null) {
- var l = map[key];
- if (l != null) {
- var i = _findIndex(l, value);
- if (i >= 0) {
- delete (l[i]);
- l.splice(i, 1);
- return true;
- }
- }
- }
- return false;
- };
- /**
- * Sets whether or not the given element(s) should be draggable,
- * regardless of what a particular plumb command may request.
- *
- * @param element
- * May be a string, a element objects, or a list of
- * strings/elements.
- * @param draggable
- * Whether or not the given element(s) should be draggable.
- */
- var _setDraggable = function(element, draggable) {
- return _elementProxy(element, function(el, id) {
- draggableStates[id] = draggable;
- if (jsPlumb.CurrentLibrary.isDragSupported(el)) {
- jsPlumb.CurrentLibrary.setDraggable(el, draggable);
- }
- });
- };
- /**
- * private method to do the business of hiding/showing.
- *
- * @param el
- * either Id of the element in question or a library specific
- * object for the element.
- * @param state
- * String specifying a value for the css 'display' property
- * ('block' or 'none').
- */
- var _setVisible = function(el, state) {
- _operation(_getAttribute(el, "id"), function(jpc) {
- jpc.canvas.style.display = state;
- });
- };
- /**
- * toggles the draggable state of the given element(s).
- *
- * @param el
- * either an id, or an element object, or a list of
- * ids/element objects.
- */
- var _toggleDraggable = function(el) {
- return _elementProxy(el, function(el, elId) {
- var state = draggableStates[elId] == null ? _draggableByDefault : draggableStates[elId];
- state = !state;
- draggableStates[elId] = state;
- jsPlumb.CurrentLibrary.setDraggable(el, state);
- return state;
- });
- };
- /**
- * private method to do the business of toggling hiding/showing.
- *
- * @param elId
- * Id of the element in question
- */
- var _toggleVisible = function(elId) {
- _operation(elId, function(jpc) {
- var state = ('none' == jpc.canvas.style.display);
- jpc.canvas.style.display = state ? "block" : "none";
- });
- // todo this should call _elementProxy, and pass in the
- // _operation(elId, f) call as a function. cos _toggleDraggable does
- // that.
- };
- /**
- * updates the offset and size for a given element, and stores the
- * values. if 'offset' is not null we use that (it would have been
- * passed in from a drag call) because it's faster; but if it is null,
- * or if 'recalc' is true in order to force a recalculation, we use the
- * offset, outerWidth and outerHeight methods to get the current values.
- */
- var _updateOffset = function(params) {
- var timestamp = params.timestamp, recalc = params.recalc, offset = params.offset, elId = params.elId;
- if (!recalc) {
- if (timestamp && timestamp === offsetTimestamps[elId])
- return;
- }
- if (recalc || offset == null) { // if forced repaint or no offset
- // available, we recalculate.
- // get the current size and offset, and store them
- var s = _getElementObject(elId);
- sizes[elId] = _getSize(s);
- offsets[elId] = _getOffset(s);
- offsetTimestamps[elId] = timestamp;
- } else {
- offsets[elId] = offset;
- }
- };
- /**
- * wraps one function with another, creating a placeholder for the
- * wrapped function if it was null. this is used to wrap the various
- * drag/drop event functions - to allow jsPlumb to be notified of
- * important lifecycle events without imposing itself on the user's
- * drag/drop functionality. TODO: determine whether or not we should
- * support an error handler concept, if one of the functions fails.
- *
- * @param wrappedFunction original function to wrap; may be null.
- * @param newFunction function to wrap the original with.
- * @param returnOnThisValue Optional. Indicates that the wrappedFunction should
- * not be executed if the newFunction returns a value matching 'returnOnThisValue'.
- * note that this is a simple comparison and only works for primitives right now.
- */
- var _wrap = function(wrappedFunction, newFunction, returnOnThisValue) {
- wrappedFunction = wrappedFunction || function() { };
- newFunction = newFunction || function() { };
- return function() {
- var r = null;
- try {
- r = newFunction.apply(this, arguments);
- } catch (e) {
- _log('jsPlumb function failed : ' + e);
- }
- if (returnOnThisValue == null || (r !== returnOnThisValue)) {
- try {
- wrappedFunction.apply(this, arguments);
- } catch (e) {
- _log('wrapped function failed : ' + e);
- }
- }
- return r;
- };
- };
- /*
- * Class: Anchor Models a position relative to the origin of some
- * element that an Endpoint can be located.
- */
- /*
- * Function: Anchor
- *
- * Constructor for the Anchor class
- *
- * Parameters:
- * - x : the x location of the anchor as a fraction of the total width. -
- * y : the y location of the anchor as a fraction of the total height. -
- * orientation : an [x,y] array indicating the general direction a
- * connection from the anchor should go in. for more info on this, see
- * the documentation, or the docs in jquery-jsPlumb-defaults-XXX.js for
- * the default Anchors. - offsets : an [x,y] array of fixed offsets that
- * should be applied after the x,y position has been figured out. may be
- * null.
- */
- var Anchor = function(params) {
- var self = this;
- this.x = params.x || 0;
- this.y = params.y || 0;
- var orientation = params.orientation || [ 0, 0 ];
- var lastTimestamp = null, lastReturnValue = null;
- this.offsets = params.offsets || [ 0, 0 ];
- self.timestamp = null;
- this.compute = function(params) {
- var xy = params.xy, wh = params.wh, element = params.element, timestamp = params.timestamp;
- if (timestamp && timestamp === self.timestamp) {
- return lastReturnValue;
- }
- lastReturnValue = [ xy[0] + (self.x * wh[0]) + self.offsets[0], xy[1] + (self.y * wh[1]) + self.offsets[1] ];
- var container = element ? element.container : null;
- var containerAdjustment = { left : 0, top : 0 };
- if (container != null) {
- var eo = _getElementObject(container);
- var o = _getOffset(eo);
- var sl = jsPlumb.CurrentLibrary.getScrollLeft(eo);
- var st = jsPlumb.CurrentLibrary.getScrollTop(eo);
- containerAdjustment.left = o.left - sl;
- containerAdjustment.top = o.top - st;
- lastReturnValue[0] = lastReturnValue[0] - containerAdjustment.left;
- lastReturnValue[1] = lastReturnValue[1] - containerAdjustment.top;
- }
- self.timestamp = timestamp;
- return lastReturnValue;
- };
- this.getOrientation = function() { return orientation; };
- this.equals = function(anchor) {
- if (!anchor) return false;
- var ao = anchor.getOrientation();
- var o = this.getOrientation();
- return this.x == anchor.x && this.y == anchor.y
- && this.offsets[0] == anchor.offsets[0]
- && this.offsets[1] == anchor.offsets[1]
- && o[0] == ao[0] && o[1] == ao[1];
- };
- this.getCurrentLocation = function() { return lastReturnValue; };
- };
- /**
- * An Anchor that floats. its orientation is computed dynamically from
- * its position relative to the anchor it is floating relative to.
- *
- */
- var FloatingAnchor = function(params) {
- // this is the anchor that this floating anchor is referenced to for
- // purposes of calculating the orientation.
- var ref = params.reference;
- // the canvas this refers to.
- var refCanvas = params.referenceCanvas;
- var size = _getSize(_getElementObject(refCanvas));
- // these are used to store the current relative position of our
- // anchor wrt the reference anchor. they only indicate
- // direction, so have a value of 1 or -1 (or, very rarely, 0). these
- // values are written by the compute method, and read
- // by the getOrientation method.
- var xDir = 0, yDir = 0;
- // temporary member used to store an orientation when the floating
- // anchor is hovering over another anchor.
- var orientation = null;
- var _lastResult = null;
- this.compute = function(params) {
- var xy = params.xy, el = params.element;
- var result = [ xy[0] + (size[0] / 2), xy[1] + (size[1] / 2) ]; // return origin of the element. we may wish to improve this so that any object can be the drag proxy.
- if (el.container != null) {
- var o = _getOffset(el.container);
- result[0] = result[0] - o.left;
- result[1] = result[1] - o.top;
- }
- _lastResult = result;
- return result;
- };
- this.getOrientation = function() {
- if (orientation) return orientation;
- else {
- var o = ref.getOrientation();
- // here we take into account the orientation of the other
- // anchor: if it declares zero for some direction, we declare zero too. this might not be the most awesome. perhaps we can come
- // up with a better way. it's just so that the line we draw looks like it makes sense. maybe this wont make sense.
- return [ Math.abs(o[0]) * xDir * -1,
- Math.abs(o[1]) * yDir * -1 ];
- }
- };
- /**
- * notification the endpoint associated with this anchor is hovering
- * over another anchor; we want to assume that anchor's orientation
- * for the duration of the hover.
- */
- this.over = function(anchor) { orientation = anchor.getOrientation(); };
- /**
- * notification the endpoint associated with this anchor is no
- * longer hovering over another anchor; we should resume calculating
- * orientation as we normally do.
- */
- this.out = function() { orientation = null; };
- this.getCurrentLocation = function() { return _lastResult; };
- };
- /*
- * Class: DynamicAnchor
- *
- * An Anchor that contains a list of other Anchors, which it cycles
- * through at compute time to find the one that is located closest to
- * the center of the target element, and returns that Anchor's compute
- * method result. this causes endpoints to follow each other with
- * respect to the orientation of their target elements - a useful
- * feature for some applications.
- *
- * the second argument - anchorSelector - is optional, but when provided should be a function
- * that
- */
- var DynamicAnchor = function(anchors, anchorSelector) {
- this.isSelective = true;
- this.isDynamic = true;
- var _anchors = anchors || [];
- var _convert = function(anchor) { return anchor.constructor == Anchor ? anchor: jsPlumb.makeAnchor(anchor); };
- for (var i = 0; i < _anchors.length; i++) _anchors[i] = _convert(_anchors[i]);
- this.addAnchor = function(anchor) { _anchors.push(_convert(anchor)); };
- this.getAnchors = function() { return _anchors; };
- var _curAnchor = _anchors.length > 0 ? _anchors[0] : null;
- var _curIndex = _anchors.length > 0 ? 0 : -1;
- this.locked = false;
- var self = this;
-
- // helper method to calculate the distance between the centers of the two elements.
- var _distance = function(anchor, cx, cy, xy, wh) {
- var ax = xy[0] + (anchor.x * wh[0]), ay = xy[1] + (anchor.y * wh[1]);
- return Math.sqrt(Math.pow(cx - ax, 2) + Math.pow(cy - ay, 2));
- };
- // default method uses distance between element centers. you can provide your own method in the dynamic anchor
- // constructor (and also to jsPlumb.makeDynamicAnchor). the arguments to it are four arrays:
- // xy - xy loc of the anchor's element
- // wh - anchor's element's dimensions
- // txy - xy loc of the element of the other anchor in the connection
- // twh - dimensions of the element of the other anchor in the connection.
- // anchors - the list of selectable anchors
- var _anchorSelector = anchorSelector || function(xy, wh, txy, twh, anchors) {
- var cx = txy[0] + (twh[0] / 2), cy = txy[1] + (twh[1] / 2);
- var minIdx = -1, minDist = Infinity;
- for ( var i = 0; i < anchors.length; i++) {
- var d = _distance(anchors[i], cx, cy, xy, wh);
- if (d < minDist) {
- minIdx = i + 0;
- minDist = d;
- }
- }
- return anchors[minIdx];
- };
- this.compute = function(params) {
- var xy = params.xy, wh = params.wh, timestamp = params.timestamp, txy = params.txy, twh = params.twh;
- // if anchor is locked or an opposite element was not given, we
- // maintain our state. anchor will be locked
- // if it is the source of a drag and drop.
- if (self.locked || txy == null || twh == null)
- return _curAnchor.compute(params);
- else
- params.timestamp = null; // otherwise clear this, i think. we want the anchor to compute.
-
- _curAnchor = _anchorSelector(xy, wh, txy, twh, _anchors);
-
- var pos = _curAnchor.compute(params);
- return pos;
- };
- this.getCurrentLocation = function() {
- var cl = _curAnchor != null ? _curAnchor.getCurrentLocation() : null;
- return cl;
- };
- this.getOrientation = function() { return _curAnchor != null ? _curAnchor.getOrientation() : [ 0, 0 ]; };
- this.over = function(anchor) { if (_curAnchor != null) _curAnchor.over(anchor); };
- this.out = function() { if (_curAnchor != null) _curAnchor.out(); };
- };
- /*
- * Class:Connection
- *
- * The connecting line between two Endpoints.
- *
- */
- var Connection = function(params) {
- EventGenerator.apply(this);
- // ************** get the source and target and register the
- // connection. *******************
- var self = this;
- var id = new String('_jsplumb_c_' + (new Date()).getTime());
- this.getId = function() { return id; };
- this.container = params.container || _currentInstance.Defaults.Container; // may be null; we will append to the body if so.
- // get source and target as jQuery objects
- this.source = _getElementObject(params.source);
- this.target = _getElementObject(params.target);
- // sourceEndpoint and targetEndpoint override source/target, if they are present.
- if (params.sourceEndpoint) this.source = params.sourceEndpoint.getElement();
- if (params.targetEndpoint) this.target = params.targetEndpoint.getElement();
- this.sourceId = _getAttribute(this.source, "id");
- this.targetId = _getAttribute(this.target, "id");
- this.endpointsOnTop = params.endpointsOnTop != null ? params.endpointsOnTop : true;
- this.scope = params.scope; // scope may have been passed in to the connect call.
- // if it wasn't, we will pull it from the source endpoint, after having initialised the endpoints. init endpoints
- this.endpoints = [];
- this.endpointStyles = [];
- // wrapped the main function to return null if no input given. this lets us cascade defaults properly.
- var _makeAnchor = function(anchorParams) {
- if (anchorParams)
- return jsPlumb.makeAnchor(anchorParams);
- };
- var prepareEndpoint = function(existing, index, params, element) {
- if (existing) {
- self.endpoints[index] = existing;
- existing.addConnection(self);
- } else {
- if (!params.endpoints) params.endpoints = [ null, null ];
- var ep = params.endpoints[index] || params.endpoint
- || _currentInstance.Defaults.Endpoints[index]
- || jsPlumb.Defaults.Endpoints[index]
- || _currentInstance.Defaults.Endpoint
- || jsPlumb.Defaults.Endpoint
- || new jsPlumb.Endpoints.Dot();
- if (ep.constructor == String) ep = new jsPlumb.Endpoints[ep]();
- if (!params.endpointStyles) params.endpointStyles = [ null, null ];
- var es = params.endpointStyles[index] || params.endpointStyle || _currentInstance.Defaults.EndpointStyles[index] || jsPlumb.Defaults.EndpointStyles[index] || _currentInstance.Defaults.EndpointStyle || jsPlumb.Defaults.EndpointStyle;
- var a = params.anchors ? params.anchors[index] : _makeAnchor(_currentInstance.Defaults.Anchors[index]) || _makeAnchor(jsPlumb.Defaults.Anchors[index]) || _makeAnchor(_currentInstance.Defaults.Anchor) || _makeAnchor(jsPlumb.Defaults.Anchor) || _makeAnchor("BottomCenter");
- var u = params.uuids ? params.uuids[index] : null;
- var e = new Endpoint( { style : es, endpoint : ep, connections : [ self ], uuid : u, anchor : a, source : element, container : self.container });
- self.endpoints[index] = e;
- return e;
- }
- };
- var eS = prepareEndpoint(params.sourceEndpoint, 0, params, self.source);
- if (eS) _addToList(endpointsByElement, this.sourceId, eS);
- var eT = prepareEndpoint(params.targetEndpoint, 1, params, self.target);
- if (eT) _addToList(endpointsByElement, this.targetId, eT);
- // if scope not set, set it to be the scope for the source endpoint.
- if (!this.scope) this.scope = this.endpoints[0].scope;
- this.connector = this.endpoints[0].connector || this.endpoints[1].connector || params.connector || _currentInstance.Defaults.Connector || jsPlumb.Defaults.Connector || new jsPlumb.Connectors.Bezier();
- if (this.connector.constructor == String) this.connector = new jsPlumb.Connectors[this.connector](); // lets you use a string as shorthand.
- this.paintStyle = this.endpoints[0].connectorStyle || this.endpoints[1].connectorStyle || params.paintStyle || _currentInstance.Defaults.PaintStyle || jsPlumb.Defaults.PaintStyle;
- this.backgroundPaintStyle = this.endpoints[0].connectorBackgroundStyle || this.endpoints[1].connectorBackgroundStyle || params.backgroundPaintStyle || _currentInstance.Defaults.BackgroundPaintStyle || jsPlumb.Defaults.BackgroundPaintStyle;
- // init overlays
- this.overlays = params.overlays || [];
- this.addOverlay = function(overlay) { overlays.push(overlay); };
- // this is a shortcut helper method to let people add a label as
- // overlay.
- this.labelStyle = params.labelStyle || _currentInstance.Defaults.LabelStyle || jsPlumb.Defaults.LabelStyle;
- this.label = params.label;
- if (this.label) {
- this.overlays.push(new jsPlumb.Overlays.Label( {
- labelStyle : this.labelStyle,
- label : this.label
- }));
- }
- _updateOffset( { elId : this.sourceId });
- _updateOffset( { elId : this.targetId });
- // functions for mouse hover/select functionality
- this.distanceFrom = function(point) { return self.connector.distanceFrom(point); };
- this.setLabel = function(l) {
- self.label = l;
- _currentInstance.repaint(self.source);
- };
- // paint the endpoints
- var myOffset = offsets[this.sourceId], myWH = sizes[this.sourceId];
- var otherOffset = offsets[this.targetId];
- otherWH = sizes[this.targetId];
- // todo: why not fold this and the paint call that follows into one
- // call?
- var anchorLoc = this.endpoints[0].anchor.compute( {
- xy : [ myOffset.left, myOffset.top ], wh : myWH, element : this.endpoints[0],
- txy : [ otherOffset.left, otherOffset.top ], twh : otherWH, tElement : this.endpoints[1]
- });
- this.endpoints[0].paint( { anchorLoc : anchorLoc });
- anchorLoc = this.endpoints[1].anchor.compute( {
- xy : [ otherOffset.left, otherOffset.top ], wh : otherWH, element : this.endpoints[1],
- txy : [ myOffset.left, myOffset.top ], twh : myWH, tElement : this.endpoints[0]
- });
- this.endpoints[1].paint({ anchorLoc : anchorLoc });
- var canvas = _newCanvas(jsPlumb.connectorClass, self.container);
- this.canvas = canvas;
- /*
- * Function: paint
- *
- * paints the connection.
- *
- * Parameters:
- * elId Id of the element that is in motion
- * ui current library's event system ui object (present if we came from a drag to get here)
- */
- this.paint = function(params) {
- params = params || {};
- var elId = params.elId, ui = params.ui, recalc = params.recalc, timestamp = params.timestamp;
- var fai = self.floatingAnchorIndex;
- // if the moving object is not the source we must transpose the
- // two references.
- var swap = false;
- var tId = swap ? this.sourceId : this.targetId, sId = swap ? this.targetId : this.sourceId;
- var tIdx = swap ? 0 : 1, sIdx = swap ? 1 : 0;
- var el = swap ? this.target : this.source;
- if (this.canvas.getContext) {
- _updateOffset( { elId : elId, offset : ui, recalc : recalc, timestamp : timestamp });
- _updateOffset( { elId : tId, timestamp : timestamp }); // update the target if this is a forced repaint. otherwise, only the source has been moved.
- // var myOffset = offsets[sId], otherOffset = offsets[tId], myWH = sizes[sId], otherWH = sizes[tId];
- var ctx = canvas.getContext('2d');
- var sAnchorP = this.endpoints[sIdx].anchor.getCurrentLocation();
- var sAnchorO = this.endpoints[sIdx].anchor.getOrientation();
- var tAnchorP = this.endpoints[tIdx].anchor.getCurrentLocation();
- var tAnchorO = this.endpoints[tIdx].anchor.getOrientation();
-
- // paint overlays
- var maxSize = 0;
- for ( var i = 0; i < self.overlays.length; i++) {
- var o = self.overlays[i];
- var s = o.computeMaxSize(self.connector, ctx);
- if (s > maxSize)
- maxSize = s;
- }
- var dim = this.connector.compute(sAnchorP, tAnchorP, this.endpoints[sIdx].anchor, this.endpoints[tIdx].anchor, this.paintStyle.lineWidth, maxSize);
- jsPlumb.sizeCanvas(canvas, dim[0], dim[1], dim[2], dim[3]);
- var _paintOneStyle = function(ctx, paintStyle) {
- ctx.save();
- jsPlumb.extend(ctx, paintStyle);
- if (paintStyle.gradient && !ie) {
- var g = self.connector.createGradient(dim, ctx, (elId == this.sourceId));
- for ( var i = 0; i < paintStyle.gradient.stops.length; i++)
- g.addColorStop(paintStyle.gradient.stops[i][0], paintStyle.gradient.stops[i][1]);
- ctx.strokeStyle = g;
- }
- self.connector.paint(dim, ctx);
- ctx.restore();
- };
- // first check for the background style
- if (this.backgroundPaintStyle != null) {
- _paintOneStyle(ctx, this.backgroundPaintStyle);
- }
- _paintOneStyle(ctx, this.paintStyle);
- // paint overlays
- for ( var i = 0; i < self.overlays.length; i++) {
- var o = self.overlays[i];
- o.draw(self.connector, ctx);
- }
- }
- };
- // TODO: should this take a timestamp? probably. it reduces the
- // amount of time
- // spent figuring out anchor locations.
- this.repaint = function() {
- this.paint({ elId : this.sourceId, recalc : true });
- };
- _initDraggableIfNecessary(self.source, params.draggable, params.dragOptions);
- _initDraggableIfNecessary(self.target, params.draggable, params.dragOptions);
- // resizing (using the jquery.ba-resize plugin). todo: decide
- // whether to include or not.
- if (this.source.resize) {
- this.source.resize(function(e) {
- jsPlumb.repaint(self.sourceId);
- });
- }
- };
- /*
- * Class: Endpoint Models an endpoint. Can have one to N connections
- * emanating from it (although how to handle that in the UI is a very
- * good question). also has a Canvas and paint style.
- */
- /*
- * Function: Endpoint This is the Endpoint class constructor.
- * Parameters: anchor - anchor for the endpoint, of type jsPlumb.Anchor.
- * may be null. endpoint - endpoint object, of type jsPlumb.Endpoint.
- * may be null. style - endpoint style, a js object. may be null. source -
- * element the endpoint is attached to, of type jquery object. Required.
- * canvas - canvas element to use. may be, and most often is, null.
- * connections - optional list of connections to configure the endpoint
- * with. isSource - boolean. indicates the endpoint can act as a source
- * of new connections. optional. dragOptions - if isSource is set to
- * true, you can supply arguments for the jquery draggable method.
- * optional. connectionStyle - if isSource is set to true, this is the
- * paint style for connections from this endpoint. optional. connector -
- * optional connector type to use. isTarget - boolean. indicates the
- * endpoint can act as a target of new connections. optional.
- * dropOptions - if isTarget is set to true, you can supply arguments
- * for the jquery droppable method. optional. reattach - optional
- * boolean that determines whether or not the connections reattach after
- * they have been dragged off an endpoint and left floating. defaults to
- * false: connections dropped in this way will just be deleted.
- */
- var Endpoint = function(params) {
- params = params || {};
- var self = this;
- var id = new String('_jsplumb_e_' + (new Date()).getTime());
- this.getId = function() { return id; };
- if (params.dynamicAnchors)
- self.anchor = new DynamicAnchor(jsPlumb.makeAnchors(params.dynamicAnchors));
- else
- self.anchor = params.anchor ? jsPlumb.makeAnchor(params.anchor) : params.anchors ? jsPlumb.makeAnchor(params.anchors) : jsPlumb.makeAnchor("TopCenter");
- var _endpoint = params.endpoint || new jsPlumb.Endpoints.Dot();
- if (_endpoint.constructor == String) _endpoint = new jsPlumb.Endpoints[_endpoint]();
- self.endpoint = _endpoint;
- var _style = params.style || _currentInstance.Defaults.EndpointStyle || jsPlumb.Defaults.EndpointStyle;
- this.connectorStyle = params.connectorStyle;
- this.connectorOverlays = params.connectorOverlays;
- this.connector = params.connector;
- this.isSource = params.isSource || false;
- this.isTarget = params.isTarget || false;
- var _element = params.source, _uuid = params.uuid;
- var floatingEndpoint = null, inPlaceCopy = null;
- if (_uuid) endpointsByUUID[_uuid] = self;
- this.container = params.container || _currentInstance.Defaults.Container || jsPlumb.Defaults.Container;
- var _elementId = _getAttribute(_element, "id");
- this.elementId = _elementId;
- var _maxConnections = params.maxConnections || 1; // maximum number of connections this endpoint can be the source of.
- this.canvas = params.canvas || _newCanvas(jsPlumb.endpointClass, this.container, params.uuid);
- this.connections = params.connections || [];
- this.scope = params.scope || DEFAULT_SCOPE;
- this.timestamp = null;
- var _reattach = params.reattach || false;
- this.dragAllowedWhenFull = params.dragAllowedWhenFull || true;
- this.computeAnchor = function(params) {
- return self.anchor.compute(params);
- };
- this.addConnection = function(connection) {
- self.connections.push(connection);
- };
- this.detach = function(connection, ignoreTarget) {
- var idx = _findIndex(self.connections, connection);
- if (idx >= 0) {
- self.connections.splice(idx, 1);
- // this avoids a circular loop
- if (!ignoreTarget) {
- var t = connection.endpoints[0] == self ? connection.endpoints[1] : connection.endpoints[0];
- t.detach(connection, true);
- }
- _removeElement(connection.canvas, connection.container);
- _removeFromList(connectionsByScope, connection.scope, connection);
- if(!ignoreTarget) fireDetachEvent(connection);
- }
- };
- /**
- * detaches all connections this Endpoint has
- */
- this.detachAll = function() {
- while (self.connections.length > 0) {
- self.detach(self.connections[0]);
- }
- };
- /**
- * removes any connections from this Endpoint that are connected to
- * the given target endpoint.
- *
- * @param targetEndpoint
- */
- this.detachFrom = function(targetEndpoint) {
- var c = [];
- for ( var i = 0; i < self.connections.length; i++) {
- if (self.connections[i].endpoints[1] == targetEndpoint
- || self.connections[i].endpoints[0] == targetEndpoint) {
- c.push(self.connections[i]);
- }
- }
- for ( var i = 0; i < c.length; i++) {
- self.detach(c[i]);
- }
- };
-
- /**
- * detach this Endpoint from the Connection, but leave the Connection alive. used when dragging.
- */
- this.detachFromConnection = function(connection) {
- var idx = _findIndex(self.connections, connection);
- if (idx >= 0) {
- self.connections.splice(idx, 1);
- }
- };
- /**
- * returns the DOM element this Endpoint is attached to.
- */
- this.getElement = function() {
- return _element;
- };
- /**
- * returns the UUID for this Endpoint, if there is one.
- */
- this.getUuid = function() {
- return _uuid;
- };
- /**
- * private but must be exposed.
- */
- this.makeInPlaceCopy = function() {
- var e = new Endpoint( { anchor : self.anchor, source : _element, style : _style, endpoint : _endpoint });
- return e;
- };
- /**
- * returns whether or not this endpoint is connected to the given
- * endpoint.
- *
- * @param endpoint
- * Endpoint to test.
- * @since 1.1.1
- *
- * todo: needs testing. will this work if the endpoint passed in is
- * the source?
- */
- this.isConnectedTo = function(endpoint) {
- var found = false;
- if (endpoint) {
- for ( var i = 0; i < self.connections.length; i++) {
- if (self.connections[i].endpoints[1] == endpoint) {
- found = true;
- break;
- }
- }
- }
- return found;
- };
- /**
- * private but needs to be exposed.
- *
- * @returns {Boolean}
- */
- this.isFloating = function() {
- return floatingEndpoint != null;
- };
-
- /**
- * returns a connection from the pool; used when dragging starts. just gets the head of the array if it can.
- */
- var connectorSelector = function() {
- return (self.connections.length < _maxConnections) ? null : self.connections[0];
- };
- /**
- * @returns whether or not the Endpoint can accept any more
- * Connections.
- */
- this.isFull = function() {
- return _maxConnections < 1 ? false : (self.connections.length >= _maxConnections);
- };
- /**
- * sets whether or not connnctions can be dragged from this Endpoint
- * once it is full. you would use this in a UI in which you're going
- * to provide some other way of breaking connections, if you need to
- * break them at all. this property is by default true; use it in
- * conjunction with the 'reattach' option on a connect call.
- */
- this.setDragAllowedWhenFull = function(allowed) {
- self.dragAllowedWhenFull = allowed;
- };
- /**
- * a deep equals check. everything must match, including the anchor,
- * styles, everything. TODO: finish Endpoint.equals
- */
- this.equals = function(endpoint) {
- return this.anchor.equals(endpoint.anchor);
- };
- /**
- * paints the Endpoint, recalculating offset and anchor positions if
- * necessary.
- */
- this.paint = function(params) {
- params = params || {};
- var timestamp = params.timestamp;
- if (!timestamp || self.timestamp !== timestamp) {
- var ap = params.anchorPoint, canvas = params.canvas, connectorPaintStyle = params.connectorPaintStyle;
- if (ap == null) {
- // do we always want to force a repaint here? i dont
- // think so!
- var xy = params.offset || offsets[_elementId];
- var wh = params.dimensions || sizes[_elementId];
- if (xy == null || wh == null) {
- _updateOffset( { elId : _elementId, timestamp : timestamp });
- xy = offsets[_elementId];
- wh = sizes[_elementId];
- }
- var anchorParams = { xy : [ xy.left, xy.top ], wh : wh, element : self, timestamp : timestamp };
- if (self.anchor.isDynamic) {
- if (self.connections.length > 0) {
- var c = self.connections[0];
- var oIdx = c.endpoints[0] == self ? 1 : 0;
- var oId = oIdx == 0 ? c.sourceId : c.targetId;
- var oOffset = offsets[oId], oWH = sizes[oId];
- anchorParams.txy = [ oOffset.left, oOffset.top ];
- anchorParams.twh = oWH;
- anchorParams.tElement = c.endpoints[oIdx];
- }
- }
- ap = self.anchor.compute(anchorParams);
- }
- _endpoint.paint(ap, self.anchor.getOrientation(), canvas || self.canvas, _style, connectorPaintStyle || _style);
- self.timestamp = timestamp;
- }
- };
- /**
- * @deprecated
- */
- this.removeConnection = this.detach; // backwards compatibility
- // is this a connection source? we make it draggable and have the
- // drag listener
- // maintain a connection with a floating endpoint.
- if (params.isSource && jsPlumb.CurrentLibrary.isDragSupported(_element)) {
- var n = null, id = null, jpc = null, existingJpc = false, existingJpcParams = null;
- var start = function() {
- jpc = connectorSelector();
- if (self.isFull() && !self.dragAllowedWhenFull) return false;
- _updateOffset( { elId : _elementId });
- inPlaceCopy = self.makeInPlaceCopy();
- inPlaceCopy.paint();
-
- n = document.createElement("div");
- var nE = _getElementObject(n);
- _appendElement(n, self.container); //
- // create and assign an id, and initialize the offset.
- var id = _getId(nE);
- _updateOffset( { elId : id });
- // store the id of the dragging div and the source element. the drop function will pick these up.
- _setAttribute(_getElementObject(self.canvas), "dragId", id);
- _setAttribute(_getElementObject(self.canvas), "elId", _elementId);
- // create a floating anchor
- var floatingAnchor = new FloatingAnchor( { reference : self.anchor, referenceCanvas : self.canvas });
- floatingEndpoint = new Endpoint({ style : { fillStyle : 'rgba(0,0,0,0)' }, endpoint : _endpoint, anchor : floatingAnchor, source : nE });
- if (jpc == null) {
- self.anchor.locked = true;
- // create a connection. one end is this endpoint, the
- // other is a floating endpoint.
- jpc = new Connection( {
- sourceEndpoint : self,
- targetEndpoint : floatingEndpoint,
- source : _getElementObject(_element),
- target : _getElementObject(n),
- anchors : [ self.anchor, floatingAnchor ],
- paintStyle : params.connectorStyle, // this can be null. Connection will use the default.
- connector : params.connector, // this can also be null. Connection will use the default.
- overlays : self.connectorOverlays // new in 1.2.4.
- });
- } else {
- existingJpc = true;
- // if existing connection, allow to be dropped back on the source endpoint (issue 51).
- _initDropTarget(_getElementObject(inPlaceCopy.canvas));
- var anchorIdx = jpc.sourceId == _elementId ? 0 : 1;
- jpc.floatingAnchorIndex = anchorIdx;
- // detach from the connection while dragging is occurring.
- self.detachFromConnection(jpc);
- if (anchorIdx == 0) {
- existingJpcParams = [ jpc.source, jpc.sourceId ];
- jpc.source = _getElementObject(n);
- jpc.sourceId = id;
- } else {
- existingJpcParams = [ jpc.target, jpc.targetId ];
- jpc.target = _getElementObject(n);
- jpc.targetId = id;
- }
- // lock the other endpoint; if it is dynamic it will not
- // move while the drag is occurring.
- jpc.endpoints[anchorIdx == 0 ? 1 : 0].anchor.locked = true;
- // store the original endpoint and assign the new
- // floating endpoint for the drag.
- jpc.suspendedEndpoint = jpc.endpoints[anchorIdx];
- jpc.endpoints[anchorIdx] = floatingEndpoint;
- }
- // register it.
- floatingConnections[id] = jpc;
- // TODO unregister on stop? or will floating endpoint's
- // destruction be assured.
- floatingEndpoint.addConnection(jpc);
- // only register for the target endpoint; we will not be
- // dragging the source at any time
- // before this connection is either discarded or made into a
- // permanent connection.
- _addToList(endpointsByElement, id, floatingEndpoint);
- };
- var dragOptions = params.dragOptions || {};
- var defaultOpts = jsPlumb.extend( {}, jsPlumb.CurrentLibrary.defaultDragOptions);
- dragOptions = jsPlumb.extend(defaultOpts, dragOptions);
- dragOptions.scope = dragOptions.scope || self.scope;
- var startEvent = jsPlumb.CurrentLibrary.dragEvents['start'];
- var stopEvent = jsPlumb.CurrentLibrary.dragEvents['stop'];
- var dragEvent = jsPlumb.CurrentLibrary.dragEvents['drag'];
- dragOptions[startEvent] = _wrap(dragOptions[startEvent], start);
- dragOptions[dragEvent] = _wrap(dragOptions[dragEvent],
- function() {
- var _ui = jsPlumb.CurrentLibrary.getUIPosition(arguments);
- jsPlumb.CurrentLibrary.setOffset(n, _ui);
- _draw(_getElementObject(n), _ui);
- });
- dragOptions[stopEvent] = _wrap(dragOptions[stopEvent],
- function() {
- _removeFromList(endpointsByElement, id, floatingEndpoint);
- _removeElements( [ n, floatingEndpoint.canvas ], _element); // TODO: clean up the connection canvas (if the user aborted)
- _removeElement(inPlaceCopy.canvas, _element);
- var idx = jpc.floatingAnchorIndex == null ? 1 : jpc.floatingAnchorIndex;
- jpc.endpoints[idx == 0 ? 1 : 0].anchor.locked = false;
- if (jpc.endpoints[idx] == floatingEndpoint) {
- // if the connection was an existing one:
- if (existingJpc && jpc.suspendedEndpoint) {
- // fix for issue35, thanks Sylvain Gizard: when firing the detach event make sure the
- // floating endpoint has been replaced.
- if (idx == 0) {
- jpc.source = existingJpcParams[0];
- jpc.sourceId = existingJpcParams[1];
- } else {
- jpc.target = existingJpcParams[0];
- jpc.targetId = existingJpcParams[1];
- }
- jpc.endpoints[idx] = jpc.suspendedEndpoint;
- if (_reattach) {
- jpc.floatingAnchorIndex = null;
- jpc.suspendedEndpoint.addConnection(jpc);
- jsPlumb.repaint(existingJpcParams[1]);
- } else {
- jpc.endpoints[idx == 0 ? 1 : 0].detach(jpc); // the main endpoint will inform the floating endpoint
- // to disconnect, and also post the detached event.
- }
- } else {
- // TODO this looks suspiciously kind of like an Endpoint.detach call too.
- // i wonder if this one should post an event though. maybe this is good like this.
- _removeElement(jpc.canvas, self.container);
- self.detachFromConnection(jpc);
- }
- }
- self.anchor.locked = false;
- self.paint();
- jpc.repaint();
- jpc = null;
- delete inPlaceCopy;
- delete endpointsByElement[floatingEndpoint.elementId];
- delete floatingEndpoint;
- });
-
- var i = _getElementObject(self.canvas);
- jsPlumb.CurrentLibrary.initDraggable(i, dragOptions);
- }
- // pulled this out into a function so we can reuse it for the inPlaceCopy canvas; you can now drop detached connections
- // back onto the endpoint you detached it from.
- var _initDropTarget = function(canvas) {
- if (params.isTarget && jsPlumb.CurrentLibrary.isDropSupported(_element)) {
- var dropOptions = params.dropOptions || _currentInstance.Defaults.DropOptions || jsPlumb.Defaults.DropOptions;
- dropOptions = jsPlumb.extend( {}, dropOptions);
- dropOptions.scope = dropOptions.scope || self.scope;
- var originalAnchor = null;
- var dropEvent = jsPlumb.CurrentLibrary.dragEvents['drop'];
- var overEvent = jsPlumb.CurrentLibrary.dragEvents['over'];
- var outEvent = jsPlumb.CurrentLibrary.dragEvents['out'];
- var drop = function() {
- var draggable = _getElementObject(jsPlumb.CurrentLibrary.getDragObject(arguments));
- var id = _getAttribute(draggable, "dragId");
- var elId = _getAttribute(draggable, "elId");
- var jpc = floatingConnections[id];
- var idx = jpc.floatingAnchorIndex == null ? 1 : jpc.floatingAnchorIndex, oidx = idx == 0 ? 1 : 0;
- if (!self.isFull() && !(idx == 0 && !self.isSource) && !(idx == 1 && !self.isTarget)) {
- if (idx == 0) {
- jpc.source = _element;
- jpc.sourceId = _elementId;
- } else {
- jpc.target = _element;
- jpc.targetId = _elementId;
- }
- // todo test that the target is not full.
- // remove this jpc from the current endpoint
- jpc.endpoints[idx].detachFromConnection(jpc);
- if (jpc.suspendedEndpoint) jpc.suspendedEndpoint.detachFromConnection(jpc);
- jpc.endpoints[idx] = self;
- self.addConnection(jpc);
- if (!jpc.suspendedEndpoint) { // if a new connection, add it. TODO: move this to a jsPlumb internal method - addConnection or something. doesnt need to be exposed.
- _addToList(connectionsByScope, jpc.scope, jpc);
- _initDraggableIfNecessary(_element, params.draggable, {});
- }
- else {
- var suspendedElement = jpc.suspendedEndpoint.getElement(), suspendedElementId = jpc.suspendedEndpoint.elementId;
- // fire a detach event
- _currentInstance.fireUpdate("jsPlumbConnectionDetached", {
- source : idx == 0 ? suspendedElement : jpc.source, target : idx == 1 ? suspendedElement : jpc.target,
- sourceId : idx == 0 ? suspendedElementId : jpc.sourceId, targetId : idx == 1 ? suspendedElementId : jpc.targetId,
- sourceEndpoint : idx == 0 ? jpc.suspendedEndpoint : jpc.endpoints[0], targetEndpoint : idx == 1 ? jpc.suspendedEndpoint : jpc.endpoints[1]
- });
- }
-
- jsPlumb.repaint(elId);
-
- _currentInstance.fireUpdate("jsPlumbConnection", {
- source : jpc.source, target : jpc.target,
- sourceId : jpc.sourceId, targetId : jpc.targetId,
- sourceEndpoint : jpc.endpoints[0], targetEndpoint : jpc.endpoints[1]
- });
- }
-
- delete floatingConnections[id];
- };
-
- dropOptions[dropEvent] = _wrap(dropOptions[dropEvent], drop);
- dropOptions[overEvent] = _wrap(dropOptions[overEvent],
- function() {
- var draggable = jsPlumb.CurrentLibrary.getDragObject(arguments);
- var id = _getAttribute( _getElementObject(draggable), "dragId");
- var jpc = floatingConnections[id];
- var idx = jpc.floatingAnchorIndex == null ? 1 : jpc.floatingAnchorIndex;
- jpc.endpoints[idx].anchor.over(self.anchor);
- });
-
- dropOptions[outEvent] = _wrap(dropOptions[outEvent],
- function() {
- var draggable = jsPlumb.CurrentLibrary.getDragObject(arguments);
- var id = _getAttribute(_getElementObject(draggable), "dragId");
- var jpc = floatingConnections[id];
- var idx = jpc.floatingAnchorIndex == null ? 1 : jpc.floatingAnchorIndex;
- jpc.endpoints[idx].anchor.out();
- });
-
- jsPlumb.CurrentLibrary.initDroppable(canvas, dropOptions);
- }
- };
-
- // initialise the endpoint's canvas as a drop target. this will be ignored if the endpoint is not a target or drag is not supported.
- _initDropTarget(_getElementObject(self.canvas));
- return self;
- };
- /*
- * Property: Defaults These are the default settings for jsPlumb, that
- * is what will be used if you do not supply specific pieces of
- * information to the various API calls. A convenient way to implement
- * your own look and feel can be to override these defaults by including
- * a script somewhere after the jsPlumb include, but before you make any
- * calls to jsPlumb, for instance in this example we set the PaintStyle
- * to be a blue line of 27 pixels: > jsPlumb.Defaults.PaintStyle = {
- * lineWidth:27, strokeStyle:'blue' }
- */
- this.Defaults = {
- Anchor : null,
- Anchors : [ null, null ],
- BackgroundPaintStyle : null,
- Connector : null,
- Container : null,
- DragOptions : {},
- DropOptions : {},
- Endpoint : null,
- Endpoints : [ null, null ],
- EndpointStyle : {
- fillStyle : null
- },
- EndpointStyles : [ null, null ],
- LabelStyle : {
- fillStyle : "rgba(0,0,0,0)",
- color : "black"
- },
- LogEnabled : true,
- MaxConnections : null,
- // TODO: should we have OverlayStyle too?
- PaintStyle : {
- lineWidth : 10,
- strokeStyle : 'red'
- },
- Scope : "_jsPlumb_DefaultScope"
- };
- this.logEnabled = this.Defaults.LogEnabled;
- /*
- * Property: connectorClass The CSS class to set on Connection canvas
- * elements. This value is a String and can have multiple classes; the
- * entire String is appended as-is.
- */
- this.connectorClass = '_jsPlumb_connector';
- /*
- * Property: endpointClass The CSS class to set on Endpoint canvas
- * elements. This value is a String and can have multiple classes; the
- * entire String is appended as-is.
- */
- this.endpointClass = '_jsPlumb_endpoint';
- /*
- * Property: overlayClass The CSS class to set on an Overlay that is an
- * HTML element. This value is a String and can have multiple classes;
- * the entire String is appended as-is.
- */
- this.overlayClass = '_jsPlumb_overlay';
- /*
- * Property: Anchors Default jsPlumb Anchors. These are supplied in the
- * file jsPlumb-defaults-x.x.x.js, which is merged in with the main
- * jsPlumb script to form <library>.jsPlumb-all-x.x.x.js. You can
- * provide your own Anchors by supplying them in a script that is loaded
- * after jsPlumb, for instance: > jsPlumb.Anchors.MyAnchor = {
- * ....anchor code here. see the documentation. }
- */
- this.Anchors = {};
- /*
- * Property: Connectors Default jsPlumb Connectors. These are supplied
- * in the file jsPlumb-defaults-x.x.x.js, which is merged in with the
- * main jsPlumb script to form <library>.jsPlumb-all-x.x.x.js. You can
- * provide your own Connectors by supplying them in a script that is
- * loaded after jsPlumb, for instance: > jsPlumb.Connectors.MyConnector = {
- * ....connector code here. see the documentation. }
- */
- this.Connectors = {};
- /*
- * Property: Endpoints Default jsPlumb Endpoints. These are supplied in
- * the file jsPlumb-defaults-x.x.x.js, which is merged in with the main
- * jsPlumb script to form <library>.jsPlumb-all-x.x.x.js. You can
- * provide your own Endpoints by supplying them in a script that is
- * loaded after jsPlumb, for instance: > jsPlumb.Endpoints.MyEndpoint = {
- * ....endpoint code here. see the documentation. }
- */
- this.Endpoints = {};
- /*
- * Property:Overlays Default jsPlumb Overlays such as Arrows and Labels.
- * These are supplied in the file jsPlumb-defaults-x.x.x.js, which is
- * merged in with the main jsPlumb script to form
- * <library>.jsPlumb-all-x.x.x.js. You can provide your own Overlays by
- * supplying them in a script that is loaded after jsPlumb, for
- * instance: > jsPlumb.Overlays.MyOverlay = { ....overlay code here. see
- * the documentation. }
- */
- this.Overlays = {};
- /*
- * Function: addEndpoint Adds an Endpoint to a given element.
- * Parameters: target - Element to add the endpoint to. either an
- * element id, or a selector representing some element. params - Object
- * containing Endpoint options (more info required) Returns: The newly
- * created Endpoint. See Also: <addEndpoints>
- */
- this.addEndpoint = function(target, params) {
- params = jsPlumb.extend( {}, params);
- params.endpoint = params.endpoint || _currentInstance.Defaults.Endpoint || jsPlumb.Defaults.Endpoint;
- params.endpointStyle = params.endpointStyle || _currentInstance.Defaults.EndpointStyle || jsPlumb.Defaults.EndpointStyle;
- var el = _getElementObject(target), id = _getAttribute(el, "id");
- params.source = el;
- _updateOffset({ elId : id });
- var e = new Endpoint(params);
- _addToList(endpointsByElement, id, e);
- var myOffset = offsets[id], myWH = sizes[id];
- var anchorLoc = e.anchor.compute( { xy : [ myOffset.left, myOffset.top ], wh : myWH, element : e });
- e.paint({ anchorLoc : anchorLoc });
- return e;
- };
- /*
- * Function: addEndpoint Adds a list of Endpoints to a given element.
- * Parameters: target - element to add the endpoint to. either an
- * element id, or a selector representing some element. endpoints - List
- * of objects containing Endpoint options. one Endpoint is created for
- * each entry in this list. Returns: List of newly created Endpoints,
- * one for each entry in the 'endpoints' argument. See Also:
- * <addEndpoint>
- */
- this.addEndpoints = function(target, endpoints) {
- var results = [];
- for ( var i = 0; i < endpoints.length; i++) {
- results.push(_currentInstance.addEndpoint(target, endpoints[i]));
- }
- return results;
- };
- /*
- * Function: animate Wrapper around supporting library's animate
- * function; injects a call to jsPlumb in the 'step' function (creating
- * it if necessary). This only supports the two-arg version of the
- * animate call in jQuery - the one that takes an 'options' object as
- * the second arg. MooTools has only one method - a two arg one. Which
- * is handy. Parameters: el - Element to animate. Either an id, or a
- * selector representing the element. properties - The 'properties'
- * argument you want passed to the standard jQuery animate call. options -
- * The 'options' argument you want passed to the standard jQuery animate
- * call. Returns: void
- */
- this.animate = function(el, properties, options) {
- var ele = _getElementObject(el), id = _getAttribute(el, "id");
- options = options || {};
- var stepFunction = jsPlumb.CurrentLibrary.dragEvents['step'];
- var completeFunction = jsPlumb.CurrentLibrary.dragEvents['complete'];
- options[stepFunction] = _wrap(options[stepFunction], function() {
- _currentInstance.repaint(id);
- });
- // you know, probably onComplete should repaint too. that will help
- // keep up
- // with fast animations.
- options[completeFunction] = _wrap(options[completeFunction],
- function() {
- _currentInstance.repaint(id);
- });
- jsPlumb.CurrentLibrary.animate(ele, properties, options);
- };
- /*
- * Function: connect Establishes a connection between two elements.
- * Parameters: params - Object containing setup for the connection. see
- * documentation. Returns: The newly created Connection.
- */
- this.connect = function(params) {
- var _p = jsPlumb.extend( {}, params);
- // test for endpoint uuids to connect
- if (params.uuids) {
- _p.sourceEndpoint = _getEndpoint(params.uuids[0]);
- _p.targetEndpoint = _getEndpoint(params.uuids[1]);
- }
- // now ensure that if we do have Endpoints already, they're not
- // full.
- if (_p.sourceEndpoint && _p.sourceEndpoint.isFull()) {
- _log("could not add connection; source endpoint is full");
- return;
- }
- if (_p.targetEndpoint && _p.targetEndpoint.isFull()) {
- _log("could not add connection; target endpoint is full");
- return;
- }
-
- // dynamic anchors
- if (_p.dynamicAnchors) {
- // these can either be an array of anchor coords, which we will use for both source and target, or an object with {source:[anchors], target:[anchors]}, in which
- // case we will use a different set for each element.
- var a = _p.dynamicAnchors.constructor == Array;
- var sa = a ? new DynamicAnchor(jsPlumb.makeAnchors(_p.dynamicAnchors)) : new DynamicAnchor(jsPlumb.makeAnchors(_p.dynamicAnchors.source));
- var ta = a ? new DynamicAnchor(jsPlumb.makeAnchors(_p.dynamicAnchors)) : new DynamicAnchor(jsPlumb.makeAnchors(_p.dynamicAnchors.target));
- _p.anchors = [sa,ta];
- }
- var jpc = new Connection(_p);
- // add to list of connections (by scope).
- _addToList(connectionsByScope, jpc.scope, jpc);
- // fire an event
- _currentInstance.fireUpdate("jsPlumbConnection", {
- source : jpc.source, target : jpc.target,
- sourceId : jpc.sourceId, targetId : jpc.targetId,
- sourceEndpoint : jpc.endpoints[0], targetEndpoint : jpc.endpoints[1]
- });
- // force a paint
- _draw(jpc.source);
- return jpc;
- };
-
- /*
- Function: deleteEndpoint
-
- deletes an endpoint and removes all connections it has (which removes the connections from the other endpoints involved too)
-
- You can call this with either a string uuid, or an Endpoint
-
- */
- this.deleteEndpoint = function(object) {
- var endpoint = (typeof object == "string") ? endpointsByUUID[object] : object;
- if (endpoint) {
- var uuid = endpoint.getUuid();
- if (uuid) endpointsByUUID[uuid] = null;
- endpoint.detachAll();
- _removeElement(endpoint.canvas, endpoint.container);
- // remove from endpointsbyElement
- for (var e in endpointsByElement) {
- var endpoints = endpointsByElement[e];
- if (endpoints) {
- var newEndpoints = [];
- for (var i = 0; i < endpoints.length; i++)
- if (endpoints[i] != endpoint) newEndpoints.push(endpoints[i]);
-
- endpointsByElement[e] = newEndpoints;
- }
- }
- delete endpoint;
- }
- };
-
- /*
- * Function: deleteEveryEndpoint
- *
- * Deletes every Endpoint in this instance
- * of jsPlumb. Use this instead of removeEveryEndpoint now.
- *
- * Returns: void
- */
- this.deleteEveryEndpoint = function() {
- for ( var id in endpointsByElement) {
- var endpoints = endpointsByElement[id];
- if (endpoints && endpoints.length) {
- for ( var i = 0; i < endpoints.length; i++) {
- _currentInstance.deleteEndpoint(endpoints[i]);
- }
- }
- }
- delete endpointsByElement;
- endpointsByElement = {};
- delete endpointsByUUID;
- endpointsByUUID = {};
- };
- var fireDetachEvent = function(jpc) {
- _currentInstance.fireUpdate("jsPlumbConnectionDetached", {
- source : jpc.source, target : jpc.target,
- sourceId : jpc.sourceId, targetId : jpc.targetId,
- sourceEndpoint : jpc.endpoints[0], targetEndpoint : jpc.endpoints[1]
- });
- };
- /*
- * Function:
- * detach Removes a connection. takes either (source, target) (the old way, maintained for backwards compatibility), or a params
- * object with various possible values.
- *
- *
- * Parameters:
- * source - id or element object of the first element in the connection.
- * target - id or element object of the second element in the connection.
- *
- * OR
- *
- * params:
- * {
- *
- * Returns: true if successful, false if not.
- */
- this.detach = function(source, target) {
- if (arguments.length == 2) {
- var s = _getElementObject(source), sId = _getId(s);
- var t = _getElementObject(target), tId = _getId(t);
- _operation(sId, function(jpc) {
- if ((jpc.sourceId == sId && jpc.targetId == tId) || (jpc.targetId == sId && jpc.sourceId == tId)) {
- _removeElement(jpc.canvas, jpc.container);
- jpc.endpoints[0].removeConnection(jpc);
- jpc.endpoints[1].removeConnection(jpc);
- _removeFromList(connectionsByScope, jpc.scope, jpc);
- fireDetachEvent(jpc);
- }
- });
- }
- // this is the new version of the method, taking a JS object like
- // the connect method does.
- else if (arguments.length == 1) {
- if (arguments[0].constructor == Connection) {
- arguments[0].endpoints[0].detachFrom(arguments[0].endpoints[1]);
- fireDetachEvent(arguments[0]);
- }
- else if (arguments[0].connection) {
- arguments[0].connection.endpoints[0].detachFrom(arguments[0].connection.endpoints[1]);
- fireDetachEvent(arguments[0].connection);
- }
- else {
- var _p = jsPlumb.extend( {}, source); // a backwards compatibility hack: source should be thought of as 'params' in this case.
- // test for endpoint uuids to detach
- if (_p.uuids) {
- _getEndpoint(_p.uuids[0]).detachFrom(_getEndpoint(_p.uuids[1]));
- } else if (_p.sourceEndpoint && _p.targetEndpoint) {
- _p.sourceEndpoint.detachFrom(_p.targetEndpoint);
- } else {
- sourceId = _getId(_p.source);
- targetId = _getId(_p.target);
- _operation(sourceId, function(jpc) {
- if ((jpc.sourceId == sourceId && jpc.targetId == targetId) || (jpc.targetId == sourceId && jpc.sourceId == targetId)) {
- _removeElement(jpc.canvas, jpc.container);
- jpc.endpoints[0].removeConnection(jpc);
- jpc.endpoints[1].removeConnection(jpc);
- _removeFromList(connectionsByScope, jpc.scope, jpc);
- fireDetachEvent(jpc);
- }
- });
- }
- }
- }
- };
- /*
- * Function: detachAll Removes all an element's connections. Parameters:
- * el - either the id of the element, or a selector for the element.
- * Returns: void
- */
- this.detachAllConnections = function(el) {
- var id = _getAttribute(el, "id");
- var endpoints = endpointsByElement[id];
- if (endpoints && endpoints.length) {
- for ( var i = 0; i < endpoints.length; i++) {
- endpoints[i].detachAll();
- }
- }
- };
-
- /**
- * @deprecated Use detachAllConnections instead. this will be removed in jsPlumb 1.3.
- */
- this.detachAll = this.detachAllConnections;
- /*
- * Function: detachEverything Remove all Connections from all elements,
- * but leaves Endpoints in place. Returns: void See Also:
- * <removeEveryEndpoint>
- */
- this.detachEveryConnection = function() {
- for ( var id in endpointsByElement) {
- var endpoints = endpointsByElement[id];
- if (endpoints && endpoints.length) {
- for ( var i = 0; i < endpoints.length; i++) {
- endpoints[i].detachAll();
- }
- }
- }
- delete connectionsByScope;
- connectionsByScope = {};
- };
-
- /**
- * @deprecated use detachEveryConnection instead. this will be removed in jsPlumb 1.3.
- */
- this.detachEverything = this.detachEveryConnection;
- /*
- * Function: draggable initialises the draggability of some element or
- * elements. Parameters: el - either an element id, a list of element
- * ids, or a selector. options - options to pass through to the
- * underlying library Returns: void
- */
- this.draggable = function(el, options) {
- if (typeof el == 'object' && el.length) {
- for ( var i = 0; i < el.length; i++) {
- var ele = _getElementObject(el[i]);
- if (ele) _initDraggableIfNecessary(ele, true, options);
- }
- }
- else if (el._nodes) { // this is YUI specific; really the logic should be forced
- // into the library adapters (for jquery and mootools aswell)
- for ( var i = 0; i < el._nodes.length; i++) {
- var ele = _getElementObject(el._nodes[i]);
- if (ele) _initDraggableIfNecessary(ele, true, options);
- }
- }
- else {
- var ele = _getElementObject(el);
- if (ele) _initDraggableIfNecessary(ele, true, options);
- }
- };
- /*
- * Function: extend Wraps the underlying library's extend functionality.
- * Parameters: o1 - object to extend o2 - object to extend o1 with
- * Returns: o1, extended with all properties from o2.
- */
- this.extend = function(o1, o2) {
- return jsPlumb.CurrentLibrary.extend(o1, o2);
- };
- /*
- * Function: getConnections Gets all or a subset of connections
- * currently managed by this jsPlumb instance. Parameters: options - a
- * JS object that holds options defining what sort of connections you're
- * looking for. Valid values are: scope this may be a String or a list
- * of Strings. jsPlumb will only return Connections whose scope matches
- * what this option defines. If you omit it, you will be given
- * Connections of every scope. source may be a string or a list of
- * strings; constraints results to have only Connections whose source is
- * this object. target may be a string or a list of strings; constraints
- * results to have only Connections whose target is this object.
- *
- * The return value is a dictionary in this format:
- * { 'scope1': [ {sourceId:'window1', targetId:'window2', source:<sourceElement>,
- * target:<targetElement>, sourceEndpoint:<sourceEndpoint>,
- * targetEndpoint:<targetEndpoint>, connection:<connection>},
- * {sourceId:'window3', targetId:'window4', source:<sourceElement>,
- * target:<targetElement>, sourceEndpoint:<sourceEndpoint>,
- * targetEndpoint:<targetEndpoint>, connection:<connection>},
- * {sourceId:'window1', targetId:'window3', source:<sourceElement>,
- * target:<targetElement>, sourceEndpoint:<sourceEndpoint>,
- * targetEndpoint:<targetEndpoint>, connection:<connection>} ],
- * 'scope2': [ {sourceId:'window1', targetId:'window3', source:<sourceElement>,
- * target:<targetElement>, sourceEndpoint:<sourceEndpoint>,
- * targetEndpoint:<targetEndpoint>, connection:<connection>} ] }
- *
- */
- this.getConnections = function(options) {
- var r = {};
- options = options || {};
- var prepareList = function(input) {
- var r = [];
- if (input) {
- if (typeof input == 'string')
- r.push(input);
- else
- r = input;
- }
- return r;
- };
- var scopes = prepareList(options.scope);
- var sources = prepareList(options.source);
- var targets = prepareList(options.target);
- var filter = function(list, value) {
- return list.length > 0 ? _findIndex(list, value) != -1 : true;
- };
- for ( var i in connectionsByScope) {
- if (filter(scopes, i)) {
- r[i] = [];
- for ( var j = 0; j < connectionsByScope[i].length; j++) {
- var c = connectionsByScope[i][j];
- if (filter(sources, c.sourceId) && filter(targets, c.targetId))
- r[i].push({ sourceId : c.sourceId, targetId : c.targetId, source : c.source, target : c.target, sourceEndpoint : c.endpoints[0], targetEndpoint : c.endpoints[1], connection : c });
- }
- }
- }
- return r;
- };
- /*
- * Function: getDefaultScope Gets the default scope for connections and
- * endpoints. a scope defines a type of endpoint/connection; supplying a
- * scope to an endpoint or connection allows you to support different
- * types of connections in the same UI. but if you're only interested in
- * one type of connection, you don't need to supply a scope. this method
- * will probably be used by very few people; it's good for testing
- * though.
- */
- this.getDefaultScope = function() {
- return DEFAULT_SCOPE;
- };
- /*
- * Function: getEndpoint gets an Endpoint by UUID Parameters: uuid - the
- * UUID for the Endpoint Returns: Endpoint with the given UUID, null if
- * nothing found.
- */
- this.getEndpoint = _getEndpoint;
- /*
- * gets an element's id, creating one if necessary. really only exposed
- * for the lib-specific functionality to access; would be better to pass
- * the current instance into the lib-specific code (even though this is
- * a static call. i just don't want to expose it to the public API).
- */
- this.getId = _getId;
- /*
- * Function: hide Sets an element's connections to be hidden.
- * Parameters: el - either the id of the element, or a selector for the
- * element. Returns: void
- */
- this.hide = function(el) {
- _setVisible(el, "none");
- };
- /*
- * Function: makeAnchor Creates an anchor with the given params.
- *
- * You do not need to use this method. It is exposed because of the way jsPlumb is
- * split into three scripts; this will change in the future.
- *
- * Parameters: x - the x location of the anchor as a fraction of the
- * total width. y - the y location of the anchor as a fraction of the
- * total height. xOrientation - value indicating the general direction a
- * connection from the anchor should go in, in the x direction.
- * yOrientation - value indicating the general direction a connection
- * from the anchor should go in, in the y direction. xOffset - a fixed
- * offset that should be applied in the x direction that should be
- * applied after the x position has been figured out. optional. defaults
- * to 0. yOffset - a fixed offset that should be applied in the y
- * direction that should be applied after the y position has been
- * figured out. optional. defaults to 0.
- * -- OR --
- *
- * params - {x:..., y:..., xOrientation etc }
- * -- OR FROM 1.2.4 ---
- *
- * name - the name of some Anchor in the _currentInstance.Anchors array.
- * -- OR FROM 1.2.4 ---
- *
- * coords - a list of coords for the anchor, like you would pass to
- * jsPlumb.makeAnchor (eg [0.5,0.5,0,-1] - an anchor in the center of
- * some element, oriented towards the top of the screen)
- * -- OR FROM 1.2.4 ---
- *
- * anchor - an existing anchor. just gets passed back. it's handy
- * internally to have this functionality.
- *
- * Returns: The newly created Anchor.
- */
- this.makeAnchor = function(x, y, xOrientation, yOrientation, xOffset, yOffset) {
- // backwards compatibility here. we used to require an object passed
- // in but that makes the call very verbose. easier to use
- // by just passing in four/six values. but for backwards
- // compatibility if we are given only one value we assume it's a
- // call in the old form.
- if (arguments.length == 0) return null;
- var params = {};
- if (arguments.length == 1) {
- var specimen = arguments[0];
- // if it appears to be an anchor already...
- if (specimen.compute && specimen.getOrientation) return specimen;
- // is it the name of an anchor type?
- else if (typeof specimen == "string") return _currentInstance.Anchors[arguments[0]]();
- // is it an array of coordinates?
- else if (specimen.constructor == Array) {
- if (specimen[0].constructor == Array || specimen[0].constructor == String)
- return new DynamicAnchor(specimen);
- else
- return jsPlumb.makeAnchor.apply(this, specimen);
- }
- // last we try the backwards compatibility stuff.
- else if (typeof arguments[0] == "object") jsPlumb.extend(params, x);
- } else {
- params = { x : x, y : y };
- if (arguments.length >= 4) params.orientation = [ arguments[2], arguments[3] ];
- if (arguments.length == 6) params.offsets = [ arguments[4], arguments[5] ];
- }
- var a = new Anchor(params);
- a.clone = function() {
- return new Anchor(params);
- };
- return a;
- };
- /**
- * makes a list of anchors from the given list of types or coords, eg
- * ["TopCenter", "RightMiddle", "BottomCenter", [0, 1, -1, -1] ]
- */
- this.makeAnchors = function(types) {
- var r = [];
- for ( var i = 0; i < types.length; i++)
- if (typeof types[i] == "string")
- r.push(_currentInstance.Anchors[types[i]]());
- else if (types[i].constructor == Array)
- r.push(jsPlumb.makeAnchor(types[i]));
- return r;
- };
- /**
- * Makes a dynamic anchor from the given list of anchors (which may be in shorthand notation as strings or dimension arrays, or Anchor
- * objects themselves) and the given, optional, anchorSelector function (jsPlumb uses a default if this is not provided; most people will
- * not need to provide this - i think).
- */
- this.makeDynamicAnchor = function(anchors, anchorSelector) {
- return new DynamicAnchor(anchors, anchorSelector);
- };
- /*
- * Function: repaint Repaints an element and its connections. This
- * method gets new sizes for the elements before painting anything.
- * Parameters: el - either the id of the element or a selector
- * representing the element. Returns: void See Also: <repaintEverything>
- */
- this.repaint = function(el) {
- var _processElement = function(el) { _draw(_getElementObject(el)); };
- // support both lists...
- if (typeof el == 'object')
- for ( var i = 0; i < el.length; i++) _processElement(el[i]);
- else // ...and single strings.
- _processElement(el);
- };
- /*
- * Function: repaintEverything Repaints all connections.
- * Returns: void
- * See Also: <repaint>
- */
- this.repaintEverything = function() {
- var timestamp = _timestamp();
- for ( var elId in endpointsByElement) {
- _draw(_getElementObject(elId), null, timestamp);
- }
- };
- /*
- * Function: removeAllEndpoints
- * Removes all Endpoints associated with a given element. Also removes all Connections associated with each Endpoint it removes.
- * Parameters: el - either an element id, or a selector for an element.
- * Returns: void
- * See Also: <removeEndpoint>
- */
- this.removeAllEndpoints = function(el) {
- var elId = _getAttribute(el, "id");
- var ebe = endpointsByElement[elId];
- for ( var i in ebe)
- _currentInstance.deleteEndpoint(ebe[i]);
- endpointsByElement[elId] = [];
- };
- /*
- * Function: removeEveryEndpoint
- * Removes every Endpoint in this instance
- * of jsPlumb.
- *
- * Returns: void
- *
- * See Also: <removeAllEndpoints> <removeEndpoint>
- *
- * @deprecated use deleteEveryEndpoint instead
- */
- this.removeEveryEndpoint = this.deleteEveryEndpoint;
-
- /**
- * Function: removeEndpoint Removes the given Endpoint from the given
- * element. Parameters: el - either an element id, or a selector for an
- * element. endpoint - Endpoint to remove. this is an Endpoint object,
- * such as would have been returned from a call to addEndpoint. Returns:
- * void See Also: <removeAllEndpoints> <removeEveryEndpoint>
- *
- * @deprecated Use jsPlumb.deleteEndpoint instead (and note you dont need to supply the element. it's irrelevant).
- */
- this.removeEndpoint = function(el, endpoint) {
- _currentInstance.deleteEndpoint(endpoint);
- };
- /**
- * Function:reset
- * removes all endpoints and connections and clears the
- * listener list. to keep listeners just call jsPlumb.deleteEveryEndpoint.
- */
- this.reset = function() {
- this.deleteEveryEndpoint();
- this.clearListeners();
- };
- /*
- * Function: setAutomaticRepaint Sets/unsets automatic repaint on window
- * resize. Parameters: value - whether or not to automatically repaint
- * when the window is resized. Returns: void
- */
- this.setAutomaticRepaint = function(value) {
- automaticRepaint = value;
- };
- /*
- * Function: setDefaultNewCanvasSize Sets the default size jsPlumb will
- * use for a new canvas (we create a square canvas so one value is all
- * that is required). This is a hack for IE, because ExplorerCanvas
- * seems to need for a canvas to be larger than what you are going to
- * draw on it at initialisation time. The default value of this is 1200
- * pixels, which is quite large, but if for some reason you're drawing
- * connectors that are bigger, you should adjust this value
- * appropriately. Parameters: size - The default size to use. jsPlumb
- * will use a square canvas so you need only supply one value. Returns:
- * void
- */
- this.setDefaultNewCanvasSize = function(size) {
- DEFAULT_NEW_CANVAS_SIZE = size;
- };
- /*
- * Function: setDefaultScope Sets the default scope for connections and
- * endpoints. a scope defines a type of endpoint/connection; supplying a
- * scope to an endpoint or connection allows you to support different
- * types of connections in the same UI. but if you're only interested in
- * one type of connection, you don't need to supply a scope. this method
- * will probably be used by very few people; it just instructs jsPlumb
- * to use a different key for the default scope.
- */
- this.setDefaultScope = function(scope) {
- DEFAULT_SCOPE = scope;
- };
- /*
- * Function: setDraggable Sets whether or not a given element is
- * draggable, regardless of what any plumb command may request.
- * Parameters: el - either the id for the element, or a selector
- * representing the element. Returns: void
- */
- this.setDraggable = _setDraggable;
- /*
- * Function: setDraggableByDefault Sets whether or not elements are
- * draggable by default. Default for this is true. Parameters: draggable -
- * value to set Returns: void
- */
- this.setDraggableByDefault = function(draggable) {
- _draggableByDefault = draggable;
- };
- this.setDebugLog = function(debugLog) {
- log = debugLog;
- };
- /*
- * Function: setRepaintFunction Sets the function to fire when the
- * window size has changed and a repaint was fired. Parameters: f -
- * Function to execute. Returns: void
- */
- this.setRepaintFunction = function(f) {
- repaintFunction = f;
- };
- /*
- * Function: show Sets an element's connections to be visible.
- * Parameters: el - either the id of the element, or a selector for the
- * element. Returns: void
- */
- this.show = function(el) {
- _setVisible(el, "block");
- };
- /*
- * Function: sizeCanvas Helper to size a canvas. You would typically use
- * this when writing your own Connector or Endpoint implementation.
- * Parameters: x - [int] x position for the Canvas origin y - [int] y
- * position for the Canvas origin w - [int] width of the canvas h -
- * [int] height of the canvas Returns: void
- */
- this.sizeCanvas = function(canvas, x, y, w, h) {
- if (canvas) {
- canvas.style.height = h + "px";
- canvas.height = h;
- canvas.style.width = w + "px";
- canvas.width = w;
- canvas.style.left = x + "px";
- canvas.style.top = y + "px";
- }
- };
- /**
- * gets some test hooks. nothing writable.
- */
- this.getTestHarness = function() {
- return {
- endpointsByElement : endpointsByElement,
- endpointCount : function(elId) {
- var e = endpointsByElement[elId];
- return e ? e.length : 0;
- },
- connectionCount : function(scope) {
- scope = scope || DEFAULT_SCOPE;
- var c = connectionsByScope[scope];
- return c ? c.length : 0;
- },
- findIndex : _findIndex,
- getId : _getId
- };
- };
- /**
- * Toggles visibility of an element's connections. kept for backwards
- * compatibility
- */
- this.toggle = _toggleVisible;
- /*
- * Function: toggleVisible Toggles visibility of an element's
- * connections. Parameters: el - either the element's id, or a selector
- * representing the element. Returns: void, but should be updated to
- * return the current state
- */
- // TODO: update this method to return the current state.
- this.toggleVisible = _toggleVisible;
- /*
- * Function: toggleDraggable Toggles draggability (sic) of an element's
- * connections. Parameters: el - either the element's id, or a selector
- * representing the element. Returns: The current draggable state.
- */
- this.toggleDraggable = _toggleDraggable;
- /*
- * Function: unload Unloads jsPlumb, deleting all storage. You should
- * call this from an onunload attribute on the <body> element Returns:
- * void
- */
- this.unload = function() {
- delete endpointsByElement;
- delete endpointsByUUID;
- delete offsets;
- delete sizes;
- delete floatingConnections;
- delete draggableStates;
- };
- /*
- * Function: wrap
- *
- * Helper method to wrap an existing function with one of
- * your own. This is used by the various implementations to wrap event
- * callbacks for drag/drop etc; it allows jsPlumb to be transparent in
- * its handling of these things. If a user supplies their own event
- * callback, for anything, it will always be called.
- */
- this.wrap = _wrap;
-
- EventGenerator.apply(this);
- this.addListener = this.bind;
- };
- var jsPlumb = window.jsPlumb = new jsPlumbInstance();
- jsPlumb.getInstance = function(_defaults) {
- var j = new jsPlumbInstance();
- if (_defaults) jsPlumb.extend(j.Defaults, _defaults);
- return j;
- };
- })();
|