/** * 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));