vxe-gantt 3.1.0 → 3.1.2

package/lib/ui/index.js

@@ -15,7 +15,7 @@ var _log = require("./src/log");
 var setConfig = _core.VxeUI.setConfig,
   setIcon = _core.VxeUI.setIcon,
   checkVersion = _core.VxeUI.checkVersion;
-_core.VxeUI.ganttVersion = "3.1.0";
+_core.VxeUI.ganttVersion = "3.1.2";
 setConfig({
   gantt: {
     // size: null,
@@ -54,6 +54,9 @@ setConfig({
       // beforeSave: null,
       // afterSave: null
     },
+    taskBarTooltipConfig: {
+      enterable: true
+    },
     taskViewScaleConfig: {
       week: {
         startDay: 1

package/lib/ui/index.min.js

@@ -1 +1 @@
-Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"VxeUI",{enumerable:!0,get:function(){return _core.VxeUI}}),exports.default=void 0;var _core=require("@vxe-ui/core"),_log=require("./src/log"),setConfig=_core.VxeUI.setConfig,setIcon=_core.VxeUI.setIcon,checkVersion=_core.VxeUI.checkVersion,iconPrefix=(_core.VxeUI.ganttVersion="3.1.0",setConfig({gantt:{formConfig:{enabled:!0},pagerConfig:{enabled:!0},toolbarConfig:{enabled:!0},proxyConfig:{enabled:!0,autoLoad:!0,showLoading:!0,showResponseMsg:!0,showActionMsg:!0,response:{list:null,result:"result",total:"page.total",message:"message"}},taskViewScaleConfig:{week:{startDay:1}},taskViewConfig:{showNowLine:!0},taskSplitConfig:{enabled:!0,resize:!0,showCollapseTableButton:!0,showCollapseTaskButton:!0}}}),"vxe-icon-"),pVersion=(setIcon({GANTT_VIEW_LEFT_OPEN:iconPrefix+"arrow-left",GANTT_VIEW_LEFT_CLOSE:iconPrefix+"arrow-right",GANTT_VIEW_RIGHT_OPEN:iconPrefix+"arrow-right",GANTT_VIEW_RIGHT_CLOSE:iconPrefix+"arrow-left"}),3),sVersion=18,_default=(checkVersion?checkVersion(_core.VxeUI.tableVersion,pVersion,sVersion)||(0,_log.errLog)("vxe.error.errorVersion",["vxe-table@".concat(_core.VxeUI.tableVersion||"?"),"vxe-table v".concat(pVersion,".").concat(sVersion,"+")]):(0,_log.errLog)("Requires vxe-table v".concat(pVersion,".").concat(sVersion,"+")),exports.default=_core.VxeUI);
+Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"VxeUI",{enumerable:!0,get:function(){return _core.VxeUI}}),exports.default=void 0;var _core=require("@vxe-ui/core"),_log=require("./src/log"),setConfig=_core.VxeUI.setConfig,setIcon=_core.VxeUI.setIcon,checkVersion=_core.VxeUI.checkVersion,iconPrefix=(_core.VxeUI.ganttVersion="3.1.2",setConfig({gantt:{formConfig:{enabled:!0},pagerConfig:{enabled:!0},toolbarConfig:{enabled:!0},proxyConfig:{enabled:!0,autoLoad:!0,showLoading:!0,showResponseMsg:!0,showActionMsg:!0,response:{list:null,result:"result",total:"page.total",message:"message"}},taskBarTooltipConfig:{enterable:!0},taskViewScaleConfig:{week:{startDay:1}},taskViewConfig:{showNowLine:!0},taskSplitConfig:{enabled:!0,resize:!0,showCollapseTableButton:!0,showCollapseTaskButton:!0}}}),"vxe-icon-"),pVersion=(setIcon({GANTT_VIEW_LEFT_OPEN:iconPrefix+"arrow-left",GANTT_VIEW_LEFT_CLOSE:iconPrefix+"arrow-right",GANTT_VIEW_RIGHT_OPEN:iconPrefix+"arrow-right",GANTT_VIEW_RIGHT_CLOSE:iconPrefix+"arrow-left"}),3),sVersion=18,_default=(checkVersion?checkVersion(_core.VxeUI.tableVersion,pVersion,sVersion)||(0,_log.errLog)("vxe.error.errorVersion",["vxe-table@".concat(_core.VxeUI.tableVersion||"?"),"vxe-table v".concat(pVersion,".").concat(sVersion,"+")]):(0,_log.errLog)("Requires vxe-table v".concat(pVersion,".").concat(sVersion,"+")),exports.default=_core.VxeUI);

package/lib/ui/src/log.js

@@ -6,6 +6,6 @@ Object.defineProperty(exports, "__esModule", {
 exports.warnLog = exports.errLog = void 0;
 var _core = require("@vxe-ui/core");
 var log = _core.VxeUI.log;
-var version = "gantt v".concat("3.1.0");
+var version = "gantt v".concat("3.1.2");
 var warnLog = exports.warnLog = log.create('warn', version);
 var errLog = exports.errLog = log.create('error', version);

package/lib/ui/src/log.min.js

@@ -1 +1 @@
-Object.defineProperty(exports,"__esModule",{value:!0}),exports.warnLog=exports.errLog=void 0;var _core=require("@vxe-ui/core"),log=_core.VxeUI.log,version="gantt v".concat("3.1.0"),warnLog=exports.warnLog=log.create("warn",version),errLog=exports.errLog=log.create("error",version);
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.warnLog=exports.errLog=void 0;var _core=require("@vxe-ui/core"),log=_core.VxeUI.log,version="gantt v".concat("3.1.2"),warnLog=exports.warnLog=log.create("warn",version),errLog=exports.errLog=log.create("error",version);

package/lib/ui/src/utils.js

@@ -4,12 +4,14 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.eqEmptyValue = eqEmptyValue;
+exports.formatText = formatText;
 exports.getClass = getClass;
 exports.getFuncText = getFuncText;
 exports.getGlobalDefaultConfig = getGlobalDefaultConfig;
 exports.getLastZIndex = getLastZIndex;
 exports.getStringValue = getStringValue;
 exports.getSubLastZIndex = getSubLastZIndex;
+exports.isEmptyValue = isEmptyValue;
 exports.isEnableConf = isEnableConf;
 exports.nextSubZIndex = nextSubZIndex;
 exports.nextZIndex = nextZIndex;
@@ -21,6 +23,9 @@ var getConfig = _core.VxeUI.getConfig;
 function isEnableConf(conf) {
   return conf && conf.enabled !== false;
 }
+function isEmptyValue(cellValue) {
+  return cellValue === null || cellValue === undefined || cellValue === '';
+}
 function nextZIndex() {
   return _domZindex.default.getNext();
 }
@@ -46,6 +51,9 @@ function getFuncText(content, args) {
   }
   return '';
 }
+function formatText(value, placeholder) {
+  return '' + (isEmptyValue(value) ? placeholder ? _core.VxeUI.getConfig().emptyCell : '' : value);
+}
 /**
  * 判断值为：'' | null | undefined 时都属于空值
  */

package/lib/ui/src/utils.min.js

@@ -1 +1 @@
-Object.defineProperty(exports,"__esModule",{value:!0}),exports.eqEmptyValue=eqEmptyValue,exports.getClass=getClass,exports.getFuncText=getFuncText,exports.getGlobalDefaultConfig=getGlobalDefaultConfig,exports.getLastZIndex=getLastZIndex,exports.getStringValue=getStringValue,exports.getSubLastZIndex=getSubLastZIndex,exports.isEnableConf=isEnableConf,exports.nextSubZIndex=nextSubZIndex,exports.nextZIndex=nextZIndex;var _xeUtils=_interopRequireDefault(require("xe-utils")),_core=require("@vxe-ui/core"),_domZindex=_interopRequireDefault(require("dom-zindex"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}var getConfig=_core.VxeUI.getConfig;function isEnableConf(e){return e&&!1!==e.enabled}function nextZIndex(){return _domZindex.default.getNext()}function getLastZIndex(){return _domZindex.default.getCurrent()}function nextSubZIndex(){return _domZindex.default.getSubNext()}function getSubLastZIndex(){return _domZindex.default.getSubCurrent()}function getGlobalDefaultConfig(e,t){return _xeUtils.default.eqNull(e)?t:e}function getFuncText(e,t){var n;return e?(n=getConfig().translate,_xeUtils.default.toValueString(n?n(""+e,t):e)):""}function eqEmptyValue(e){return null==e||""===e}function getStringValue(e){return eqEmptyValue(e)?"":e}function getClass(e,t){return e?_xeUtils.default.isFunction(e)?e(t):e:""}
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.eqEmptyValue=eqEmptyValue,exports.formatText=formatText,exports.getClass=getClass,exports.getFuncText=getFuncText,exports.getGlobalDefaultConfig=getGlobalDefaultConfig,exports.getLastZIndex=getLastZIndex,exports.getStringValue=getStringValue,exports.getSubLastZIndex=getSubLastZIndex,exports.isEmptyValue=isEmptyValue,exports.isEnableConf=isEnableConf,exports.nextSubZIndex=nextSubZIndex,exports.nextZIndex=nextZIndex;var _xeUtils=_interopRequireDefault(require("xe-utils")),_core=require("@vxe-ui/core"),_domZindex=_interopRequireDefault(require("dom-zindex"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}var getConfig=_core.VxeUI.getConfig;function isEnableConf(e){return e&&!1!==e.enabled}function isEmptyValue(e){return null==e||""===e}function nextZIndex(){return _domZindex.default.getNext()}function getLastZIndex(){return _domZindex.default.getCurrent()}function nextSubZIndex(){return _domZindex.default.getSubNext()}function getSubLastZIndex(){return _domZindex.default.getSubCurrent()}function getGlobalDefaultConfig(e,t){return _xeUtils.default.eqNull(e)?t:e}function getFuncText(e,t){var n;return e?(n=getConfig().translate,_xeUtils.default.toValueString(n?n(""+e,t):e)):""}function formatText(e,t){return""+(isEmptyValue(e)?t?_core.VxeUI.getConfig().emptyCell:"":e)}function eqEmptyValue(e){return null==e||""===e}function getStringValue(e){return eqEmptyValue(e)?"":e}function getClass(e,t){return e?_xeUtils.default.isFunction(e)?e(t):e:""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vxe-gantt",
-  "version": "3.1.0",
+  "version": "3.1.2",
   "description": "A vue based gantt component",
   "scripts": {
     "update": "npm install --legacy-peer-deps",
@@ -64,7 +64,7 @@
     "vue": "~2.6.14",
     "vue-i18n": "^8.15.1",
     "vue-router": "^3.5.1",
-    "vxe-pc-ui": "^3.10.43",
+    "vxe-pc-ui": "^3.10.45",
     "vxe-table": "^3.19.26"
   },
   "vetur": {

package/packages/gantt/src/gantt-body.ts

@@ -51,6 +51,7 @@ export default defineVxeComponent({
       const { todayDateMaps } = internalData
       const taskViewOpts = $xeGantt.computeTaskViewOpts
       const { showNowLine, viewStyle } = taskViewOpts
+      const scaleUnit = $xeGantt.computeScaleUnit
       const { scaleItem } = headerGroups[headerGroups.length - 1] || {}
       const { field, dateObj } = column
       const { cellClassName, cellStyle } = viewStyle || {}
@@ -99,7 +100,18 @@ export default defineVxeComponent({
           })
         )
       }
-      const ctParams = { source: sourceType, type: viewType, dateObj, row, column, $rowIndex, rowIndex, _rowIndex }
+      const ctParams = {
+        $gantt: $xeGantt,
+        source: sourceType,
+        type: viewType,
+        scaleType: scaleUnit,
+        dateObj,
+        row,
+        column,
+        $rowIndex,
+        rowIndex,
+        _rowIndex
+      }
       return h('td', {
         key: $columnIndex,
         class: [
@@ -149,6 +161,7 @@ export default defineVxeComponent({
       const { transform } = treeOpts
       const childrenField = treeOpts.children || treeOpts.childrenField
 
+      const scaleUnit = $xeGantt.computeScaleUnit
       const taskViewOpts = $xeGantt.computeTaskViewOpts
       const { viewStyle } = taskViewOpts
       const { rowClassName, rowStyle } = viewStyle || {}
@@ -186,7 +199,16 @@ export default defineVxeComponent({
           trOns.dragend = $xeTable.handleRowDragDragendEvent
           trOns.dragover = $xeTable.handleRowDragDragoverEvent
         }
-        const rowParams = { source: sourceType, type: viewType, row, rowIndex, $rowIndex, _rowIndex }
+        const rowParams = {
+          $gantt: $xeGantt,
+          source: sourceType,
+          type: viewType,
+          scaleType: scaleUnit,
+          row,
+          rowIndex,
+          $rowIndex,
+          _rowIndex
+        }
         trVNs.push(
           h('tr', {
             key: treeConfig ? rowid : $rowIndex,

package/packages/gantt/src/gantt-chart.ts

@@ -58,8 +58,9 @@ export default defineVxeComponent({
       const titleField = $xeGantt.computeTitleField
       const progressField = $xeGantt.computeProgressField
       const taskBarOpts = $xeGantt.computeTaskBarOpts
-      const barParams = { $gantt: $xeGantt, row }
-      const { showProgress, showContent, contentMethod, barStyle, drag } = taskBarOpts
+      const scaleUnit = $xeGantt.computeScaleUnit
+      const barParams = { $gantt: $xeGantt, row, scaleType: scaleUnit }
+      const { showProgress, showContent, contentMethod, barStyle, drag, showTooltip } = taskBarOpts
       const isBarRowStyle = XEUtils.isFunction(barStyle)
       const barStyObj = (barStyle ? (isBarRowStyle ? barStyle(barParams) : barStyle) : {}) || {}
       const { round } = barStyObj
@@ -87,10 +88,46 @@ export default defineVxeComponent({
       }
 
       if (contentMethod) {
-        title = getStringValue(contentMethod({ row, title }))
+        title = getStringValue(contentMethod({ row, title, scaleType: scaleUnit }))
       }
 
-      const ctParams = { source: sourceType, type: viewType, row, $rowIndex, rowIndex, _rowIndex }
+      const ctParams = {
+        $gantt: $xeGantt,
+        source: sourceType,
+        type: viewType,
+        scaleType: scaleUnit,
+        row,
+        $rowIndex,
+        rowIndex,
+        _rowIndex
+      }
+      const ons: {
+        click: any
+        dblclick: any
+        mousedown: any
+        mouseover?: any
+        mouseleave?: any
+      } = {
+        click (evnt: MouseEvent) {
+          $xeGantt.handleTaskBarClickEvent(evnt, barParams)
+        },
+        dblclick (evnt: MouseEvent) {
+          $xeGantt.handleTaskBarDblclickEvent(evnt, barParams)
+        },
+        mousedown (evnt: MouseEvent) {
+          if ($xeGantt.handleTaskBarMousedownEvent) {
+            $xeGantt.handleTaskBarMousedownEvent(evnt, barParams)
+          }
+        }
+      }
+      if (showTooltip) {
+        ons.mouseover = (evnt: MouseEvent) => {
+          $xeGantt.triggerTaskBarTooltipEvent(evnt, Object.assign({ $event: evnt }, ctParams))
+        }
+        ons.mouseleave = (evnt: MouseEvent) => {
+          $xeGantt.handleTaskBarTooltipLeaveEvent(evnt, Object.assign({ $event: evnt }, ctParams))
+        }
+      }
       return h('div', {
         key: treeConfig ? rowid : $rowIndex,
         attrs: {
@@ -116,19 +153,7 @@ export default defineVxeComponent({
           attrs: {
             rowid
           },
-          on: {
-            click (evnt: MouseEvent) {
-              $xeGantt.handleTaskBarClickEvent(evnt, barParams)
-            },
-            dblclick (evnt: MouseEvent) {
-              $xeGantt.handleTaskBarDblclickEvent(evnt, barParams)
-            },
-            mousedown (evnt: MouseEvent) {
-              if ($xeGantt.handleTaskBarMousedownEvent) {
-                $xeGantt.handleTaskBarMousedownEvent(evnt, barParams)
-              }
-            }
-          }
+          on: ons
         }, taskBarSlot
           ? $xeGantt.callSlot(taskBarSlot, barParams, h)
           : [

package/packages/gantt/src/gantt-header.ts

@@ -79,15 +79,17 @@ export default defineVxeComponent({
               }, columns.map((column, cIndex) => {
                 const { field, childCount, dateObj } = column
                 let label = `${column.title}`
-                if ($rowIndex < headerGroups.length - 1) {
-                  if (scaleItem.type === 'day') {
-                    label = getI18n(`vxe.gantt.dayss.w${dateObj.e}`)
-                  } else {
-                    label = getI18n(`vxe.gantt.${!$rowIndex && headerGroups.length > 1 ? 'tFullFormat' : 'tSimpleFormat'}.${type}`, dateObj)
-                  }
+                if (scaleItem.type === 'day') {
+                  label = getI18n(`vxe.gantt.dayss.w${dateObj.e}`)
                 } else {
-                  if (isLast && scaleItem.type === 'week') {
+                  if ($rowIndex) {
                     label = getI18n(`vxe.gantt.tSimpleFormat.${type}`, dateObj)
+                  } else {
+                    if (isLast && scaleItem.type === 'week') {
+                      label = getI18n(`vxe.gantt.tSimpleFormat.${type}`, dateObj)
+                    } else {
+                      label = getI18n(`vxe.gantt.tFullFormat.${type}`, dateObj)
+                    }
                   }
                 }
                 let cellVNs: string | VxeComponentSlotType[] = label

package/packages/gantt/src/gantt-view.ts

@@ -197,7 +197,7 @@ function handleColumnHeader ($xeGanttView: VxeGanttViewConstructor & VxeGanttVie
       if (minScale.level < 17) {
         handleData('quarter', colMaps, minCol)
       }
-      if (minScale.level < 14) {
+      if (minScale.level < 15) {
         handleData('month', colMaps, minCol)
       }
       if (minScale.level < 13) {
@@ -206,7 +206,7 @@ function handleColumnHeader ($xeGanttView: VxeGanttViewConstructor & VxeGanttVie
       if (minScale.level < 11) {
         handleData('day', colMaps, minCol)
       }
-      if (minScale.level < 12) {
+      if (minScale.level < 9) {
         handleData('date', colMaps, minCol)
       }
       if (minScale.level < 7) {
@@ -215,6 +215,9 @@ function handleColumnHeader ($xeGanttView: VxeGanttViewConstructor & VxeGanttVie
       if (minScale.level < 5) {
         handleData('minute', colMaps, minCol)
       }
+      if (minScale.level < 3) {
+        handleData('second', colMaps, minCol)
+      }
 
       fullCols.push(minCol)
     }

package/packages/gantt/src/gantt.ts

@@ -2,7 +2,7 @@ import { PropType, VNode, CreateElement, Component } from 'vue'
 import { defineVxeComponent } from '../../ui/src/comp'
 import { VxeUI } from '@vxe-ui/core'
 import XEUtils from 'xe-utils'
-import { getLastZIndex, nextZIndex, isEnableConf } from '../../ui/src/utils'
+import { getLastZIndex, nextZIndex, isEnableConf, formatText } from '../../ui/src/utils'
 import { getOffsetHeight, getPaddingTopBottomSize, getDomNode, toCssUnit, addClass, removeClass } from '../../ui/src/dom'
 import { getSlotVNs } from '../../ui/src/vn'
 import { warnLog, errLog } from '../../ui/src/log'
@@ -10,7 +10,7 @@ import GanttViewComponent from './gantt-view'
 import { VxeTable as VxeTableComponent } from 'vxe-table'
 
 import type { ValueOf, VxeFormInstance, VxeFormItemProps, VxePagerInstance, VxePagerDefines, VxeComponentStyleType, VxeComponentSizeType, VxeFormDefines, VxeFormItemPropTypes } from 'vxe-pc-ui'
-import type { VxeTableMethods, VxeToolbarPropTypes, VxeTableProps, VxeTableConstructor, VxeTablePrivateMethods, VxeTableDefines, TableReactData, VxeToolbarInstance, TableInternalData, VxeTablePropTypes, VxeGridPropTypes, VxeGridDefines } from 'vxe-table'
+import type { VxeTableMethods, VxeToolbarPropTypes, VxeTooltipInstance, VxeTableProps, VxeTableConstructor, VxeTablePrivateMethods, VxeTableDefines, TableReactData, VxeToolbarInstance, TableInternalData, VxeTablePropTypes, VxeGridPropTypes, VxeGridDefines } from 'vxe-table'
 import type { VxeGanttEmits, GanttReactData, GanttInternalData, VxeGanttPropTypes, VxeGanttViewInstance, VxeGanttDefines, VxeGanttConstructor } from '../../../types'
 
 const { getConfig, getIcon, getI18n, commands, globalMixins, createEvent, globalEvents, GLOBAL_EVENT_KEYS, renderEmptyElement } = VxeUI
@@ -78,6 +78,7 @@ function createInternalData (): GanttInternalData {
   return {
     uFoot: false,
     resizeTableWidth: 0
+    // barTipTimeout: undefined
   }
 }
 
@@ -120,6 +121,7 @@ export default /* define-vxe-component start */ defineVxeComponent({
     taskViewScaleConfig: Object as PropType<VxeGanttPropTypes.TaskViewScaleConfig>,
     taskViewConfig: Object as PropType<VxeGanttPropTypes.TaskViewConfig>,
     taskBarConfig: Object as PropType<VxeGanttPropTypes.TaskBarConfig>,
+    taskBarTooltipConfig: Object as PropType<VxeGanttPropTypes.TaskBarTooltipConfig>,
     taskSplitConfig: Object as PropType<VxeGanttPropTypes.TaskSplitConfig>,
     taskBarResizeConfig: Object as PropType<VxeGanttPropTypes.TaskBarResizeConfig>,
     taskBarDragConfig: Object as PropType<VxeGanttPropTypes.TaskBarDragConfig>,
@@ -157,7 +159,14 @@ export default /* define-vxe-component start */ defineVxeComponent({
       },
       showLeftView: true,
       showRightView: true,
-      taskScaleList: []
+      taskScaleList: [],
+
+      barTipStore: {
+        row: null,
+        content: '',
+        visible: false,
+        params: null
+      }
     }
 
     const internalData = createInternalData()
@@ -256,6 +265,12 @@ export default /* define-vxe-component start */ defineVxeComponent({
 
       return Object.assign({}, getConfig().gantt.taskSplitConfig, props.taskSplitConfig)
     },
+    computeTaskBarTooltipOpts () {
+      const $xeGantt = this
+      const props = $xeGantt
+
+      return Object.assign({}, getConfig().gantt.taskBarTooltipConfig, props.taskBarTooltipConfig)
+    },
     computeScaleUnit () {
       const $xeGantt = this
 
@@ -276,13 +291,20 @@ export default /* define-vxe-component start */ defineVxeComponent({
       const { taskScaleList } = reactData
       return taskScaleList.find(item => item.type === 'week')
     },
-    computeTaskScaleConfs () {
+    computeTaskViewScales () {
       const $xeGantt = this
 
       const taskViewOpts = $xeGantt.computeTaskViewOpts as VxeGanttPropTypes.TaskViewConfig
       const { scales } = taskViewOpts
       return scales
     },
+    /**
+     * 已废弃，保留兼容
+     * @deprecated
+     */
+    computeTaskScaleConfs () {
+      return this.computeTaskViewScales
+    },
     computeTitleField () {
       const $xeGantt = this
 
@@ -550,7 +572,7 @@ export default /* define-vxe-component start */ defineVxeComponent({
 
       $xeGantt.initProxy()
     },
-    computeTaskScaleConfs () {
+    computeTaskViewScales () {
       const $xeGantt = this
 
       $xeGantt.handleTaskScaleConfig()
@@ -568,7 +590,7 @@ export default /* define-vxe-component start */ defineVxeComponent({
       const $xeGantt = this
       const reactData = $xeGantt.reactData
 
-      const taskScaleConfs = $xeGantt.computeTaskScaleConfs
+      const taskScaleConfs = $xeGantt.computeTaskViewScales
       const taskViewScaleOpts = $xeGantt.computeTaskViewScaleOpts
       const scaleConfs: VxeGanttDefines.ColumnScaleObj[] = []
       if (taskScaleConfs) {
@@ -1712,6 +1734,28 @@ export default /* define-vxe-component start */ defineVxeComponent({
       reactData.showRightView = false
       return $xeGantt.$nextTick()
     },
+    /**
+       * 关闭 bar tooltip
+       */
+    closeTaskBarTooltip () {
+      const $xeGantt = this
+      const reactData = $xeGantt.reactData
+
+      const { barTipStore } = reactData
+      const $tooltip = $xeGantt.$refs.refTooltip as VxeTooltipInstance
+      if (barTipStore.visible) {
+        Object.assign(barTipStore, {
+          row: null,
+          content: null,
+          visible: false,
+          params: {}
+        })
+        if ($tooltip && $tooltip.close) {
+          $tooltip.close()
+        }
+      }
+      return $xeGantt.$nextTick()
+    },
     callSlot (slotFunc: any, params: any, h: CreateElement) {
       const $xeGantt = this
       const slots = $xeGantt.$scopedSlots
@@ -1846,6 +1890,75 @@ export default /* define-vxe-component start */ defineVxeComponent({
 
       $xeGantt.dispatchEvent('task-bar-dblclick', params, evnt)
     },
+    triggerTaskBarTooltipEvent (evnt: MouseEvent, params: VxeGanttDefines.TaskBarMouseoverParams) {
+      const $xeGantt = this
+      const reactData = $xeGantt.reactData
+
+      const { barTipStore } = reactData
+      const taskBarTooltipOpts = $xeGantt.computeTaskBarTooltipOpts
+      const titleField = $xeGantt.computeTitleField
+      const { contentMethod } = taskBarTooltipOpts
+      const { row } = params
+      let content = formatText(XEUtils.get(row, titleField))
+      if (contentMethod) {
+        const customContnet = contentMethod(params)
+        if (!XEUtils.eqNull(customContnet)) {
+          content = `${customContnet}`
+        }
+      }
+      $xeGantt.handleTargetEnterEvent(barTipStore.row !== row)
+      const tipContent = formatText(content)
+      Object.assign(barTipStore, {
+        row,
+        visible: true,
+        content: tipContent,
+        params
+      })
+      $xeGantt.$nextTick(() => {
+        const $tooltip = $xeGantt.$refs.refTooltip as VxeTooltipInstance
+        if ($tooltip) {
+          if ($tooltip.openByEvent) {
+            $tooltip.openByEvent(evnt, evnt.currentTarget, tipContent)
+          } else if ($tooltip.open) {
+            $tooltip.open(evnt.currentTarget, tipContent)
+          }
+        }
+      })
+    },
+    handleTargetEnterEvent (isClear: boolean) {
+      const $xeGantt = this
+      const internalData = $xeGantt.internalData
+
+      const $tooltip = $xeGantt.$refs.refTooltip as VxeTooltipInstance
+      clearTimeout(internalData.barTipTimeout)
+      if (isClear) {
+        $xeGantt.closeTaskBarTooltip()
+      } else {
+        if ($tooltip && $tooltip.setActived) {
+          $tooltip.setActived(true)
+        }
+      }
+    },
+    handleTaskBarTooltipLeaveEvent () {
+      const $xeGantt = this
+      const internalData = $xeGantt.internalData
+
+      const taskBarTooltipOpts = $xeGantt.computeTaskBarTooltipOpts
+      let $tooltip = $xeGantt.$refs.refTooltip as VxeTooltipInstance
+      if ($tooltip && $tooltip.setActived) {
+        $tooltip.setActived(false)
+      }
+      if (taskBarTooltipOpts.enterable) {
+        internalData.barTipTimeout = setTimeout(() => {
+          $tooltip = $xeGantt.$refs.refTooltip as VxeTooltipInstance
+          if ($tooltip && $tooltip.isActived && !$tooltip.isActived()) {
+            $xeGantt.closeTaskBarTooltip()
+          }
+        }, taskBarTooltipOpts.leaveDelay)
+      } else {
+        $xeGantt.closeTaskBarTooltip()
+      }
+    },
     handleTaskHeaderContextmenuEvent (evnt: Event, params: VxeGanttDefines.TaskHeaderContextmenuParams) {
       const $xeGantt = this
       const $xeTable = $xeGantt.$refs.refTable as VxeTableConstructor & VxeTablePrivateMethods
@@ -2356,13 +2469,19 @@ export default /* define-vxe-component start */ defineVxeComponent({
       return childVNs
     },
     renderLayout (h: CreateElement) {
+      const VxeUITooltipComponent = VxeUI.getComponent('VxeTooltip')
+
       const $xeGantt = this
+      const reactData = $xeGantt.reactData
       const slots = $xeGantt.$scopedSlots
 
+      const { barTipStore } = reactData
       const currLayoutConf = $xeGantt.computeCurrLayoutConf
       const { headKeys, bodyKeys, footKeys } = currLayoutConf
+      const taskBarTooltipOpts = $xeGantt.computeTaskBarTooltipOpts
       const asideLeftSlot = slots.asideLeft || slots['aside-left']
       const asideRightSlot = slots.asideRight || slots['aside-right']
+      const taskBarTooltipSlot = slots.taskBarTooltip || slots['task-bar-tooltip']
       return [
         h('div', {
           class: 'vxe-gantt--layout-header-wrapper'
@@ -2389,7 +2508,42 @@ export default /* define-vxe-component start */ defineVxeComponent({
         }, $xeGantt.renderChildLayout(h, footKeys)),
         h('div', {
           ref: 'refPopupContainerElem'
-        })
+        }),
+        h('div', {}, [
+        /**
+          * 任务条提示
+          */
+          h(VxeUITooltipComponent, {
+            key: 'gtp',
+            ref: 'refTooltip',
+            props: {
+              theme: taskBarTooltipOpts.theme,
+              enterable: taskBarTooltipOpts.enterable,
+              enterDelay: taskBarTooltipOpts.enterDelay,
+              leaveDelay: taskBarTooltipOpts.leaveDelay,
+              useHTML: taskBarTooltipOpts.useHTML,
+              width: taskBarTooltipOpts.width,
+              height: taskBarTooltipOpts.height,
+              minWidth: taskBarTooltipOpts.minWidth,
+              minHeight: taskBarTooltipOpts.minHeight,
+              maxWidth: taskBarTooltipOpts.maxWidth,
+              maxHeight: taskBarTooltipOpts.maxHeight,
+              isArrow: false
+            },
+            scopedSlots: taskBarTooltipSlot
+              ? {
+                  content: () => {
+                    const { row, content: tooltipContent } = barTipStore
+                    if (row) {
+                      return h('div', {
+                      }, taskBarTooltipSlot(Object.assign({ tooltipContent, $gantt: $xeGantt }, barTipStore.params)))
+                    }
+                    return renderEmptyElement($xeGantt)
+                  }
+                }
+              : {}
+          })
+        ])
       ]
     },
     renderVN (h: CreateElement): VNode {

package/packages/ui/index.ts

@@ -43,6 +43,9 @@ setConfig({
       // beforeSave: null,
       // afterSave: null
     },
+    taskBarTooltipConfig: {
+      enterable: true
+    },
     taskViewScaleConfig: {
       week: {
         startDay: 1

package/packages/ui/src/utils.ts

@@ -8,6 +8,10 @@ export function isEnableConf (conf: any): boolean {
   return conf && conf.enabled !== false
 }
 
+export function isEmptyValue (cellValue: any) {
+  return cellValue === null || cellValue === undefined || cellValue === ''
+}
+
 export function nextZIndex () {
   return DomZIndex.getNext()
 }
@@ -39,6 +43,10 @@ export function getFuncText (content: string | number | boolean | null | undefin
   return ''
 }
 
+export function formatText (value: any, placeholder?: any) {
+  return '' + (isEmptyValue(value) ? (placeholder ? VxeUI.getConfig().emptyCell : '') : value)
+}
+
 /**
  * 判断值为：'' | null | undefined 时都属于空值
  */