fireInternet/res/highcharts/code/es-modules/parts/OHLCSeries.js

/* *
 * (c) 2010-2019 Torstein Honsi
 *
 * License: www.highcharts.com/license
 */

'use strict';

import H from './Globals.js';
import './Utilities.js';
import './Point.js';

var Point = H.Point,
    seriesType = H.seriesType,
    seriesTypes = H.seriesTypes;

/**
 * The ohlc series type.
 *
 * @private
 * @class
 * @name Highcharts.seriesTypes.ohlc
 *
 * @augments Highcharts.Series
 */
seriesType(
    'ohlc',
    'column'

    /**
     * An OHLC chart is a style of financial chart used to describe price
     * movements over time. It displays open, high, low and close values per
     * data point.
     *
     * @sample stock/demo/ohlc/
     *         OHLC chart
     *
     * @extends      plotOptions.column
     * @excluding    borderColor, borderRadius, borderWidth, crisp, stacking,
     *               stack
     * @product      highstock
     * @optionparent plotOptions.ohlc
     */
    , {

        /**
         * 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.ohlc.dataGrouping.groupPixelWidth
         */

        /**
         * The pixel width of the line/border. Defaults to `1`.
         *
         * @sample {highstock} stock/plotoptions/ohlc-linewidth/
         *         A greater line width
         *
         * @type    {number}
         * @default 1
         * @product highstock
         */
        lineWidth: 1,

        tooltip: {
            pointFormat: '<span style="color:{point.color}">\u25CF</span> ' +
            '<b> {series.name}</b><br/>' +
            'Open: {point.open}<br/>' +
            'High: {point.high}<br/>' +
            'Low: {point.low}<br/>' +
            'Close: {point.close}<br/>'
        },

        threshold: null,

        states: {

            /**
             * @extends plotOptions.column.states.hover
             * @product highstock
             */
            hover: {

                /**
                 * The pixel width of the line representing the OHLC point.
                 *
                 * @type    {number}
                 * @default 3
                 * @product highstock
                 */
                lineWidth: 3
            }
        },

        /**
         * Determines which one of `open`, `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/ohlc-pointvalkey/
         *         Possible values
         *
         * @type       {string}
         * @default    close
         * @validvalue ["open", "high", "low", "close"]
         * @product    highstock
         * @apioption  plotOptions.ohlc.pointValKey
         */

        /**
         * Line color for up points.
         *
         * @type      {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
         * @product   highstock
         * @apioption plotOptions.ohlc.upColor
         */

        stickyTracking: true

    }, /** @lends Highcharts.seriesTypes.ohlc */ {
        directTouch: false,
        pointArrayMap: ['open', 'high', 'low', 'close'],
        toYData: function (point) {
            // return a plain array for speedy calculation
            return [point.open, point.high, point.low, point.close];
        },
        pointValKey: 'close',

        pointAttrToOptions: {
            'stroke': 'color',
            'stroke-width': 'lineWidth'
        },

        /**
         * @private
         * @function Highcarts.seriesTypes.ohlc#init
         */
        init: function () {
            seriesTypes.column.prototype.init.apply(this, arguments);

            this.options.stacking = false; // #8817
        },

        /**
         * Postprocess mapping between options and SVG attributes
         *
         * @private
         * @function Highcharts.seriesTypes.ohlc#pointAttribs
         *
         * @param {Highcharts.Point} point
         *
         * @param {string} state
         *
         * @return {Highcharts.Dictionary<*>}
         */
        pointAttribs: function (point, state) {
            var attribs = seriesTypes.column.prototype.pointAttribs.call(
                    this,
                    point,
                    state
                ),
                options = this.options;

            delete attribs.fill;

            if (
                !point.options.color &&
            options.upColor &&
            point.open < point.close
            ) {
                attribs.stroke = options.upColor;
            }

            return attribs;
        },

        /**
         * Translate data points from raw values x and y to plotX and plotY
         *
         * @private
         * @function Highcharts.seriesTypes.ohlc#translate
         */
        translate: function () {
            var series = this,
                yAxis = series.yAxis,
                hasModifyValue = !!series.modifyValue,
                translated = [
                    'plotOpen',
                    'plotHigh',
                    'plotLow',
                    'plotClose',
                    'yBottom'
                ]; // translate OHLC for

            seriesTypes.column.prototype.translate.apply(series);

            // Do the translation
            series.points.forEach(function (point) {
                [point.open, point.high, point.low, point.close, point.low]
                    .forEach(
                        function (value, i) {
                            if (value !== null) {
                                if (hasModifyValue) {
                                    value = series.modifyValue(value);
                                }
                                point[translated[i]] =
                                    yAxis.toPixels(value, true);
                            }
                        }
                    );

                // Align the tooltip to the high value to avoid covering the
                // point
                point.tooltipPos[1] =
                point.plotHigh + yAxis.pos - series.chart.plotTop;
            });
        },

        /**
         * Draw the data points
         *
         * @private
         * @function Highcharts.seriesTypes.ohlc#drawPoints
         */
        drawPoints: function () {
            var series = this,
                points = series.points,
                chart = series.chart;


            points.forEach(function (point) {
                var plotOpen,
                    plotClose,
                    crispCorr,
                    halfWidth,
                    path,
                    graphic = point.graphic,
                    crispX,
                    isNew = !graphic;

                if (point.plotY !== undefined) {

                    // Create and/or update the graphic
                    if (!graphic) {
                        point.graphic = graphic = chart.renderer.path()
                            .add(series.group);
                    }

                    if (!chart.styledMode) {
                        graphic.attr(
                            series.pointAttribs(
                                point, point.selected && 'select'
                            )
                        ); // #3897
                    }

                    // crisp vector coordinates
                    crispCorr = (graphic.strokeWidth() % 2) / 2;
                    crispX = Math.round(point.plotX) - crispCorr; // #2596
                    halfWidth = Math.round(point.shapeArgs.width / 2);

                    // the vertical stem
                    path = [
                        'M',
                        crispX, Math.round(point.yBottom),
                        'L',
                        crispX, Math.round(point.plotHigh)
                    ];

                    // open
                    if (point.open !== null) {
                        plotOpen = Math.round(point.plotOpen) + crispCorr;
                        path.push(
                            'M',
                            crispX,
                            plotOpen,
                            'L',
                            crispX - halfWidth,
                            plotOpen
                        );
                    }

                    // close
                    if (point.close !== null) {
                        plotClose = Math.round(point.plotClose) + crispCorr;
                        path.push(
                            'M',
                            crispX,
                            plotClose,
                            'L',
                            crispX + halfWidth,
                            plotClose
                        );
                    }

                    graphic[isNew ? 'attr' : 'animate']({ d: path })
                        .addClass(point.getClassName(), true);

                }


            });

        },

        animate: null // Disable animation

    },
    /** @lends Highcharts.seriesTypes.ohlc.prototype.pointClass.prototype */
    {

        /**
         * Extend the parent method by adding up or down to the class name.
         *
         * @private
         * @function Highcharts.seriesTypes.ohlc#getClassName
         */
        getClassName: function () {
            return Point.prototype.getClassName.call(this) +
            (
                this.open < this.close ?
                    ' highcharts-point-up' :
                    ' highcharts-point-down'
            );
        }

    }
);

