/**
|
* Highcharts Drilldown plugin
|
*
|
* Author: Torstein Honsi
|
* Last revision: 2013-02-18
|
* License: MIT License
|
*
|
* Demo: http://jsfiddle.net/highcharts/Vf3yT/
|
*/
|
|
/*global HighchartsAdapter*/
|
(function (H) {
|
|
"use strict";
|
|
var noop = function () {},
|
defaultOptions = H.getOptions(),
|
each = H.each,
|
extend = H.extend,
|
wrap = H.wrap,
|
Chart = H.Chart,
|
seriesTypes = H.seriesTypes,
|
PieSeries = seriesTypes.pie,
|
ColumnSeries = seriesTypes.column,
|
fireEvent = HighchartsAdapter.fireEvent;
|
|
// Utilities
|
function tweenColors(startColor, endColor, pos) {
|
var rgba = [
|
Math.round(startColor[0] + (endColor[0] - startColor[0]) * pos),
|
Math.round(startColor[1] + (endColor[1] - startColor[1]) * pos),
|
Math.round(startColor[2] + (endColor[2] - startColor[2]) * pos),
|
startColor[3] + (endColor[3] - startColor[3]) * pos
|
];
|
return 'rgba(' + rgba.join(',') + ')';
|
}
|
|
// Add language
|
extend(defaultOptions.lang, {
|
drillUpText: '◁ Back to {series.name}'
|
});
|
defaultOptions.drilldown = {
|
activeAxisLabelStyle: {
|
cursor: 'pointer',
|
color: '#039',
|
fontWeight: 'bold',
|
textDecoration: 'underline'
|
},
|
activeDataLabelStyle: {
|
cursor: 'pointer',
|
color: '#039',
|
fontWeight: 'bold',
|
textDecoration: 'underline'
|
},
|
animation: {
|
duration: 500
|
},
|
drillUpButton: {
|
position: {
|
align: 'right',
|
x: -10,
|
y: 10
|
}
|
// relativeTo: 'plotBox'
|
// theme
|
}
|
};
|
|
/**
|
* A general fadeIn method
|
*/
|
H.SVGRenderer.prototype.Element.prototype.fadeIn = function () {
|
this
|
.attr({
|
opacity: 0.1,
|
visibility: 'visible'
|
})
|
.animate({
|
opacity: 1
|
}, {
|
duration: 250
|
});
|
};
|
|
// Extend the Chart prototype
|
Chart.prototype.drilldownLevels = [];
|
|
Chart.prototype.addSeriesAsDrilldown = function (point, ddOptions) {
|
var oldSeries = point.series,
|
xAxis = oldSeries.xAxis,
|
yAxis = oldSeries.yAxis,
|
newSeries,
|
color = point.color || oldSeries.color,
|
pointIndex,
|
level;
|
|
ddOptions = extend({
|
color: color
|
}, ddOptions);
|
pointIndex = HighchartsAdapter.inArray(this, oldSeries.points);
|
level = {
|
seriesOptions: oldSeries.userOptions,
|
shapeArgs: point.shapeArgs,
|
bBox: point.graphic.getBBox(),
|
color: color,
|
newSeries: ddOptions,
|
pointOptions: oldSeries.options.data[pointIndex],
|
pointIndex: pointIndex,
|
oldExtremes: {
|
xMin: xAxis && xAxis.userMin,
|
xMax: xAxis && xAxis.userMax,
|
yMin: yAxis && yAxis.userMin,
|
yMax: yAxis && yAxis.userMax
|
}
|
};
|
|
this.drilldownLevels.push(level);
|
|
newSeries = this.addSeries(ddOptions, false);
|
if (xAxis) {
|
xAxis.oldPos = xAxis.pos;
|
xAxis.userMin = xAxis.userMax = null;
|
yAxis.userMin = yAxis.userMax = null;
|
}
|
|
// Run fancy cross-animation on supported and equal types
|
if (oldSeries.type === newSeries.type) {
|
newSeries.animate = newSeries.animateDrilldown || noop;
|
newSeries.options.animation = true;
|
}
|
|
oldSeries.remove(false);
|
|
this.redraw();
|
this.showDrillUpButton();
|
};
|
|
Chart.prototype.getDrilldownBackText = function () {
|
var lastLevel = this.drilldownLevels[this.drilldownLevels.length - 1];
|
|
return this.options.lang.drillUpText.replace('{series.name}', lastLevel.seriesOptions.name);
|
|
};
|
|
Chart.prototype.showDrillUpButton = function () {
|
var chart = this,
|
backText = this.getDrilldownBackText(),
|
buttonOptions = chart.options.drilldown.drillUpButton;
|
|
|
if (!this.drillUpButton) {
|
this.drillUpButton = this.renderer.button(
|
backText,
|
null,
|
null,
|
function () {
|
chart.drillUp();
|
}
|
)
|
.attr(extend({
|
align: buttonOptions.position.align,
|
zIndex: 9
|
}, buttonOptions.theme))
|
.add()
|
.align(buttonOptions.position, false, buttonOptions.relativeTo || 'plotBox');
|
} else {
|
this.drillUpButton.attr({
|
text: backText
|
})
|
.align();
|
}
|
};
|
|
Chart.prototype.drillUp = function () {
|
var chart = this,
|
level = chart.drilldownLevels.pop(),
|
oldSeries = chart.series[0],
|
oldExtremes = level.oldExtremes,
|
newSeries = chart.addSeries(level.seriesOptions, false);
|
|
fireEvent(chart, 'drillup', { seriesOptions: level.seriesOptions });
|
|
if (newSeries.type === oldSeries.type) {
|
newSeries.drilldownLevel = level;
|
newSeries.animate = newSeries.animateDrillupTo || noop;
|
newSeries.options.animation = true;
|
|
if (oldSeries.animateDrillupFrom) {
|
oldSeries.animateDrillupFrom(level);
|
}
|
}
|
|
oldSeries.remove(false);
|
|
// Reset the zoom level of the upper series
|
if (newSeries.xAxis) {
|
newSeries.xAxis.setExtremes(oldExtremes.xMin, oldExtremes.xMax, false);
|
newSeries.yAxis.setExtremes(oldExtremes.yMin, oldExtremes.yMax, false);
|
}
|
|
|
this.redraw();
|
|
if (this.drilldownLevels.length === 0) {
|
this.drillUpButton = this.drillUpButton.destroy();
|
} else {
|
this.drillUpButton.attr({
|
text: this.getDrilldownBackText()
|
})
|
.align();
|
}
|
};
|
|
PieSeries.prototype.animateDrilldown = function (init) {
|
var level = this.chart.drilldownLevels[this.chart.drilldownLevels.length - 1],
|
animationOptions = this.chart.options.drilldown.animation,
|
animateFrom = level.shapeArgs,
|
start = animateFrom.start,
|
angle = animateFrom.end - start,
|
startAngle = angle / this.points.length,
|
startColor = H.Color(level.color).rgba;
|
|
if (!init) {
|
each(this.points, function (point, i) {
|
var endColor = H.Color(point.color).rgba;
|
|
/*jslint unparam: true*/
|
point.graphic
|
.attr(H.merge(animateFrom, {
|
start: start + i * startAngle,
|
end: start + (i + 1) * startAngle
|
}))
|
.animate(point.shapeArgs, H.merge(animationOptions, {
|
step: function (val, fx) {
|
if (fx.prop === 'start') {
|
this.attr({
|
fill: tweenColors(startColor, endColor, fx.pos)
|
});
|
}
|
}
|
}));
|
/*jslint unparam: false*/
|
});
|
}
|
};
|
|
|
/**
|
* When drilling up, keep the upper series invisible until the lower series has
|
* moved into place
|
*/
|
PieSeries.prototype.animateDrillupTo =
|
ColumnSeries.prototype.animateDrillupTo = function (init) {
|
if (!init) {
|
var newSeries = this,
|
level = newSeries.drilldownLevel;
|
|
each(this.points, function (point) {
|
point.graphic.hide();
|
if (point.dataLabel) {
|
point.dataLabel.hide();
|
}
|
if (point.connector) {
|
point.connector.hide();
|
}
|
});
|
|
|
// Do dummy animation on first point to get to complete
|
setTimeout(function () {
|
each(newSeries.points, function (point, i) {
|
// Fade in other points
|
var verb = i === level.pointIndex ? 'show' : 'fadeIn';
|
point.graphic[verb]();
|
if (point.dataLabel) {
|
point.dataLabel[verb]();
|
}
|
if (point.connector) {
|
point.connector[verb]();
|
}
|
});
|
}, Math.max(this.chart.options.drilldown.animation.duration - 50, 0));
|
|
// Reset
|
this.animate = noop;
|
}
|
|
};
|
|
ColumnSeries.prototype.animateDrilldown = function (init) {
|
var animateFrom = this.chart.drilldownLevels[this.chart.drilldownLevels.length - 1].shapeArgs,
|
animationOptions = this.chart.options.drilldown.animation;
|
|
if (!init) {
|
|
animateFrom.x += (this.xAxis.oldPos - this.xAxis.pos);
|
|
each(this.points, function (point) {
|
point.graphic
|
.attr(animateFrom)
|
.animate(point.shapeArgs, animationOptions);
|
});
|
}
|
|
};
|
|
/**
|
* When drilling up, pull out the individual point graphics from the lower series
|
* and animate them into the origin point in the upper series.
|
*/
|
ColumnSeries.prototype.animateDrillupFrom =
|
PieSeries.prototype.animateDrillupFrom =
|
function (level) {
|
var animationOptions = this.chart.options.drilldown.animation,
|
group = this.group;
|
|
delete this.group;
|
each(this.points, function (point) {
|
var graphic = point.graphic,
|
startColor = H.Color(point.color).rgba;
|
|
delete point.graphic;
|
|
/*jslint unparam: true*/
|
graphic.animate(level.shapeArgs, H.merge(animationOptions, {
|
|
step: function (val, fx) {
|
if (fx.prop === 'start') {
|
this.attr({
|
fill: tweenColors(startColor, H.Color(level.color).rgba, fx.pos)
|
});
|
}
|
},
|
complete: function () {
|
graphic.destroy();
|
if (group) {
|
group = group.destroy();
|
}
|
}
|
}));
|
/*jslint unparam: false*/
|
});
|
};
|
|
H.Point.prototype.doDrilldown = function () {
|
var series = this.series,
|
chart = series.chart,
|
drilldown = chart.options.drilldown,
|
i = drilldown.series.length,
|
seriesOptions;
|
|
while (i-- && !seriesOptions) {
|
if (drilldown.series[i].id === this.drilldown) {
|
seriesOptions = drilldown.series[i];
|
}
|
}
|
|
// Fire the event. If seriesOptions is undefined, the implementer can check for
|
// seriesOptions, and call addSeriesAsDrilldown async if necessary.
|
fireEvent(chart, 'drilldown', {
|
point: this,
|
seriesOptions: seriesOptions
|
});
|
|
if (seriesOptions) {
|
chart.addSeriesAsDrilldown(this, seriesOptions);
|
}
|
|
};
|
|
wrap(H.Point.prototype, 'init', function (proceed, series, options, x) {
|
var point = proceed.call(this, series, options, x),
|
chart = series.chart,
|
tick = series.xAxis && series.xAxis.ticks[x],
|
tickLabel = tick && tick.label;
|
|
if (point.drilldown) {
|
|
// Add the click event to the point label
|
H.addEvent(point, 'click', function () {
|
point.doDrilldown();
|
});
|
|
// Make axis labels clickable
|
if (tickLabel) {
|
if (!tickLabel._basicStyle) {
|
tickLabel._basicStyle = tickLabel.element.getAttribute('style');
|
}
|
tickLabel
|
.addClass('highcharts-drilldown-axis-label')
|
.css(chart.options.drilldown.activeAxisLabelStyle)
|
.on('click', function () {
|
if (point.doDrilldown) {
|
point.doDrilldown();
|
}
|
});
|
|
}
|
} else if (tickLabel && tickLabel._basicStyle) {
|
tickLabel.element.setAttribute('style', tickLabel._basicStyle);
|
}
|
|
return point;
|
});
|
|
wrap(H.Series.prototype, 'drawDataLabels', function (proceed) {
|
var css = this.chart.options.drilldown.activeDataLabelStyle;
|
|
proceed.call(this);
|
|
each(this.points, function (point) {
|
if (point.drilldown && point.dataLabel) {
|
point.dataLabel
|
.attr({
|
'class': 'highcharts-drilldown-data-label'
|
})
|
.css(css)
|
.on('click', function () {
|
point.doDrilldown();
|
});
|
}
|
});
|
});
|
|
// Mark the trackers with a pointer
|
ColumnSeries.prototype.supportsDrilldown = true;
|
PieSeries.prototype.supportsDrilldown = true;
|
var type,
|
drawTrackerWrapper = function (proceed) {
|
proceed.call(this);
|
each(this.points, function (point) {
|
if (point.drilldown && point.graphic) {
|
point.graphic
|
.attr({
|
'class': 'highcharts-drilldown-point'
|
})
|
.css({ cursor: 'pointer' });
|
}
|
});
|
};
|
for (type in seriesTypes) {
|
if (seriesTypes[type].prototype.supportsDrilldown) {
|
wrap(seriesTypes[type].prototype, 'drawTracker', drawTrackerWrapper);
|
}
|
}
|
|
}(Highcharts));
|
