define(function (require) { var TooltipContent = require('./TooltipContent'); var zrUtil = require('zrender/core/util'); var formatUtil = require('../../util/format'); var numberUtil = require('../../util/number'); var modelUtil = require('../../util/model'); var parsePercent = numberUtil.parsePercent; var env = require('zrender/core/env'); var Model = require('../../model/Model'); var globalListener = require('../axisPointer/globalListener'); var bind = zrUtil.bind; var each = zrUtil.each; require('../../echarts').extendComponentView({ type: 'tooltip', init: function (ecModel, api) { if (env.node) { return; } var tooltipContent = new TooltipContent(api.getDom(), api); this._tooltipContent = tooltipContent; }, render: function (tooltipModel, ecModel, api) { if (env.node) { return; } // Reset this.group.removeAll(); /** * @private * @type {module:echarts/component/tooltip/TooltipModel} */ this._tooltipModel = tooltipModel; /** * @private * @type {module:echarts/model/Global} */ this._ecModel = ecModel; /** * @private * @type {module:echarts/ExtensionAPI} */ this._api = api; /** * @private * @type {Array.} */ this._lastSeriesDataByAxis; /** * @private * @type {boolean} */ this._alwaysShowContent = tooltipModel.get('alwaysShowContent'); var tooltipContent = this._tooltipContent; tooltipContent.update(); tooltipContent.setEnterable(tooltipModel.get('enterable')); this._initGlobalListener(); this._keepShow(); }, _initGlobalListener: function () { var tooltipModel = this._tooltipModel; var triggerOn = tooltipModel.get('triggerOn'); globalListener.register( 'itemTooltip', this._api, {delay: tooltipModel.get('showDelay')}, bind(function (currTrigger, e, dispatchAction) { if (currTrigger === triggerOn) { this._tryShow(e, dispatchAction); } else if (currTrigger === 'leave') { this._hide(dispatchAction); } }, this) ); }, _keepShow: function () { var tooltipModel = this._tooltipModel; var ecModel = this._ecModel; var api = this._api; // Try to keep the tooltip show when refreshing if (this._lastX != null && this._lastY != null // When user is willing to control tooltip totally using API, // self.manuallyShowTip({x, y}) might cause tooltip hide, // which is not expected. && tooltipModel.get('triggerOn') !== 'none' ) { var self = this; clearTimeout(this._refreshUpdateTimeout); this._refreshUpdateTimeout = setTimeout(function () { // Show tip next tick after other charts are rendered // In case highlight action has wrong result // FIXME self.manuallyShowTip(tooltipModel, ecModel, api, { x: self._lastX, y: self._lastY }); }); } }, /** * Show tip manually by * dispatchAction({ * type: 'showTip', * x: 10, * y: 10 * }); * Or * dispatchAction({ * type: 'showTip', * seriesIndex: 0, * dataIndex or dataIndexInside or name * }); * * TODO Batch */ manuallyShowTip: function (tooltipModel, ecModel, api, payload) { if (payload.from === this.uid) { return; } if (env.node) { return; } var dispatchAction = makeDispatchAction(payload, api); // Reset ticket this._ticket = ''; var seriesIndex = payload.seriesIndex; var seriesModel = ecModel.getSeriesByIndex(seriesIndex); if (payload.x != null && payload.y != null) { this._tryShow({ offsetX: payload.x, offsetY: payload.y, position: payload.position, target: api.getZr().handler.findHover(payload.x, payload.y), event: {}, // When triggered from axisPointer. seriesDataByAxis: payload.seriesDataByAxis, tooltipOption: payload.tooltipOption }, dispatchAction); } else if (seriesModel) { var data = seriesModel.getData(); var dataIndex = modelUtil.queryDataIndex(data, payload); if (dataIndex == null || zrUtil.isArray(dataIndex)) { return; } var el = data.getItemGraphicEl(dataIndex); var cx; var cy; // Try to get the point in coordinate system var coordSys = seriesModel.coordinateSystem; if (seriesModel.getTooltipPosition) { var point = seriesModel.getTooltipPosition(dataIndex) || []; cx = point[0]; cy = point[1]; } else if (coordSys && coordSys.dataToPoint) { var point = coordSys.dataToPoint( data.getValues( zrUtil.map(coordSys.dimensions, function (dim) { return seriesModel.coordDimToDataDim(dim)[0]; }), dataIndex, true ) ); cx = point && point[0]; cy = point && point[1]; } else if (el) { // Use graphic bounding rect var rect = el.getBoundingRect().clone(); rect.applyTransform(el.transform); cx = rect.x + rect.width / 2; cy = rect.y + rect.height / 2; } if (cx != null && cy != null) { this._tryShow({ offsetX: cx, offsetY: cy, position: payload.position, target: el, event: {} }, dispatchAction); } } }, manuallyHideTip: function (tooltipModel, ecModel, api, payload) { var tooltipContent = this._tooltipContent; if (!this._alwaysShowContent) { tooltipContent.hideLater(this._tooltipModel.get('hideDelay')); } this._lastX = this._lastY = null; if (payload.from !== this.uid) { this._hide(makeDispatchAction(payload, api)); } }, _tryShow: function (e, dispatchAction) { var el = e.target; var tooltipModel = this._tooltipModel; if (!tooltipModel) { return; } // Save mouse x, mouse y. So we can try to keep showing the tip if chart is refreshed this._lastX = e.offsetX; this._lastY = e.offsetY; var seriesDataByAxis = e.seriesDataByAxis; if (seriesDataByAxis && seriesDataByAxis.length) { var contentNotChanged = this._updateContentNotChanged(seriesDataByAxis); this._showAxisTooltip(seriesDataByAxis, e, contentNotChanged); } // Always show item tooltip if mouse is on the element with dataIndex else if (el && el.dataIndex != null) { this._lastSeriesDataByAxis = null; this._showSeriesItemTooltip(e, el, dispatchAction); } // Tooltip provided directly. Like legend. else if (el && el.tooltip) { this._lastSeriesDataByAxis = null; this._showComponentItemTooltip(e, el, dispatchAction); } else { this._lastSeriesDataByAxis = null; this._hide(dispatchAction); } }, _showAxisTooltip: function (seriesDataByAxis, e, contentNotChanged) { var ecModel = this._ecModel; var point = [e.offsetX, e.offsetY]; var defaultHtml = []; var paramsList = []; var tooltipModel = this._tooltipModel; if (e.tooltipOption) { tooltipModel = new Model(e.tooltipOption, tooltipModel, ecModel); } each(seriesDataByAxis, function (item) { var axisModel = ecModel.getComponent(item.axisDim + 'Axis', item.axisIndex); var axisValue = item.value; var seriesDefaultHtml = []; if (!axisModel || axisValue == null) { return; } zrUtil.each(item.seriesDataIndices, function (idxItem) { var series = ecModel.getSeriesByIndex(idxItem.seriesIndex); var dataIndex = idxItem.dataIndexInside; var dataParams = series && series.getDataParams(dataIndex); if (dataParams) { paramsList.push(dataParams); seriesDefaultHtml.push(series.formatTooltip(dataIndex, true)); } }); // Default tooltip content // FIXME // (1) shold be the first data which has name? // (2) themeRiver, firstDataIndex is array, and first line is unnecessary. var firstLine = item.valueLabel; defaultHtml.push( (firstLine ? formatUtil.encodeHTML(firstLine) + '
' : '') + seriesDefaultHtml.join('
') ); }, this); // In most case, the second axis is shown upper than the first one. defaultHtml.reverse(); defaultHtml = defaultHtml.join('

'); var positionExpr = e.position; if (contentNotChanged) { this._updatePosition( tooltipModel, positionExpr || tooltipModel.get('position'), point[0], point[1], this._tooltipContent, paramsList ); } else { this._showTooltipContent( tooltipModel, defaultHtml, paramsList, Math.random(), point[0], point[1], positionExpr ); } }, _showSeriesItemTooltip: function (e, el, dispatchAction) { var ecModel = this._ecModel; // Use dataModel in element if possible // Used when mouseover on a element like markPoint or edge // In which case, the data is not main data in series. var seriesIndex = el.seriesIndex; var seriesModel = ecModel.getSeriesByIndex(seriesIndex); // For example, graph link. var dataModel = el.dataModel || seriesModel; var dataIndex = el.dataIndex; var dataType = el.dataType; var data = dataModel.getData(); var tooltipModel = buildItemTooltipModel( data.getItemModel(dataIndex), dataModel, seriesModel, this._tooltipModel, ecModel ); var tooltipTrigger = tooltipModel.get('trigger'); if (tooltipTrigger != null && tooltipTrigger !== 'item') { return; } var params = dataModel.getDataParams(dataIndex, dataType); var defaultHtml = dataModel.formatTooltip(dataIndex, false, dataType); var asyncTicket = 'item_' + dataModel.name + '_' + dataIndex; this._showTooltipContent( tooltipModel, defaultHtml, params, asyncTicket, e.offsetX, e.offsetY, e.position, e.target ); // FIXME // duplicated showtip if manuallyShowTip is called from dispatchAction. dispatchAction({ type: 'showTip', dataIndexInside: dataIndex, dataIndex: data.getRawIndex(dataIndex), seriesIndex: seriesIndex, from: this.uid }); }, _showComponentItemTooltip: function (e, el, dispatchAction) { var tooltipOpt = el.tooltip; if (typeof tooltipOpt === 'string') { var content = tooltipOpt; tooltipOpt = { content: content, // Fixed formatter formatter: content }; } var subTooltipModel = new Model(tooltipOpt, this._tooltipModel, this._ecModel); var defaultHtml = subTooltipModel.get('content'); var asyncTicket = Math.random(); // Do not check whether `trigger` is 'none' here, because `trigger` // only works on cooridinate system. In fact, we have not found case // that requires setting `trigger` nothing on component yet. this._showTooltipContent( subTooltipModel, defaultHtml, subTooltipModel.get('formatterParams') || {}, asyncTicket, e.offsetX, e.offsetY, e.position, el ); // If not dispatch showTip, tip may be hide triggered by axis. dispatchAction({ type: 'showTip', from: this.uid }); }, _showTooltipContent: function ( tooltipModel, defaultHtml, params, asyncTicket, x, y, positionExpr, el ) { // Reset ticket this._ticket = ''; if (!tooltipModel.get('showContent') || !tooltipModel.get('show')) { return; } var tooltipContent = this._tooltipContent; var formatter = tooltipModel.get('formatter'); positionExpr = positionExpr || tooltipModel.get('position'); var html = defaultHtml; if (formatter && typeof formatter === 'string') { html = formatUtil.formatTpl(formatter, params, true); } else if (typeof formatter === 'function') { var callback = bind(function (cbTicket, html) { if (cbTicket === this._ticket) { tooltipContent.setContent(html); this._updatePosition( tooltipModel, positionExpr, x, y, tooltipContent, params, el ); } }, this); this._ticket = asyncTicket; html = formatter(params, asyncTicket, callback); } tooltipContent.show(tooltipModel); tooltipContent.setContent(html); this._updatePosition( tooltipModel, positionExpr, x, y, tooltipContent, params, el ); }, /** * @param {string|Function|Array.} positionExpr * @param {number} x Mouse x * @param {number} y Mouse y * @param {boolean} confine Whether confine tooltip content in view rect. * @param {Object|} params * @param {module:zrender/Element} el target element * @param {module:echarts/ExtensionAPI} api * @return {Array.} */ _updatePosition: function (tooltipModel, positionExpr, x, y, content, params, el) { var viewWidth = this._api.getWidth(); var viewHeight = this._api.getHeight(); var rect = el && el.getBoundingRect().clone(); el && rect.applyTransform(el.transform); if (typeof positionExpr === 'function') { // Callback of position can be an array or a string specify the position positionExpr = positionExpr([x, y], params, content.el, rect); } var contentSize = content.getSize(); var align = tooltipModel.get('align'); var vAlign = tooltipModel.get('verticalAlign'); if (zrUtil.isArray(positionExpr)) { x = parsePercent(positionExpr[0], viewWidth); y = parsePercent(positionExpr[1], viewHeight); } // Specify tooltip position by string 'top' 'bottom' 'left' 'right' around graphic element else if (typeof positionExpr === 'string' && el) { var pos = calcTooltipPosition( positionExpr, rect, contentSize ); x = pos[0]; y = pos[1]; } else { var pos = refixTooltipPosition( x, y, content.el, viewWidth, viewHeight, align ? 0 : 20, vAlign ? 0 : 20 ); x = pos[0]; y = pos[1]; } align && (x -= align === 'center' ? contentSize[0] / 2 : align === 'right' ? contentSize[0] : 0); vAlign && (y -= vAlign === 'middle' ? contentSize[1] / 2 : vAlign === 'bottom' ? contentSize[1] : 0); if (tooltipModel.get('confine')) { var pos = confineTooltipPosition( x, y, content.el, viewWidth, viewHeight ); x = pos[0]; y = pos[1]; } content.moveTo(x, y); }, // FIXME // Should we remove this but leave this to user? _updateContentNotChanged: function (seriesDataByAxis) { var last = this._lastSeriesDataByAxis; var contentNotChanged = !!last && last.length === seriesDataByAxis.length; each(last, function (lastItem, i) { var newItem = seriesDataByAxis[i]; var lastIndices = lastItem.seriesDataIndices || []; var newIndices = newItem.seriesDataIndices || []; contentNotChanged &= lastItem.value === newItem.value && lastItem.axisId === newItem.axisId && lastItem.axisIndex === newItem.axisIndex && lastIndices.length === newIndices.length; each(lastIndices, function (lastIdxItem, j) { var newIdxItem = newIndices[j]; contentNotChanged &= lastIdxItem.seriesIndex === newIdxItem.seriesIndex && lastIdxItem.dataIndex === newIdxItem.dataIndex; }); }); this._lastSeriesDataByAxis = seriesDataByAxis; return !!contentNotChanged; }, _hide: function (dispatchAction) { // Do not directly hideLater here, because this behavior may be prevented // in dispatchAction when showTip is dispatched. // FIXME // duplicated hideTip if manuallyHideTip is called from dispatchAction. this._lastSeriesDataByAxis = null; dispatchAction({ type: 'hideTip', from: this.uid }); }, dispose: function (ecModel, api) { if (env.node) { return; } this._tooltipContent.hide(); globalListener.disopse(api.getZr(), 'itemTooltip'); } }); function buildItemTooltipModel(itemModel, dataModel, seriesModel, globalTooltipModel, ecModel) { var tooltipOpt = itemModel.get('tooltip', true); // In each data item tooltip can be simply write: // { // value: 10, // tooltip: 'Something you need to know' // } if (typeof tooltipOpt === 'string') { tooltipOpt = {formatter: tooltipOpt}; } var coordSysTooltipModel; if (seriesModel) { var coordSysModel = (seriesModel.coordinateSystem || {}).model; coordSysModel && (coordSysTooltipModel = coordSysModel.getModel('tooltip', globalTooltipModel)); } var seriesTooltipModel = dataModel.getModel('tooltip', coordSysTooltipModel || globalTooltipModel); return new Model(tooltipOpt, seriesTooltipModel, ecModel); } function makeDispatchAction(payload, api) { return payload.dispatchAction || zrUtil.bind(api.dispatchAction, api); } function refixTooltipPosition(x, y, el, viewWidth, viewHeight, gapH, gapV) { var width = el.clientWidth; var height = el.clientHeight; if (x + width + gapH > viewWidth) { x -= width + gapH; } else { x += gapH; } if (y + height + gapV > viewHeight) { y -= height + gapV; } else { y += gapV; } return [x, y]; } function confineTooltipPosition(x, y, el, viewWidth, viewHeight) { var width = el.clientWidth; var height = el.clientHeight; x = Math.min(x + width, viewWidth) - width; y = Math.min(y + height, viewHeight) - height; x = Math.max(x, 0); y = Math.max(y, 0); return [x, y]; } function calcTooltipPosition(position, rect, contentSize) { var domWidth = contentSize[0]; var domHeight = contentSize[1]; var gap = 5; var x = 0; var y = 0; var rectWidth = rect.width; var rectHeight = rect.height; switch (position) { case 'inside': x = rect.x + rectWidth / 2 - domWidth / 2; y = rect.y + rectHeight / 2 - domHeight / 2; break; case 'top': x = rect.x + rectWidth / 2 - domWidth / 2; y = rect.y - domHeight - gap; break; case 'bottom': x = rect.x + rectWidth / 2 - domWidth / 2; y = rect.y + rectHeight + gap; break; case 'left': x = rect.x - domWidth - gap; y = rect.y + rectHeight / 2 - domHeight / 2; break; case 'right': x = rect.x + rectWidth + gap; y = rect.y + rectHeight / 2 - domHeight / 2; } return [x, y]; } });