bpmn-js/README.md

94 lines
2.4 KiB
Markdown
Raw Normal View History

2016-05-20 07:11:13 +00:00
> The project is still in an early stage. Documentation may be missing and [examples](https://github.com/bpmn-io/bpmn-js-examples) may be broken.
# bpmn-js - BPMN 2.0 for the web
2014-05-07 07:55:06 +00:00
2015-02-19 13:59:57 +00:00
[![Build Status](https://travis-ci.org/bpmn-io/bpmn-js.svg?branch=master)](https://travis-ci.org/bpmn-io/bpmn-js)
View and edit BPMN 2.0 diagrams in the browser.
2018-02-05 15:24:42 +00:00
[![bpmn-js screencast](./resources/screencast.gif "bpmn-js in action")](http://demo.bpmn.io/s/start)
2014-05-07 07:55:06 +00:00
## Installation
2014-05-22 11:23:29 +00:00
2018-02-08 22:02:14 +00:00
Use the library [pre-packaged](https://github.com/bpmn-io/bpmn-js-examples/tree/master/pre-packaged)
or include it [via npm](https://github.com/bpmn-io/bpmn-js-examples/tree/master/bundling)
into your node-style web-application.
2014-05-22 11:23:29 +00:00
## Usage
To get started, create a [bpmn-js](https://github.com/bpmn-io/bpmn-js) instance
and render [BPMN 2.0 diagrams](https://www.omg.org/spec/BPMN/2.0.2/) in the browser:
2014-05-22 11:23:29 +00:00
```javascript
var xml; // my BPMN 2.0 xml
2018-02-05 15:24:05 +00:00
var viewer = new BpmnJS({
container: 'body'
});
2014-05-22 11:23:29 +00:00
viewer.importXML(xml, function(err) {
if (err) {
console.log('error rendering', err);
} else {
console.log('rendered');
}
});
```
Checkout our [examples](https://github.com/bpmn-io/bpmn-js-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:
```javascript
var viewer = new BpmnJS();
// attach it to some element
viewer.attachTo('#container');
// detach the panel
viewer.detach();
```
2014-06-13 18:01:36 +00:00
2014-05-22 11:23:29 +00:00
2014-05-07 07:55:06 +00:00
## Resources
* [Demo](http://demo.bpmn.io)
* [Issues](https://github.com/bpmn-io/bpmn-js/issues)
* [Examples](https://github.com/bpmn-io/bpmn-js-examples)
* [Forum](https://forum.bpmn.io)
2014-05-07 07:55:06 +00:00
2016-05-20 07:11:13 +00:00
## Building the Project
2016-05-20 07:11:13 +00:00
Perform the following steps to build the library, including running all tests:
2016-05-20 07:11:13 +00:00
```
cd bpmn-js
npm install
2016-07-04 12:38:51 +00:00
npm run all
2016-05-20 07:11:13 +00:00
```
You may need to perform [additional project setup](./docs/project/SETUP.md) when
building the latest development snapshot.
2016-07-04 12:38:51 +00:00
Please checkout our [contributing guidelines](./CONTRIBUTING.md) if you plan to
file an issue or pull request.
2014-05-07 07:55:06 +00:00
2016-05-20 07:11:13 +00:00
## Related
bpmn-js builds on top of a few additional powerful tools:
* [bpmn-moddle](https://github.com/bpmn-io/bpmn-moddle): Read / write support for BPMN 2.0 XML in the browsers
* [diagram-js](https://github.com/bpmn-io/diagram-js): Diagram rendering and editing toolkit
2014-05-07 07:55:06 +00:00
## License
Use under the terms of the [bpmn.io license](http://bpmn.io/license).