UNPKG

highcharts

Version:
205 lines (204 loc) 5.42 kB
/* * * * (c) 2010-2025 Torstein Honsi * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ 'use strict'; /* * * * API Options * * */ /** * 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. * @sample maps/demo/mappoint-mapmarker * Using the mapmarker symbol for points * @sample maps/demo/mappoint-datalabels-mapmarker * Using the mapmarker shape for data labels * * @extends plotOptions.scatter * @product highmaps * @optionparent plotOptions.mappoint */ const MapPointSeriesDefaults = { dataLabels: { crop: false, defer: false, enabled: true, formatter: function () { return this.point.name; }, overflow: false, style: { /** @internal */ color: "#000000" /* Palette.neutralColor100 */ } }, legendSymbol: 'lineMarker' }; /* * * * Default Export * * */ export default MapPointSeriesDefaults; /* * * * API Options * * */ /** * 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 `[hc-key, value]`. Example: * * ```js * data: [ * ['us-ny', 0], * ['us-mi', 5], * ['us-tx', 3], * ['us-ak', 5] * ] * ``` * * 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 geometry of a point. * * To achieve a better separation between the structure and the data, * it is recommended to use `mapData` to define the geometry instead * of defining it on the data points themselves. * * The geometry object is compatible to that of a `feature` in geoJSON, so * features of geoJSON can be passed directly into the `data`, optionally * after first filtering and processing it. * * @sample maps/series/mappoint-line-geometry/ * Map point and line geometry * * @type {Object} * @since 9.3.0 * @product highmaps * @apioption series.mappoint.data.geometry */ /** * The geometry type, which in case of the `mappoint` series is always `Point`. * * @type {string} * @since 9.3.0 * @product highmaps * @validvalue ["Point"] * @apioption series.mappoint.data.geometry.type */ /** * The geometry coordinates in terms of `[longitude, latitude]`. * * @type {Highcharts.LonLatArray} * @since 9.3.0 * @product highmaps * @apioption series.mappoint.data.geometry.coordinates */ /** * 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 projected units. * * @sample {highmaps} maps/series/mapline-mappoint-path-xy/ * Map point demo * * @type {number} * @product highmaps * @apioption series.mappoint.data.x */ /** * The x coordinate of the point in terms of projected units. * * @sample {highmaps} maps/series/mapline-mappoint-path-xy/ * Map point demo * * @type {number|null} * @product highmaps * @apioption series.mappoint.data.y */ /** * @type {number} * @product highmaps * @excluding borderColor, borderWidth * @apioption plotOptions.mappoint */ (''); // Keeps doclets above in JS file