Creating the Perfect Rounded Edge With D3 Curves
D3.js is one of the most popular libraries for data visualization. Read on to learn from an expert how to use his library to programmatically create curved lines.
Join the DZone community and get the full member experience.
Join For FreeA coaching client showed me this design and asked: Ok, how do I build this?
Tree structure with rounded edges
Well hmm... it's a tree of some sort. Each icon is a node, and each line is an edge. Nodes can have multiple children. I think...
You can build this with D3. Calculate each node's position, then iterate and render. An image imported as an SVG component will do. Webpack can handle that for you.
So you have node positions and you know which nodes are connected. Now what?
You can turn that into pairs of coordinates. Point A to point B. With a line between them.
D3 is perfect for that! Drawing lines from A to B is super easy:
// create a line path generator
const line = d3.line ( ) ;
// pair of coordinates
const data = [ [ 0 , 0 ] , [ 100 , 100 ] ] ;
// draw, using JSX notation
<svg>
<path d= {line(data) } style= {lineStyle} />
</svg>
That draws a line from point (0, 0)
to point (100, 100)
.
But we don't want straight lines. Straight lines don't look good.
Lucky for us, D3 has ample support for curves. Many different curve formulas to choose from.
We can add some curve to our line with the .curve
method.
// create a line path generator
const line2 = d3.line ( ).curve (d3.curveCardinal ) ;
If you try that, you'll see that nothing happens. Curves need multiple points in your line data to work well.
Like this:
That's a nice curve and all, but not quite what we're looking for. And if you look at the curve examples in D3 docs, you'll see that nothing quite fits.
After some experimentation, I found a solution.
A React component that takes two points, injects two just perfectly spaced points, and draws a D3 curve between them.
The poorly named <RoundedCorner>
component is just 15 lines of Prettier'd code. All values discovered experimentally.
const RoundedCorner = ( { start, end, radius = 5 } ) => {
const line = d3
.line ( )
.x (d => d[ 0 ] )
.y (d => d[ 1 ] )
.curve (d3.curveBundle.beta ( 1 ) ) ;
const points = [
start,
[start[ 0 ] , end[ 1 ] - radius] ,
[start[ 0 ] + radius, end[ 1 ] ] ,
end
] ;
return <path d= {line(points) } style= {lineStyle} />;
} ;
We take start
and end
coordinates, and the desired radius
. Similar to CSS rounded borders.
Experimentally, I discovered that for the best results, you have to place two points between the two endpoints. One on each side of the rounded corner you want.
Then you have to use the curveBundle
generator with the beta
factor set to 1
. I honestly don't know what that means but it works.
You can see I tried a few different configurations in the example CodeSandbox. That's because some curves produced weird edges when turned around like that.
But not good ol' curveBundle.
Published at DZone with permission of Swizec Teller, DZone MVB. See the original article here.
Opinions expressed by DZone contributors are their own.
Comments