Component for visualising hierarchical networks

<vcf-network>

Gitter npm version Published on Vaadin Directory

Live Demo ↗

Installation

Install vcf-network:

npm i @vaadin-component-factory/vcf-network --save

Usage

Once installed, import it in your application:

import '@vaadin-component-factory/vcf-network/vcf-network.js';

Add <vcf-network> element to the page.

<vcf-network></vcf-network>

Creating networks

The hierarchical network visualization consists of nodes, edges and components. A component is a grouping of nodes, edges and other components.

Add nodes

Click the button for the node type you would like to add on the left tool panel. This will activate the "Add node mode" for this node type. You can then click anywhere on the middle canvas area to create a node at that position.

add-nodes

Add edges

To add an edge between two nodes, first click and hold on the node you would like the edge to begin from. The cursor will change and you will be able to drag an edge to another node. When you release the mouse button over another node, an edge will be created.

add-edges

Creating components

In order to create components you must first select the nodes that will be in that component. You can select a single node by clicking with the left mouse button but to select multiple nodes, you must click and drag with the right mouse button. Once you have selected nodes, click the Create Component button on the right panel. You can then edit the components name and color using the fields also found on the right panel.

create-components

Hotkeys

Mouse

  • Double Click: Create node if on empty space
  • Right Click: Right click and drag to create selection rectangle

Keyboard

  • N: Create normal node at cursor position or activate add node mode if add-node-toggle is enabled
  • I: Create input node at cursor position or activate add node mode if add-node-toggle is enabled
  • O: Create output node at cursor position or activate add node mode if add-node-toggle is enabled
  • C: Create component from current selection
  • D: Duplicate current selection
  • E: Export current selection
  • Backspace: Delete current selection

Running demo

  1. Fork the vcf-network repository and clone it locally.

  2. Make sure you have npm installed.

  3. When in the vcf-network directory, run npm install to install dependencies.

  4. Run npm start to open the demo.

Contributing

To contribute to the component, please read the guideline first.

License

Commercial Vaadin Add-on License version 3 (CVALv3). For license terms, see LICENSE.

Vaadin collects development time usage statistics to improve this product. For details and to opt-out, see https://github.com/vaadin/vaadin-usage-statistics.

Install

Link to this version
ImportedReleased 29 August 2019Other
Framework Support
Polymer 3.0+
Browser Independent
Install with
npm install @vaadin-component-factory/vcf-network"@1.2.0"
Run the above npm command in your project folder. If you have any issues installing, please contact the author.
Release notes - Version 1.2.0

Dependencies

  • @polymer/iron-icons#^3.0.1
  • @polymer/polymer#^3.0.0
  • @vaadin/vaadin-button#^2.2.0
  • @vaadin/vaadin-confirm-dialog#^1.1.4
  • @vaadin/vaadin-element-mixin#^2.1.3
  • @vaadin/vaadin-lumo-styles#^1.5.0
  • @vaadin/vaadin-radio-button#^1.2.3
  • @vaadin/vaadin-select#^2.1.2
  • @vaadin/vaadin-text-field#^2.4.4
  • @vaadin/vaadin-themable-mixin#^1.4.4
  • tippy.js#^4.3.4
  • vis#^4.21.0