highcharts 6.1.1 → 6.2.0

package/js/es-modules/parts/BarSeries.js

@@ -1,9 +1,11 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
+
 'use strict';
+
 import H from './Globals.js';
 import './Utilities.js';
 import './ColumnSeries.js';
@@ -11,31 +13,69 @@ import './ColumnSeries.js';
 var seriesType = H.seriesType;
 
 /**
- * The Bar series class
+ * Bar series type.
+ *
+ * @private
+ * @class
+ * @name Highcharts.seriesTypes.bar
+ *
+ * @augments Highcharts.Series
  */
-seriesType('bar', 'column', null, {
+seriesType('bar', 'column',
+
+    /**
+     * A bar series is a special type of column series where the columns are
+     * horizontal.
+     *
+     * @sample highcharts/demo/bar-basic/
+     *         Bar chart
+     *
+     * @extends   plotOptions.column
+     * @product   highcharts
+     * @apioption plotOptions.bar
+     */
+
+    /**
+     * Alignment of the data label relative to the data point.
+     *
+     * @sample {highcharts} highcharts/plotoptions/bar-datalabels-align-inside-bar/
+     *         Data labels inside the bar
+     *
+     * @type      {string}
+     * @default   left
+     * @product   highcharts
+     * @apioption plotOptions.bar.dataLabels.align
+     */
+
+    /**
+     * The x position of the data label relative to the data point.
+     *
+     * @sample {highcharts} highcharts/plotoptions/bar-datalabels-align-inside-bar/
+     *         Data labels inside the bar
+     *
+     * @type      {number}
+     * @default   5
+     * @product   highcharts
+     * @apioption plotOptions.bar.dataLabels.x
+     */
+
+    /**
+     * @ignore
+     */
+    null
+
+, {
     inverted: true
 });
-/**
- * A bar series is a special type of column series where the columns are
- * horizontal.
- *
- * @sample       highcharts/demo/bar-basic/
- *               Bar chart
- * @extends      {plotOptions.column}
- * @product      highcharts
- * @optionparent plotOptions.bar
- */
 
 
 /**
  * A `bar` series. If the [type](#series.bar.type) option is not specified,
  * it is inherited from [chart.type](#chart.type).
  *
- * @type      {Object}
  * @extends   series,plotOptions.bar
- * @excluding connectNulls,dashStyle,dataParser,dataURL,gapSize,gapUnit,linecap,
- *            lineWidth,marker,connectEnds,step
+ * @excluding connectNulls, dashStyle, dataParser, dataURL, gapSize, gapUnit,
+ *            linecap, lineWidth, marker, connectEnds, step
  * @product   highcharts
  * @apioption series.bar
  */
@@ -66,8 +106,8 @@ seriesType('bar', 'column', null, {
  *     ]
  *  ```
  *
- * 3.  An array of objects with named values. The objects are point
- * configuration objects as seen below. If the total number of data
+ * 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.bar.turboThreshold),
  * this option is not available.
  *
@@ -85,18 +125,19 @@ seriesType('bar', 'column', null, {
  *     }]
  *  ```
  *
- * @type      {Array<Object|Array|Number>}
+ * @sample {highcharts} highcharts/chart/reflow-true/
+ *         Numerical values
+ * @sample {highcharts} highcharts/series/data-array-of-arrays/
+ *         Arrays of numeric x and y
+ * @sample {highcharts} highcharts/series/data-array-of-arrays-datetime/
+ *         Arrays of datetime x and y
+ * @sample {highcharts} highcharts/series/data-array-of-name-value/
+ *         Arrays of point.name and y
+ * @sample {highcharts} highcharts/series/data-array-of-objects/
+ *         Config objects
+ *
+ * @type      {Array<number|Array<number|string|Date>|*>}
  * @extends   series.column.data
- * @sample    {highcharts} highcharts/chart/reflow-true/
- *            Numerical values
- * @sample    {highcharts} highcharts/series/data-array-of-arrays/
- *            Arrays of numeric x and y
- * @sample    {highcharts} highcharts/series/data-array-of-arrays-datetime/
- *            Arrays of datetime x and y
- * @sample    {highcharts} highcharts/series/data-array-of-name-value/
- *            Arrays of point.name and y
- * @sample    {highcharts} highcharts/series/data-array-of-objects/
- *            Config objects
  * @product   highcharts
  * @apioption series.bar.data
  */
@@ -112,27 +153,3 @@ seriesType('bar', 'column', null, {
  * @product   highcharts highstock
  * @apioption series.bar.states.select
  */
-
-/**
- * Alignment of the data label relative to the data point.
- *
- * @type      {String}
- * @sample    {highcharts}
- *            highcharts/plotoptions/bar-datalabels-align-inside-bar/
- *            Data labels inside the bar
- * @default   left
- * @product   highcharts
- * @apioption plotOptions.bar.dataLabels.align
- */
-
-/**
- * The x position of the data label relative to the data point.
- *
- * @type      {Number}
- * @sample    {highcharts}
- *            highcharts/plotoptions/bar-datalabels-align-inside-bar/
- *            Data labels inside the bar
- * @default   5
- * @product   highcharts
- * @apioption plotOptions.bar.dataLabels.x
- */

package/js/es-modules/parts/CandlestickSeries.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -18,7 +18,7 @@ var defaultPlotOptions = H.defaultPlotOptions,
  *
  * @sample stock/demo/candlestick/ Candlestick chart
  *
- * @extends {plotOptions.ohlc}
+ * @extends plotOptions.ohlc
  * @excluding borderColor,borderRadius,borderWidth
  * @product highstock
  * @optionparent plotOptions.candlestick
@@ -63,7 +63,7 @@ var candlestickOptions = {
     },
 
     /**
-     * @extends {plotOptions.ohlc.tooltip}
+     * @extends plotOptions.ohlc.tooltip
      */
     tooltip: defaultPlotOptions.ohlc.tooltip,
 
@@ -91,7 +91,8 @@ seriesType('candlestick', 'ohlc', merge(
     drawPoints: function () {
         var series = this,
             points = series.points,
-            chart = series.chart;
+            chart = series.chart,
+            reversedYAxis = series.yAxis.reversed;
 
 
         each(points, function (point) {
@@ -126,9 +127,12 @@ seriesType('candlestick', 'ohlc', merge(
                 topBox = Math.min(plotOpen, plotClose);
                 bottomBox = Math.max(plotOpen, plotClose);
                 halfWidth = Math.round(point.shapeArgs.width / 2);
-                hasTopWhisker =
+                hasTopWhisker = reversedYAxis ?
+                    bottomBox !== point.yBottom :
                     Math.round(topBox) !== Math.round(point.plotHigh);
-                hasBottomWhisker = bottomBox !== point.yBottom;
+                hasBottomWhisker = reversedYAxis ?
+                    Math.round(topBox) !== Math.round(point.plotHigh) :
+                    bottomBox !== point.yBottom;
                 topBox = Math.round(topBox) + crispCorr;
                 bottomBox = Math.round(bottomBox) + crispCorr;
 
@@ -152,13 +156,19 @@ seriesType('candlestick', 'ohlc', merge(
                     crispX, topBox,
                     'L',
                     // #460, #2094
-                    crispX, hasTopWhisker ? Math.round(point.plotHigh) : topBox,
+                    crispX, hasTopWhisker ?
+                        Math.round(
+                            reversedYAxis ? point.yBottom : point.plotHigh
+                        ) :
+                        topBox,
                     'M',
                     crispX, bottomBox,
                     'L',
                     // #460, #2094
                     crispX, hasBottomWhisker ?
-                        Math.round(point.yBottom) :
+                        Math.round(
+                            reversedYAxis ? point.plotHigh : point.yBottom
+                        ) :
                         bottomBox
                 );
 
@@ -205,8 +215,8 @@ seriesType('candlestick', 'ohlc', merge(
  *     ]
  *  ```
  *
- * 2.  An array of objects with named values. The objects are point
- * configuration objects as seen below. If the total number of data
+ * 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.candlestick.turboThreshold), this option is not available.
  *