vue+elemen實現(xiàn)el-tooltip在文本超出區(qū)域后浮現(xiàn)

更新時間：2023年12月20日 11:48:23 作者：sgabon

el-tooltip組件本身就是懸浮提示功能,在對它進行二次封裝時,實現(xiàn)超出的文本浮現(xiàn),本文就來介紹一下vue+elemen實現(xiàn)el-tooltip在文本超出區(qū)域后浮現(xiàn),感興趣的可以了解一下

前言

最近在做一個vue+element的項目，遇到的一些難搞的需求。
關于<el-tooltip>的使用想必也不用我多說了，官方文檔是相當?shù)脑敿殻臼褂米约喝ヰI了么官網(wǎng)看。

具體需求

由于我的內容是循環(huán)生成的，字體的多少，并不是一個定值，如果僅使用官方的<el-tooltip>組件的話，豈不是包著的每一個div都會有這個tooltip，結果導致一整個頁面的tooltip，體驗特別不好。而且整個頁面生成了上百個<el-tooltip>標簽，占用了大量的資源。

解決方案

方案一

剛開始在網(wǎng)上翻找解決方案，找到一個別人將tooltip組件二次封裝，好用確實是好用，但是同樣會生成大量的tooltip標簽，遂放棄。

方案二

后來，我想到了一個我用過的表格屬性——:show-overflow-tooltip=“true”——在表格組件中，某一個單元格中的內容超過了該單列的列寬，會隱藏多余部分，通過…展示。并且將鼠標移入即可查看該單元格內的完整內容。效果如圖：

效果展示

而鼠標放到文字沒超出列寬的地方則不顯示 tooltip，神奇的是，整個頁面，只生成了一個<el-tooltip>標簽，無論有多少內容，永遠只有一個<el-tooltip>存在，大大節(jié)省了資源。于是翻看源碼看他是怎么實現(xiàn)該功能的。

表格的tooltip屬性

具體方法

1.先在頁面上定義一個tooltip標簽

<el-tooltip ref="tooltip" :content="tooltipContent" />

此標簽就是要在頁面中生成的那個唯一的<el-tooltip>標簽。

2.在文字區(qū)域的父標簽上添加鼠標移入移除方法

					   <div
                           class="card-carousel--card--footer"
                           @mouseenter="handleDivMouseEnter($event)"
                           @mouseleave="handleDivMouseleave($event)"
                         >
                           <p class="topicStyle"> {{ info } </p>
	                   </div>

前提是：承載內容的標簽需要有一個class。若要在組件標簽上添加方法，應該是要添加【.native】的。

3.引入需要的方法

import debounce from 'throttle-debounce/debounce'
import { getStyle } from '@/utils/dom.js

在created中添加

created() {
     this.activateTooltip = debounce(50, tooltip =&gt; tooltip.handleShowPopper())
},

此處getStyle方法是自動計算邊距，我將源碼中的js提出來，方便使用。
源碼位置：\element-dev\packages\table\src\table-body.js

4.在methods添加鼠標移入移出方法

// 鼠標移入
handleDivMouseEnter(event) {
        const target = event.target
        // 判斷是否text-overflow, 如果是就顯示tooltip
        let child = target.querySelector('.groupItemClass')
	    // 在此處我一共有三個class控制三塊class，這一塊主要是對<el-menu>以及文本區(qū)域控制，所以class要有多個。
        // 如果區(qū)域寬度被限定，則通過高度判斷
        let heightFlag = false
        if (!child) {
          child = target.querySelector('.setItemClass')
          if (!child) {
            // 文本區(qū)域 
            child = target.querySelector('.topicStyle')
          }
        }
        if (child.scrollHeight > child.offsetHeight) {
            heightFlag = true
        }
        // use range width instead of scrollWidth to determine whether the text is overflowing
        // to address a potential FireFox bug: https://bugzilla.mozilla.org/show_bug.cgi?id=1074543#c3
        const range = document.createRange()
        range.setStart(child, 0)
        range.setEnd(child, child.childNodes.length)
        const rangeWidth = range.getBoundingClientRect().width // 文本區(qū)域寬度
        const padding = (parseInt(getStyle(target, 'paddingLeft'), 10) || 0) +
          (parseInt(getStyle(target, 'paddingRight'), 10) || 0)
        if ((rangeWidth + padding > target.offsetWidth || child.scrollWidth > child.offsetWidth) || heightFlag && this.$refs.tooltip) {
          const tooltip = this.$refs.tooltip
          // TODO 會引起整個 Table 的重新渲染，需要優(yōu)化
          this.tooltipContent = target.innerText || target.textContent
          tooltip.referenceElm = target
          tooltip.$refs.popper && (tooltip.$refs.popper.style.display = 'none')
          tooltip.doDestroy()
          tooltip.setExpectedState(true)
          this.activateTooltip(tooltip)
        }
      }
      
// 鼠標移出  
handleDivMouseleave(event) {
        const tooltip = this.$refs.tooltip
        if (tooltip) {
          tooltip.setExpectedState(false)
          tooltip.handleClosePopper()
        }
      },