jqSimpleConnect is a lightweight JavaScript library which provides the functionality for visually connect elements in a web page.
It uses <div> elements to draw the connectors, in order to avoid dependencies with SVG and Canvas and in order to be more fast and simple.
His only requirement is jQuery, another JavaScript library, which must be included in the web page along with jqSimpleConnect.
In order to use jqSimpleConnect, the only thing that you have to do is to include the JavaScript files of jqSimpleConnect and jQuery into your page's <head> tag:
<script type="text/javascript" src="jquery.min.js"></script>
<script type="text/javascript" src="jqSimpleConnect.min.js"></script>And then call the connect method:
<div style="position:relative; height: 80px;">
<div id="div_a" style="position:absolute; top:5px; left:5px;">Div A</div>
<div id="div_b" style="position:absolute; top:50px; left:150px;">Div B</div>
</div>
<script type="text/javascript">
jqSimpleConnect.connect("#div_a", "#div_b", {radius: 8, color: 'green'});
</script>You can find examples in the following links:
Draws a connection between the elements "A" and "B".
jqSimpleConnect.connect = function(elementA, elementB, options)Parameters
| Parameter | Description |
|---|---|
| elementA | A CSS selector or a jQuery's object for select the first element. |
| elementB | A CSS selector or a jQuery's object for select the second element. |
| options | (optional) An associative array with the properties (all of them optionals): color (which defines the color of the connection), radius (which defines the width of the connection's lines), roundedCorners (a boolean indicating if the corners must be round), anchorA (which defines the anchor type of the first element, 'horizontal' or 'vertical') and anchorB (which defines the anchor type of the second element, 'horizontal' or 'vertical'). |
Returns
An string which identifies uniquely the connection.
Repaints an specific connection from the page.
jqSimpleConnect.repaintConnection = function(connectionId)Parameters
| Parameter | Description |
|---|---|
| connectionId | The connection's unique identifier. |
Returns
true if the connection was repainted or false if no connection with that identifier was found.
Repaints all the connections in the page.
jqSimpleConnect.repaintAll = function()Removes an specific connection from the page.
jqSimpleConnect.removeConnection = function(connectionId)Parameters
| Parameter | Description |
|---|---|
| connectionId | The connection's unique identifier. |
Returns
true if the connection was removed or false if no connection with that identifier was found.
Removes all the connections in the page.
jqSimpleConnect.removeAll = function()This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; If not, see http://www.gnu.org/licenses/.