A BPMN 2.0 rendering toolkit and web modeler. https://bpmn.io/toolkit/bpmn-js/
Go to file
Nico Rehwaldt ffb8ac3ea2 test: mock canvas event with a button
There do not exist mouse events without one. :o)
2020-12-16 16:39:23 +01:00
.github chore: use dependabot for security updates only 2020-12-09 11:26:06 +01:00
docs feat(translations): update translatable string 2020-11-03 20:39:20 +00:00
lib feat(replace): add multiplicity marker to replace menu for participants 2020-12-11 06:59:20 +00:00
resources chore(logo): update local file 2020-05-26 14:42:45 +02:00
tasks chore(tasks/update-website): do not read and write at the same time 2020-02-04 09:49:21 +01:00
test test: mock canvas event with a button 2020-12-16 16:39:23 +01: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): declare Promise as a global variable for linting 2020-04-29 11:12:23 +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(tasks): update examples and websites on stable release only 2020-02-05 11:26:11 +00:00
CHANGELOG.md chore(CHANGELOG): update to v7.5.0 2020-12-03 14:13:19 +01:00
LICENSE chore(project): update license 2020-05-20 16:09:03 +00:00
README.md docs(README): use ES6 consistently in code snippets 2020-12-15 23:25:43 +01:00
index.js fix(project): correct library default export 2018-04-05 09:47:37 +02:00
package-lock.json deps: patch bump dependencies 2020-12-10 13:18:47 +01:00
package.json deps: pin to puppeteer@1 2020-12-10 13:14:32 +01:00
rollup.config.js deps: bump development dependencies 2020-12-02 20:28:33 +00: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:

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

try {
  const { warnings } = await viewer.importXML(xml);

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

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:

const 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.