/** * @license Highcharts JS v3.0.6 (2013-10-04) * Prototype adapter * * @author Michael Nelson, Torstein Hønsi. * * Feel free to use and modify this script. * Highcharts license: www.highcharts.com/license. */ // JSLint options: /*global Effect, Class, Event, Element, $, $$, $A */ // Adapter interface between prototype and the Highcharts charting library var HighchartsAdapter = (function () { var hasEffect = typeof Effect !== 'undefined'; return { /** * Initialize the adapter. This is run once as Highcharts is first run. * @param {Object} pathAnim The helper object to do animations across adapters. */ init: function (pathAnim) { if (hasEffect) { /** * Animation for Highcharts SVG element wrappers only * @param {Object} element * @param {Object} attribute * @param {Object} to * @param {Object} options */ Effect.HighchartsTransition = Class.create(Effect.Base, { initialize: function (element, attr, to, options) { var from, opts; this.element = element; this.key = attr; from = element.attr ? element.attr(attr) : $(element).getStyle(attr); // special treatment for paths if (attr === 'd') { this.paths = pathAnim.init( element, element.d, to ); this.toD = to; // fake values in order to read relative position as a float in update from = 0; to = 1; } opts = Object.extend((options || {}), { from: from, to: to, attribute: attr }); this.start(opts); }, setup: function () { HighchartsAdapter._extend(this.element); // If this is the first animation on this object, create the _highcharts_animation helper that // contain pointers to the animation objects. if (!this.element._highchart_animation) { this.element._highchart_animation = {}; } // Store a reference to this animation instance. this.element._highchart_animation[this.key] = this; }, update: function (position) { var paths = this.paths, element = this.element, obj; if (paths) { position = pathAnim.step(paths[0], paths[1], position, this.toD); } if (element.attr) { // SVGElement if (element.element) { // If not, it has been destroyed (#1405) element.attr(this.options.attribute, position); } } else { // HTML, #409 obj = {}; obj[this.options.attribute] = position; $(element).setStyle(obj); } }, finish: function () { // Delete the property that holds this animation now that it is finished. // Both canceled animations and complete ones gets a 'finish' call. if (this.element && this.element._highchart_animation) { // #1405 delete this.element._highchart_animation[this.key]; } } }); } }, /** * Run a general method on the framework, following jQuery syntax * @param {Object} el The HTML element * @param {String} method Which method to run on the wrapped element */ adapterRun: function (el, method) { // This currently works for getting inner width and height. If adding // more methods later, we need a conditional implementation for each. return parseInt($(el).getStyle(method), 10); }, /** * Downloads a script and executes a callback when done. * @param {String} scriptLocation * @param {Function} callback */ getScript: function (scriptLocation, callback) { var head = $$('head')[0]; // Returns an array, so pick the first element. if (head) { // Append a new 'script' element, set its type and src attributes, add a 'load' handler that calls the callback head.appendChild(new Element('script', { type: 'text/javascript', src: scriptLocation}).observe('load', callback)); } }, /** * Custom events in prototype needs to be namespaced. This method adds a namespace 'h:' in front of * events that are not recognized as native. */ addNS: function (eventName) { var HTMLEvents = /^(?:load|unload|abort|error|select|change|submit|reset|focus|blur|resize|scroll)$/, MouseEvents = /^(?:click|mouse(?:down|up|over|move|out))$/; return (HTMLEvents.test(eventName) || MouseEvents.test(eventName)) ? eventName : 'h:' + eventName; }, // el needs an event to be attached. el is not necessarily a dom element addEvent: function (el, event, fn) { if (el.addEventListener || el.attachEvent) { Event.observe($(el), HighchartsAdapter.addNS(event), fn); } else { HighchartsAdapter._extend(el); el._highcharts_observe(event, fn); } }, // motion makes things pretty. use it if effects is loaded, if not... still get to the end result. animate: function (el, params, options) { var key, fx; // default options options = options || {}; options.delay = 0; options.duration = (options.duration || 500) / 1000; options.afterFinish = options.complete; // animate wrappers and DOM elements if (hasEffect) { for (key in params) { // The fx variable is seemingly thrown away here, but the Effect.setup will add itself to the _highcharts_animation object // on the element itself so its not really lost. fx = new Effect.HighchartsTransition($(el), key, params[key], options); } } else { if (el.attr) { // #409 without effects for (key in params) { el.attr(key, params[key]); } } if (options.complete) { options.complete(); } } if (!el.attr) { // HTML element, #409 $(el).setStyle(params); } }, // this only occurs in higcharts 2.0+ stop: function (el) { var key; if (el._highcharts_extended && el._highchart_animation) { for (key in el._highchart_animation) { // Cancel the animation // The 'finish' function in the Effect object will remove the reference el._highchart_animation[key].cancel(); } } }, // um.. each each: function (arr, fn) { $A(arr).each(fn); }, inArray: function (item, arr, from) { return arr ? arr.indexOf(item, from) : -1; }, /** * Get the cumulative offset relative to the top left of the page. This method, unlike its * jQuery and MooTools counterpart, still suffers from issue #208 regarding the position * of a chart within a fixed container. */ offset: function (el) { return $(el).cumulativeOffset(); }, // fire an event based on an event name (event) and an object (el). // again, el may not be a dom element fireEvent: function (el, event, eventArguments, defaultFunction) { if (el.fire) { el.fire(HighchartsAdapter.addNS(event), eventArguments); } else if (el._highcharts_extended) { eventArguments = eventArguments || {}; el._highcharts_fire(event, eventArguments); } if (eventArguments && eventArguments.defaultPrevented) { defaultFunction = null; } if (defaultFunction) { defaultFunction(eventArguments); } }, removeEvent: function (el, event, handler) { if ($(el).stopObserving) { if (event) { event = HighchartsAdapter.addNS(event); } $(el).stopObserving(event, handler); } if (window === el) { Event.stopObserving(el, event, handler); } else { HighchartsAdapter._extend(el); el._highcharts_stop_observing(event, handler); } }, washMouseEvent: function (e) { return e; }, // um, grep grep: function (arr, fn) { return arr.findAll(fn); }, // um, map map: function (arr, fn) { return arr.map(fn); }, // extend an object to handle highchart events (highchart objects, not svg elements). // this is a very simple way of handling events but whatever, it works (i think) _extend: function (object) { if (!object._highcharts_extended) { Object.extend(object, { _highchart_events: {}, _highchart_animation: null, _highcharts_extended: true, _highcharts_observe: function (name, fn) { this._highchart_events[name] = [this._highchart_events[name], fn].compact().flatten(); }, _highcharts_stop_observing: function (name, fn) { if (name) { if (fn) { this._highchart_events[name] = [this._highchart_events[name]].compact().flatten().without(fn); } else { delete this._highchart_events[name]; } } else { this._highchart_events = {}; } }, _highcharts_fire: function (name, args) { var target = this; (this._highchart_events[name] || []).each(function (fn) { // args is never null here if (args.stopped) { return; // "throw $break" wasn't working. i think because of the scope of 'this'. } // Attach a simple preventDefault function to skip default handler if called args.preventDefault = function () { args.defaultPrevented = true; }; args.target = target; // If the event handler return false, prevent the default handler from executing if (fn.bind(this)(args) === false) { args.preventDefault(); } } .bind(this)); } }); } } }; }());