Subversion-Projekte lars-tiefland.cienc

Revision

Details | Letzte Änderung | Log anzeigen | RSS feed

Revision Autor Zeilennr. Zeile
9 lars 1
/**
2
 * jqPlot
3
 * Pure JavaScript plotting plugin using jQuery
4
 *
5
 * Version: 1.0.8
6
 * Revision: 1250
7
 *
8
 * Copyright (c) 2009-2013 Chris Leonello
9
 * jqPlot is currently available for use in all personal or commercial projects
10
 * under both the MIT (http://www.opensource.org/licenses/mit-license.php) and GPL
11
 * version 2.0 (http://www.gnu.org/licenses/gpl-2.0.html) licenses. This means that you can
12
 * choose the license that best suits your project and use it accordingly.
13
 *
14
 * Although not required, the author would appreciate an email letting him
15
 * know of any substantial use of jqPlot.  You can reach the author at:
16
 * chris at jqplot dot com or see http://www.jqplot.com/info.php .
17
 *
18
 * If you are feeling kind and generous, consider supporting the project by
19
 * making a donation at: http://www.jqplot.com/donate.php .
20
 *
21
 * sprintf functions contained in jqplot.sprintf.js by Ash Searle:
22
 *
23
 *     version 2007.04.27
24
 *     author Ash Searle
25
 *     http://hexmen.com/blog/2007/03/printf-sprintf/
26
 *     http://hexmen.com/js/sprintf.js
27
 *     The author (Ash Searle) has placed this code in the public domain:
28
 *     "This code is unrestricted: you are free to use it however you like."
29
 *
30
 */
