TooltipView.js 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782
  1. /*
  2. * Licensed to the Apache Software Foundation (ASF) under one
  3. * or more contributor license agreements. See the NOTICE file
  4. * distributed with this work for additional information
  5. * regarding copyright ownership. The ASF licenses this file
  6. * to you under the Apache License, Version 2.0 (the
  7. * "License"); you may not use this file except in compliance
  8. * with the License. You may obtain a copy of the License at
  9. *
  10. * http://www.apache.org/licenses/LICENSE-2.0
  11. *
  12. * Unless required by applicable law or agreed to in writing,
  13. * software distributed under the License is distributed on an
  14. * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
  15. * KIND, either express or implied. See the License for the
  16. * specific language governing permissions and limitations
  17. * under the License.
  18. */
  19. var echarts = require("../../echarts");
  20. var zrUtil = require("zrender/lib/core/util");
  21. var env = require("zrender/lib/core/env");
  22. var TooltipContent = require("./TooltipContent");
  23. var TooltipRichContent = require("./TooltipRichContent");
  24. var formatUtil = require("../../util/format");
  25. var numberUtil = require("../../util/number");
  26. var graphic = require("../../util/graphic");
  27. var findPointFromSeries = require("../axisPointer/findPointFromSeries");
  28. var layoutUtil = require("../../util/layout");
  29. var Model = require("../../model/Model");
  30. var globalListener = require("../axisPointer/globalListener");
  31. var axisHelper = require("../../coord/axisHelper");
  32. var axisPointerViewHelper = require("../axisPointer/viewHelper");
  33. var _model = require("../../util/model");
  34. var getTooltipRenderMode = _model.getTooltipRenderMode;
  35. /*
  36. * Licensed to the Apache Software Foundation (ASF) under one
  37. * or more contributor license agreements. See the NOTICE file
  38. * distributed with this work for additional information
  39. * regarding copyright ownership. The ASF licenses this file
  40. * to you under the Apache License, Version 2.0 (the
  41. * "License"); you may not use this file except in compliance
  42. * with the License. You may obtain a copy of the License at
  43. *
  44. * http://www.apache.org/licenses/LICENSE-2.0
  45. *
  46. * Unless required by applicable law or agreed to in writing,
  47. * software distributed under the License is distributed on an
  48. * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
  49. * KIND, either express or implied. See the License for the
  50. * specific language governing permissions and limitations
  51. * under the License.
  52. */
  53. var bind = zrUtil.bind;
  54. var each = zrUtil.each;
  55. var parsePercent = numberUtil.parsePercent;
  56. var proxyRect = new graphic.Rect({
  57. shape: {
  58. x: -1,
  59. y: -1,
  60. width: 2,
  61. height: 2
  62. }
  63. });
  64. var _default = echarts.extendComponentView({
  65. type: 'tooltip',
  66. init: function (ecModel, api) {
  67. if (env.node) {
  68. return;
  69. }
  70. var tooltipModel = ecModel.getComponent('tooltip');
  71. var renderMode = tooltipModel.get('renderMode');
  72. this._renderMode = getTooltipRenderMode(renderMode);
  73. var tooltipContent;
  74. if (this._renderMode === 'html') {
  75. tooltipContent = new TooltipContent(api.getDom(), api);
  76. this._newLine = '<br/>';
  77. } else {
  78. tooltipContent = new TooltipRichContent(api);
  79. this._newLine = '\n';
  80. }
  81. this._tooltipContent = tooltipContent;
  82. },
  83. render: function (tooltipModel, ecModel, api) {
  84. if (env.node) {
  85. return;
  86. } // Reset
  87. this.group.removeAll();
  88. /**
  89. * @private
  90. * @type {module:echarts/component/tooltip/TooltipModel}
  91. */
  92. this._tooltipModel = tooltipModel;
  93. /**
  94. * @private
  95. * @type {module:echarts/model/Global}
  96. */
  97. this._ecModel = ecModel;
  98. /**
  99. * @private
  100. * @type {module:echarts/ExtensionAPI}
  101. */
  102. this._api = api;
  103. /**
  104. * Should be cleaned when render.
  105. * @private
  106. * @type {Array.<Array.<Object>>}
  107. */
  108. this._lastDataByCoordSys = null;
  109. /**
  110. * @private
  111. * @type {boolean}
  112. */
  113. this._alwaysShowContent = tooltipModel.get('alwaysShowContent');
  114. var tooltipContent = this._tooltipContent;
  115. tooltipContent.update();
  116. tooltipContent.setEnterable(tooltipModel.get('enterable'));
  117. this._initGlobalListener();
  118. this._keepShow();
  119. },
  120. _initGlobalListener: function () {
  121. var tooltipModel = this._tooltipModel;
  122. var triggerOn = tooltipModel.get('triggerOn');
  123. globalListener.register('itemTooltip', this._api, bind(function (currTrigger, e, dispatchAction) {
  124. // If 'none', it is not controlled by mouse totally.
  125. if (triggerOn !== 'none') {
  126. if (triggerOn.indexOf(currTrigger) >= 0) {
  127. this._tryShow(e, dispatchAction);
  128. } else if (currTrigger === 'leave') {
  129. this._hide(dispatchAction);
  130. }
  131. }
  132. }, this));
  133. },
  134. _keepShow: function () {
  135. var tooltipModel = this._tooltipModel;
  136. var ecModel = this._ecModel;
  137. var api = this._api; // Try to keep the tooltip show when refreshing
  138. if (this._lastX != null && this._lastY != null // When user is willing to control tooltip totally using API,
  139. // self.manuallyShowTip({x, y}) might cause tooltip hide,
  140. // which is not expected.
  141. && tooltipModel.get('triggerOn') !== 'none') {
  142. var self = this;
  143. clearTimeout(this._refreshUpdateTimeout);
  144. this._refreshUpdateTimeout = setTimeout(function () {
  145. // Show tip next tick after other charts are rendered
  146. // In case highlight action has wrong result
  147. // FIXME
  148. !api.isDisposed() && self.manuallyShowTip(tooltipModel, ecModel, api, {
  149. x: self._lastX,
  150. y: self._lastY
  151. });
  152. });
  153. }
  154. },
  155. /**
  156. * Show tip manually by
  157. * dispatchAction({
  158. * type: 'showTip',
  159. * x: 10,
  160. * y: 10
  161. * });
  162. * Or
  163. * dispatchAction({
  164. * type: 'showTip',
  165. * seriesIndex: 0,
  166. * dataIndex or dataIndexInside or name
  167. * });
  168. *
  169. * TODO Batch
  170. */
  171. manuallyShowTip: function (tooltipModel, ecModel, api, payload) {
  172. if (payload.from === this.uid || env.node) {
  173. return;
  174. }
  175. var dispatchAction = makeDispatchAction(payload, api); // Reset ticket
  176. this._ticket = ''; // When triggered from axisPointer.
  177. var dataByCoordSys = payload.dataByCoordSys;
  178. if (payload.tooltip && payload.x != null && payload.y != null) {
  179. var el = proxyRect;
  180. el.position = [payload.x, payload.y];
  181. el.update();
  182. el.tooltip = payload.tooltip; // Manually show tooltip while view is not using zrender elements.
  183. this._tryShow({
  184. offsetX: payload.x,
  185. offsetY: payload.y,
  186. target: el
  187. }, dispatchAction);
  188. } else if (dataByCoordSys) {
  189. this._tryShow({
  190. offsetX: payload.x,
  191. offsetY: payload.y,
  192. position: payload.position,
  193. event: {},
  194. dataByCoordSys: payload.dataByCoordSys,
  195. tooltipOption: payload.tooltipOption
  196. }, dispatchAction);
  197. } else if (payload.seriesIndex != null) {
  198. if (this._manuallyAxisShowTip(tooltipModel, ecModel, api, payload)) {
  199. return;
  200. }
  201. var pointInfo = findPointFromSeries(payload, ecModel);
  202. var cx = pointInfo.point[0];
  203. var cy = pointInfo.point[1];
  204. if (cx != null && cy != null) {
  205. this._tryShow({
  206. offsetX: cx,
  207. offsetY: cy,
  208. position: payload.position,
  209. target: pointInfo.el,
  210. event: {}
  211. }, dispatchAction);
  212. }
  213. } else if (payload.x != null && payload.y != null) {
  214. // FIXME
  215. // should wrap dispatchAction like `axisPointer/globalListener` ?
  216. api.dispatchAction({
  217. type: 'updateAxisPointer',
  218. x: payload.x,
  219. y: payload.y
  220. });
  221. this._tryShow({
  222. offsetX: payload.x,
  223. offsetY: payload.y,
  224. position: payload.position,
  225. target: api.getZr().findHover(payload.x, payload.y).target,
  226. event: {}
  227. }, dispatchAction);
  228. }
  229. },
  230. manuallyHideTip: function (tooltipModel, ecModel, api, payload) {
  231. var tooltipContent = this._tooltipContent;
  232. if (!this._alwaysShowContent && this._tooltipModel) {
  233. tooltipContent.hideLater(this._tooltipModel.get('hideDelay'));
  234. }
  235. this._lastX = this._lastY = null;
  236. if (payload.from !== this.uid) {
  237. this._hide(makeDispatchAction(payload, api));
  238. }
  239. },
  240. // Be compatible with previous design, that is, when tooltip.type is 'axis' and
  241. // dispatchAction 'showTip' with seriesIndex and dataIndex will trigger axis pointer
  242. // and tooltip.
  243. _manuallyAxisShowTip: function (tooltipModel, ecModel, api, payload) {
  244. var seriesIndex = payload.seriesIndex;
  245. var dataIndex = payload.dataIndex;
  246. var coordSysAxesInfo = ecModel.getComponent('axisPointer').coordSysAxesInfo;
  247. if (seriesIndex == null || dataIndex == null || coordSysAxesInfo == null) {
  248. return;
  249. }
  250. var seriesModel = ecModel.getSeriesByIndex(seriesIndex);
  251. if (!seriesModel) {
  252. return;
  253. }
  254. var data = seriesModel.getData();
  255. var tooltipModel = buildTooltipModel([data.getItemModel(dataIndex), seriesModel, (seriesModel.coordinateSystem || {}).model, tooltipModel]);
  256. if (tooltipModel.get('trigger') !== 'axis') {
  257. return;
  258. }
  259. api.dispatchAction({
  260. type: 'updateAxisPointer',
  261. seriesIndex: seriesIndex,
  262. dataIndex: dataIndex,
  263. position: payload.position
  264. });
  265. return true;
  266. },
  267. _tryShow: function (e, dispatchAction) {
  268. var el = e.target;
  269. var tooltipModel = this._tooltipModel;
  270. if (!tooltipModel) {
  271. return;
  272. } // Save mouse x, mouse y. So we can try to keep showing the tip if chart is refreshed
  273. this._lastX = e.offsetX;
  274. this._lastY = e.offsetY;
  275. var dataByCoordSys = e.dataByCoordSys;
  276. if (dataByCoordSys && dataByCoordSys.length) {
  277. this._showAxisTooltip(dataByCoordSys, e);
  278. } // Always show item tooltip if mouse is on the element with dataIndex
  279. else if (el && el.dataIndex != null) {
  280. this._lastDataByCoordSys = null;
  281. this._showSeriesItemTooltip(e, el, dispatchAction);
  282. } // Tooltip provided directly. Like legend.
  283. else if (el && el.tooltip) {
  284. this._lastDataByCoordSys = null;
  285. this._showComponentItemTooltip(e, el, dispatchAction);
  286. } else {
  287. this._lastDataByCoordSys = null;
  288. this._hide(dispatchAction);
  289. }
  290. },
  291. _showOrMove: function (tooltipModel, cb) {
  292. // showDelay is used in this case: tooltip.enterable is set
  293. // as true. User intent to move mouse into tooltip and click
  294. // something. `showDelay` makes it easyer to enter the content
  295. // but tooltip do not move immediately.
  296. var delay = tooltipModel.get('showDelay');
  297. cb = zrUtil.bind(cb, this);
  298. clearTimeout(this._showTimout);
  299. delay > 0 ? this._showTimout = setTimeout(cb, delay) : cb();
  300. },
  301. _showAxisTooltip: function (dataByCoordSys, e) {
  302. var ecModel = this._ecModel;
  303. var globalTooltipModel = this._tooltipModel;
  304. var point = [e.offsetX, e.offsetY];
  305. var singleDefaultHTML = [];
  306. var singleParamsList = [];
  307. var singleTooltipModel = buildTooltipModel([e.tooltipOption, globalTooltipModel]);
  308. var renderMode = this._renderMode;
  309. var newLine = this._newLine;
  310. var markers = {};
  311. each(dataByCoordSys, function (itemCoordSys) {
  312. // var coordParamList = [];
  313. // var coordDefaultHTML = [];
  314. // var coordTooltipModel = buildTooltipModel([
  315. // e.tooltipOption,
  316. // itemCoordSys.tooltipOption,
  317. // ecModel.getComponent(itemCoordSys.coordSysMainType, itemCoordSys.coordSysIndex),
  318. // globalTooltipModel
  319. // ]);
  320. // var displayMode = coordTooltipModel.get('displayMode');
  321. // var paramsList = displayMode === 'single' ? singleParamsList : [];
  322. each(itemCoordSys.dataByAxis, function (item) {
  323. var axisModel = ecModel.getComponent(item.axisDim + 'Axis', item.axisIndex);
  324. var axisValue = item.value;
  325. var seriesDefaultHTML = [];
  326. if (!axisModel || axisValue == null) {
  327. return;
  328. }
  329. var valueLabel = axisPointerViewHelper.getValueLabel(axisValue, axisModel.axis, ecModel, item.seriesDataIndices, item.valueLabelOpt);
  330. zrUtil.each(item.seriesDataIndices, function (idxItem) {
  331. var series = ecModel.getSeriesByIndex(idxItem.seriesIndex);
  332. var dataIndex = idxItem.dataIndexInside;
  333. var dataParams = series && series.getDataParams(dataIndex);
  334. dataParams.axisDim = item.axisDim;
  335. dataParams.axisIndex = item.axisIndex;
  336. dataParams.axisType = item.axisType;
  337. dataParams.axisId = item.axisId;
  338. dataParams.axisValue = axisHelper.getAxisRawValue(axisModel.axis, axisValue);
  339. dataParams.axisValueLabel = valueLabel;
  340. if (dataParams) {
  341. singleParamsList.push(dataParams);
  342. var seriesTooltip = series.formatTooltip(dataIndex, true, null, renderMode);
  343. var html;
  344. if (zrUtil.isObject(seriesTooltip)) {
  345. html = seriesTooltip.html;
  346. var newMarkers = seriesTooltip.markers;
  347. zrUtil.merge(markers, newMarkers);
  348. } else {
  349. html = seriesTooltip;
  350. }
  351. seriesDefaultHTML.push(html);
  352. }
  353. }); // Default tooltip content
  354. // FIXME
  355. // (1) shold be the first data which has name?
  356. // (2) themeRiver, firstDataIndex is array, and first line is unnecessary.
  357. var firstLine = valueLabel;
  358. if (renderMode !== 'html') {
  359. singleDefaultHTML.push(seriesDefaultHTML.join(newLine));
  360. } else {
  361. singleDefaultHTML.push((firstLine ? formatUtil.encodeHTML(firstLine) + newLine : '') + seriesDefaultHTML.join(newLine));
  362. }
  363. });
  364. }, this); // In most case, the second axis is shown upper than the first one.
  365. singleDefaultHTML.reverse();
  366. singleDefaultHTML = singleDefaultHTML.join(this._newLine + this._newLine);
  367. var positionExpr = e.position;
  368. this._showOrMove(singleTooltipModel, function () {
  369. if (this._updateContentNotChangedOnAxis(dataByCoordSys)) {
  370. this._updatePosition(singleTooltipModel, positionExpr, point[0], point[1], this._tooltipContent, singleParamsList);
  371. } else {
  372. this._showTooltipContent(singleTooltipModel, singleDefaultHTML, singleParamsList, Math.random(), point[0], point[1], positionExpr, undefined, markers);
  373. }
  374. }); // Do not trigger events here, because this branch only be entered
  375. // from dispatchAction.
  376. },
  377. _showSeriesItemTooltip: function (e, el, dispatchAction) {
  378. var ecModel = this._ecModel; // Use dataModel in element if possible
  379. // Used when mouseover on a element like markPoint or edge
  380. // In which case, the data is not main data in series.
  381. var seriesIndex = el.seriesIndex;
  382. var seriesModel = ecModel.getSeriesByIndex(seriesIndex); // For example, graph link.
  383. var dataModel = el.dataModel || seriesModel;
  384. var dataIndex = el.dataIndex;
  385. var dataType = el.dataType;
  386. var data = dataModel.getData();
  387. var tooltipModel = buildTooltipModel([data.getItemModel(dataIndex), dataModel, seriesModel && (seriesModel.coordinateSystem || {}).model, this._tooltipModel]);
  388. var tooltipTrigger = tooltipModel.get('trigger');
  389. if (tooltipTrigger != null && tooltipTrigger !== 'item') {
  390. return;
  391. }
  392. var params = dataModel.getDataParams(dataIndex, dataType);
  393. var seriesTooltip = dataModel.formatTooltip(dataIndex, false, dataType, this._renderMode);
  394. var defaultHtml;
  395. var markers;
  396. if (zrUtil.isObject(seriesTooltip)) {
  397. defaultHtml = seriesTooltip.html;
  398. markers = seriesTooltip.markers;
  399. } else {
  400. defaultHtml = seriesTooltip;
  401. markers = null;
  402. }
  403. var asyncTicket = 'item_' + dataModel.name + '_' + dataIndex;
  404. this._showOrMove(tooltipModel, function () {
  405. this._showTooltipContent(tooltipModel, defaultHtml, params, asyncTicket, e.offsetX, e.offsetY, e.position, e.target, markers);
  406. }); // FIXME
  407. // duplicated showtip if manuallyShowTip is called from dispatchAction.
  408. dispatchAction({
  409. type: 'showTip',
  410. dataIndexInside: dataIndex,
  411. dataIndex: data.getRawIndex(dataIndex),
  412. seriesIndex: seriesIndex,
  413. from: this.uid
  414. });
  415. },
  416. _showComponentItemTooltip: function (e, el, dispatchAction) {
  417. var tooltipOpt = el.tooltip;
  418. if (typeof tooltipOpt === 'string') {
  419. var content = tooltipOpt;
  420. tooltipOpt = {
  421. content: content,
  422. // Fixed formatter
  423. formatter: content
  424. };
  425. }
  426. var subTooltipModel = new Model(tooltipOpt, this._tooltipModel, this._ecModel);
  427. var defaultHtml = subTooltipModel.get('content');
  428. var asyncTicket = Math.random(); // Do not check whether `trigger` is 'none' here, because `trigger`
  429. // only works on cooridinate system. In fact, we have not found case
  430. // that requires setting `trigger` nothing on component yet.
  431. this._showOrMove(subTooltipModel, function () {
  432. this._showTooltipContent(subTooltipModel, defaultHtml, subTooltipModel.get('formatterParams') || {}, asyncTicket, e.offsetX, e.offsetY, e.position, el);
  433. }); // If not dispatch showTip, tip may be hide triggered by axis.
  434. dispatchAction({
  435. type: 'showTip',
  436. from: this.uid
  437. });
  438. },
  439. _showTooltipContent: function (tooltipModel, defaultHtml, params, asyncTicket, x, y, positionExpr, el, markers) {
  440. // Reset ticket
  441. this._ticket = '';
  442. if (!tooltipModel.get('showContent') || !tooltipModel.get('show')) {
  443. return;
  444. }
  445. var tooltipContent = this._tooltipContent;
  446. var formatter = tooltipModel.get('formatter');
  447. positionExpr = positionExpr || tooltipModel.get('position');
  448. var html = defaultHtml;
  449. if (formatter && typeof formatter === 'string') {
  450. html = formatUtil.formatTpl(formatter, params, true);
  451. } else if (typeof formatter === 'function') {
  452. var callback = bind(function (cbTicket, html) {
  453. if (cbTicket === this._ticket) {
  454. tooltipContent.setContent(html, markers, tooltipModel);
  455. this._updatePosition(tooltipModel, positionExpr, x, y, tooltipContent, params, el);
  456. }
  457. }, this);
  458. this._ticket = asyncTicket;
  459. html = formatter(params, asyncTicket, callback);
  460. }
  461. tooltipContent.setContent(html, markers, tooltipModel);
  462. tooltipContent.show(tooltipModel);
  463. this._updatePosition(tooltipModel, positionExpr, x, y, tooltipContent, params, el);
  464. },
  465. /**
  466. * @param {string|Function|Array.<number>|Object} positionExpr
  467. * @param {number} x Mouse x
  468. * @param {number} y Mouse y
  469. * @param {boolean} confine Whether confine tooltip content in view rect.
  470. * @param {Object|<Array.<Object>} params
  471. * @param {module:zrender/Element} el target element
  472. * @param {module:echarts/ExtensionAPI} api
  473. * @return {Array.<number>}
  474. */
  475. _updatePosition: function (tooltipModel, positionExpr, x, y, content, params, el) {
  476. var viewWidth = this._api.getWidth();
  477. var viewHeight = this._api.getHeight();
  478. positionExpr = positionExpr || tooltipModel.get('position');
  479. var contentSize = content.getSize();
  480. var align = tooltipModel.get('align');
  481. var vAlign = tooltipModel.get('verticalAlign');
  482. var rect = el && el.getBoundingRect().clone();
  483. el && rect.applyTransform(el.transform);
  484. if (typeof positionExpr === 'function') {
  485. // Callback of position can be an array or a string specify the position
  486. positionExpr = positionExpr([x, y], params, content.el, rect, {
  487. viewSize: [viewWidth, viewHeight],
  488. contentSize: contentSize.slice()
  489. });
  490. }
  491. if (zrUtil.isArray(positionExpr)) {
  492. x = parsePercent(positionExpr[0], viewWidth);
  493. y = parsePercent(positionExpr[1], viewHeight);
  494. } else if (zrUtil.isObject(positionExpr)) {
  495. positionExpr.width = contentSize[0];
  496. positionExpr.height = contentSize[1];
  497. var layoutRect = layoutUtil.getLayoutRect(positionExpr, {
  498. width: viewWidth,
  499. height: viewHeight
  500. });
  501. x = layoutRect.x;
  502. y = layoutRect.y;
  503. align = null; // When positionExpr is left/top/right/bottom,
  504. // align and verticalAlign will not work.
  505. vAlign = null;
  506. } // Specify tooltip position by string 'top' 'bottom' 'left' 'right' around graphic element
  507. else if (typeof positionExpr === 'string' && el) {
  508. var pos = calcTooltipPosition(positionExpr, rect, contentSize);
  509. x = pos[0];
  510. y = pos[1];
  511. } else {
  512. var pos = refixTooltipPosition(x, y, content, viewWidth, viewHeight, align ? null : 20, vAlign ? null : 20);
  513. x = pos[0];
  514. y = pos[1];
  515. }
  516. align && (x -= isCenterAlign(align) ? contentSize[0] / 2 : align === 'right' ? contentSize[0] : 0);
  517. vAlign && (y -= isCenterAlign(vAlign) ? contentSize[1] / 2 : vAlign === 'bottom' ? contentSize[1] : 0);
  518. if (tooltipModel.get('confine')) {
  519. var pos = confineTooltipPosition(x, y, content, viewWidth, viewHeight);
  520. x = pos[0];
  521. y = pos[1];
  522. }
  523. content.moveTo(x, y);
  524. },
  525. // FIXME
  526. // Should we remove this but leave this to user?
  527. _updateContentNotChangedOnAxis: function (dataByCoordSys) {
  528. var lastCoordSys = this._lastDataByCoordSys;
  529. var contentNotChanged = !!lastCoordSys && lastCoordSys.length === dataByCoordSys.length;
  530. contentNotChanged && each(lastCoordSys, function (lastItemCoordSys, indexCoordSys) {
  531. var lastDataByAxis = lastItemCoordSys.dataByAxis || {};
  532. var thisItemCoordSys = dataByCoordSys[indexCoordSys] || {};
  533. var thisDataByAxis = thisItemCoordSys.dataByAxis || [];
  534. contentNotChanged &= lastDataByAxis.length === thisDataByAxis.length;
  535. contentNotChanged && each(lastDataByAxis, function (lastItem, indexAxis) {
  536. var thisItem = thisDataByAxis[indexAxis] || {};
  537. var lastIndices = lastItem.seriesDataIndices || [];
  538. var newIndices = thisItem.seriesDataIndices || [];
  539. contentNotChanged &= lastItem.value === thisItem.value && lastItem.axisType === thisItem.axisType && lastItem.axisId === thisItem.axisId && lastIndices.length === newIndices.length;
  540. contentNotChanged && each(lastIndices, function (lastIdxItem, j) {
  541. var newIdxItem = newIndices[j];
  542. contentNotChanged &= lastIdxItem.seriesIndex === newIdxItem.seriesIndex && lastIdxItem.dataIndex === newIdxItem.dataIndex;
  543. });
  544. });
  545. });
  546. this._lastDataByCoordSys = dataByCoordSys;
  547. return !!contentNotChanged;
  548. },
  549. _hide: function (dispatchAction) {
  550. // Do not directly hideLater here, because this behavior may be prevented
  551. // in dispatchAction when showTip is dispatched.
  552. // FIXME
  553. // duplicated hideTip if manuallyHideTip is called from dispatchAction.
  554. this._lastDataByCoordSys = null;
  555. dispatchAction({
  556. type: 'hideTip',
  557. from: this.uid
  558. });
  559. },
  560. dispose: function (ecModel, api) {
  561. if (env.node) {
  562. return;
  563. }
  564. this._tooltipContent.hide();
  565. globalListener.unregister('itemTooltip', api);
  566. }
  567. });
  568. /**
  569. * @param {Array.<Object|module:echarts/model/Model>} modelCascade
  570. * From top to bottom. (the last one should be globalTooltipModel);
  571. */
  572. function buildTooltipModel(modelCascade) {
  573. var resultModel = modelCascade.pop();
  574. while (modelCascade.length) {
  575. var tooltipOpt = modelCascade.pop();
  576. if (tooltipOpt) {
  577. if (Model.isInstance(tooltipOpt)) {
  578. tooltipOpt = tooltipOpt.get('tooltip', true);
  579. } // In each data item tooltip can be simply write:
  580. // {
  581. // value: 10,
  582. // tooltip: 'Something you need to know'
  583. // }
  584. if (typeof tooltipOpt === 'string') {
  585. tooltipOpt = {
  586. formatter: tooltipOpt
  587. };
  588. }
  589. resultModel = new Model(tooltipOpt, resultModel, resultModel.ecModel);
  590. }
  591. }
  592. return resultModel;
  593. }
  594. function makeDispatchAction(payload, api) {
  595. return payload.dispatchAction || zrUtil.bind(api.dispatchAction, api);
  596. }
  597. function refixTooltipPosition(x, y, content, viewWidth, viewHeight, gapH, gapV) {
  598. var size = content.getOuterSize();
  599. var width = size.width;
  600. var height = size.height;
  601. if (gapH != null) {
  602. if (x + width + gapH > viewWidth) {
  603. x -= width + gapH;
  604. } else {
  605. x += gapH;
  606. }
  607. }
  608. if (gapV != null) {
  609. if (y + height + gapV > viewHeight) {
  610. y -= height + gapV;
  611. } else {
  612. y += gapV;
  613. }
  614. }
  615. return [x, y];
  616. }
  617. function confineTooltipPosition(x, y, content, viewWidth, viewHeight) {
  618. var size = content.getOuterSize();
  619. var width = size.width;
  620. var height = size.height;
  621. x = Math.min(x + width, viewWidth) - width;
  622. y = Math.min(y + height, viewHeight) - height;
  623. x = Math.max(x, 0);
  624. y = Math.max(y, 0);
  625. return [x, y];
  626. }
  627. function calcTooltipPosition(position, rect, contentSize) {
  628. var domWidth = contentSize[0];
  629. var domHeight = contentSize[1];
  630. var gap = 5;
  631. var x = 0;
  632. var y = 0;
  633. var rectWidth = rect.width;
  634. var rectHeight = rect.height;
  635. switch (position) {
  636. case 'inside':
  637. x = rect.x + rectWidth / 2 - domWidth / 2;
  638. y = rect.y + rectHeight / 2 - domHeight / 2;
  639. break;
  640. case 'top':
  641. x = rect.x + rectWidth / 2 - domWidth / 2;
  642. y = rect.y - domHeight - gap;
  643. break;
  644. case 'bottom':
  645. x = rect.x + rectWidth / 2 - domWidth / 2;
  646. y = rect.y + rectHeight + gap;
  647. break;
  648. case 'left':
  649. x = rect.x - domWidth - gap;
  650. y = rect.y + rectHeight / 2 - domHeight / 2;
  651. break;
  652. case 'right':
  653. x = rect.x + rectWidth + gap;
  654. y = rect.y + rectHeight / 2 - domHeight / 2;
  655. }
  656. return [x, y];
  657. }
  658. function isCenterAlign(align) {
  659. return align === 'center' || align === 'middle';
  660. }
  661. module.exports = _default;