highcharts
Version:
JavaScript charting framework
1,627 lines (1,516 loc) • 68.4 kB
JavaScript
/**
* (c) 2009-2018 Highsoft AS
* Authors: Øystein Moseng, Torstein Hønsi, Jon A. Nygård
*
* License: www.highcharts.com/license
*/
'use strict';
import H from '../parts/Globals.js';
import '../parts/Utilities.js';
var addEvent = H.addEvent,
each = H.each,
objectEach = H.objectEach,
pick = H.pick,
filter = H.grep,
merge = H.merge,
seriesTypes = H.seriesTypes;
/*
Add drag/drop support to specific data props for different series types.
The dragDrop.draggableX/Y user options on series enable/disable all of these
per direction unless they are specifically set in options using
dragDrop.{optionName}. If the prop does not specify an optionName here, it
can only be enabled/disabled by the user with draggableX/Y.
Supported options for each prop:
optionName: User option in series.dragDrop that enables/disables
dragging this prop.
axis: Can be 'x' or 'y'. Whether this prop is linked to x or y axis.
move: Whether or not this prop should be updated when moving points.
resize: Whether or not to draw a drag handle and allow user to drag and
update this prop by itself.
beforeResize: Hook to perform tasks before a resize is made. Gets
the guide box, the new points values, and the point as args.
resizeSide: Which side of the guide box to resize when dragging the
handle. Can be "left", "right", "top", "bottom". Chart.inverted is
handled automatically. Can also be a function, taking the new point
values as parameter, as well as the point, and returning a string
with the side.
propValidate: Function that takes the prop value and the point as
arguments, and returns true if the prop value is valid, false if
not. It is used to prevent e.g. resizing "low" above "high".
handlePositioner: For resizeable props, return 0,0 in SVG plot coords of
where to place the dragHandle. Gets point as argument. Should return
object with x and y properties.
handleFormatter: For resizeable props, return the path of the drag
handle as an SVG path array. Gets the point as argument. The handle
is translated according to handlePositioner.
handleOptions: Options to merge with the default handle options.
TODO:
- It makes sense to have support for resizing the size of bubbles and
e.g variwide columns. This requires us to support dragging along a
z-axis, somehow computing a relative value from old to new pixel
size.
- Moving maps could be useful, although we would have to compute new
point.path values in order to do it properly (using SVG translate
is easier, but won't update the data).
*/
// 90deg rotated column handle path, used in multiple series types
var horizHandleFormatter = function (point) {
var shapeArgs = point.shapeArgs || point.graphic.getBBox(),
top = shapeArgs.r || 0, // Rounding of bar corners
bottom = shapeArgs.height - top,
centerY = shapeArgs.height / 2;
return [
// Top wick
'M', 0, top,
'L', 0, centerY - 5,
// Circle
'A', 1, 1, 0, 0, 0, 0, centerY + 5,
'A', 1, 1, 0, 0, 0, 0, centerY - 5,
// Bottom wick
'M', 0, centerY + 5,
'L', 0, bottom
];
};
// Line series - only draggableX/Y, no drag handles
var lineDragDropProps = seriesTypes.line.prototype.dragDropProps = {
x: {
axis: 'x',
move: true
},
y: {
axis: 'y',
move: true
}
};
// Flag series - same as line/scatter
if (seriesTypes.flags) {
seriesTypes.flags.prototype.dragDropProps = lineDragDropProps;
}
// Column series - x can be moved, y can only be resized. Note extra
// functionality for handling upside down columns (below threshold).
var columnDragDropProps = seriesTypes.column.prototype.dragDropProps = {
x: {
axis: 'x',
move: true
},
y: {
axis: 'y',
move: false,
resize: true,
// Force guideBox start coordinates
beforeResize: function (guideBox, pointVals, point) {
// We need to ensure that guideBox always starts at threshold.
// We flip whether or not we update the top or bottom of the guide
// box at threshold, but if we drag the mouse fast, the top has not
// reached threshold before we cross over and update the bottom.
var threshold = point.series.translatedThreshold,
y = guideBox.attr('y'),
height,
diff;
if (pointVals.y >= point.series.options.threshold || 0) {
// Above threshold - always set height to hit the threshold
height = guideBox.attr('height');
diff = threshold ? threshold - (y + height) : 0;
guideBox.attr({
height: Math.max(0, Math.round(height + diff))
});
} else {
// Below - always set y to start at threshold
guideBox.attr({
y: Math.round(y + (threshold ? threshold - y : 0))
});
}
},
// Flip the side of the resize handle if column is below threshold
resizeSide: function (pointVals, point) {
return pointVals.y >= (point.series.options.threshold || 0) ?
'top' : 'bottom';
},
// Position handle at bottom if column is below threshold
handlePositioner: function (point) {
var bBox = point.shapeArgs || point.graphic.getBBox();
return {
x: bBox.x,
y: point.y >= (point.series.options.threshold || 0) ?
bBox.y : bBox.y + bBox.height
};
},
// Horizontal handle
handleFormatter: function (point) {
var shapeArgs = point.shapeArgs,
radius = shapeArgs.r || 0, // Rounding of bar corners
centerX = shapeArgs.width / 2;
return [
// Left wick
'M', radius, 0,
'L', centerX - 5, 0,
// Circle
'A', 1, 1, 0, 0, 0, centerX + 5, 0,
'A', 1, 1, 0, 0, 0, centerX - 5, 0,
// Right wick
'M', centerX + 5, 0,
'L', shapeArgs.width - radius, 0
];
}
}
};
// Bullet graph, x/y same as column, but also allow target to be dragged.
if (seriesTypes.bullet) {
seriesTypes.bullet.prototype.dragDropProps = {
x: columnDragDropProps.x,
y: columnDragDropProps.y,
target: {
/**
* Allow target value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.bullet.dragDrop.draggableTarget
*/
optionName: 'draggableTarget',
axis: 'y',
move: true,
resize: true,
resizeSide: 'top',
handlePositioner: function (point) {
var bBox = point.targetGraphic.getBBox();
return {
x: point.barX,
y: bBox.y + bBox.height / 2
};
},
handleFormatter: columnDragDropProps.y.handleFormatter
}
};
}
// Columnrange series - move x, resize or move low/high
if (seriesTypes.columnrange) {
seriesTypes.columnrange.prototype.dragDropProps = {
x: {
axis: 'x',
move: true
},
low: {
/**
* Allow low value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.columnrange.dragDrop.draggableLow
*/
optionName: 'draggableLow',
axis: 'y',
move: true,
resize: true,
resizeSide: 'bottom',
handlePositioner: function (point) {
var bBox = point.shapeArgs || point.graphic.getBBox();
return {
x: bBox.x,
y: bBox.y + bBox.height
};
},
handleFormatter: columnDragDropProps.y.handleFormatter,
propValidate: function (val, point) {
return val <= point.high;
}
},
high: {
/**
* Allow high value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.columnrange.dragDrop.draggableHigh
*/
optionName: 'draggableHigh',
axis: 'y',
move: true,
resize: true,
resizeSide: 'top',
handlePositioner: function (point) {
var bBox = point.shapeArgs || point.graphic.getBBox();
return {
x: bBox.x,
y: bBox.y
};
},
handleFormatter: columnDragDropProps.y.handleFormatter,
propValidate: function (val, point) {
return val >= point.low;
}
}
};
}
// Boxplot series - move x, resize or move low/q1/q3/high
if (seriesTypes.boxplot) {
seriesTypes.boxplot.prototype.dragDropProps = {
x: columnDragDropProps.x,
low: {
/**
* Allow low value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.boxplot.dragDrop.draggableLow
*/
optionName: 'draggableLow',
axis: 'y',
move: true,
resize: true,
resizeSide: 'bottom',
handlePositioner: function (point) {
return {
x: point.shapeArgs.x,
y: point.lowPlot
};
},
handleFormatter: columnDragDropProps.y.handleFormatter,
propValidate: function (val, point) {
return val <= point.q1;
}
},
q1: {
/**
* Allow Q1 value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.boxplot.dragDrop.draggableQ1
*/
optionName: 'draggableQ1',
axis: 'y',
move: true,
resize: true,
resizeSide: 'bottom',
handlePositioner: function (point) {
return {
x: point.shapeArgs.x,
y: point.q1Plot
};
},
handleFormatter: columnDragDropProps.y.handleFormatter,
propValidate: function (val, point) {
return val <= point.median && val >= point.low;
}
},
median: {
// Median can not be dragged individually, just move the whole
// point for this.
axis: 'y',
move: true
},
q3: {
/**
* Allow Q3 value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.boxplot.dragDrop.draggableQ3
*/
optionName: 'draggableQ3',
axis: 'y',
move: true,
resize: true,
resizeSide: 'top',
handlePositioner: function (point) {
return {
x: point.shapeArgs.x,
y: point.q3Plot
};
},
handleFormatter: columnDragDropProps.y.handleFormatter,
propValidate: function (val, point) {
return val <= point.high && val >= point.median;
}
},
/**
* Allow high value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.boxplot.dragDrop.draggableHigh
*/
high: {
optionName: 'draggableHigh',
axis: 'y',
move: true,
resize: true,
resizeSide: 'top',
handlePositioner: function (point) {
return {
x: point.shapeArgs.x,
y: point.highPlot
};
},
handleFormatter: columnDragDropProps.y.handleFormatter,
propValidate: function (val, point) {
return val >= point.q3;
}
}
};
}
// OHLC series - move x, resize or move open/high/low/close
if (seriesTypes.ohlc) {
seriesTypes.ohlc.prototype.dragDropProps = {
x: columnDragDropProps.x,
low: {
/**
* Allow low value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.ohlc.dragDrop.draggableLow
*/
optionName: 'draggableLow',
axis: 'y',
move: true,
resize: true,
resizeSide: 'bottom',
handlePositioner: function (point) {
return {
x: point.shapeArgs.x,
y: point.plotLow
};
},
handleFormatter: columnDragDropProps.y.handleFormatter,
propValidate: function (val, point) {
return val <= point.open && val <= point.close;
}
},
high: {
/**
* Allow high value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.ohlc.dragDrop.draggableHigh
*/
optionName: 'draggableHigh',
axis: 'y',
move: true,
resize: true,
resizeSide: 'top',
handlePositioner: function (point) {
return {
x: point.shapeArgs.x,
y: point.plotHigh
};
},
handleFormatter: columnDragDropProps.y.handleFormatter,
propValidate: function (val, point) {
return val >= point.open && val >= point.close;
}
},
open: {
/**
* Allow open value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.ohlc.dragDrop.draggableOpen
*/
optionName: 'draggableOpen',
axis: 'y',
move: true,
resize: true,
resizeSide: function (point) {
return point.open >= point.close ? 'top' : 'bottom';
},
handlePositioner: function (point) {
return {
x: point.shapeArgs.x,
y: point.plotOpen
};
},
handleFormatter: columnDragDropProps.y.handleFormatter,
propValidate: function (val, point) {
return val <= point.high && val >= point.low;
}
},
close: {
/**
* Allow close value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.ohlc.dragDrop.draggableClose
*/
optionName: 'draggableClose',
axis: 'y',
move: true,
resize: true,
resizeSide: function (point) {
return point.open >= point.close ? 'bottom' : 'top';
},
handlePositioner: function (point) {
return {
x: point.shapeArgs.x,
y: point.plotClose
};
},
handleFormatter: columnDragDropProps.y.handleFormatter,
propValidate: function (val, point) {
return val <= point.high && val >= point.low;
}
}
};
}
// Arearange series - move x, resize or move low/high
if (seriesTypes.arearange) {
var columnrangeDragDropProps = seriesTypes.columnrange
.prototype.dragDropProps,
// Use a circle covering the marker as drag handle
arearangeHandleFormatter = function (point) {
var radius = point.graphic ?
point.graphic.getBBox().width / 2 + 1 :
4;
return [
'M', 0 - radius, 0,
'a', radius, radius, 0, 1, 0, radius * 2, 0,
'a', radius, radius, 0, 1, 0, radius * -2, 0
];
};
seriesTypes.arearange.prototype.dragDropProps = {
x: columnrangeDragDropProps.x,
low: {
/**
* Allow low value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.arearange.dragDrop.draggableLow
*/
optionName: 'draggableLow',
axis: 'y',
move: true,
resize: true,
resizeSide: 'bottom',
handlePositioner: function (point) {
var bBox = point.lowerGraphic && point.lowerGraphic.getBBox();
return bBox ? {
x: bBox.x + bBox.width / 2,
y: bBox.y + bBox.height / 2
} : { x: -999, y: -999 };
},
handleFormatter: arearangeHandleFormatter,
propValidate: columnrangeDragDropProps.low.propValidate
},
high: {
/**
* Allow high value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.arearange.dragDrop.draggableHigh
*/
optionName: 'draggableHigh',
axis: 'y',
move: true,
resize: true,
resizeSide: 'top',
handlePositioner: function (point) {
var bBox = point.upperGraphic && point.upperGraphic.getBBox();
return bBox ? {
x: bBox.x + bBox.width / 2,
y: bBox.y + bBox.height / 2
} : { x: -999, y: -999 };
},
handleFormatter: arearangeHandleFormatter,
propValidate: columnrangeDragDropProps.high.propValidate
}
};
}
// Waterfall - mostly as column, but don't show drag handles for sum points
if (seriesTypes.waterfall) {
seriesTypes.waterfall.prototype.dragDropProps = {
x: columnDragDropProps.x,
y: merge(columnDragDropProps.y, {
handleFormatter: function (point) {
return point.isSum || point.isIntermediateSum ? null :
columnDragDropProps.y.handleFormatter(point);
}
})
};
}
// Xrange - resize/move x/x2, and move y
if (seriesTypes.xrange) {
// Handle positioner logic is the same for x and x2 apart from the
// x value. shapeArgs does not take yAxis reversed etc into account, so we
// use axis.toPixels to handle positioning.
var xrangeHandlePositioner = function (point, xProp) {
var series = point.series,
xAxis = series.xAxis,
yAxis = series.yAxis,
inverted = series.chart.inverted,
// Using toPixels handles axis.reversed, but doesn't take
// chart.inverted into account.
newX = xAxis.toPixels(point[xProp], true),
newY = yAxis.toPixels(point.y, true);
// Handle chart inverted
if (inverted) {
newX = xAxis.len - newX;
newY = yAxis.len - newY -
point.shapeArgs.height / 2;
} else {
newY -= point.shapeArgs.height / 2;
}
return {
x: Math.round(newX),
y: Math.round(newY)
};
},
xrangeDragDropProps = seriesTypes.xrange.prototype.dragDropProps = {
y: {
axis: 'y',
move: true
},
x: {
/**
* Allow x value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.xrange.dragDrop.draggableX1
*/
optionName: 'draggableX1',
axis: 'x',
move: true,
resize: true,
resizeSide: 'left',
handlePositioner: function (point) {
return xrangeHandlePositioner(point, 'x');
},
handleFormatter: horizHandleFormatter,
propValidate: function (val, point) {
return val <= point.x2;
}
},
x2: {
/**
* Allow x2 value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.xrange.dragDrop.draggableX2
*/
optionName: 'draggableX2',
axis: 'x',
move: true,
resize: true,
resizeSide: 'right',
handlePositioner: function (point) {
return xrangeHandlePositioner(point, 'x2');
},
handleFormatter: horizHandleFormatter,
propValidate: function (val, point) {
return val >= point.x;
}
}
};
}
// Gantt - same as xrange, but with aliases
if (seriesTypes.gantt) {
seriesTypes.gantt.prototype.dragDropProps = {
y: xrangeDragDropProps.y,
start: merge(xrangeDragDropProps.x, {
/**
* Allow start value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.gantt.dragDrop.draggableStart
*/
optionName: 'draggableStart',
// Do not allow individual drag handles for milestones
validateIndividualDrag: function (point) {
return !point.milestone;
}
}),
end: merge(xrangeDragDropProps.x2, {
/**
* Allow end value to be dragged individually. Requires
* `draggable-points` module.
*
* @type {boolean}
* @default true
* @apioption plotOptions.gantt.dragDrop.draggableEnd
*/
optionName: 'draggableEnd',
// Do not allow individual drag handles for milestones
validateIndividualDrag: function (point) {
return !point.milestone;
}
})
};
}
// Don't support certain series types
each(
['gauge', 'pie', 'sunburst', 'wordcloud', 'sankey', 'histogram', 'pareto',
'vector', 'windbarb', 'treemap', 'bellcurve', 'sma', 'map', 'mapline'],
function (type) {
if (seriesTypes[type]) {
seriesTypes[type].prototype.dragDropProps = null;
}
}
);
/**
* The draggable-points module allows points to be moved around or modified
* in the chart. In addition to the options mentioned under the `dragDrop`
* API structure, the module fires three events,
* [point.dragStart](series.line.point.events.dragStart),
* [point.drag](series.line.point.events.drag) and
* [point.drop](series.line.point.events.drop).
*
* It requires the `modules/draggable-points.js` file to be loaded.
*
* @type {object}
* @since 6.2.0
*
* @sample highcharts/dragdrop/resize-column Draggable column and line series
*
* @sample highcharts/dragdrop/drag-bubble Draggable bubbles
*
* @sample highcharts/dragdrop/drag-xrang Draggable X range series
*
* @apioption plotOptions.series.dragDrop
*/
/**
* The amount of pixels to drag the pointer before it counts as a drag
* operation. This prevents drag/drop to fire when just clicking or selecting
* points.
*
* @type {number}
* @default 2
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.dragSensitivity
*/
var defaultDragSensitivity = 2;
/**
* Style options for the guide box. The guide box has one state by default,
* the "default" state.
*
* @type {object}
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.guideBox
*/
var defaultGuideBoxOptions = {
/**
* Style options for the guide box default state.
*
* @type {object}
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.guideBox.default
*/
default: {
/**
* CSS class name of the guide box in this state. Defaults to
* `highcharts-drag-box-default`.
*
* @type {String}
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.guideBox.default.className
*/
className: 'highcharts-drag-box-default',
/**
* Width of the line around the guide box.
*
* @type {number}
* @default 1
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.guideBox.default.lineWidth
*/
lineWidth: 1,
/**
* Color of the border around the guide box.
*
* @type {Color}
* @since 6.2.0
* @default #888
* @apioption plotOptions.series.dragDrop.guideBox.default.lineColor
*/
lineColor: '#888',
/**
* Guide box fill color.
*
* @type {Color}
* @since 6.2.0
* @default rgba(0, 0, 0, 0.1)
* @apioption plotOptions.series.dragDrop.guideBox.default.color
*/
color: 'rgba(0, 0, 0, 0.1)',
/**
* Guide box cursor.
*
* @type {string}
* @default move
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.guideBox.default.cursor
*/
cursor: 'move',
/**
* Guide box zIndex.
*
* @type {number}
* @since 6.2.0
* @default 900
* @apioption plotOptions.series.dragDrop.guideBox.default.zIndex
*/
zIndex: 900
}
};
/**
* Options for the drag handles.
*
* @type {Object}
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.dragHandle
*/
var defaultDragHandleOptions = {
/**
* Function to define the SVG path to use for the drag handles. Takes
* the point as argument. Should return an SVG path in array format. The
* SVG path is automatically positioned on the point.
*
* @type {Function}
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.dragHandle.pathFormatter
*/
// pathFormatter: null,
/**
* The mouse cursor to use for the drag handles. By default this is
* intelligently switching between `ew-resize` and `ns-resize` depending
* on the direction the point is being dragged.
*
* @type {String}
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.dragHandle.cursor
*/
// cursor: null,
/**
* The class name of the drag handles. Defaults to `highcharts-drag-handle`.
*
* @type {String}
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.dragHandle.className
*/
className: 'highcharts-drag-handle',
/**
* The fill color of the drag handles.
*
* @type {Color}
* @since 6.2.0
* @default #fff
* @apioption plotOptions.series.dragDrop.dragHandle.color
*/
color: '#fff',
/**
* The line color of the drag handles.
*
* @type {Color}
* @since 6.2.0
* @default rgba(0, 0, 0, 0.6)
* @apioption plotOptions.series.dragDrop.dragHandle.lineColor
*/
lineColor: 'rgba(0, 0, 0, 0.6)',
/**
* The line width for the drag handles.
*
* @type {number}
* @default 2
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.dragHandle.lineWidth
*/
lineWidth: 1,
/**
* The z index for the drag handles.
*
* @type {number}
* @since 6.2.0
* @default 901
* @apioption plotOptions.series.dragDrop.dragHandle.zIndex
*/
zIndex: 901
};
/**
* Set the minimum X value the points can be moved to.
*
* @type {number}
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.dragMinX
*/
/**
* Set the maximum X value the points can be moved to.
*
* @type {number}
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.dragMaxX
*/
/**
* Set the minimum Y value the points can be moved to.
*
* @type {number}
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.dragMinY
*/
/**
* Set the maximum Y value the points can be moved to.
*
* @type {number}
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.dragMaxY
*/
/**
* The X precision value to drag to for this series. Set to 0 to disable. By
* default this is disabled, except for category axes, where the default is 1.
*
* @type {number}
* @default 0
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.dragPrecisionX
*/
/**
* The Y precision value to drag to for this series. Set to 0 to disable. By
* default this is disabled, except for category axes, where the default is 1.
*
* @type {number}
* @default 0
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.dragPrecisionY
*/
/**
* Enable dragging in the X dimension.
*
* @type {boolean}
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.draggableX
*/
/**
* Enable dragging in the Y dimension. Note that this is not supported for
* TreeGrid axes (the default axis type in Gantt charts).
*
* @type {boolean}
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.draggableY
*/
/**
* Group the points by a property. Points with the same property value will be
* grouped together when moving.
*
* @type {String}
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.groupBy
*/
/**
* Update points as they are dragged. If false, a guide box is drawn to
* illustrate the new point size.
*
* @type {boolean}
* @default true
* @since 6.2.0
* @apioption plotOptions.series.dragDrop.liveRedraw
*/
/**
* Set a key to hold when dragging to zoom the chart. Requires the
* draggable-points module. This is useful to avoid zooming while moving points.
* Should be set different than [chart.panKey](#chart.panKey).
*
* @type {String}
* @validvalue ["alt", "ctrl", "meta", "shift"]
* @since 6.2.0
* @apioption chart.zoomKey
*/
/**
* Callback that fires when starting to drag a point. The mouse event object is
* passed in as an argument. See [drag and drop options](series.line.dragDrop).
*
* Requires the draggable-points module.
*
* @type {Function}
* @since 6.2.0
* @apioption plotOptions.series.point.events.dragStart
*/
/**
* Callback that fires while dragging a point. The mouse event is passed in as
* parameter. The original data can be accessed from `e.origin`, and the new
* point values can be accessed from `e.newPoints`. If there is only a single
* point being updated, it can be accessed from `e.newPoint` for simplicity. To
* stop the default drag action, return `false`. See
* [drag and drop options](series.line.dragDrop).
*
* Requires the draggable-points module.
*
* @type {Function}
* @since 6.2.0
* @apioption plotOptions.series.point.events.drag
*/
/**
* Callback that fires when the point is dropped. The mouse event is passed in
* as parameter. The original data can be accessed from `e.origin`, and the new
* point values can be accessed from `e.newPoints`. If there is only a single
* point being updated, it can be accessed from `e.newPoint` for simplicity. To
* stop the default drop action, return `false`. See
* [drag and drop options](series.line.dragDrop).
*
* Requires the draggable-points module.
*
* @type {Function}
* @since 6.2.0
* @apioption plotOptions.series.point.events.drop
*/
/**
* Point specific options for the draggable-points module. Overrides options on
* `series.dragDrop`.
*
* Requires the draggable-points module.
*
* @extends plotOptions.series.dragDrop
* @since 6.2.0
* @apioption series.line.data.dragDrop
*/
/**
* Utility function to test if a series is using drag/drop, looking at its
* options.
*
* @private
* @param {Highcharts.Series} series
* The series to test.
*
* @return {boolean}
* True if the series is using drag/drop.
*/
function isSeriesDraggable(series) {
var props = ['draggableX', 'draggableY'],
i;
// Add optionNames from dragDropProps to the array of props to check for
objectEach(series.dragDropProps, function (val) {
if (val.optionName) {
props.push(val.optionName);
}
});
// Loop over all options we have that could enable dragDrop for this
// series. If any of them are truthy, this series is draggable.
i = props.length;
while (i--) {
if (series.options.dragDrop[props[i]]) {
return true;
}
}
}
/**
* Utility function to test if a chart should have drag/drop enabled, looking
* at its options.
*
* @private
* @param {Highcharts.Chart} chart
* The chart to test.
*
* @return {boolean}
* True if the chart is drag/droppable.
*/
function isChartDraggable(chart) {
var i = chart.series.length;
if (chart.hasCartesianSeries && !chart.polar) {
while (i--) {
if (
chart.series[i].options.dragDrop &&
isSeriesDraggable(chart.series[i])
) {
return true;
}
}
}
}
/**
* Utility function to test if a point is movable (any of its props can be
* dragged by a move, not just individually).
*
* @private
* @param {Highcharts.Point} point
* The point to test.
*
* @return {boolean}
* True if the point is movable.
*/
function isPointMovable(point) {
var series = point.series,
seriesDragDropOptions = series.options.dragDrop,
pointDragDropOptions = point.options && point.options.dragDrop,
updateProps = series.dragDropProps,
hasMovableX,
hasMovableY;
objectEach(updateProps, function (p) {
if (p.axis === 'x' && p.move) {
hasMovableX = true;
} else if (p.axis === 'y' && p.move) {
hasMovableY = true;
}
});
// We can only move the point if draggableX/Y is set, even if all the
// individual prop options are set.
return (
seriesDragDropOptions.draggableX && hasMovableX ||
seriesDragDropOptions.draggableY && hasMovableY
) &&
!(
pointDragDropOptions &&
pointDragDropOptions.draggableX === false &&
pointDragDropOptions.draggableY === false
) &&
series.yAxis &&
series.xAxis;
}
/**
* In mousemove events, check that we have dragged mouse further than the
* dragSensitivity before we call mouseMove handler.
*
* @private
* @param {global.Event} e
* Mouse move event to test.
*
* @param {Highcharts.Chart} chart
* Chart that has started dragging.
*
* @param {number} sensitivity
* Pixel sensitivity to test against.
*
* @return {boolean}
* True if the event is moved past sensitivity relative to the chart's
* drag origin.
*/
function hasDraggedPastSensitivity(e, chart, sensitivity) {
var orig = chart.dragDropData.origin,
oldX = orig.pageX,
oldY = orig.pageY,
newX = e.pageX,
newY = e.pageY,
distance = Math.sqrt(
(newX - oldX) * (newX - oldX) +
(newY - oldY) * (newY - oldY)
);
return distance > sensitivity;
}
/**
* Get a snapshot of points, mouse position, and guide box dimensions
*
* @private
* @param {global.Event} e
* Mouse event with mouse position to snapshot.
*
* @param {Array<Highcharts.Point>} points
* Points to take snapshot of. We store the value of the data properties
* defined in each series' dragDropProps.
*
* @param {Highcharts.SVGElement} [guideBox]
* The guide box to take snapshot of.
*
* @return {object}
* Snapshot object. Point properties are placed in a hashmap with IDs as
* keys.
*/
function getPositionSnapshot(e, points, guideBox) {
var res = {
pageX: e.pageX,
pageY: e.pageY,
guideBox: guideBox && {
x: guideBox.attr('x'),
y: guideBox.attr('y'),
width: guideBox.attr('width'),
height: guideBox.attr('height')
},
points: {}
};
// Loop over the points and add their props
each(points, function (point) {
var pointProps = {};
// Add all of the props defined in the series' dragDropProps to the
// snapshot
objectEach(point.series.dragDropProps, function (val, key) {
pointProps[key] = point[key];
});
pointProps.point = point; // Store reference to point
res.points[point.id] = pointProps;
});
return res;
}
/**
* Get a list of points that are grouped with this point. If only one point is
* in the group, that point is returned by itself in an array.
*
* @private
* @param {Highcharts.Point} point
* Point to find group from.
*
* @return {Array<Highcharts.Point>}
* Array of points in this group.
*/
function getGroupedPoints(point) {
var series = point.series,
groupKey = series.options.dragDrop.groupBy;
return point.options[groupKey] ?
// If we have a grouping option, filter the points by that
filter(series.points, function (comparePoint) {
return comparePoint.options[groupKey] === point.options[groupKey];
}) :
// Otherwise return the point by itself only
[point];
}
/**
* Resize a rect element on one side. The element is modified.
*
* @private
* @param {Highcharts.SVGElement} rect
* Rect element to resize.
*
* @param {string} updateSide
* Which side of the rect to update. Can be `left`, `right`, `top` or
* `bottom`.
*
* @param {object} update
* Object with x and y properties, detailing how much to resize each
* dimension.
*
* @return {Highcharts.SVGElement}
* The modified rect.
*/
function resizeRect(rect, updateSide, update) {
var resizeAttrs;
switch (updateSide) {
case 'left':
resizeAttrs = {
x: rect.attr('x') + update.x,
width: Math.max(1, rect.attr('width') - update.x)
};
break;
case 'right':
resizeAttrs = {
width: Math.max(1, rect.attr('width') + update.x)
};
break;
case 'top':
resizeAttrs = {
y: rect.attr('y') + update.y,
height: Math.max(1, rect.attr('height') - update.y)
};
break;
case 'bottom':
resizeAttrs = {
height: Math.max(1, rect.attr('height') + update.y)
};
break;
default:
}
rect.attr(resizeAttrs);
}
/**
* Flip a side property, used with resizeRect. If input side is "left", return
* "right" etc.
*
* @private
* @param {string} side
* Side prop to flip. Can be `left`, `right`, `top` or `bottom`.
*
* @return {string}
* The flipped side.
*/
function flipResizeSide(side) {
return {
left: 'right',
right: 'left',
top: 'bottom',
bottom: 'top'
}[side];
}
/**
* Prepare chart.dragDropData with origin info, and show the guide box.
*
* @private
* @param {global.Event} e
* Mouse event with original mouse position.
*
* @param {Highcharts.Point} point
* The point the dragging started on.
*/
function initDragDrop(e, point) {
var groupedPoints = getGroupedPoints(point),
series = point.series,
chart = series.chart,
guideBox;
// If liveRedraw is disabled, show the guide box with the default state
if (!pick(
series.options.dragDrop && series.options.dragDrop.liveRedraw,
true
)) {
chart.dragGuideBox = guideBox = series.getGuideBox(groupedPoints);
chart.setGuideBoxState('default', series.options.dragDrop.guideBox)
.add(series.group);
}
// Store some data on the chart to pick up later
chart.dragDropData = {
origin: getPositionSnapshot(e, groupedPoints, guideBox),
point: point,
groupedPoints: groupedPoints
};
// Set drag state
chart.isDragging = true;
}
/**
* Calculate new point options from points being dragged.
*
* @private
* @param {object} dragDropData
* A chart's dragDropData with drag/drop origin information, and info on
* which points are being dragged.
*
* @param {global.Event} newPos
* Event with the new position of the mouse (pageX/Y properties).
*
* @return {Array<object>}
* Hashmap with point.id mapped to an object with the original point
* reference, as well as the new data values.
*/
function getNewPoints(dragDropData, newPos) {
var point = dragDropData.point,
series = point.series,
options = merge(series.options.dragDrop, point.options.dragDrop),
updateProps = {},
resizeProp = dragDropData.updateProp,
hashmap = {};
// Go through the data props that can be updated on this series and find out
// which ones we want to update.
objectEach(point.series.dragDropProps, function (val, key) {
// If we are resizing, skip if this key is not the correct one or it
// is not resizable.
if (
resizeProp && (
resizeProp !== key ||
!val.resize ||
val.optionName && options[val.optionName] === false
)
) {
return;
}
// If we are resizing, we now know it is good. If we are moving, check
// that moving along this axis is enabled, and the prop is movable.
// If this prop is enabled, add it to be updated.
if (
resizeProp || (
val.move &&
(
val.axis === 'x' && options.draggableX ||
val.axis === 'y' && options.draggableY
)
)
) {
updateProps[key] = val;
}
});
// Go through the points to be updated and get new options for each of them
each(
resizeProp ? // If resizing, only update the point we are resizing
[point] :
dragDropData.groupedPoints,
function (p) {
hashmap[p.id] = {
point: p,
newValues: p.getDropValues(dragDropData.origin, newPos, updateProps)
};
});
return hashmap;
}
/**
* Update the points in a chart from dragDropData.newPoints.
*
* @private
* @param {Highcharts.Chart} chart
* A chart with dragDropData.newPoints.
*
* @param {boolean} [animate=true]
* Animate updating points?
*/
function updatePoints(chart, animate) {
var newPoints = chart.dragDropData.newPoints,
animOptions = animate === false ? false : merge({
duration: 400 // 400 is the default in H.animate
}, chart.options.animation);
chart.isDragDropAnimating = true;
// Update the points
objectEach(newPoints, function (newPoint) {
newPoint.point.update(newPoint.newValues, false);
});
chart.redraw(animOptions);
// Clear the isAnimating flag after animation duration is complete.
// The complete handler for animation seems to have bugs at this time, so
// we have to use a timeout instead.
setTimeout(function () {
delete chart.isDragDropAnimating;
if (chart.hoverPoint && !chart.dragHandles) {
chart.hoverPoint.showDragHandles();
}
}, animOptions.duration);
}
/**
* Resize the guide box according to point options and a difference in mouse
* positions. Handles reversed axes.
*
* @private
* @param {Highcharts.Point} point
* The point that is being resized.
*
* @param {number} dX
* Difference in X position.
*
* @param {number} dY
* Difference in Y position.
*/
function resizeGuideBox(point, dX, dY) {
var series = point.series,
chart = series.chart,
dragDropData = chart.dragDropData,
resizeSide,
newPoint,
resizeProp = series.dragDropProps[dragDropData.updateProp];
// dragDropProp.resizeSide holds info on which side to resize.
newPoint = dragDropData.newPoints[point.id].newValues;
resizeSide = typeof resizeProp.resizeSide === 'function' ?
resizeProp.resizeSide(newPoint, point) : resizeProp.resizeSide;
// Call resize hook if it is defined
if (resizeProp.beforeResize) {
resizeProp.beforeResize(chart.dragGuideBox, newPoint, point);
}
// Do the resize
resizeRect(
chart.dragGuideBox,
resizeProp.axis === 'x' && series.xAxis.reversed ||
resizeProp.axis === 'y' && series.yAxis.reversed ?
flipResizeSide(resizeSide) : resizeSide,
{
x: resizeProp.axis === 'x' ?
dX - (dragDropData.origin.prevdX || 0) : 0,
y: resizeProp.axis === 'y' ?
dY - (dragDropData.origin.prevdY || 0) : 0
}
);
}
/**
* Default mouse move handler while dragging. Handles updating points or guide
* box.
*
* @private
* @param {global.Event} e
* The mouse move event.
*
* @param {Highcharts.Point} point
* The point that is dragged.
*/
function dragMove(e, point) {
var series = point.series,
chart = series.chart,
data = chart.dragDropData,
options = merge(series.options.dragDrop, point.options.dragDrop),
draggableX = options.draggableX,
draggableY = options.draggableY,
origin = data.origin,
dX = e.pageX - origin.pageX,
dY = e.pageY - origin.pageY,
oldDx = dX,
updateProp = data.updateProp;
// Handle inverted
if (chart.inverted) {
dX = -dY;
dY = -oldDx;
}
// If we have liveRedraw enabled, update the points immediately. Otherwise
// update the guideBox.
if (pick(options.liveRedraw, true)) {
updatePoints(chart, false);
// Update drag handles
if (chart.dragHandles) {
chart.hideDragHandles();
}
point.showDragHandles();
} else {
// No live redraw, update guide box
if (updateProp) {
// We are resizing, so resize the guide box
resizeGuideBox(point, dX, dY);
} else {
// We are moving, so move the guide box
chart.dragGuideBox.translate(
draggableX ? dX : 0, draggableY ? dY : 0
);
}
}
// Update stored previous dX/Y
origin.prevdX = dX;
origin.prevdY = dY;
}
/**
* Set the state of the guide box.
*
* @private
* @param {string} state
* The state to set the guide box to.
*
* @param {object} options
* Additional overall guideBox options to consider.
*
* @return {Highcharts.SVGElement}
* The modified guide box.
*/
H.Chart.prototype.setGuideBoxState = function (state, options) {
var guideBox = this.dragGuideBox,
guideBoxOptions = merge(defaultGuideBoxOptions, options),
stateOptions = merge(guideBoxOptions.default, guideBoxOptions[state]);
return guideBox.attr({
className: stateOptions.className,
stroke: stateOptions.lineColor,
strokeWidth: stateOptions.lineWidth,
fill: stateOptions.color,
cursor: stateOptions.cursor,
zIndex: stateOptions.zIndex
});
};
/**
* Get updated point values when dragging a point.
*
* @private
* @param {object} origin Mouse position (pageX/Y) and point props at current
* data values. Point props should be organized per point.id in a hashmap.
*
* @param {global.Event} newPos New mouse position (pageX/Y).
*
* @param {object} updateProps Point props to modify. Map of prop objects where
* each key refers to the prop, and the value is an object with an axis
* property. Example:
* {
* x: {
* axis: 'x'
* },
* x2: {
* axis: 'x'
* }
* }
*
* @returns {object}
* An object with updated data values.
*/
H.Point.prototype.getDropValues = function (origin, newPos, updateProps) {
var point = this,
series = point.series,