Merge pull request #516 from danvk/jstd-coverage
[dygraphs.git] / dygraph-gviz.js
1 /**
2 * @license
3 * Copyright 2011 Dan Vanderkam (danvdk@gmail.com)
4 * MIT-licensed (http://opensource.org/licenses/MIT)
5 */
6
7 /**
8 * @fileoverview A wrapper around the Dygraph class which implements the
9 * interface for a GViz (aka Google Visualization API) visualization.
10 * It is designed to be a drop-in replacement for Google's AnnotatedTimeline,
11 * so the documentation at
12 * http://code.google.com/apis/chart/interactive/docs/gallery/annotatedtimeline.html
13 * translates over directly.
14 *
15 * For a full demo, see:
16 * - http://dygraphs.com/tests/gviz.html
17 * - http://dygraphs.com/tests/annotation-gviz.html
18 */
19
20 (function() {
21 /*global Dygraph:false */
22 "use strict";
23
24 /**
25 * A wrapper around Dygraph that implements the gviz API.
26 * @param {!HTMLDivElement} container The DOM object the visualization should
27 * live in.
28 * @constructor
29 */
30 Dygraph.GVizChart = function(container) {
31 this.container = container;
32 };
33
34 /**
35 * @param {GVizDataTable} data
36 * @param {Object.<*>} options
37 */
38 Dygraph.GVizChart.prototype.draw = function(data, options) {
39 // Clear out any existing dygraph.
40 // TODO(danvk): would it make more sense to simply redraw using the current
41 // date_graph object?
42 this.container.innerHTML = '';
43 if (typeof(this.date_graph) != 'undefined') {
44 this.date_graph.destroy();
45 }
46
47 this.date_graph = new Dygraph(this.container, data, options);
48 };
49
50 /**
51 * Google charts compatible setSelection
52 * Only row selection is supported, all points in the row will be highlighted
53 * @param {Array.<{row:number}>} selection_array array of the selected cells
54 * @public
55 */
56 Dygraph.GVizChart.prototype.setSelection = function(selection_array) {
57 var row = false;
58 if (selection_array.length) {
59 row = selection_array[0].row;
60 }
61 this.date_graph.setSelection(row);
62 };
63
64 /**
65 * Google charts compatible getSelection implementation
66 * @return {Array.<{row:number,column:number}>} array of the selected cells
67 * @public
68 */
69 Dygraph.GVizChart.prototype.getSelection = function() {
70 var selection = [];
71
72 var row = this.date_graph.getSelection();
73
74 if (row < 0) return selection;
75
76 var points = this.date_graph.layout_.points;
77 for (var setIdx = 0; setIdx < points.length; ++setIdx) {
78 selection.push({row: row, column: setIdx + 1});
79 }
80
81 return selection;
82 };
83
84 })();