A BPMN 2.0 rendering toolkit and web modeler. https://bpmn.io/toolkit/bpmn-js/
Go to file
Oguz Eroglu 6f451e464e chore(project): bump diagram-js version
Closes #1207
2019-10-16 09:25:22 +00:00
.github chore(project): simplify bug report template 2019-08-08 08:46:10 +02:00
docs chore(CONTRIBUTING): link conventional commits 2018-09-27 14:34:48 +02:00
lib feat(adaptive-label-positioning): adjust label position post creation 2019-10-14 14:48:32 +00:00
resources chore(project): update screencast 2019-04-11 09:35:56 +02:00
tasks chore(tasks): log executed integration test cmd 2019-07-31 13:01:59 +02:00
test feat(adaptive-label-positioning): adjust label position post creation 2019-10-14 14:48:32 +00:00
.babelrc chore(project): build using ES6 ready deps 2018-04-03 16:30:05 +02:00
.eslintignore chore(project): don't lint coverage folder 2018-10-04 16:37:28 +02:00
.eslintrc chore(project): build pre-packaged distros with Rollup 2018-04-03 18:09:52 +02:00
.gitignore chore(project): re-introduce package-lock 2018-11-27 08:38:38 +00:00
.npmignore chore(project): remove coverage directory from the package 2019-08-22 13:55:30 +02:00
.travis.yml chore(ci): add wiredeps script 2019-04-12 17:42:08 +02:00
CHANGELOG.md chore(CHANGELOG): update to v5.0.5 2019-09-25 13:26:38 +02:00
LICENSE chore(LICENSE): update date 2019-02-28 10:22:35 +01:00
README.md docs(README): update related section 2019-07-18 15:46:08 +02:00
index.js fix(project): correct library default export 2018-04-05 09:47:37 +02:00
package-lock.json chore(project): bump diagram-js version 2019-10-16 09:25:22 +00:00
package.json chore(project): bump diagram-js version 2019-10-16 09:25:22 +00:00
rollup.config.js chore(project): minify using terser 2019-07-31 13:03:32 +02:00

README.md

bpmn-js - BPMN 2.0 for the web

Build Status

View and edit BPMN 2.0 diagrams in the browser.

bpmn-js screencast

Installation

Use the library pre-packaged or include it via npm into your node-style web-application.

Usage

To get started, create a bpmn-js instance and render BPMN 2.0 diagrams in the browser:

var xml; // my BPMN 2.0 xml
var viewer = new BpmnJS({
  container: 'body'
});

viewer.importXML(xml, function(err) {

  if (err) {
    console.log('error rendering', err);
  } else {
    console.log('rendered');
  }
});

Checkout our examples for many more supported usage scenarios.

Dynamic Attach/Detach

You may attach or detach the viewer dynamically to any element on the page, too:

var viewer = new BpmnJS();

// attach it to some element
viewer.attachTo('#container');

// detach the panel
viewer.detach();

Resources

Building the Project

Perform the following steps to build the library, including running all tests:

cd bpmn-js
npm install
npm run all

You may need to perform additional project setup when building the latest development snapshot.

Please checkout our contributing guidelines if you plan to file an issue or pull request.

bpmn-js builds on top of a few powerful tools:

  • bpmn-moddle: Read / write support for BPMN 2.0 XML in the browsers
  • diagram-js: Diagram rendering and editing toolkit

License

Use under the terms of the bpmn.io license.