436 lines
13 KiB
JavaScript
436 lines
13 KiB
JavaScript
/** @format */
|
|
|
|
/**
|
|
* External dependencies
|
|
*/
|
|
|
|
import { findIndex } from 'lodash';
|
|
import { max as d3Max } from 'd3-array';
|
|
import { axisBottom as d3AxisBottom, axisLeft as d3AxisLeft } from 'd3-axis';
|
|
import { format as d3Format } from 'd3-format';
|
|
import {
|
|
scaleBand as d3ScaleBand,
|
|
scaleLinear as d3ScaleLinear,
|
|
scaleTime as d3ScaleTime,
|
|
} from 'd3-scale';
|
|
import { mouse as d3Mouse, select as d3Select } from 'd3-selection';
|
|
import { line as d3Line } from 'd3-shape';
|
|
import { timeFormat as d3TimeFormat, utcParse as d3UTCParse } from 'd3-time-format';
|
|
|
|
export const parseDate = d3UTCParse( '%Y-%m-%d' );
|
|
|
|
/**
|
|
* Describes `getUniqueKeys`
|
|
* @param {array} data - The chart component's `data` prop.
|
|
* @returns {array} of unique category keys
|
|
*/
|
|
export const getUniqueKeys = data => {
|
|
return [
|
|
...new Set(
|
|
data.reduce( ( accum, curr ) => {
|
|
Object.keys( curr ).forEach( key => key !== 'date' && accum.push( key ) );
|
|
return accum;
|
|
}, [] )
|
|
),
|
|
];
|
|
};
|
|
|
|
/**
|
|
* Describes `getOrderedKeys`
|
|
* @param {array} data - The chart component's `data` prop.
|
|
* @param {array} uniqueKeys - from `getUniqueKeys`.
|
|
* @returns {array} of unique category keys ordered by cumulative total value
|
|
*/
|
|
export const getOrderedKeys = ( data, uniqueKeys ) =>
|
|
uniqueKeys
|
|
.map( key => ( {
|
|
key,
|
|
focus: true,
|
|
total: data.reduce( ( a, c ) => a + c[ key ], 0 ),
|
|
visible: true,
|
|
} ) )
|
|
.sort( ( a, b ) => b.total - a.total );
|
|
|
|
/**
|
|
* Describes `getLineData`
|
|
* @param {array} data - The chart component's `data` prop.
|
|
* @param {array} orderedKeys - from `getOrderedKeys`.
|
|
* @returns {array} an array objects with a category `key` and an array of `values` with `date` and `value` properties
|
|
*/
|
|
export const getLineData = ( data, orderedKeys ) =>
|
|
orderedKeys.map( row => ( {
|
|
key: row.key,
|
|
focus: row.focus,
|
|
visible: row.visible,
|
|
values: data.map( d => ( {
|
|
date: d.date,
|
|
focus: row.focus,
|
|
value: d[ row.key ],
|
|
visible: row.visible,
|
|
} ) ),
|
|
} ) );
|
|
|
|
/**
|
|
* Describes `getUniqueDates`
|
|
* @param {array} lineData - from `GetLineData`
|
|
* @returns {array} an array of unique date values sorted from earliest to latest
|
|
*/
|
|
export const getUniqueDates = lineData => {
|
|
return [
|
|
...new Set(
|
|
lineData.reduce( ( accum, { values } ) => {
|
|
values.forEach( ( { date } ) => accum.push( date ) );
|
|
return accum;
|
|
}, [] )
|
|
),
|
|
].sort( ( a, b ) => parseDate( a ) - parseDate( b ) );
|
|
};
|
|
|
|
export const getColor = ( key, params ) => {
|
|
const keyValue =
|
|
params.orderedKeys.length > 1
|
|
? findIndex( params.orderedKeys, d => d.key === key ) / ( params.orderedKeys.length - 1 )
|
|
: 0;
|
|
return params.colorScheme( keyValue );
|
|
};
|
|
|
|
/**
|
|
* Describes getXScale
|
|
* @param {array} uniqueDates - from `getUniqueDates`
|
|
* @param {number} width - calculated width of the charting space
|
|
* @returns {function} a D3 scale of the dates
|
|
*/
|
|
export const getXScale = ( uniqueDates, width ) =>
|
|
d3ScaleBand()
|
|
.domain( uniqueDates )
|
|
.rangeRound( [ 0, width ] )
|
|
.paddingInner( 0.1 );
|
|
|
|
/**
|
|
* Describes getXGroupScale
|
|
* @param {array} orderedKeys - from `getOrderedKeys`
|
|
* @param {function} xScale - from `getXScale`
|
|
* @returns {function} a D3 scale for each category within the xScale range
|
|
*/
|
|
export const getXGroupScale = ( orderedKeys, xScale ) =>
|
|
d3ScaleBand()
|
|
.domain( orderedKeys.filter( d => d.visible ).map( d => d.key ) )
|
|
.rangeRound( [ 0, xScale.bandwidth() ] )
|
|
.padding( 0.07 );
|
|
|
|
/**
|
|
* Describes getXLineScale
|
|
* @param {array} uniqueDates - from `getUniqueDates`
|
|
* @param {number} width - calculated width of the charting space
|
|
* @returns {function} a D3 scaletime for each date
|
|
*/
|
|
export const getXLineScale = ( uniqueDates, width ) =>
|
|
d3ScaleTime()
|
|
.domain( [ new Date( uniqueDates[ 0 ] ), new Date( uniqueDates[ uniqueDates.length - 1 ] ) ] )
|
|
.rangeRound( [ 0, width ] );
|
|
|
|
/**
|
|
* Describes getYMax
|
|
* @param {array} lineData - from `getLineData`
|
|
* @returns {number} the maximum value in the timeseries multiplied by 4/3
|
|
*/
|
|
export const getYMax = lineData =>
|
|
Math.round( 4 / 3 * d3Max( lineData, d => d3Max( d.values.map( date => date.value ) ) ) );
|
|
|
|
/**
|
|
* Describes getYScale
|
|
* @param {number} height - calculated height of the charting space
|
|
* @param {number} yMax - from `getYMax`
|
|
* @returns {function} the D3 linear scale from 0 to the value from `getYMax`
|
|
*/
|
|
export const getYScale = ( height, yMax ) =>
|
|
d3ScaleLinear()
|
|
.domain( [ 0, yMax ] )
|
|
.rangeRound( [ height, 0 ] );
|
|
|
|
/**
|
|
* Describes getyTickOffset
|
|
* @param {number} height - calculated height of the charting space
|
|
* @param {number} scale - ratio of the expected width to calculated width (given the viewbox)
|
|
* @param {number} yMax - from `getYMax`
|
|
* @returns {function} the D3 linear scale from 0 to the value from `getYMax`, offset by 12 pixels down
|
|
*/
|
|
export const getYTickOffset = ( height, scale, yMax ) =>
|
|
d3ScaleLinear()
|
|
.domain( [ 0, yMax ] )
|
|
.rangeRound( [ height + scale * 12, scale * 12 ] );
|
|
|
|
/**
|
|
* Describes getyTickOffset
|
|
* @param {function} xLineScale - from `getXLineScale`.
|
|
* @param {function} yScale - from `getYScale`.
|
|
* @returns {function} the D3 line function for plotting all category values
|
|
*/
|
|
export const getLine = ( xLineScale, yScale ) =>
|
|
d3Line()
|
|
.x( d => xLineScale( new Date( d.date ) ) )
|
|
.y( d => yScale( d.value ) );
|
|
|
|
/**
|
|
* Describes getDateSpaces
|
|
* @param {array} uniqueDates - from `getUniqueDates`
|
|
* @param {number} width - calculated width of the charting space
|
|
* @param {function} xLineScale - from `getXLineScale`
|
|
* @returns {array} that icnludes the date, start (x position) and width to layout the mouseover rectangles
|
|
*/
|
|
export const getDateSpaces = ( uniqueDates, width, xLineScale ) =>
|
|
uniqueDates.map( ( d, i ) => {
|
|
const xNow = xLineScale( new Date( d ) );
|
|
const xPrev =
|
|
i >= 1
|
|
? xLineScale( new Date( uniqueDates[ i - 1 ] ) )
|
|
: xLineScale( new Date( uniqueDates[ 0 ] ) );
|
|
const xNext =
|
|
i < uniqueDates.length - 1
|
|
? xLineScale( new Date( uniqueDates[ i + 1 ] ) )
|
|
: xLineScale( new Date( uniqueDates[ uniqueDates.length - 1 ] ) );
|
|
let xWidth = i === 0 ? xNext - xNow : xNow - xPrev;
|
|
const xStart = i === 0 ? 0 : xNow - xWidth / 2;
|
|
xWidth = i === 0 || i === uniqueDates.length - 1 ? xWidth / 2 : xWidth;
|
|
return {
|
|
date: d,
|
|
start: uniqueDates.length > 1 ? xStart : 0,
|
|
width: uniqueDates.length > 1 ? xWidth : width,
|
|
};
|
|
} );
|
|
|
|
export const drawAxis = ( node, params ) => {
|
|
const xScale = params.type === 'line' ? params.xLineScale : params.xScale;
|
|
|
|
const yGrids = [];
|
|
for ( let i = 0; i < 4; i++ ) {
|
|
yGrids.push( i / 3 * params.yMax );
|
|
}
|
|
|
|
node
|
|
.append( 'g' )
|
|
.attr( 'class', 'axis' )
|
|
.attr( 'transform', `translate(0,${ params.height })` )
|
|
.call(
|
|
d3AxisBottom( xScale )
|
|
.tickValues( params.uniqueDates.map( d => ( params.type === 'line' ? new Date( d ) : d ) ) )
|
|
.tickFormat( d => d3TimeFormat( '%d' )( d instanceof Date ? d : new Date( d ) ) )
|
|
);
|
|
|
|
node
|
|
.append( 'g' )
|
|
.attr( 'class', 'grid' )
|
|
.attr( 'transform', `translate(-${ params.margin.left },0)` )
|
|
.call(
|
|
d3AxisLeft( params.yScale )
|
|
.tickValues( yGrids )
|
|
.tickSize( -params.width - params.margin.left )
|
|
.tickFormat( '' )
|
|
)
|
|
.call( g => g.select( '.domain' ).remove() );
|
|
|
|
node
|
|
.append( 'g' )
|
|
.attr( 'class', 'axis y-axis' )
|
|
.call(
|
|
d3AxisLeft( params.yTickOffset )
|
|
.tickValues( yGrids )
|
|
.tickFormat( d => ( d !== 0 ? d3Format( '.3s' )( d ) : 0 ) )
|
|
);
|
|
|
|
node
|
|
.selectAll( '.y-axis .tick text' )
|
|
.style( 'font-size', `${ Math.round( params.scale * 10 ) }px` );
|
|
|
|
node.selectAll( '.domain' ).remove();
|
|
node
|
|
.selectAll( '.axis' )
|
|
.selectAll( '.tick' )
|
|
.select( 'line' )
|
|
.remove();
|
|
};
|
|
|
|
const showTooltip = ( node, params, d ) => {
|
|
const chartCoords = node.node().getBoundingClientRect();
|
|
let [ xPosition, yPosition ] = d3Mouse( node.node() );
|
|
xPosition = xPosition > chartCoords.width - 200 ? xPosition - 200 : xPosition + 20;
|
|
yPosition = yPosition > chartCoords.height - 150 ? yPosition - 200 : yPosition + 20;
|
|
const keys = params.orderedKeys.filter( row => row.visible ).map(
|
|
row => `
|
|
<li>
|
|
<span class="key-colour" style="background-color:${ getColor( row.key, params ) }"></span>
|
|
<span class="key-key">${ row.key }:</span>
|
|
<span class="key-value">${ d3Format( ',.0f' )( d[ row.key ] ) }</span>
|
|
</li>
|
|
`
|
|
);
|
|
|
|
params.tooltip
|
|
.style( 'left', xPosition + 'px' )
|
|
.style( 'top', yPosition + 'px' )
|
|
.style( 'display', 'inline-block' ).html( `
|
|
<div>
|
|
<h4>${ d.date }</h4>
|
|
<ul>
|
|
${ keys.join( '' ) }
|
|
</ul>
|
|
</div>
|
|
` );
|
|
};
|
|
|
|
const handleMouseOverBarChart = ( d, i, nodes, node, data, params ) => {
|
|
d3Select( nodes[ i ].parentNode )
|
|
.select( '.barfocus' )
|
|
.attr( 'opacity', '0.1' );
|
|
showTooltip( node, params, d );
|
|
};
|
|
|
|
const handleMouseOutBarChart = ( d, i, nodes, params ) => {
|
|
d3Select( nodes[ i ].parentNode )
|
|
.select( '.barfocus' )
|
|
.attr( 'opacity', '0' );
|
|
params.tooltip.style( 'display', 'none' );
|
|
};
|
|
|
|
const handleMouseOverLineChart = ( d, i, nodes, node, data, params ) => {
|
|
d3Select( nodes[ i ].parentNode )
|
|
.select( '.focus-grid' )
|
|
.attr( 'opacity', '1' );
|
|
showTooltip( node, params, data.find( e => e.date === d.date ) );
|
|
};
|
|
|
|
const handleMouseOutLineChart = ( d, i, nodes, params ) => {
|
|
d3Select( nodes[ i ].parentNode )
|
|
.select( '.focus-grid' )
|
|
.attr( 'opacity', '0' );
|
|
params.tooltip.style( 'display', 'none' );
|
|
};
|
|
|
|
export const drawLines = ( node, data, params ) => {
|
|
const focus = node
|
|
.append( 'g' )
|
|
.attr( 'class', 'focusspaces' )
|
|
.selectAll( '.focus' )
|
|
.data( params.dateSpaces )
|
|
.enter()
|
|
.append( 'g' )
|
|
.attr( 'class', 'focus' );
|
|
|
|
focus
|
|
.append( 'line' )
|
|
.attr( 'class', 'focus-grid' )
|
|
.attr( 'x1', d => params.xLineScale( new Date( d.date ) ) )
|
|
.attr( 'y1', 0 )
|
|
.attr( 'x2', d => params.xLineScale( new Date( d.date ) ) )
|
|
.attr( 'y2', params.height )
|
|
.attr( 'opacity', '0' );
|
|
|
|
focus
|
|
.append( 'rect' )
|
|
.attr( 'class', 'focus-g' )
|
|
.attr( 'x', d => d.start )
|
|
.attr( 'y', 0 )
|
|
.attr( 'width', d => d.width )
|
|
.attr( 'height', params.height )
|
|
.attr( 'opacity', 0 )
|
|
.on( 'mouseover', ( d, i, nodes ) =>
|
|
handleMouseOverLineChart( d, i, nodes, node, data, params )
|
|
)
|
|
.on( 'mouseout', ( d, i, nodes ) => handleMouseOutLineChart( d, i, nodes, params ) );
|
|
|
|
const series = node
|
|
.append( 'g' )
|
|
.attr( 'class', 'lines' )
|
|
.selectAll( '.line-g' )
|
|
.data( params.lineData.filter( d => d.visible ) )
|
|
.enter()
|
|
.append( 'g' )
|
|
.attr( 'class', 'line-g' );
|
|
|
|
series
|
|
.append( 'path' )
|
|
.attr( 'fill', 'none' )
|
|
.attr( 'stroke-width', 3 )
|
|
.attr( 'stroke-linejoin', 'round' )
|
|
.attr( 'stroke-linecap', 'round' )
|
|
.attr( 'stroke', d => getColor( d.key, params ) )
|
|
.style( 'opacity', d => {
|
|
const opacity = d.focus ? 1 : 0.1;
|
|
return d.visible ? opacity : 0;
|
|
} )
|
|
.attr( 'd', d => params.line( d.values ) );
|
|
|
|
series
|
|
.selectAll( 'circle' )
|
|
.data( ( d, i ) => d.values.map( row => ( { ...row, i, visible: d.visible, key: d.key } ) ) )
|
|
.enter()
|
|
.append( 'circle' )
|
|
.attr( 'r', 3.5 )
|
|
.attr( 'fill', '#fff' )
|
|
.attr( 'stroke', d => getColor( d.key, params ) )
|
|
.attr( 'stroke-width', 3 )
|
|
.style( 'opacity', d => {
|
|
const opacity = d.focus ? 1 : 0.1;
|
|
return d.visible ? opacity : 0;
|
|
} )
|
|
.attr( 'cx', d => params.xLineScale( new Date( d.date ) ) )
|
|
.attr( 'cy', d => params.yScale( d.value ) );
|
|
};
|
|
|
|
export const drawBars = ( node, data, params ) => {
|
|
const barGroup = node
|
|
.append( 'g' )
|
|
.attr( 'class', 'bars' )
|
|
.selectAll( 'g' )
|
|
.data( data )
|
|
.enter()
|
|
.append( 'g' )
|
|
.attr( 'transform', d => `translate(${ params.xScale( d.date ) },0)` )
|
|
.attr( 'class', 'bargroup' );
|
|
|
|
barGroup
|
|
.append( 'rect' )
|
|
.attr( 'class', 'barfocus' )
|
|
.attr( 'x', 0 )
|
|
.attr( 'y', 0 )
|
|
.attr( 'width', params.xGroupScale.range()[ 1 ] )
|
|
.attr( 'height', params.height )
|
|
.attr( 'opacity', '0' );
|
|
|
|
barGroup
|
|
.selectAll( '.bar' )
|
|
.data( d =>
|
|
params.orderedKeys.filter( row => row.visible ).map( row => ( {
|
|
key: row.key,
|
|
focus: row.focus,
|
|
value: d[ row.key ],
|
|
visible: row.visible,
|
|
} ) )
|
|
)
|
|
.enter()
|
|
.append( 'rect' )
|
|
.attr( 'class', 'bar' )
|
|
.attr( 'x', d => params.xGroupScale( d.key ) )
|
|
.attr( 'y', d => params.yScale( d.value ) )
|
|
.attr( 'width', params.xGroupScale.bandwidth() )
|
|
.attr( 'height', d => params.height - params.yScale( d.value ) )
|
|
.attr( 'fill', d => getColor( d.key, params ) )
|
|
.style( 'opacity', d => {
|
|
const opacity = d.focus ? 1 : 0.1;
|
|
return d.visible ? opacity : 0;
|
|
} );
|
|
|
|
barGroup
|
|
.append( 'rect' )
|
|
.attr( 'class', 'barmouse' )
|
|
.attr( 'x', 0 )
|
|
.attr( 'y', 0 )
|
|
.attr( 'width', params.xGroupScale.range()[ 1 ] )
|
|
.attr( 'height', params.height )
|
|
.attr( 'opacity', '0' )
|
|
.on( 'mouseover', ( d, i, nodes ) =>
|
|
handleMouseOverBarChart( d, i, nodes, node, data, params )
|
|
)
|
|
.on( 'mouseout', ( d, i, nodes ) => handleMouseOutBarChart( d, i, nodes, params ) );
|
|
};
|