highcharts 6.1.1 → 6.2.0

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

@@ -1,15 +1,18 @@
 /**
- * (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 './Axis.js';
 import './Chart.js';
 import './Point.js';
 import './Series.js';
+
 var addEvent = H.addEvent,
     animate = H.animate,
     Axis = H.Axis,
@@ -44,21 +47,28 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * same time as the chart is initialized, add the series as a configuration
      * option instead. With multiple axes, the `offset` is dynamically adjusted.
      *
-     * @param  {SeriesOptions} options
-     *         The config options for the series.
-     * @param  {Boolean} [redraw=true]
-     *         Whether to redraw the chart after adding.
-     * @param  {AnimationOptions} animation
-     *         Whether to apply animation, and optionally animation
-     *         configuration.
-     *
-     * @return {Highcharts.Series}
-     *         The newly created series object.
-     *
      * @sample highcharts/members/chart-addseries/
      *         Add a series from a button
      * @sample stock/members/chart-addseries/
      *         Add a series in Highstock
+     *
+     * @function Highcharts.Chart#addSeries
+     *
+     * @param {Highcharts.SeriesOptions} options
+     *        The config options for the series.
+     *
+     * @param {boolean} [redraw=true]
+     *        Whether to redraw the chart after adding.
+     *
+     * @param {boolean|Highcharts.AnimationOptionsObject} [animation]
+     *        Whether to apply animation, and optionally animation
+     *        configuration.
+     *
+     * @return {Highcharts.Series}
+     *         The newly created series object.
+     *
+     * @fires Highcharts.Chart#event:addSeries
+     * @fires Highcharts.Chart#event:afterAddSeries
      */
     addSeries: function (options, redraw, animation) {
         var series,
@@ -90,18 +100,25 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * adds expense to the calculations and rendering. When adding data at the
      * same time as the chart is initialized, add the axis as a configuration
      * option instead.
-     * @param  {AxisOptions} options
-     *         The axis options.
-     * @param  {Boolean} [isX=false]
-     *         Whether it is an X axis or a value axis.
-     * @param  {Boolean} [redraw=true]
-     *         Whether to redraw the chart after adding.
-     * @param  {AnimationOptions} [animation=true]
-     *         Whether and how to apply animation in the redraw.
-     *
-     * @sample highcharts/members/chart-addaxis/ Add and remove axes
-     *
-     * @return {Axis}
+     *
+     * @sample highcharts/members/chart-addaxis/
+     *         Add and remove axes
+     *
+     * @function Highcharts.Chart#addAxis
+     *
+     * @param {Highcharts.XAxisOptions|Highcharts.YAxisOptions|Highcharts.ZAxisOptions} options
+     *        The axis options.
+     *
+     * @param {boolean} [isX=false]
+     *        Whether it is an X axis or a value axis.
+     *
+     * @param {boolean} [redraw=true]
+     *        Whether to redraw the chart after adding.
+     *
+     * @param {boolean|Highcharts.AnimationOptionsObject} [animation=true]
+     *        Whether and how to apply animation in the redraw.
+     *
+     * @return {Highcharts.Axis}
      *         The newly generated Axis object.
      */
     addAxis: function (options, isX, redraw, animation) {
@@ -131,17 +148,19 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * screen are defined in {@link
      * https://api.highcharts.com/highcharts/loading|the loading options}.
      *
-     * @param  {String} str
-     *         An optional text to show in the loading label instead of the
-     *         default one. The default text is set in {@link
-     *         http://api.highcharts.com/highcharts/lang.loading|lang.loading}.
-     *
      * @sample highcharts/members/chart-hideloading/
      *         Show and hide loading from a button
      * @sample highcharts/members/chart-showloading/
      *         Apply different text labels
      * @sample stock/members/chart-show-hide-loading/
      *         Toggle loading in Highstock
+     *
+     * @function Highcharts.Chart#showLoading
+     *
+     * @param {string} str
+     *        An optional text to show in the loading label instead of the
+     *        default one. The default text is set in
+     *        {@link http://api.highcharts.com/highcharts/lang.loading|lang.loading}.
      */
     showLoading: function (str) {
         var chart = this,
@@ -188,13 +207,17 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
     /**
      * Hide the loading layer.
      *
-     * @see    Highcharts.Chart#showLoading
+     * @see Highcharts.Chart#showLoading
+     *
      * @sample highcharts/members/chart-hideloading/
      *         Show and hide loading from a button
      * @sample stock/members/chart-show-hide-loading/
      *         Toggle loading in Highstock
+     *
+     * @function Highcharts.Chart#hideLoading
      */
     hideLoading: function () {
+
         var options = this.options,
             loadingDiv = this.loadingDiv;
 
@@ -203,6 +226,7 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
                 'highcharts-loading highcharts-loading-hidden';
             
         }
+
         this.loadingShown = false;
     },
 
@@ -265,31 +289,40 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * adding and removing items from the collection. Read more under the
      * parameter description below.
      *
-     * See also the {@link https://api.highcharts.com/highcharts/responsive|
-     * responsive option set}. Switching between `responsive.rules` basically
-     * runs `chart.update` under the hood.
-     *
-     * @param  {Options} options
-     *         A configuration object for the new chart options.
-     * @param  {Boolean} [redraw=true]
-     *         Whether to redraw the chart.
-     * @param  {Boolean} [oneToOne=false]
-     *         When `true`, the `series`, `xAxis` and `yAxis` collections will
-     *         be updated one to one, and items will be either added or removed
-     *         to match the new updated options. For example, if the chart has
-     *         two series and we call `chart.update` with a configuration
-     *         containing three series, one will be added. If we call
-     *         `chart.update` with one series, one will be removed. Setting an
-     *         empty `series` array will remove all series, but leaving out the
-     *         `series` property will leave all series untouched. If the series
-     *         have id's, the new series options will be matched by id, and the
-     *         remaining ones removed.
-     * @param  {AnimationOptions} [animation=true]
-     *         Whether to apply animation, and optionally animation
-     *         configuration.
+     * See also the
+     * {@link https://api.highcharts.com/highcharts/responsive|responsive option set}.
+     * Switching between `responsive.rules` basically runs `chart.update` under
+     * the hood.
      *
      * @sample highcharts/members/chart-update/
      *         Update chart geometry
+     *
+     * @function Highcharts.Chart#update
+     *
+     * @param {Highcharts.Options} options
+     *        A configuration object for the new chart options.
+     *
+     * @param {boolean} [redraw=true]
+     *        Whether to redraw the chart.
+     *
+     * @param {boolean} [oneToOne=false]
+     *        When `true`, the `series`, `xAxis` and `yAxis` collections will
+     *        be updated one to one, and items will be either added or removed
+     *        to match the new updated options. For example, if the chart has
+     *        two series and we call `chart.update` with a configuration
+     *        containing three series, one will be added. If we call
+     *        `chart.update` with one series, one will be removed. Setting an
+     *        empty `series` array will remove all series, but leaving out the
+     *        `series` property will leave all series untouched. If the series
+     *        have id's, the new series options will be matched by id, and the
+     *        remaining ones removed.
+     *
+     * @param {boolean|Highcharts.AnimationOptionsObject} [animation=true]
+     *        Whether to apply animation, and optionally animation
+     *        configuration.
+     *
+     * @fires Highcharts.Chart#event:update
+     * @fires Highcharts.Chart#event:afterUpdate
      */
     update: function (options, redraw, oneToOne, animation) {
         var chart = this,
@@ -459,7 +492,9 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
         });
 
         each(itemsForRemoval, function (item) {
-            item.remove(false);
+            if (item.remove) {
+                item.remove(false);
+            }
         });
 
         if (updateAllAxes) {
@@ -499,9 +534,11 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * Shortcut to set the subtitle options. This can also be done from {@link
      * Chart#update} or {@link Chart#setTitle}.
      *
-     * @param  {SubtitleOptions} options
-     *         New subtitle options. The subtitle text itself is set by the
-     *         `options.text` property.
+     * @function Highcharts.Chart#setSubtitle
+     *
+     * @param {Highcharts.SubtitleOptions} options
+     *        New subtitle options. The subtitle text itself is set by the
+     *        `options.text` property.
      */
     setSubtitle: function (options) {
         this.setTitle(undefined, options);
@@ -516,27 +553,33 @@ extend(Point.prototype, /** @lends Highcharts.Point.prototype */ {
      * Update point with new options (typically x/y data) and optionally redraw
      * the series.
      *
-     * @param  {Object} options
-     *         The point options. Point options are handled as described under
-     *         the `series.type.data` item for each series type. For example
-     *         for a line series, if options is a single number, the point will
-     *         be given that number as the main y value. If it is an array, it
-     *         will be interpreted as x and y values respectively. If it is an
-     *         object, advanced options are applied.
-     * @param  {Boolean} [redraw=true]
-     *          Whether to redraw the chart after the point is updated. If doing
-     *          more operations on the chart, it is best practice to set
-     *          `redraw` to false and call `chart.redraw()` after.
-     * @param  {AnimationOptions} [animation=true]
-     *         Whether to apply animation, and optionally animation
-     *         configuration.
-     *
      * @sample highcharts/members/point-update-column/
      *         Update column value
      * @sample highcharts/members/point-update-pie/
      *         Update pie slice
      * @sample maps/members/point-update/
      *         Update map area value in Highmaps
+     *
+     * @function Highcharts.Point#update
+     *
+     * @param {*} options
+     *        The point options. Point options are handled as described under
+     *        the `series.type.data` item for each series type. For example
+     *        for a line series, if options is a single number, the point will
+     *        be given that number as the main y value. If it is an array, it
+     *        will be interpreted as x and y values respectively. If it is an
+     *        object, advanced options are applied.
+     *
+     * @param {boolean} [redraw=true]
+     *        Whether to redraw the chart after the point is updated. If doing
+     *        more operations on the chart, it is best practice to set
+     *        `redraw` to false and call `chart.redraw()` after.
+     *
+     * @param {boolean|Highcharts.AnimationOptionsObject} [animation=true]
+     *        Whether to apply animation, and optionally animation
+     *        configuration.
+     *
+     * @fires Highcharts.Point#event:update
      */
     update: function (options, redraw, animation, runEvent) {
         var point = this,
@@ -614,14 +657,6 @@ extend(Point.prototype, /** @lends Highcharts.Point.prototype */ {
 
     /**
      * Remove a point and optionally redraw the series and if necessary the axes
-     * @param  {Boolean} redraw
-     *         Whether to redraw the chart or wait for an explicit call. When
-     *         doing more operations on the chart, for example running
-     *         `point.remove()` in a loop, it is best practice to set `redraw`
-     *         to false and call `chart.redraw()` after.
-     * @param  {AnimationOptions} [animation=false]
-     *         Whether to apply animation, and optionally animation
-     *         configuration.
      *
      * @sample highcharts/plotoptions/series-point-events-remove/
      *         Remove point and confirm
@@ -629,6 +664,18 @@ extend(Point.prototype, /** @lends Highcharts.Point.prototype */ {
      *         Remove pie slice
      * @sample maps/members/point-remove/
      *         Remove selected points in Highmaps
+     *
+     * @function Highcharts.Point#remove
+     *
+     * @param {boolean} redraw
+     *        Whether to redraw the chart or wait for an explicit call. When
+     *        doing more operations on the chart, for example running
+     *        `point.remove()` in a loop, it is best practice to set `redraw`
+     *        to false and call `chart.redraw()` after.
+     *
+     * @param {boolean|Highcharts.AnimationOptionsObject} [animation=false]
+     *        Whether to apply animation, and optionally animation
+     *        configuration.
      */
     remove: function (redraw, animation) {
         this.series.removePoint(
@@ -646,25 +693,6 @@ extend(Series.prototype, /** @lends Series.prototype */ {
      * the end, or by giving it an X value, to the start or in the middle of the
      * series.
      *
-     * @param  {Number|Array|Object} options
-     *         The point options. If options is a single number, a point with
-     *         that y value is appended to the series.If it is an array, it will
-     *         be interpreted as x and y values respectively. If it is an
-     *         object, advanced options as outlined under `series.data` are
-     *         applied.
-     * @param  {Boolean} [redraw=true]
-     *         Whether to redraw the chart after the point is added. When adding
-     *         more than one point, it is highly recommended that the redraw
-     *         option be set to false, and instead {@link Chart#redraw}
-     *         is explicitly called after the adding of points is finished.
-     *         Otherwise, the chart will redraw after adding each point.
-     * @param  {Boolean} [shift=false]
-     *         If true, a point is shifted off the start of the series as one is
-     *         appended to the end.
-     * @param  {AnimationOptions} [animation]
-     *         Whether to apply animation, and optionally animation
-     *         configuration.
-     *
      * @sample highcharts/members/series-addpoint-append/
      *         Append point
      * @sample highcharts/members/series-addpoint-append-and-shift/
@@ -679,6 +707,30 @@ extend(Series.prototype, /** @lends Series.prototype */ {
      *         Append and shift in Highstock
      * @sample maps/members/series-addpoint/
      *         Add a point in Highmaps
+     *
+     * @function Highcharts.Series#addPoint
+     *
+     * @param {number|Array<number>|*} options
+     *        The point options. If options is a single number, a point with
+     *        that y value is appended to the series. If it is an array, it will
+     *        be interpreted as x and y values respectively. If it is an
+     *        object, advanced options as outlined under `series.data` are
+     *        applied.
+     *
+     * @param {boolean} [redraw=true]
+     *        Whether to redraw the chart after the point is added. When adding
+     *        more than one point, it is highly recommended that the redraw
+     *        option be set to false, and instead {@link Chart#redraw} is
+     *        explicitly called after the adding of points is finished.
+     *        Otherwise, the chart will redraw after adding each point.
+     *
+     * @param {boolean} [shift=false]
+     *        If true, a point is shifted off the start of the series as one is
+     *        appended to the end.
+     *
+     * @param {boolean|Highcharts.AnimationOptionsObject} [animation]
+     *        Whether to apply animation, and optionally animation
+     *        configuration.
      */
     addPoint: function (options, redraw, shift, animation) {
         var series = this,
@@ -760,20 +812,26 @@ extend(Series.prototype, /** @lends Series.prototype */ {
      * that is not instanciated because it is outside the view or subject to
      * Highstock data grouping.
      *
-     * @param  {Number} i
-     *         The index of the point in the {@link Highcharts.Series.data|data}
-     *         array.
-     * @param  {Boolean} [redraw=true]
-     *         Whether to redraw the chart after the point is added. When
-     *         removing more than one point, it is highly recommended that the
-     *         `redraw` option be set to `false`, and instead {@link
-     *         Highcharts.Chart#redraw} is explicitly called after the adding of
-     *         points is finished.
-     * @param  {AnimationOptions} [animation]
-     *         Whether and optionally how the series should be animated.
-     *
      * @sample highcharts/members/series-removepoint/
      *         Remove cropped point
+     *
+     * @function Highcharts.Series#removePoint
+     *
+     * @param {number} i
+     *        The index of the point in the {@link Highcharts.Series.data|data}
+     *        array.
+     *
+     * @param {boolean} [redraw=true]
+     *        Whether to redraw the chart after the point is added. When
+     *        removing more than one point, it is highly recommended that the
+     *        `redraw` option be set to `false`, and instead {@link
+     *        Highcharts.Chart#redraw} is explicitly called after the adding of
+     *        points is finished.
+     *
+     * @param {boolean|Highcharts.AnimationOptionsObject} [animation]
+     *        Whether and optionally how the series should be animated.
+     *
+     * @fires Highcharts.Point#event:remove
      */
     removePoint: function (i, redraw, animation) {
 
@@ -822,17 +880,23 @@ extend(Series.prototype, /** @lends Series.prototype */ {
     /**
      * Remove a series and optionally redraw the chart.
      *
-     * @param  {Boolean} [redraw=true]
-     *         Whether to redraw the chart or wait for an explicit call to
-     *         {@link Highcharts.Chart#redraw}.
-     * @param  {AnimationOptions} [animation]
-     *         Whether to apply animation, and optionally animation
-     *         configuration
-     * @param  {Boolean} [withEvent=true]
-     *         Used internally, whether to fire the series `remove` event.
-     *
      * @sample highcharts/members/series-remove/
      *         Remove first series from a button
+     *
+     * @function Highcharts.Series#remove
+     *
+     * @param {boolean} [redraw=true]
+     *        Whether to redraw the chart or wait for an explicit call to
+     *        {@link Highcharts.Chart#redraw}.
+     *
+     * @param {boolean|Highcharts.AnimationOptionsObject} [animation]
+     *        Whether to apply animation, and optionally animation
+     *        configuration.
+     *
+     * @param {boolean} [withEvent=true]
+     *        Used internally, whether to fire the series `remove` event.
+     *
+     * @fires Highcharts.Series#event:remove
      */
     remove: function (redraw, animation, withEvent) {
         var series = this,
@@ -842,6 +906,7 @@ extend(Series.prototype, /** @lends Series.prototype */ {
 
             // Destroy elements
             series.destroy();
+            series.remove = null; // Prevent from doing again (#9097)
 
             // Redraw
             chart.isDirtyLegend = chart.isDirtyBox = true;
@@ -867,18 +932,22 @@ extend(Series.prototype, /** @lends Series.prototype */ {
      * performance expensive than some other utility methods like {@link
      * Series#setData} or {@link Series#setVisible}.
      *
-     * @param  {SeriesOptions} options
-     *         New options that will be merged with the series' existing
-     *         options.
-     * @param  {Boolean} [redraw=true]
-     *         Whether to redraw the chart after the series is altered. If doing
-     *         more operations on the chart, it is a good idea to set redraw to
-     *         false and call {@link Chart#redraw} after.
-     *
      * @sample highcharts/members/series-update/
      *         Updating series options
      * @sample maps/members/series-update/
      *         Update series options in Highmaps
+     *
+     * @function Highcharts.Series#update
+     *
+     * @param {Highcharts.SeriesOptions} options
+     *        New options that will be merged with the series' existing options.
+     *
+     * @param {boolean} [redraw=true]
+     *        Whether to redraw the chart after the series is altered. If doing
+     *        more operations on the chart, it is a good idea to set redraw to
+     *        false and call {@link Chart#redraw} after.
+     *
+     * @fires Highcharts.Series#event:afterUpdate
      */
     update: function (newOptions, redraw) {
         var series = this,
@@ -993,13 +1062,17 @@ extend(Series.prototype, /** @lends Series.prototype */ {
         fireEvent(this, 'afterUpdate');
 
         if (pick(redraw, true)) {
-            chart.redraw(false);
+            chart.redraw(doSoftUpdate ? undefined : false);
         }
     },
 
     /**
      * Used from within series.update
+     *
      * @private
+     * @function Highcharts.Series#setName
+     *
+     * @param {string} name
      */
     setName: function (name) {
         this.name = this.options.name = this.userOptions.name = name;
@@ -1015,10 +1088,14 @@ extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      * with the existing options, so only new or altered options need to be
      * specified.
      *
-     * @param  {Object} options
-     *         The new options that will be merged in with existing options on
-     *         the axis.
-     * @sample highcharts/members/axis-update/ Axis update demo
+     * @sample highcharts/members/axis-update/
+     *         Axis update demo
+     *
+     * @function Highcharts.Axis#update
+     *
+     * @param {Highcharts.XAxisOptions|Highcharts.YAxisOptions|Highcharts.ZAxisOptions} options
+     *        The new options that will be merged in with existing options on
+     *        the axis.
      */
     update: function (options, redraw) {
         var chart = this.chart,
@@ -1055,10 +1132,13 @@ extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
     /**
      * Remove the axis from the chart.
      *
-     * @param {Boolean} [redraw=true] Whether to redraw the chart following the
-     * remove.
+     * @sample highcharts/members/chart-addaxis/
+     *         Add and remove axes
+     *
+     * @function Highcharts.Axis#remove
      *
-     * @sample highcharts/members/chart-addaxis/ Add and remove axes
+     * @param {boolean} [redraw=true]
+     *        Whether to redraw the chart following the remove.
      */
     remove: function (redraw) {
         var chart = this.chart,
@@ -1097,11 +1177,16 @@ extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
     /**
      * Update the axis title by options after render time.
      *
-     * @param  {TitleOptions} titleOptions
-     *         The additional title options.
-     * @param  {Boolean} [redraw=true]
-     *         Whether to redraw the chart after setting the title.
-     * @sample highcharts/members/axis-settitle/ Set a new Y axis title
+     * @sample highcharts/members/axis-settitle/
+     *         Set a new Y axis title
+     *
+     * @function Highcharts.Axis#setTitle
+     *
+     * @param {Highcharts.XAxisTitleOptions|Highcharts.YAxisTitleOptions|Highcharts.ZAxisTitleOptions} titleOptions
+     *        The additional title options.
+     *
+     * @param {boolean} [redraw=true]
+     *        Whether to redraw the chart after setting the title.
      */
     setTitle: function (titleOptions, redraw) {
         this.update({ title: titleOptions }, redraw);
@@ -1109,10 +1194,17 @@ extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
 
     /**
      * Set new axis categories and optionally redraw.
-     * @param {Array<String>} categories - The new categories.
-     * @param {Boolean} [redraw=true] - Whether to redraw the chart.
-     * @sample highcharts/members/axis-setcategories/ Set categories by click on
-     * a button
+     *
+     * @sample highcharts/members/axis-setcategories/
+     *         Set categories by click on a button
+     *
+     * @function Highcharts.Axis#setCategories
+     *
+     * @param {Array<string>} categories
+     *        The new categories.
+     *
+     * @param {boolean} [redraw=true]
+     *        Whether to redraw the chart.
      */
     setCategories: function (categories, redraw) {
         this.update({ categories: categories }, redraw);

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

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -83,7 +83,7 @@ seriesType('flags', 'column', {
 
     /**
      * The shape of the marker. Can be one of "flag", "circlepin", "squarepin",
-     * or an image on the format `url(/path-to-image.jpg)`. Individual
+     * or an image of the format `url(/path-to-image.jpg)`. Individual
      * shapes can also be set for each point.
      *
      * @validvalue ["flag", "circlepin", "squarepin"]
@@ -160,6 +160,27 @@ seriesType('flags', 'column', {
      * @apioption plotOptions.flags.useHTML
      */
 
+    /**
+     * Fixed width of the flag's shape. By default, width is autocalculated
+     * according to the flag's title.
+     *
+     * @type      {Number}
+     * @default   undefined
+     * @product   highstock
+     * @sample    {highstock} stock/demo/flags-shapes/ Flags with fixed width
+     * @apioption plotOptions.flags.width
+     */
+
+     /**
+     * Fixed height of the flag's shape. By default, height is autocalculated
+     * according to the flag's title.
+     *
+     * @type      {Number}
+     * @default   undefined
+     * @product   highstock
+     * @apioption plotOptions.flags.height
+     */
+
     
 
 }, /** @lends seriesTypes.flags.prototype */ {
@@ -323,7 +344,16 @@ seriesType('flags', 'column', {
                         x: box.pos,
                         anchorX: point.anchorX
                     });
-                    point.graphic.isNew = false;
+                    // Hide flag when its box position is not specified (#8573)
+                    if (!box.pos) {
+                        point.graphic.attr({
+                            x: -9999,
+                            anchorX: -9999
+                        });
+                        point.graphic.isNew = true;
+                    } else {
+                        point.graphic.isNew = false;
+                    }
                 }
             });
         }
@@ -387,9 +417,21 @@ seriesType('flags', 'column', {
         });
     },
 
-    animate: noop, // Disable animation
+    // Disable animation, but keep clipping (#8546):
+    animate: function (init) {
+        if (init) {
+            this.setClip();
+        } else {
+            this.animate = null;
+        }
+    },
+    setClip: function () {
+        Series.prototype.setClip.apply(this, arguments);
+        if (this.options.clip !== false && this.sharedClipKey) {
+            this.markerGroup.clip(this.chart[this.sharedClipKey]);
+        }
+    },
     buildKDTree: noop,
-    setClip: noop,
     /**
      * Don't invert the flag marker group (#4960)
      */
@@ -478,8 +520,8 @@ createPinSymbol('square');
  * An array of data points for the series. For the `flags` series type,
  * points can be given in the following ways:
  *
- * 1.  An array of objects with named values. The objects are point
- * configuration objects as seen below. If the total number of data
+ * 1.  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.flags.turboThreshold),
  * this option is not available.
  *