force-graph

Force-directed graph rendered on HTML5 canvas.

A web component to represent a graph data structure in a 2-dimensional canvas using a force-directed iterative layout. Uses HTML5 canvas for rendering and d3-force for the underlying physics engine. Supports canvas zooming/panning, node dragging and node/link hover/click interactions.

Check out the examples:

• Basic (source)
• Load JSON (source)
• Medium size graph (~4k elements) (source)
• Large size graph (~75k elements) (source)
• Text as nodes (source)
• Images as nodes (source)
• Directional links (using arrows) (source)
• Directional links (using moving particles) (source)
• Curved lines and self links (source)
• Text in links (source)
• Dash odd links (source)
• Highlight nodes/links (source)
• Multiple Node Selection (source)
• Auto-colored nodes/links (source)
• Custom node shapes (source)
• Zoom/pan viewport (source)
• Click to focus on node (source)
• Click to expand/collapse nodes (source)
• Fix nodes after dragging (source)
• Fit graph to canvas (source)
• Dynamic data changes (source)
• Node collision detection (source)
• Emit link particles on demand (source)
• Force-directed tree (DAG mode) (source)
• Expandable Tree (source)
• yarn.lock dependency graph (DAG mode) (source)

See also the 3D version.

And check out the React bindings.

Quick start

import ForceGraph from 'force-graph';

or

var ForceGraph = require('force-graph');

or even

<script src="//unpkg.com/force-graph"></script>

then

var myGraph = ForceGraph();
myGraph(<myDOMElement>)
    .graphData(<myData>);

API reference

Data input

Container layout

Node styling

Link styling

Render control

Force engine (d3-force) configuration

Interaction

Utility

Input JSON syntax

{
    "nodes": [
        {
          "id": "id1",
          "name": "name1",
          "val": 1
        },
        {
          "id": "id2",
          "name": "name2",
          "val": 10
        },
        (...)
    ],
    "links": [
        {
            "source": "id1",
            "target": "id2"
        },
        (...)
    ]
}

Giving Back

If this project has helped you and you'd like to contribute back, you can always buy me a ☕ !