advanced_chart.js 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541
  1. /**
  2. * DevExtreme (viz/chart_components/advanced_chart.js)
  3. * Version: 19.1.16
  4. * Build date: Tue Oct 18 2022
  5. *
  6. * Copyright (c) 2012 - 2022 Developer Express Inc. ALL RIGHTS RESERVED
  7. * Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
  8. */
  9. "use strict";
  10. var extend = require("../../core/utils/extend").extend;
  11. var inArray = require("../../core/utils/array").inArray;
  12. var iteratorModule = require("../../core/utils/iterator");
  13. var rangeModule = require("../translators/range");
  14. var DEFAULT_AXIS_NAME = "defaultAxisName";
  15. var axisModule = require("../axes/base_axis");
  16. var seriesFamilyModule = require("../core/series_family");
  17. var BaseChart = require("./base_chart").BaseChart;
  18. var crosshairModule = require("./crosshair");
  19. var _isArray = Array.isArray;
  20. var _isDefined = require("../../core/utils/type").isDefined;
  21. var _each = iteratorModule.each;
  22. var _reverseEach = iteratorModule.reverseEach;
  23. var _noop = require("../../core/utils/common").noop;
  24. var _extend = extend;
  25. var vizUtils = require("../core/utils");
  26. var _map = vizUtils.map;
  27. var mergeMarginOptions = vizUtils.mergeMarginOptions;
  28. var FONT = "font";
  29. var COMMON_AXIS_SETTINGS = "commonAxisSettings";
  30. function prepareAxis(axisOptions) {
  31. return _isArray(axisOptions) ? 0 === axisOptions.length ? [{}] : axisOptions : [axisOptions]
  32. }
  33. function processBubbleMargin(opt, bubbleSize) {
  34. if (opt.processBubbleSize) {
  35. opt.size = bubbleSize
  36. }
  37. return opt
  38. }
  39. function estimateBubbleSize(size, panesCount, maxSize, rotated) {
  40. var width = rotated ? size.width / panesCount : size.width;
  41. var height = rotated ? size.height : size.height / panesCount;
  42. return Math.min(width, height) * maxSize
  43. }
  44. var AdvancedChart = BaseChart.inherit({
  45. _setDeprecatedOptions: function() {
  46. this.callBase.apply(this, arguments);
  47. _extend(this._deprecatedOptions, {
  48. barWidth: {
  49. since: "18.1",
  50. message: "Use the 'commonSeriesSettings.barPadding' or 'series.barPadding' option instead"
  51. },
  52. equalBarWidth: {
  53. since: "18.1",
  54. message: "Use the 'commonSeriesSettings.ignoreEmptyPoints' or 'series.ignoreEmptyPoints' option instead"
  55. }
  56. })
  57. },
  58. _fontFields: [COMMON_AXIS_SETTINGS + ".label." + FONT, COMMON_AXIS_SETTINGS + ".title." + FONT],
  59. _dispose: function() {
  60. var that = this;
  61. var disposeObjectsInArray = this._disposeObjectsInArray;
  62. that.callBase();
  63. that.panes = null;
  64. if (that._legend) {
  65. that._legend.dispose();
  66. that._legend = null
  67. }
  68. disposeObjectsInArray.call(that, "panesBackground");
  69. disposeObjectsInArray.call(that, "seriesFamilies");
  70. that._disposeAxes()
  71. },
  72. _reinitAxes: function() {
  73. this.panes = this._createPanes();
  74. this._populateAxes();
  75. this._axesReinitialized = true
  76. },
  77. _getCrosshairMargins: function() {
  78. var crosshairOptions = this._getCrosshairOptions() || {};
  79. var crosshairEnabled = crosshairOptions.enabled;
  80. var margins = crosshairModule.getMargins();
  81. return {
  82. x: crosshairEnabled && crosshairOptions.horizontalLine.visible ? margins.x : 0,
  83. y: crosshairEnabled && crosshairOptions.verticalLine.visible ? margins.y : 0
  84. }
  85. },
  86. _populateAxes: function() {
  87. var that = this;
  88. var panes = that.panes;
  89. var rotated = that._isRotated();
  90. var argumentAxesOptions = prepareAxis(that.option("argumentAxis") || {})[0];
  91. var valueAxisOption = that.option("valueAxis");
  92. var valueAxesOptions = prepareAxis(valueAxisOption || {});
  93. var argumentAxesPopulatedOptions = [];
  94. var valueAxesPopulatedOptions = [];
  95. var axisNames = [];
  96. var valueAxesCounter = 0;
  97. var paneWithNonVirtualAxis;
  98. var crosshairMargins = that._getCrosshairMargins();
  99. function getNextAxisName() {
  100. return DEFAULT_AXIS_NAME + valueAxesCounter++
  101. }
  102. if (rotated) {
  103. paneWithNonVirtualAxis = "right" === argumentAxesOptions.position ? panes[panes.length - 1].name : panes[0].name
  104. } else {
  105. paneWithNonVirtualAxis = "top" === argumentAxesOptions.position ? panes[0].name : panes[panes.length - 1].name
  106. }
  107. argumentAxesPopulatedOptions = _map(panes, function(pane) {
  108. var virtual = pane.name !== paneWithNonVirtualAxis;
  109. return that._populateAxesOptions("argumentAxis", argumentAxesOptions, {
  110. pane: pane.name,
  111. name: null,
  112. optionPath: "argumentAxis",
  113. crosshairMargin: rotated ? crosshairMargins.x : crosshairMargins.y
  114. }, rotated, virtual)
  115. });
  116. _each(valueAxesOptions, function(priority, axisOptions) {
  117. var axisPanes = [];
  118. var name = axisOptions.name;
  119. if (name && inArray(name, axisNames) !== -1) {
  120. that._incidentOccurred("E2102");
  121. return
  122. }
  123. name && axisNames.push(name);
  124. if (axisOptions.pane) {
  125. axisPanes.push(axisOptions.pane)
  126. }
  127. if (axisOptions.panes && axisOptions.panes.length) {
  128. axisPanes = axisPanes.concat(axisOptions.panes.slice(0))
  129. }
  130. axisPanes = vizUtils.unique(axisPanes);
  131. if (!axisPanes.length) {
  132. axisPanes.push(void 0)
  133. }
  134. _each(axisPanes, function(_, pane) {
  135. var optionPath = _isArray(valueAxisOption) ? "valueAxis[".concat(priority, "]") : "valueAxis";
  136. valueAxesPopulatedOptions.push(that._populateAxesOptions("valueAxis", axisOptions, {
  137. name: name || getNextAxisName(),
  138. pane: pane,
  139. priority: priority,
  140. optionPath: optionPath,
  141. crosshairMargin: rotated ? crosshairMargins.y : crosshairMargins.x
  142. }, rotated))
  143. })
  144. });
  145. that._redesignAxes(argumentAxesPopulatedOptions, true, paneWithNonVirtualAxis);
  146. that._redesignAxes(valueAxesPopulatedOptions, false)
  147. },
  148. _redesignAxes: function(options, isArgumentAxes, paneWithNonVirtualAxis) {
  149. var that = this;
  150. var axesBasis = [];
  151. var axes = isArgumentAxes ? that._argumentAxes : that._valueAxes;
  152. _each(options, function(_, opt) {
  153. var curAxes = axes && axes.filter(function(a) {
  154. return a.name === opt.name && (!_isDefined(opt.pane) && that.panes.some(function(p) {
  155. return p.name === a.pane
  156. }) || a.pane === opt.pane)
  157. });
  158. if (curAxes && curAxes.length > 0) {
  159. _each(curAxes, function(_, axis) {
  160. axis.updateOptions(opt);
  161. axis.validate();
  162. axesBasis.push({
  163. axis: axis
  164. })
  165. })
  166. } else {
  167. axesBasis.push({
  168. options: opt
  169. })
  170. }
  171. });
  172. if (axes) {
  173. _reverseEach(axes, function(index, axis) {
  174. if (!axesBasis.some(function(basis) {
  175. return basis.axis && basis.axis === axis
  176. })) {
  177. that._disposeAxis(index, isArgumentAxes)
  178. }
  179. })
  180. } else {
  181. if (isArgumentAxes) {
  182. axes = that._argumentAxes = []
  183. } else {
  184. axes = that._valueAxes = []
  185. }
  186. }
  187. _each(axesBasis, function(index, basis) {
  188. var axis = basis.axis;
  189. if (basis.axis && isArgumentAxes) {
  190. basis.axis.isVirtual = basis.axis.pane !== paneWithNonVirtualAxis
  191. } else {
  192. if (basis.options) {
  193. axis = that._createAxis(isArgumentAxes, basis.options, isArgumentAxes ? basis.options.pane !== paneWithNonVirtualAxis : void 0, isArgumentAxes ? index : void 0);
  194. axes.push(axis)
  195. }
  196. }
  197. axis.applyVisualRangeSetter(that._getVisualRangeSetter())
  198. })
  199. },
  200. _disposeAxis: function(index, isArgumentAxis) {
  201. var axes = isArgumentAxis ? this._argumentAxes : this._valueAxes;
  202. var axis = axes[index];
  203. if (!axis) {
  204. return
  205. }
  206. axis.dispose();
  207. axes.splice(index, 1)
  208. },
  209. _prepareStackPoints: function(singleSeries, stackPoints) {
  210. var points = singleSeries.getPoints();
  211. var stackName = singleSeries.getStackName();
  212. _each(points, function(_, point) {
  213. var argument = point.argument;
  214. if (!stackPoints[argument]) {
  215. stackPoints[argument] = {};
  216. stackPoints[argument][null] = []
  217. }
  218. if (stackName && !_isArray(stackPoints[argument][stackName])) {
  219. stackPoints[argument][stackName] = [];
  220. _each(stackPoints[argument][null], function(_, point) {
  221. if (!point.stackName) {
  222. stackPoints[argument][stackName].push(point)
  223. }
  224. })
  225. }
  226. if (stackName) {
  227. stackPoints[argument][stackName].push(point);
  228. stackPoints[argument][null].push(point)
  229. } else {
  230. _each(stackPoints[argument], function(_, stack) {
  231. stack.push(point)
  232. })
  233. }
  234. point.stackPoints = stackPoints[argument][stackName];
  235. point.stackName = stackName
  236. })
  237. },
  238. _resetStackPoints: function(singleSeries) {
  239. _each(singleSeries.getPoints(), function(_, point) {
  240. point.stackPoints = null;
  241. point.stackName = null
  242. })
  243. },
  244. _disposeAxes: function() {
  245. var that = this;
  246. var disposeObjectsInArray = that._disposeObjectsInArray;
  247. disposeObjectsInArray.call(that, "_argumentAxes");
  248. disposeObjectsInArray.call(that, "_valueAxes")
  249. },
  250. _appendAdditionalSeriesGroups: function() {
  251. this._crosshairCursorGroup.linkAppend();
  252. this._scrollBar && this._scrollBarGroup.linkAppend()
  253. },
  254. _getLegendTargets: function() {
  255. var _this = this;
  256. return (this.series || []).map(function(s) {
  257. var item = _this._getLegendOptions(s);
  258. item.legendData.series = s;
  259. if (!s.getOptions().showInLegend) {
  260. item.legendData.visible = false
  261. }
  262. return item
  263. })
  264. },
  265. _legendItemTextField: "name",
  266. _seriesPopulatedHandlerCore: function() {
  267. this._processSeriesFamilies();
  268. this._processValueAxisFormat()
  269. },
  270. _renderTrackers: function() {
  271. var that = this;
  272. var i;
  273. for (i = 0; i < that.series.length; ++i) {
  274. that.series[i].drawTrackers()
  275. }
  276. },
  277. _specialProcessSeries: function() {
  278. this._processSeriesFamilies()
  279. },
  280. _processSeriesFamilies: function() {
  281. var that = this;
  282. var types = [];
  283. var families = [];
  284. var paneSeries;
  285. var themeManager = that._themeManager;
  286. var negativesAsZeroes = themeManager.getOptions("negativesAsZeroes");
  287. var negativesAsZeros = themeManager.getOptions("negativesAsZeros");
  288. var familyOptions = {
  289. equalBarWidth: themeManager.getOptions("equalBarWidth"),
  290. minBubbleSize: themeManager.getOptions("minBubbleSize"),
  291. maxBubbleSize: themeManager.getOptions("maxBubbleSize"),
  292. barWidth: themeManager.getOptions("barWidth"),
  293. barGroupPadding: themeManager.getOptions("barGroupPadding"),
  294. barGroupWidth: themeManager.getOptions("barGroupWidth"),
  295. negativesAsZeroes: _isDefined(negativesAsZeroes) ? negativesAsZeroes : negativesAsZeros
  296. };
  297. if (that.seriesFamilies && that.seriesFamilies.length) {
  298. _each(that.seriesFamilies, function(_, family) {
  299. family.updateOptions(familyOptions);
  300. family.adjustSeriesValues()
  301. });
  302. return
  303. }
  304. _each(that.series, function(_, item) {
  305. if (inArray(item.type, types) === -1) {
  306. types.push(item.type)
  307. }
  308. });
  309. _each(that._getLayoutTargets(), function(_, pane) {
  310. paneSeries = that._getSeriesForPane(pane.name);
  311. _each(types, function(_, type) {
  312. var family = new seriesFamilyModule.SeriesFamily({
  313. type: type,
  314. pane: pane.name,
  315. equalBarWidth: familyOptions.equalBarWidth,
  316. minBubbleSize: familyOptions.minBubbleSize,
  317. maxBubbleSize: familyOptions.maxBubbleSize,
  318. barWidth: familyOptions.barWidth,
  319. barGroupPadding: familyOptions.barGroupPadding,
  320. barGroupWidth: familyOptions.barGroupWidth,
  321. negativesAsZeroes: familyOptions.negativesAsZeroes,
  322. rotated: that._isRotated()
  323. });
  324. family.add(paneSeries);
  325. family.adjustSeriesValues();
  326. families.push(family)
  327. })
  328. });
  329. that.seriesFamilies = families
  330. },
  331. _updateSeriesDimensions: function() {
  332. var that = this;
  333. var i;
  334. var seriesFamilies = that.seriesFamilies || [];
  335. for (i = 0; i < seriesFamilies.length; i++) {
  336. var family = seriesFamilies[i];
  337. family.updateSeriesValues();
  338. family.adjustSeriesDimensions()
  339. }
  340. },
  341. _getLegendCallBack: function(series) {
  342. return this._legend && this._legend.getActionCallback(series)
  343. },
  344. _appendAxesGroups: function() {
  345. var that = this;
  346. that._stripsGroup.linkAppend();
  347. that._gridGroup.linkAppend();
  348. that._axesGroup.linkAppend();
  349. that._constantLinesGroup.linkAppend();
  350. that._labelAxesGroup.linkAppend();
  351. that._scaleBreaksGroup.linkAppend()
  352. },
  353. _populateMarginOptions: function() {
  354. var that = this;
  355. var bubbleSize = estimateBubbleSize(that.getSize(), that.panes.length, that._themeManager.getOptions("maxBubbleSize"), that._isRotated());
  356. var argumentMarginOptions = {};
  357. that._valueAxes.forEach(function(valueAxis) {
  358. var groupSeries = that.series.filter(function(series) {
  359. return series.getValueAxis() === valueAxis
  360. });
  361. var marginOptions = {};
  362. groupSeries.forEach(function(series) {
  363. if (series.isVisible()) {
  364. var seriesMarginOptions = processBubbleMargin(series.getMarginOptions(), bubbleSize);
  365. marginOptions = mergeMarginOptions(marginOptions, seriesMarginOptions);
  366. argumentMarginOptions = mergeMarginOptions(argumentMarginOptions, seriesMarginOptions)
  367. }
  368. });
  369. valueAxis.setMarginOptions(marginOptions)
  370. });
  371. that._argumentAxes.forEach(function(a) {
  372. return a.setMarginOptions(argumentMarginOptions)
  373. })
  374. },
  375. _populateBusinessRange: function(updatedAxis, keepRange) {
  376. var that = this;
  377. var rotated = that._isRotated();
  378. var argRange = new rangeModule.Range({
  379. rotated: !!rotated
  380. });
  381. var series = that._getVisibleSeries();
  382. that._valueAxes.forEach(function(valueAxis) {
  383. var groupRange = new rangeModule.Range({
  384. rotated: !!rotated,
  385. pane: valueAxis.pane,
  386. axis: valueAxis.name
  387. });
  388. var groupSeries = series.filter(function(series) {
  389. return series.getValueAxis() === valueAxis
  390. });
  391. groupSeries.forEach(function(series) {
  392. var seriesRange = series.getRangeData();
  393. groupRange.addRange(seriesRange.val);
  394. argRange.addRange(seriesRange.arg)
  395. });
  396. if (!updatedAxis || updatedAxis && groupSeries.length && valueAxis === updatedAxis) {
  397. valueAxis.setGroupSeries(groupSeries);
  398. valueAxis.setBusinessRange(groupRange, that._axesReinitialized || keepRange, that._argumentAxes[0]._lastVisualRangeUpdateMode)
  399. }
  400. });
  401. if (!updatedAxis || updatedAxis && series.length) {
  402. that._argumentAxes.forEach(function(a) {
  403. return a.setBusinessRange(argRange, that._axesReinitialized, void 0, that._groupsData.categories)
  404. })
  405. }
  406. that._populateMarginOptions()
  407. },
  408. getArgumentAxis: function() {
  409. return (this._argumentAxes || []).filter(function(a) {
  410. return !a.isVirtual
  411. })[0]
  412. },
  413. getValueAxis: function(name) {
  414. var _this2 = this;
  415. return (this._valueAxes || []).filter(_isDefined(name) ? function(a) {
  416. return a.name === name
  417. } : function(a) {
  418. return a.pane === _this2.defaultPane
  419. })[0]
  420. },
  421. _getGroupsData: function() {
  422. var that = this;
  423. var groups = [];
  424. that._valueAxes.forEach(function(axis) {
  425. groups.push({
  426. series: that.series.filter(function(series) {
  427. return series.getValueAxis() === axis
  428. }),
  429. valueAxis: axis,
  430. valueOptions: axis.getOptions()
  431. })
  432. });
  433. return {
  434. groups: groups,
  435. argumentAxes: that._argumentAxes,
  436. argumentOptions: that._argumentAxes[0].getOptions()
  437. }
  438. },
  439. _groupSeries: function() {
  440. var that = this;
  441. that._correctValueAxes(false);
  442. that._groupsData = that._getGroupsData()
  443. },
  444. _processValueAxisFormat: function() {
  445. var axesWithFullStackedFormat = [];
  446. this.series.forEach(function(series) {
  447. var axis = series.getValueAxis();
  448. if (series.isFullStackedSeries()) {
  449. axis.setPercentLabelFormat();
  450. axesWithFullStackedFormat.push(axis)
  451. }
  452. });
  453. this._valueAxes.forEach(function(axis) {
  454. if (axesWithFullStackedFormat.indexOf(axis) === -1) {
  455. axis.resetAutoLabelFormat()
  456. }
  457. })
  458. },
  459. _populateAxesOptions: function(typeSelector, userOptions, axisOptions, rotated, virtual) {
  460. var that = this;
  461. var preparedUserOptions = that._prepareStripsAndConstantLines(typeSelector, userOptions, rotated);
  462. var options = _extend(true, {}, preparedUserOptions, axisOptions, that._prepareAxisOptions(typeSelector, preparedUserOptions, rotated));
  463. if (virtual) {
  464. options.visible = options.tick.visible = options.minorTick.visible = options.label.visible = false;
  465. options.title = {}
  466. }
  467. return options
  468. },
  469. _createAxis: function(isArgumentAxes, options, virtual, index) {
  470. var that = this;
  471. var typeSelector = isArgumentAxes ? "argumentAxis" : "valueAxis";
  472. var renderingSettings = _extend({
  473. renderer: that._renderer,
  474. incidentOccurred: that._incidentOccurred,
  475. eventTrigger: that._eventTrigger,
  476. axisClass: isArgumentAxes ? "arg" : "val",
  477. widgetClass: "dxc",
  478. stripsGroup: that._stripsGroup,
  479. labelAxesGroup: that._labelAxesGroup,
  480. constantLinesGroup: that._constantLinesGroup,
  481. scaleBreaksGroup: that._scaleBreaksGroup,
  482. axesContainerGroup: that._axesGroup,
  483. gridGroup: that._gridGroup,
  484. isArgumentAxis: isArgumentAxes
  485. }, that._getAxisRenderingOptions(typeSelector));
  486. var axis = new axisModule.Axis(renderingSettings);
  487. axis.updateOptions(options);
  488. axis.isVirtual = virtual;
  489. return axis
  490. },
  491. _getVisualRangeSetter: _noop,
  492. _getTrackerSettings: function() {
  493. return _extend(this.callBase(), {
  494. argumentAxis: this.getArgumentAxis()
  495. })
  496. },
  497. _prepareStripsAndConstantLines: function(typeSelector, userOptions, rotated) {
  498. userOptions = this._themeManager.getOptions(typeSelector, userOptions, rotated);
  499. if (userOptions.strips) {
  500. _each(userOptions.strips, function(i) {
  501. userOptions.strips[i] = _extend(true, {}, userOptions.stripStyle, userOptions.strips[i])
  502. })
  503. }
  504. if (userOptions.constantLines) {
  505. _each(userOptions.constantLines, function(i, line) {
  506. userOptions.constantLines[i] = _extend(true, {}, userOptions.constantLineStyle, line)
  507. })
  508. }
  509. return userOptions
  510. },
  511. _legendDataField: "series",
  512. _adjustSeriesLabels: _noop,
  513. _correctValueAxes: _noop,
  514. refresh: function() {
  515. this._disposeAxes();
  516. this.callBase()
  517. },
  518. _layoutAxes: function(drawAxes) {
  519. var that = this;
  520. var cleanPanesCanvases = drawAxes();
  521. var needSpace = that.checkForMoreSpaceForPanesCanvas();
  522. if (needSpace) {
  523. var size = this._layout.backward(this._rect, this._rect, [needSpace.width, needSpace.height]);
  524. needSpace.width = Math.max(0, size[0]);
  525. needSpace.height = Math.max(0, size[1]);
  526. this._canvas = this._createCanvasFromRect(this._rect);
  527. drawAxes(needSpace, cleanPanesCanvases)
  528. }
  529. },
  530. checkForMoreSpaceForPanesCanvas: function() {
  531. return this.layoutManager.needMoreSpaceForPanesCanvas(this._getLayoutTargets(), this._isRotated())
  532. },
  533. _notify: function() {
  534. this._axesReinitialized = false
  535. }
  536. });
  537. exports.AdvancedChart = AdvancedChart;