175 lines
4.8 KiB
JavaScript
175 lines
4.8 KiB
JavaScript
/* *
|
|
*
|
|
* (c) 2010-2020 Torstein Honsi
|
|
*
|
|
* License: www.highcharts.com/license
|
|
*
|
|
* !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
|
|
*
|
|
* */
|
|
'use strict';
|
|
import H from '../parts/Globals.js';
|
|
import '../parts/Utilities.js';
|
|
import '../parts/Options.js';
|
|
import '../parts/Point.js';
|
|
import '../parts/ScatterSeries.js';
|
|
var merge = H.merge, Point = H.Point, Series = H.Series, seriesType = H.seriesType;
|
|
/**
|
|
* @private
|
|
* @class
|
|
* @name Highcharts.seriesTypes.mappoint
|
|
*
|
|
* @augments Highcharts.Series
|
|
*/
|
|
seriesType('mappoint', 'scatter',
|
|
/**
|
|
* A mappoint series is a special form of scatter series where the points
|
|
* can be laid out in map coordinates on top of a map.
|
|
*
|
|
* @sample maps/demo/mapline-mappoint/
|
|
* Map-line and map-point series.
|
|
*
|
|
* @extends plotOptions.scatter
|
|
* @product highmaps
|
|
* @optionparent plotOptions.mappoint
|
|
*/
|
|
{
|
|
dataLabels: {
|
|
crop: false,
|
|
defer: false,
|
|
enabled: true,
|
|
formatter: function () {
|
|
return this.point.name;
|
|
},
|
|
overflow: false,
|
|
style: {
|
|
/** @internal */
|
|
color: '#000000'
|
|
}
|
|
}
|
|
// Prototype members
|
|
}, {
|
|
type: 'mappoint',
|
|
forceDL: true,
|
|
drawDataLabels: function () {
|
|
Series.prototype.drawDataLabels.call(this);
|
|
if (this.dataLabelsGroup) {
|
|
this.dataLabelsGroup.clip(this.chart.clipRect);
|
|
}
|
|
}
|
|
// Point class
|
|
}, {
|
|
applyOptions: function (options, x) {
|
|
var mergedOptions = (typeof options.lat !== 'undefined' &&
|
|
typeof options.lon !== 'undefined' ?
|
|
merge(options, this.series.chart.fromLatLonToPoint(options)) :
|
|
options);
|
|
return Point.prototype
|
|
.applyOptions.call(this, mergedOptions, x);
|
|
}
|
|
});
|
|
/**
|
|
* A `mappoint` series. If the [type](#series.mappoint.type) option
|
|
* is not specified, it is inherited from [chart.type](#chart.type).
|
|
*
|
|
*
|
|
* @extends series,plotOptions.mappoint
|
|
* @excluding dataParser, dataURL
|
|
* @product highmaps
|
|
* @apioption series.mappoint
|
|
*/
|
|
/**
|
|
* An array of data points for the series. For the `mappoint` series
|
|
* type, points can be given in the following ways:
|
|
*
|
|
* 1. An array of numerical values. In this case, the numerical values will be
|
|
* interpreted as `y` options. The `x` values will be automatically
|
|
* calculated, either starting at 0 and incremented by 1, or from
|
|
* `pointStart` and `pointInterval` given in the series options. If the axis
|
|
* has categories, these will be used. Example:
|
|
* ```js
|
|
* data: [0, 5, 3, 5]
|
|
* ```
|
|
*
|
|
* 2. An array of arrays with 2 values. In this case, the values correspond to
|
|
* `x,y`. If the first value is a string, it is applied as the name of the
|
|
* point, and the `x` value is inferred.
|
|
* ```js
|
|
* data: [
|
|
* [0, 1],
|
|
* [1, 8],
|
|
* [2, 7]
|
|
* ]
|
|
* ```
|
|
*
|
|
* 3. An array of objects with named values. The following snippet shows only a
|
|
* few settings, see the complete options set below. If the total number of
|
|
* data points exceeds the series'
|
|
* [turboThreshold](#series.mappoint.turboThreshold),
|
|
* this option is not available.
|
|
* ```js
|
|
* data: [{
|
|
* x: 1,
|
|
* y: 7,
|
|
* name: "Point2",
|
|
* color: "#00FF00"
|
|
* }, {
|
|
* x: 1,
|
|
* y: 4,
|
|
* name: "Point1",
|
|
* color: "#FF00FF"
|
|
* }]
|
|
* ```
|
|
*
|
|
* @type {Array<number|Array<number,(number|null)>|null|*>}
|
|
* @extends series.map.data
|
|
* @excluding labelrank, middleX, middleY, path, value
|
|
* @product highmaps
|
|
* @apioption series.mappoint.data
|
|
*/
|
|
/**
|
|
* The latitude of the point. Must be combined with the `lon` option
|
|
* to work. Overrides `x` and `y` values.
|
|
*
|
|
* @sample {highmaps} maps/demo/mappoint-latlon/
|
|
* Point position by lat/lon
|
|
*
|
|
* @type {number}
|
|
* @since 1.1.0
|
|
* @product highmaps
|
|
* @apioption series.mappoint.data.lat
|
|
*/
|
|
/**
|
|
* The longitude of the point. Must be combined with the `lon` option
|
|
* to work. Overrides `x` and `y` values.
|
|
*
|
|
* @sample {highmaps} maps/demo/mappoint-latlon/
|
|
* Point position by lat/lon
|
|
*
|
|
* @type {number}
|
|
* @since 1.1.0
|
|
* @product highmaps
|
|
* @apioption series.mappoint.data.lon
|
|
*/
|
|
/**
|
|
* The x coordinate of the point in terms of the map path coordinates.
|
|
*
|
|
* @sample {highmaps} maps/demo/mapline-mappoint/
|
|
* Map point demo
|
|
*
|
|
* @type {number}
|
|
* @product highmaps
|
|
* @apioption series.mappoint.data.x
|
|
*/
|
|
/**
|
|
* The x coordinate of the point in terms of the map path coordinates.
|
|
*
|
|
* @sample {highmaps} maps/demo/mapline-mappoint/
|
|
* Map point demo
|
|
*
|
|
* @type {number|null}
|
|
* @product highmaps
|
|
* @apioption series.mappoint.data.y
|
|
*/
|
|
''; // adds doclets above to transpiled file
|