/**
 * A `ohlc` series. If the [type](#series.ohlc.type) option is not
 * specified, it is inherited from [chart.type](#chart.type).
 *
 * @extends   series,plotOptions.ohlc
 * @excluding dataParser, dataURL
 * @product   highstock
 * @apioption series.ohlc
 */

/**
 * An array of data points for the series. For the `ohlc` series type,
 * points can be given in the following ways:
 *
 * 1. An array of arrays with 5 or 4 values. In this case, the values correspond
 *    to `x,open,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 4\.
 *    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, 6, 5, 6, 7],
 *        [1, 9, 4, 8, 2],
 *        [2, 6, 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.ohlc.turboThreshold), this option is not
 *    available.
 *    ```js
 *    data: [{
 *        x: 1,
 *        open: 3,
 *        high: 4,
 *        low: 5,
 *        close: 2,
 *        name: "Point2",
 *        color: "#00FF00"
 *    }, {
 *        x: 1,
 *        open: 4,
 *        high: 3,
 *        low: 6,
 *        close: 7,
 *        name: "Point1",
 *        color: "#FF00FF"
 *    }]
 *    ```
 *
 * @type      {Array<Array<(number|string),number,number,number>|Array<(number|string),number,number,number,number>|*>}
 * @extends   series.arearange.data
 * @excluding y, marker
 * @product   highstock
 * @apioption series.ohlc.data
 */

/**
 * The closing value of each data point.
 *
 * @type      {number}
 * @product   highstock
 * @apioption series.ohlc.data.close
 */

/**
 * The opening value of each data point.
 *
 * @type      {number}
 * @product   highstock
 * @apioption series.ohlc.data.open
 */