highcharts
Version:
JavaScript charting framework
186 lines (185 loc) • 5.34 kB
JavaScript
/* *
*
* (c) 2010-2025 Pawel Lysy
*
* License: www.highcharts.com/license
*
* !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
*
* */
'use strict';
/* *
*
* API Options
*
* */
/**
* An HLC chart is a style of financial chart used to describe price
* movements over time. It displays high, low and close values per
* data point.
*
* @sample stock/demo/hlc/
* HLC chart
*
* @extends plotOptions.column
* @excluding borderColor, borderRadius, borderWidth, crisp, stacking,
* stack
* @product highstock
* @optionparent plotOptions.hlc
*/
const HLCSeriesDefaults = {
/**
* The approximate pixel width of each group. If for example a series
* with 30 points is displayed over a 600 pixel wide plot area, no
* grouping is performed. If however the series contains so many points
* that the spacing is less than the groupPixelWidth, Highcharts will
* try to group it into appropriate groups so that each is more or less
* two pixels wide. Defaults to `5`.
*
* @type {number}
* @default 5
* @product highstock
* @apioption plotOptions.hlc.dataGrouping.groupPixelWidth
*/
/**
* @type {Highcharts.DataGroupingApproximationValue|Function}
* @default hlc
* @product highstock
* @apioption plotOptions.hlc.dataGrouping.approximation
*/
/**
* @default close
* @apioption plotOptions.hlc.colorKey
*/
/**
* The pixel width of the line/border. Defaults to `1`.
*
* @sample {highstock} stock/plotoptions/hlc-linewidth/
* A greater line width
*
* @type {number}
* @default 1
* @product highstock
*
* @public
*/
lineWidth: 1,
tooltip: {
pointFormat: '<span style="color:{point.color}">\u25CF</span> ' +
'<b> {series.name}</b><br/>' +
'{series.chart.options.lang.stockHigh}: {point.high}<br/>' +
'{series.chart.options.lang.stockLow}: {point.low}<br/>' +
'{series.chart.options.lang.stockClose}: {point.close}<br/>'
},
/**
* @type {number|null}
*/
threshold: null,
states: {
/**
* @extends plotOptions.column.states.hover
* @product highstock
*/
hover: {
/**
* The pixel width of the line representing the HLC point.
*
* @type {number}
* @default 3
* @product highstock
*/
lineWidth: 3
}
},
/**
* Determines which one of `high`, `low`, `close` values should
* be represented as `point.y`, which is later used to set dataLabel
* position and [compare](#plotOptions.series.compare).
*
* @sample {highstock} stock/plotoptions/hlc-pointvalkey/
* Possible values
*
* @declare Highcharts.OptionsHLCPointValKeyValue
* @type {string}
* @default close
* @validvalue ["high", "low", "close"]
* @product highstock
* @apioption plotOptions.hlc.pointValKey
*/
/**
* @default close
* @apioption plotOptions.hlc.colorKey
*/
stickyTracking: true
};
/**
* A `hlc` series. If the [type](#series.hlc.type) option is not
* specified, it is inherited from [chart.type](#chart.type).
*
* @extends series,plotOptions.hlc
* @excluding dataParser, dataURL
* @product highstock
* @apioption series.hlc
*/
/**
* An array of data points for the series. For the `hlc` series type,
* points can be given in the following ways:
*
* 1. An array of arrays with 4 or 3 values. In this case, the values correspond
* to `x,high,low,close`. If the first value is a string, it is applied
* as the name of the point, and the `x` value is inferred. The `x` value can
* also be omitted, in which case the inner arrays should be of length of 3\.
* Then the `x` value is automatically calculated, either starting at 0 and
* incremented by 1, or from `pointStart` and `pointInterval` given in the
* series options.
* ```js
* data: [
* [0, 5, 6, 7],
* [1, 4, 8, 2],
* [2, 3, 4, 10]
* ]
* ```
*
* 2. 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.hlc.turboThreshold), this option is not
* available.
* ```js
* data: [{
* x: 1,
* high: 4,
* low: 5,
* close: 2,
* name: "Point2",
* color: "#00FF00"
* }, {
* x: 1,
* high: 3,
* low: 6,
* close: 7,
* name: "Point1",
* color: "#FF00FF"
* }]
* ```
*
* @type {Array<Array<(number|string),number,number>|Array<(number|string),number,number,number>|*>}
* @extends series.arearange.data
* @excluding y, marker
* @product highstock
* @apioption series.hlc.data
*/
/**
* The closing value of each data point.
*
* @type {number}
* @product highstock
* @apioption series.hlc.data.close
*/
(''); // Keeps doclets above in JS file
/* *
*
* Default Export
*
* */
export default HLCSeriesDefaults;