devextreme
Version:
HTML5 JavaScript Component Suite for Responsive Web Development
617 lines (611 loc) • 24.6 kB
JavaScript
/**
* DevExtreme (esm/viz/series/points/symbol_point.js)
* Version: 21.1.4
* Build date: Mon Jun 21 2021
*
* Copyright (c) 2012 - 2021 Developer Express Inc. ALL RIGHTS RESERVED
* Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
*/
import {
extend
} from "../../../core/utils/extend";
import {
each
} from "../../../core/utils/iterator";
import {
noop
} from "../../../core/utils/common";
import {
getWindow,
hasProperty
} from "../../../core/utils/window";
var window = getWindow();
import {
Label
} from "./label";
var _extend = extend;
import {
isDefined as _isDefined
} from "../../../core/utils/type";
import {
normalizeEnum as _normalizeEnum
} from "../../core/utils";
var _math = Math;
var _round = _math.round;
var _floor = _math.floor;
var _ceil = _math.ceil;
var DEFAULT_IMAGE_WIDTH = 20;
var DEFAULT_IMAGE_HEIGHT = 20;
var LABEL_OFFSET = 10;
var CANVAS_POSITION_DEFAULT = "canvas_position_default";
function getSquareMarkerCoords(radius) {
return [-radius, -radius, radius, -radius, radius, radius, -radius, radius, -radius, -radius]
}
function getPolygonMarkerCoords(radius) {
var r = _ceil(radius);
return [-r, 0, 0, -r, r, 0, 0, r, -r, 0]
}
function getCrossMarkerCoords(radius) {
var r = _ceil(radius);
var floorHalfRadius = _floor(r / 2);
var ceilHalfRadius = _ceil(r / 2);
return [-r, -floorHalfRadius, -floorHalfRadius, -r, 0, -ceilHalfRadius, floorHalfRadius, -r, r, -floorHalfRadius, ceilHalfRadius, 0, r, floorHalfRadius, floorHalfRadius, r, 0, ceilHalfRadius, -floorHalfRadius, r, -r, floorHalfRadius, -ceilHalfRadius, 0]
}
function getTriangleDownMarkerCoords(radius) {
return [-radius, -radius, radius, -radius, 0, radius, -radius, -radius]
}
function getTriangleUpMarkerCoords(radius) {
return [-radius, radius, radius, radius, 0, -radius, -radius, radius]
}
export default {
deleteLabel: function() {
this._label.dispose();
this._label = null
},
_hasGraphic: function() {
return this.graphic
},
clearVisibility: function() {
var graphic = this.graphic;
if (graphic && graphic.attr("visibility")) {
graphic.attr({
visibility: null
})
}
},
isVisible: function() {
return this.inVisibleArea && this.series.isVisible()
},
setInvisibility: function() {
var graphic = this.graphic;
if (graphic && "hidden" !== graphic.attr("visibility")) {
graphic.attr({
visibility: "hidden"
})
}
this._errorBar && this._errorBar.attr({
visibility: "hidden"
});
this._label.draw(false)
},
clearMarker: function() {
var graphic = this.graphic;
graphic && graphic.attr(this._emptySettings)
},
_createLabel: function() {
this._label = new Label({
renderer: this.series._renderer,
labelsGroup: this.series._labelsGroup,
point: this
})
},
_updateLabelData: function() {
this._label.setData(this._getLabelFormatObject())
},
_updateLabelOptions: function() {
!this._label && this._createLabel();
this._label.setOptions(this._options.label)
},
_checkImage: function(image) {
return _isDefined(image) && ("string" === typeof image || _isDefined(image.url))
},
_fillStyle: function() {
this._styles = this._options.styles
},
_checkSymbol: function(oldOptions, newOptions) {
var oldSymbol = oldOptions.symbol;
var newSymbol = newOptions.symbol;
var symbolChanged = "circle" === oldSymbol && "circle" !== newSymbol || "circle" !== oldSymbol && "circle" === newSymbol;
var imageChanged = this._checkImage(oldOptions.image) !== this._checkImage(newOptions.image);
return !!(symbolChanged || imageChanged)
},
_populatePointShape: function(symbol, radius) {
switch (symbol) {
case "square":
return getSquareMarkerCoords(radius);
case "polygon":
return getPolygonMarkerCoords(radius);
case "triangle":
case "triangleDown":
return getTriangleDownMarkerCoords(radius);
case "triangleUp":
return getTriangleUpMarkerCoords(radius);
case "cross":
return getCrossMarkerCoords(radius)
}
},
hasCoords: function() {
return null !== this.x && null !== this.y
},
correctValue: function(correction) {
var axis = this.series.getValueAxis();
if (this.hasValue()) {
this.value = this.properValue = axis.validateUnit(this.initialValue.valueOf() + correction.valueOf());
this.minValue = axis.validateUnit(correction)
}
},
resetCorrection: function() {
this.value = this.properValue = this.initialValue;
this.minValue = CANVAS_POSITION_DEFAULT
},
resetValue: function() {
if (this.hasValue()) {
this.value = this.properValue = this.initialValue = 0;
this.minValue = 0;
this._label.setDataField("value", this.value)
}
},
_getTranslates: function(animationEnabled) {
var translateX = this.x;
var translateY = this.y;
if (animationEnabled) {
if (this._options.rotated) {
translateX = this.defaultX
} else {
translateY = this.defaultY
}
}
return {
x: translateX,
y: translateY
}
},
_createImageMarker: function(renderer, settings, options) {
var width = options.width || DEFAULT_IMAGE_WIDTH;
var height = options.height || DEFAULT_IMAGE_HEIGHT;
return renderer.image(-_round(.5 * width), -_round(.5 * height), width, height, options.url ? options.url.toString() : options.toString(), "center").attr({
translateX: settings.translateX,
translateY: settings.translateY,
visibility: settings.visibility
})
},
_createSymbolMarker: function(renderer, pointSettings) {
var marker;
var symbol = this._options.symbol;
if ("circle" === symbol) {
delete pointSettings.points;
marker = renderer.circle().attr(pointSettings)
} else if ("square" === symbol || "polygon" === symbol || "triangle" === symbol || "triangleDown" === symbol || "triangleUp" === symbol || "cross" === symbol) {
marker = renderer.path([], "area").attr(pointSettings).sharp()
}
return marker
},
_createMarker: function(renderer, group, image, settings) {
var marker = this._checkImage(image) ? this._createImageMarker(renderer, settings, image) : this._createSymbolMarker(renderer, settings);
if (marker) {
marker.data({
"chart-data-point": this
}).append(group)
}
return marker
},
_getSymbolBBox: function(x, y, r) {
return {
x: x - r,
y: y - r,
width: 2 * r,
height: 2 * r
}
},
_getImageBBox: function(x, y) {
var image = this._options.image;
var width = image.width || DEFAULT_IMAGE_WIDTH;
var height = image.height || DEFAULT_IMAGE_HEIGHT;
return {
x: x - _round(width / 2),
y: y - _round(height / 2),
width: width,
height: height
}
},
_getGraphicBBox: function() {
var options = this._options;
var x = this.x;
var y = this.y;
var bBox;
if (options.visible) {
bBox = this._checkImage(options.image) ? this._getImageBBox(x, y) : this._getSymbolBBox(x, y, options.styles.normal.r)
} else {
bBox = {
x: x,
y: y,
width: 0,
height: 0
}
}
return bBox
},
hideInsideLabel: noop,
_getShiftLabelCoords: function(label) {
var coord = this._addLabelAlignmentAndOffset(label, this._getLabelCoords(label));
return this._checkLabelPosition(label, coord)
},
_drawLabel: function() {
var customVisibility = this._getCustomLabelVisibility();
var label = this._label;
var isVisible = this._showForZeroValues() && this.hasValue() && false !== customVisibility && (this.series.getLabelVisibility() || customVisibility);
label.draw(!!isVisible)
},
correctLabelPosition: function(label) {
var coord = this._getShiftLabelCoords(label);
if (!this.hideInsideLabel(label, coord)) {
label.setFigureToDrawConnector(this._getLabelConnector(label.pointPosition));
label.shift(_round(coord.x), _round(coord.y))
}
},
_showForZeroValues: function() {
return true
},
_getLabelConnector: function(pointPosition) {
var bBox = this._getGraphicBBox(pointPosition);
var w2 = bBox.width / 2;
var h2 = bBox.height / 2;
return {
x: bBox.x + w2,
y: bBox.y + h2,
r: this._options.visible ? Math.max(w2, h2) : 0
}
},
_getPositionFromLocation: function() {
return {
x: this.x,
y: this.y
}
},
_isPointInVisibleArea: function(visibleArea, graphicBBox) {
return visibleArea.minX <= graphicBBox.x + graphicBBox.width && visibleArea.maxX >= graphicBBox.x && visibleArea.minY <= graphicBBox.y + graphicBBox.height && visibleArea.maxY >= graphicBBox.y
},
_checkLabelPosition: function(label, coord) {
var visibleArea = this._getVisibleArea();
var labelBBox = label.getBoundingRect();
var graphicBBox = this._getGraphicBBox(label.pointPosition);
var fullGraphicBBox = this._getGraphicBBox();
var isInside = "inside" === label.getLayoutOptions().position;
var offset = LABEL_OFFSET;
if (this._isPointInVisibleArea(visibleArea, fullGraphicBBox)) {
if (!this._options.rotated) {
if (visibleArea.minX > coord.x) {
coord.x = visibleArea.minX
}
if (visibleArea.maxX < coord.x + labelBBox.width) {
coord.x = visibleArea.maxX - labelBBox.width
}
if (visibleArea.minY > coord.y) {
coord.y = isInside ? visibleArea.minY : graphicBBox.y + graphicBBox.height + offset
}
if (visibleArea.maxY < coord.y + labelBBox.height) {
coord.y = isInside ? visibleArea.maxY - labelBBox.height : graphicBBox.y - labelBBox.height - offset
}
} else {
if (visibleArea.minX > coord.x) {
coord.x = isInside ? visibleArea.minX : graphicBBox.x + graphicBBox.width + offset
}
if (visibleArea.maxX < coord.x + labelBBox.width) {
coord.x = isInside ? visibleArea.maxX - labelBBox.width : graphicBBox.x - offset - labelBBox.width
}
if (visibleArea.minY > coord.y) {
coord.y = visibleArea.minY
}
if (visibleArea.maxY < coord.y + labelBBox.height) {
coord.y = visibleArea.maxY - labelBBox.height
}
}
}
return coord
},
_addLabelAlignmentAndOffset: function(label, coord) {
var labelBBox = label.getBoundingRect();
var labelOptions = label.getLayoutOptions();
if (!this._options.rotated) {
if ("left" === labelOptions.alignment) {
coord.x += labelBBox.width / 2
} else if ("right" === labelOptions.alignment) {
coord.x -= labelBBox.width / 2
}
}
coord.x += labelOptions.horizontalOffset;
coord.y += labelOptions.verticalOffset;
return coord
},
_getLabelCoords: function(label) {
return this._getLabelCoordOfPosition(label, this._getLabelPosition(label.pointPosition))
},
_getLabelCoordOfPosition: function(label, position) {
var labelBBox = label.getBoundingRect();
var graphicBBox = this._getGraphicBBox(label.pointPosition);
var offset = LABEL_OFFSET;
var centerY = graphicBBox.height / 2 - labelBBox.height / 2;
var centerX = graphicBBox.width / 2 - labelBBox.width / 2;
var x = graphicBBox.x;
var y = graphicBBox.y;
switch (position) {
case "left":
x -= labelBBox.width + offset;
y += centerY;
break;
case "right":
x += graphicBBox.width + offset;
y += centerY;
break;
case "top":
x += centerX;
y -= labelBBox.height + offset;
break;
case "bottom":
x += centerX;
y += graphicBBox.height + offset;
break;
case "inside":
x += centerX;
y += centerY
}
return {
x: x,
y: y
}
},
_drawMarker: function(renderer, group, animationEnabled) {
var options = this._options;
var translates = this._getTranslates(animationEnabled);
var style = this._getStyle();
this.graphic = this._createMarker(renderer, group, options.image, _extend({
translateX: translates.x,
translateY: translates.y,
points: this._populatePointShape(options.symbol, style.r)
}, style))
},
_getErrorBarSettings: function() {
return {
visibility: "visible"
}
},
_getErrorBarBaseEdgeLength() {
return 2 * this.getPointRadius()
},
_drawErrorBar: function(renderer, group) {
if (!this._options.errorBars) {
return
}
var options = this._options;
var errorBarOptions = options.errorBars;
var points = [];
var settings;
var pos = this._errorBarPos;
var high = this._highErrorCoord;
var low = this._lowErrorCoord;
var displayMode = _normalizeEnum(errorBarOptions.displayMode);
var isHighDisplayMode = "high" === displayMode;
var isLowDisplayMode = "low" === displayMode;
var highErrorOnly = (isHighDisplayMode || !_isDefined(low)) && _isDefined(high) && !isLowDisplayMode;
var lowErrorOnly = (isLowDisplayMode || !_isDefined(high)) && _isDefined(low) && !isHighDisplayMode;
var edgeLength = errorBarOptions.edgeLength;
if (edgeLength <= 1 && edgeLength > 0) {
edgeLength = this._getErrorBarBaseEdgeLength() * errorBarOptions.edgeLength
}
edgeLength = _floor(parseInt(edgeLength) / 2);
highErrorOnly && (low = this._baseErrorBarPos);
lowErrorOnly && (high = this._baseErrorBarPos);
if ("none" !== displayMode && _isDefined(high) && _isDefined(low) && _isDefined(pos)) {
!lowErrorOnly && points.push([pos - edgeLength, high, pos + edgeLength, high]);
points.push([pos, high, pos, low]);
!highErrorOnly && points.push([pos + edgeLength, low, pos - edgeLength, low]);
options.rotated && each(points, (function(_, p) {
p.reverse()
}));
settings = this._getErrorBarSettings(errorBarOptions);
if (!this._errorBar) {
this._errorBar = renderer.path(points, "line").attr(settings).append(group)
} else {
settings.points = points;
this._errorBar.attr(settings)
}
} else {
this._errorBar && this._errorBar.attr({
visibility: "hidden"
})
}
},
getTooltipParams: function() {
var graphic = this.graphic;
return {
x: this.x,
y: this.y,
offset: graphic ? graphic.getBBox().height / 2 : 0
}
},
setPercentValue: function(absTotal, total, leftHoleTotal, rightHoleTotal) {
var valuePercent = this.value / absTotal || 0;
var minValuePercent = this.minValue / absTotal || 0;
var percent = valuePercent - minValuePercent;
this._label.setDataField("percent", percent);
this._label.setDataField("total", total);
if (this.series.isFullStackedSeries() && this.hasValue()) {
if (this.leftHole) {
this.leftHole /= absTotal - leftHoleTotal;
this.minLeftHole /= absTotal - leftHoleTotal
}
if (this.rightHole) {
this.rightHole /= absTotal - rightHoleTotal;
this.minRightHole /= absTotal - rightHoleTotal
}
this.value = this.properValue = valuePercent;
this.minValue = !minValuePercent ? this.minValue : minValuePercent
}
},
_storeTrackerR: function() {
var navigator = window.navigator;
var r = this._options.styles.normal.r;
var minTrackerSize = hasProperty("ontouchstart") || navigator.msPointerEnabled && navigator.msMaxTouchPoints || navigator.pointerEnabled && navigator.maxTouchPoints ? 20 : 6;
this._options.trackerR = r < minTrackerSize ? minTrackerSize : r;
return this._options.trackerR
},
_translateErrorBars: function() {
var options = this._options;
var rotated = options.rotated;
var errorBars = options.errorBars;
var translator = this._getValTranslator();
if (!errorBars) {
return
}
_isDefined(this.lowError) && (this._lowErrorCoord = translator.translate(this.lowError));
_isDefined(this.highError) && (this._highErrorCoord = translator.translate(this.highError));
this._errorBarPos = _floor(rotated ? this.vy : this.vx);
this._baseErrorBarPos = "stdDeviation" === errorBars.type ? this._lowErrorCoord + (this._highErrorCoord - this._lowErrorCoord) / 2 : rotated ? this.vx : this.vy
},
_translate: function() {
var valTranslator = this._getValTranslator();
var argTranslator = this._getArgTranslator();
if (this._options.rotated) {
this.vx = this.x = valTranslator.translate(this.value);
this.vy = this.y = argTranslator.translate(this.argument);
this.minX = valTranslator.translate(this.minValue);
this.defaultX = valTranslator.translate(CANVAS_POSITION_DEFAULT)
} else {
this.vy = this.y = valTranslator.translate(this.value);
this.vx = this.x = argTranslator.translate(this.argument);
this.minY = valTranslator.translate(this.minValue);
this.defaultY = valTranslator.translate(CANVAS_POSITION_DEFAULT)
}
this._translateErrorBars();
this._calculateVisibility(this.x, this.y)
},
_updateData: function(data) {
this.value = this.properValue = this.initialValue = this.originalValue = data.value;
this.minValue = this.initialMinValue = this.originalMinValue = _isDefined(data.minValue) ? data.minValue : CANVAS_POSITION_DEFAULT
},
_getImageSettings: function(image) {
return {
href: image.url || image.toString(),
width: image.width || DEFAULT_IMAGE_WIDTH,
height: image.height || DEFAULT_IMAGE_HEIGHT
}
},
getCrosshairData: function() {
var r = this._options.rotated;
var value = this.properValue;
var argument = this.argument;
return {
x: this.vx,
y: this.vy,
xValue: r ? value : argument,
yValue: r ? argument : value,
axis: this.series.axis
}
},
getPointRadius: function() {
var style = this._getStyle();
var options = this._options;
var r = style.r;
var extraSpace;
var symbol = options.symbol;
var isSquare = "square" === symbol;
var isTriangle = "triangle" === symbol || "triangleDown" === symbol || "triangleUp" === symbol;
if (options.visible && !options.image && r) {
extraSpace = style["stroke-width"] / 2;
return (isSquare || isTriangle ? 1.4 * r : r) + extraSpace
}
return 0
},
_updateMarker: function(animationEnabled, style) {
var options = this._options;
var settings;
var image = options.image;
var visibility = !this.isVisible() ? {
visibility: "hidden"
} : {};
if (this._checkImage(image)) {
settings = _extend({}, {
visibility: style.visibility
}, visibility, this._getImageSettings(image))
} else {
settings = _extend({}, style, visibility, {
points: this._populatePointShape(options.symbol, style.r)
})
}
if (!animationEnabled) {
settings.translateX = this.x;
settings.translateY = this.y
}
this.graphic.attr(settings).sharp()
},
_getLabelFormatObject: function() {
return {
argument: this.initialArgument,
value: this.initialValue,
originalArgument: this.originalArgument,
originalValue: this.originalValue,
seriesName: this.series.name,
lowErrorValue: this.lowError,
highErrorValue: this.highError,
point: this
}
},
_getLabelPosition: function() {
var rotated = this._options.rotated;
if (this.initialValue > 0) {
return rotated ? "right" : "top"
} else {
return rotated ? "left" : "bottom"
}
},
_getFormatObject: function(tooltip) {
var labelFormatObject = this._label.getData();
return _extend({}, labelFormatObject, {
argumentText: tooltip.formatValue(this.initialArgument, "argument"),
valueText: tooltip.formatValue(this.initialValue)
}, _isDefined(labelFormatObject.percent) ? {
percentText: tooltip.formatValue(labelFormatObject.percent, "percent")
} : {}, _isDefined(labelFormatObject.total) ? {
totalText: tooltip.formatValue(labelFormatObject.total)
} : {})
},
getMarkerVisibility: function() {
return this._options.visible
},
coordsIn: function(x, y) {
var trackerRadius = this._storeTrackerR();
return x >= this.x - trackerRadius && x <= this.x + trackerRadius && y >= this.y - trackerRadius && y <= this.y + trackerRadius
},
getMinValue: function(noErrorBar) {
var errorBarOptions = this._options.errorBars;
if (errorBarOptions && !noErrorBar) {
var displayMode = errorBarOptions.displayMode;
var lowValue = "high" !== displayMode && _isDefined(this.lowError) ? this.lowError : this.value;
var highValue = "low" !== displayMode && _isDefined(this.highError) ? this.highError : this.value;
return lowValue < highValue ? lowValue : highValue
} else {
return this.value
}
},
getMaxValue: function(noErrorBar) {
var errorBarOptions = this._options.errorBars;
if (errorBarOptions && !noErrorBar) {
var displayMode = errorBarOptions.displayMode;
var lowValue = "high" !== displayMode && _isDefined(this.lowError) ? this.lowError : this.value;
var highValue = "low" !== displayMode && _isDefined(this.highError) ? this.highError : this.value;
return lowValue > highValue ? lowValue : highValue
} else {
return this.value
}
}
};