31
(function($) {
32
 
33
    /**
34
     * Class: $.jqplot.PointLabels
35
     * Plugin for putting labels at the data points.
36
     *
37
     * To use this plugin, include the js
38
     * file in your source:
39
     *
40
     * > <script type="text/javascript" src="plugins/jqplot.pointLabels.js"></script>
41
     *
42
     * By default, the last value in the data ponit array in the data series is used
43
     * for the label.  For most series renderers, extra data can be added to the
44
     * data point arrays and the last value will be used as the label.
45
     *
46
     * For instance,
47
     * this series:
48
     *
49
     * > [[1,4], [3,5], [7,2]]
50
     *
51
     * Would, by default, use the y values in the labels.
52
     * Extra data can be added to the series like so:
53
     *
54
     * > [[1,4,'mid'], [3 5,'hi'], [7,2,'low']]
55
     *
56
     * And now the point labels would be 'mid', 'low', and 'hi'.
57
     *
58
     * Options to the point labels and a custom labels array can be passed into the
59
     * "pointLabels" option on the series option like so:
60
     *
61
     * > series:[{pointLabels:{
62
     * >    labels:['mid', 'hi', 'low'],
63
     * >    location:'se',
64
     * >    ypadding: 12
65
     * >    }
66
     * > }]
67
     *
68
     * A custom labels array in the options takes precendence over any labels
69
     * in the series data.  If you have a custom labels array in the options,
70
     * but still want to use values from the series array as labels, set the
71
     * "labelsFromSeries" option to true.
72
     *
73
     * By default, html entities (<, >, etc.) are escaped in point labels.
74
     * If you want to include actual html markup in the labels,
75
     * set the "escapeHTML" option to false.
76
     *
77
     */
78
    $.jqplot.PointLabels = function(options) {
79
        // Group: Properties
80
        //
81
        // prop: show
82
        // show the labels or not.
83
        this.show = $.jqplot.config.enablePlugins;
84
        // prop: location
85
        // compass location where to position the label around the point.
86
        // 'n', 'ne', 'e', 'se', 's', 'sw', 'w', 'nw'
87
        this.location = 'n';
88
        // prop: labelsFromSeries
89
        // true to use labels within data point arrays.
90
        this.labelsFromSeries = false;
91
        // prop: seriesLabelIndex
92
        // array index for location of labels within data point arrays.
93
        // if null, will use the last element of the data point array.
94
        this.seriesLabelIndex = null;
95
        // prop: labels
96
        // array of arrays of labels, one array for each series.
97
        this.labels = [];
98
        // actual labels that will get displayed.
99
        // needed to preserve user specified labels in labels array.
100
        this._labels = [];
101
        // prop: stackedValue
102
        // true to display value as stacked in a stacked plot.
103
        // no effect if labels is specified.
104
        this.stackedValue = false;
105
        // prop: ypadding
106
        // vertical padding in pixels between point and label
107
        this.ypadding = 6;
108
        // prop: xpadding
109
        // horizontal padding in pixels between point and label
110
        this.xpadding = 6;
111
        // prop: escapeHTML
112
        // true to escape html entities in the labels.
113
        // If you want to include markup in the labels, set to false.
114
        this.escapeHTML = true;
115
        // prop: edgeTolerance
116
        // Number of pixels that the label must be away from an axis
117
        // boundary in order to be drawn.  Negative values will allow overlap
118
        // with the grid boundaries.
119
        this.edgeTolerance = -5;
120
        // prop: formatter
121
        // A class of a formatter for the tick text.  sprintf by default.
122
        this.formatter = $.jqplot.DefaultTickFormatter;
123
        // prop: formatString
124
        // string passed to the formatter.
125
        this.formatString = '';
126
        // prop: hideZeros
127
        // true to not show a label for a value which is 0.
128
        this.hideZeros = false;
129
        this._elems = [];
130
 
131
        $.extend(true, this, options);
132
    };
133
 
134
    var locations = ['nw', 'n', 'ne', 'e', 'se', 's', 'sw', 'w'];
135
    var locationIndicies = {'nw':0, 'n':1, 'ne':2, 'e':3, 'se':4, 's':5, 'sw':6, 'w':7};
136
    var oppositeLocations = ['se', 's', 'sw', 'w', 'nw', 'n', 'ne', 'e'];
137
 
138
    // called with scope of a series
139
    $.jqplot.PointLabels.init = function (target, data, seriesDefaults, opts, plot){
140
        var options = $.extend(true, {}, seriesDefaults, opts);
141
        options.pointLabels = options.pointLabels || {};
142
        if (this.renderer.constructor === $.jqplot.BarRenderer && this.barDirection === 'horizontal' && !options.pointLabels.location) {
143
            options.pointLabels.location = 'e';
144
        }
145
        // add a pointLabels attribute to the series plugins
146
        this.plugins.pointLabels = new $.jqplot.PointLabels(options.pointLabels);
147
        this.plugins.pointLabels.setLabels.call(this);
148
    };
149
 
150
    // called with scope of series
151
    $.jqplot.PointLabels.prototype.setLabels = function() {
152
        var p = this.plugins.pointLabels;
153
        var labelIdx;
154
        if (p.seriesLabelIndex != null) {
155
            labelIdx = p.seriesLabelIndex;
156
        }
157
        else if (this.renderer.constructor === $.jqplot.BarRenderer && this.barDirection === 'horizontal') {
158
           labelIdx = (this._plotData[0].length < 3) ? 0 : this._plotData[0].length -1;
159
        }
160
        else {
161
            labelIdx = (this._plotData.length === 0) ? 0 : this._plotData[0].length -1;
162
        }
163
        p._labels = [];
164
        if (p.labels.length === 0 || p.labelsFromSeries) {
165
            if (p.stackedValue) {
166
                if (this._plotData.length && this._plotData[0].length){
167
                    // var idx = p.seriesLabelIndex || this._plotData[0].length -1;
168
                    for (var i=0; i<this._plotData.length; i++) {
169
                        p._labels.push(this._plotData[i][labelIdx]);
170
                    }
171
                }
172
            }
173
            else {
174
                // var d = this._plotData;
175
                var d = this.data;
176
                if (this.renderer.constructor === $.jqplot.BarRenderer && this.waterfall) {
177
                    d = this._data;
178
                }
179
                if (d.length && d[0].length) {
180
                    // var idx = p.seriesLabelIndex || d[0].length -1;
181
                    for (var i=0; i<d.length; i++) {
182
                        p._labels.push(d[i][labelIdx]);
183
                    }
184
                }
185
                d = null;
186
            }
187
        }
188
        else if (p.labels.length){
189
            p._labels = p.labels;
190
        }
191
    };
192
 
193
    $.jqplot.PointLabels.prototype.xOffset = function(elem, location, padding) {
194
        location = location || this.location;
195
        padding = padding || this.xpadding;
196
        var offset;
197
 
198
        switch (location) {
199
            case 'nw':
200
                offset = -elem.outerWidth(true) - this.xpadding;
201
                break;
202
            case 'n':
203
                offset = -elem.outerWidth(true)/2;
204
                break;
205
            case 'ne':
206
                offset =  this.xpadding;
207
                break;
208
            case 'e':
209
                offset = this.xpadding;
210
                break;
211
            case 'se':
212
                offset = this.xpadding;
213
                break;
214
            case 's':
215
                offset = -elem.outerWidth(true)/2;
216
                break;
217
            case 'sw':
218
                offset = -elem.outerWidth(true) - this.xpadding;
219
                break;
220
            case 'w':
221
                offset = -elem.outerWidth(true) - this.xpadding;
222
                break;
223
            default: // same as 'nw'
224
                offset = -elem.outerWidth(true) - this.xpadding;
225
                break;
226
        }
227
        return offset;
228
    };
229
 
230
    $.jqplot.PointLabels.prototype.yOffset = function(elem, location, padding) {
231
        location = location || this.location;
232
        padding = padding || this.xpadding;
233
        var offset;
234
 
235
        switch (location) {
236
            case 'nw':
237
                offset = -elem.outerHeight(true) - this.ypadding;
238
                break;
239
            case 'n':
240
                offset = -elem.outerHeight(true) - this.ypadding;
241
                break;
242
            case 'ne':
243
                offset = -elem.outerHeight(true) - this.ypadding;
244
                break;
245
            case 'e':
246
                offset = -elem.outerHeight(true)/2;
247
                break;
248
            case 'se':
249
                offset = this.ypadding;
250
                break;
251
            case 's':
252
                offset = this.ypadding;
253
                break;
254
            case 'sw':
255
                offset = this.ypadding;
256
                break;
257
            case 'w':
258
                offset = -elem.outerHeight(true)/2;
259
                break;
260
            default: // same as 'nw'
261
                offset = -elem.outerHeight(true) - this.ypadding;
262
                break;
263
        }
264
        return offset;
265
    };
266
 
267
    // called with scope of series
268
    $.jqplot.PointLabels.draw = function (sctx, options, plot) {
269
        var p = this.plugins.pointLabels;
270
        // set labels again in case they have changed.
271
        p.setLabels.call(this);
272
        // remove any previous labels
273
        for (var i=0; i<p._elems.length; i++) {
274
            // Memory Leaks patch
275
            // p._elems[i].remove();
276
            p._elems[i].emptyForce();
277
        }
278
        p._elems.splice(0, p._elems.length);
279
 
280
        if (p.show) {
281
            var ax = '_'+this._stackAxis+'axis';
282
 
283
            if (!p.formatString) {
284
                p.formatString = this[ax]._ticks[0].formatString;
285
                p.formatter = this[ax]._ticks[0].formatter;
286
            }
287
 
288
            var pd = this._plotData;
289
            var ppd = this._prevPlotData;
290
            var xax = this._xaxis;
291
            var yax = this._yaxis;
292
            var elem, helem;
293
 
294
            for (var i=0, l=p._labels.length; i < l; i++) {
295
                var label = p._labels[i];
296
 
297
                if (label == null || (p.hideZeros && parseInt(label, 10) == 0)) {
298
                    continue;
299
                }
300
 
301
                label = p.formatter(p.formatString, label);
302
 
303
                helem = document.createElement('div');
304
                p._elems[i] = $(helem);
305
 
306
                elem = p._elems[i];
307
 
308
 
309
                elem.addClass('jqplot-point-label jqplot-series-'+this.index+' jqplot-point-'+i);
310
                elem.css('position', 'absolute');
311
                elem.insertAfter(sctx.canvas);
312
 
313
                if (p.escapeHTML) {
314
                    elem.text(label);
315
                }
316
                else {
317
                    elem.html(label);
318
                }
319
                var location = p.location;
320
                if ((this.fillToZero && pd[i][1] < 0) || (this.fillToZero && this._type === 'bar' && this.barDirection === 'horizontal' && pd[i][0] < 0) || (this.waterfall && parseInt(label, 10)) < 0) {
321
                    location = oppositeLocations[locationIndicies[location]];
322
                }
323
 
324
 
325
                var ell = xax.u2p(pd[i][0]) + p.xOffset(elem, location);
326
                var elt = yax.u2p(pd[i][1]) + p.yOffset(elem, location);
327
 
328
                // we have stacked chart but are not showing stacked values,
329
                // place labels in center.
330
                if (this._stack && !p.stackedValue) {
331
                    if (this.barDirection === "vertical") {
332
                        elt = (this._barPoints[i][0][1] + this._barPoints[i][1][1]) / 2 + plot._gridPadding.top - 0.5 * elem.outerHeight(true);
333
                    }
334
                    else {
335
                        ell = (this._barPoints[i][2][0] + this._barPoints[i][0][0]) / 2 + plot._gridPadding.left - 0.5 * elem.outerWidth(true);
336
                    }
337
                }
338
 
339
                if (this.renderer.constructor == $.jqplot.BarRenderer) {
340
                    if (this.barDirection == "vertical") {
341
                        ell += this._barNudge;
342
                    }
343
                    else {
344
                        elt -= this._barNudge;
345
                    }
346
                }
347
                elem.css('left', ell);
348
                elem.css('top', elt);
349
                var elr = ell + elem.width();
350
                var elb = elt + elem.height();
351
                var et = p.edgeTolerance;
352
                var scl = $(sctx.canvas).position().left;
353
                var sct = $(sctx.canvas).position().top;
354
                var scr = sctx.canvas.width + scl;
355
                var scb = sctx.canvas.height + sct;
356
                // if label is outside of allowed area, remove it
357
                if (ell - et < scl || elt - et < sct || elr + et > scr || elb + et > scb) {
358
                    elem.remove();
359
                }
360
 
361
                elem = null;
362
                helem = null;
363
            }
364
 
365
            // finally, animate them if the series is animated
366
            // if (this.renderer.animation && this.renderer.animation._supported && this.renderer.animation.show && plot._drawCount < 2) {
367
            //     var sel = '.jqplot-point-label.jqplot-series-'+this.index;
368
            //     $(sel).hide();
369
            //     $(sel).fadeIn(1000);
370
            // }
371
 
372
        }
373
    };
374
 
375
    $.jqplot.postSeriesInitHooks.push($.jqplot.PointLabels.init);
376
    $.jqplot.postDrawSeriesHooks.push($.jqplot.PointLabels.draw);
377
})(jQuery);