Skip to content

slfan1989/jsplumb

This branch is 4976 commits ahead of, 1 commit behind jsplumb/jsplumb:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Jan 30, 2020
0cc9d7a · Jan 30, 2020
Jun 4, 2019
Jun 5, 2019
Jan 30, 2020
Jan 30, 2020
Jan 30, 2020
Jul 15, 2015
Apr 28, 2019
Jan 30, 2020
Nov 28, 2019
Oct 21, 2017
Oct 21, 2017
Nov 23, 2017
Sep 23, 2019
Apr 23, 2019
Dec 18, 2014
Jun 5, 2019
Jan 27, 2020
Aug 23, 2017
Jan 26, 2017
Jan 21, 2016
Jan 30, 2020
Nov 18, 2013
Jan 27, 2020
Sep 4, 2014

Repository files navigation

jsPlumb

jsPlumb provides a means for a developer to visually connect elements on their web pages. It uses SVG and runs on all browsers from IE9 and later.

The final version of jsPlumb to support IE8 was 1.7.10. You can still get 1.7.10 from a tag, if you need it.

If you're new to jsPlumb, please do take the time to read the documentation. There are a few integration issues that you should be aware of: z-index needs special attention, for example.

This project is the 'Community Edition' of jsPlumb. The 'Toolkit Edition' is a commercially-licensed wrapper around this.

This project is not the correct place to report issues for the Toolkit edition. The Toolkit is not a public project. Issues reported for the Toolkit edition in this issue tracker will be deleted.

Documentation

For the Community edition the documentation can now be found here:

http://jsplumb.github.io/jsplumb/

Changelog

Can be found at http://jsplumb.github.io/jsplumb/changelog.html

Installation

npm install jsplumb

NOTE: jsPlumb does not follow strict semantic versioning. It is not at all recommended that you use wildcards when specifying a dependency on jsPlumb. The given command will install jsPlumb version using a caret for wildcard, eg ^2.9.0 - you might want to take off the caret.

jsPlumb does not follow strict semantic versioning largely because of the stipulation that breaking changes must result in the major version being bumped. A major version implies something fundamental has occurred. The bump from 1.7.10 to 2.0.0 in jsPlumb was caused by the removal of the VML renderer, meaning IE6 and IE8 were no longer supported. You may say, a-ha! A breaking change! And you would be right; that was a breaking change. But a new major version might also occur when a new capability is added that doesn't affect existing functionality. And not every breaking change constitutes a fundamental change in the library itself. This note about semver was added to jsPlumb, for example, due to a discussion about how the stop event behaviour in the underlying drag library - Katavorio - had changed. Semver would say that the major version should have been bumped. But the change was not something fundamental. No capabilities had been added or removed...just some variables had been shuffled around.

Maybe you agree with this viewpoint. Maybe you don't.

We package the following files:

"files": [
    "index.d.ts",
    "dist/js/jsplumb.js",
    "dist/js/jsplumb.min.js",
    "css/jsplumbtoolkit-defaults.css"
  ],

We recommend including the jsplumbtoolkit-defaults.css file to begin with, as it provides some sane default values.

Typescript

An index.d.ts is included in the npm package.

Issues

jsPlumb uses GitHub's issue tracker for enhancements and bugs. A losing battle was fought against the usage of Github for questions; now it seems to be the default, and the Google group is no longer in use.

Requirements

No external dependencies.

jsPlumb in action

Links to various demonstrations can be found here.

jsPlumb Helper Projects

  • Bezier curve functions:

https://github.com/jsplumb/jsBezier

  • Simple geometry functions:

https://github.com/jsplumb/biltong

  • Drag+drop:

https://github.com/jsplumb/katavorio

  • Events:

https://github.com/jsplumb/mottle

Tests

There is a full suite of unit tests checked in to the test and dist/test directories.

Twitter

Please don't.

Mailing List

Sign up for the jsPlumb announcements mailing list here.

License

All 1.x.x and 2.x.x versions of jsPlumb Community edition are dual-licensed under both MIT and GPLv2.

About

Visual connectivity for webapps

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 89.6%
  • HTML 8.2%
  • CSS 2.2%