STORM React Diagrams
Latest Release Notes: http://dylanv.blog/2018/01/18/storm-react-diagrams-v4-0-0/
A super simple, no-nonsense diagramming library written in React that just works.
A no-nonsense diagramming library written entirely in React with the help of Lodash, and a single polyfill. It aims to be:
- Simple, and void of any fuss/complications when implementing it into your own application
- Customizable without having to hack the core (adapters/factories etc..)
- Simple to operate and understand without sugar and magic
- Fast and optimized to handle large diagrams with hundreds of nodes/links
- Super easy to use, and should work as you expect it to
npm install storm-react-diagrams or
yarn add storm-react-diagrams
How to run demos
yarn install you must then run:
yarn run storybook
How to build
webpack in the root directory (or
export NODE_ENV=production && webpack if you want a production build) and it will spit out the transpiled code and typescript definitions into the dist directory as a single file. It will also compile the code for the demos .We use webpack for this because TSC cannot compile a single UMD file (TSC can currently only output multiple UMD files).
NOTE: We turn off name mangeling in production builds because we require class names to be left intact when serializing.
Make your own nodes
To see how to create your own nodes like the one below, take a look at demo3:
How does it work
The library uses a Model Graph to represent the virtual diagram and then renders the diagram using 2 layers:
- Node Layer -> which is responsible for rendering nodes as HTML components
- Link Layer -> which renders the links as SVG paths
Each node and link is fed into a factory that then generates the corresponding node or link react widget. Therefore, to create custom nodes and links, register your own factories that return your own widgets.
As long as a node contains at least one port and the corresponding NodeWidget contains at least one PortWidget, a link can be connected to it.
Delete removes any selected items
Shift + Mouse Drag triggers a multi-selection box
Shift + Mouse Click selects the item (items can be multi-selected)
Mouse Drag drags the entire diagram
Mouse Wheel zooms the diagram in / out
Click Link + Drag creates a new link point
Click Node Port + Drag creates a new link