Connecting charts
One of the key requirements of a dashboard is the ability to connect charts to your model. VisuallyJs makes this a snap. On this page we'll run through various basic scenarios, to give you a feel for what's possible.
Series based charts
We'll start with a simple example - in this canvas we have a set of nodes that display a value they are tracking.
- Click the +/- buttons to increment/decrement the value.
- Click in whitespace to add a new node at the location you clicked, with a random new value between 0 and 15.
Column chart
Dual value axis charts
Charts with two value axes - such as bubble and scatter charts - are easily integrated too.
Scatter Chart
Here's a scatter chart which tracks the location of the nodes on the canvas (perhaps not the most useful application, but fun!):
This is the code:
<SurfaceProvider>
<DashboardExampleSurface1/>
<ScatterChartComponent options={{
title:{ text:"Node location" },
series:[{
xAxisField:"left",
yAxisField:"top",
color:"#569934"
}],
yAxis:{
inverted:true
},
tooltip:{
format:"<b>Node: </b>{{point.id}}<b>Value: </b>{{point.value}}<b>Left: </b>{{point.left}}<b>Top: </b>{{point.top}}"
}}}/>
</SurfaceProvider>
Points to note are:
- We map
xAxisFieldtoleftandyAxisFieldtotop- these are the properties used to position nodes on the canvas. - We mark
yAxisasinverted:true. By default, the Y axis in a dual value chart has its minimum value in the lower left corner, but that is the opposite way to the way that browsers measure Y. So marking the y axisinvertedmeans that the scatter points correctly map the Y axis of the nodes in the canvas.
Bubble Chart
This bubble chart extends the view provided by the scatter chart above to map the value field from each node to the bubble size:
- As with the scatter chart, we map
xAxisFieldtoleftandyAxisFieldtotop - We mark
yAxisasinverted:true- see discussion for scatter chart above - We map
valueFieldtovalue, meaning that the size of each bubble is proportional to thevaluein the node it represents.
Bubble charts have a default maximum bubble size of 50 pixels and a default minimum size of 8 pixels. This is to prevent large discrepancies in data values from resulting in bubbles of widely different sizes in the chart. This maximum and minimum can be changed in the chart options.