内容过长被省略时,实现多种tooltip(提示工具)的方式

2,925 阅读4分钟

前言

开发中,为保证界面优美,同时不影响用户体验的情况下,在各场景都会用到tooltip的功能。

传统的直接使用ui框架中 Tooltip 文字提示组件的方式,就不赘述了,这里只讲述一些特别的用法。(还会继续积累~)

判断内容是否超出宽度,需要显示tooltip

第一种:鼠标悬浮到内容上判断

可以使用@mouseenter方法,通过获取父元素的宽度offsetWidth(包括内容、内边距padding和边框border的宽度),与当前元素宽度做比较,若超出,则显示tooltip。

(增加setTimeout定时器可防止出现闪现) 下面是相关示例代码

<a-tooltip :visible="showTooltip" :title="item.content" placement="topLeft">
  <div class="ellipsis-item">
    <span
      @mouseenter="(e) => enterName(e)"
      @mouseleave="leaveName"
    >
      {{ item.content }}
    </span>
  </div>
</a-tooltip>
enterName(e) {
  //div父元素
  const parentWidth = e.currentTarget.parentNode.offsetWidth;
  //span子元素
  const contentWidth = e.currentTarget.offsetWidth;
  // 子元素>父元素,文字内容超出当前宽度时手动控制气泡框显示
  setTimeout(()=>{
    if (contentWidth > parentWidth) {
      this.showTooltip = true;
    }    
  }, 100)
},
leaveName(){
  setTimeout(()=>{
    this.showTooltip = false;
  }, 200)
}
.ellipsis-item {
  white-space: nowrap;
  overflow: hidden;
  text-overflow: ellipsis;
}

第二种:初始加载内容时判断

在宽度固定的情况下,比如Drawer抽屉组件或者Modal对话框组件里的内容,判断是否。(用于提前判断内容超过指定宽度被省略,并显示“详情”link的效果)

可使用getComputedStyle获取元素宽度属性。效果如下:

created() {
  if (this.detailInfo.type !== "code_editor") {
    this.$nextTick(() => {
      let element = this.$refs.detailRef;
      var keyStyle = window.getComputedStyle(element?.children[0]);
      var keyWidth = keyStyle.getPropertyValue("width"); // 获取当前元素的宽度属性
      var valStyle = window.getComputedStyle(element?.children[1]);
      var valWidth = valStyle.getPropertyValue("width");

      var widthInPixels = parseFloat(keyWidth) + parseFloat(valWidth); // 将带有单位的宽度转换为数字

      if (widthInPixels >= 407) {
        // 为true则显示“详情”link
        this.textOver = true;
      }
    });
  }
},

还可以统计字符串的长度来判断是否超过指定值,如果是汉字,则字符串长度加2,否则字符串长度加1

用 Unicode 字符范围判断:

checkLength(str){
  var length = 0;
  for(var i = 0;i < str.length; i++){
    if(str.charCodeAt(i) > 255){
      length += 2;
    }else{
      length ++;
    }
  }
  return length;
}

用 正则表达式判断:

let reg = new RegExp("[\\u4E00-\\u9FFF]+", "g")
if(reg.test(str)){
  length += 2;
}

实现显示tooltip的方式

1. 表格配置中使用HTML标签

需要实现vxe-table中,表格的表头内容过长被省略时,显示tooltip的方法,如下图所示效果:

但是在Ant Design Vue中的table组件,并没有能够直接实现tooltip的属性。 因此,要想使table组件的表头显示tooltip,可以在methods中处理列配置,根据每一列的宽度,单独处理需要显示tooltip组件的标题,适应更复杂的场景。

data() {
  return {
    // antd表格列配置的初始值
    dataTableHeaders: [
      {
        dataIndex: 'column1',
        key: 'column1',
        title: 'column1',
      },
      // ... 其他列定义
    ],
  };
},
computed: {
    // 此处需要将currentColumns动态绑定到a-table表格的columns属性上
    currentColumns() {
      return this.getColumns();
    },
},

// 此方法对antd表格列配置的初始值进行转换
getColumns(){
  let newArr = JSON.parse(JSON.stringify(this.dataTableHeaders));

  newArr = newArr.map((item) => {
    // 表头显示tooltip
    const name = item.title;
    const titleContent = name.length>13?name:''
    item.title = () => {
      return <a-tooltip placement="top">{name}
        <template slot="title">{titleContent}</template>
      </a-tooltip>
      
      // 或者使用HTML的属性title
      // <span title="这是123列的提示">123</span>
    }
    return item
  });
  return newArr
}

表格内容显示tooltip也可以在<a-table>标签里实现。

2. attr()创建纯CSS的提示工具

CSS内置函数attr() 用来获取选择到的元素的某一 HTML 属性值, 在伪元素content中用attr()获取标签中data-tooltip属性的值,再加上css动画效果,即可在鼠标悬浮时显示值的内容。

<p>
    Hover
    <span class="tooltip" data-tooltip="Tooltip Content">Here</span>
    to see the tooltip.
    <br />
    
    You can also hover
    <span class="tooltip" data-tooltip="This is another Tooltip Content"
      >here</span
    >
    to see another example.
</p>
.tooltip {
  position: relative;
  border-bottom: 1px dotted black;
}

.tooltip:before {
  content: attr(data-tooltip);
  position: absolute;
  width: 100px;
  background-color: #13c2c2;
  color: #fff;
  text-align: center;
  padding: 10px;
  line-height: 1.2;
  border-radius: 6px;
  z-index: 1;
  opacity: 0;
  transition: opacity 1s;
  bottom: 125%;
  left: 50%;
  margin-left: -60px;
  font-size: 0.75em;
  visibility: hidden;
}

.tooltip:after {
  content: "";
  position: absolute;
  bottom: 75%;
  left: 50%;
  margin-left: -5px;
  border-width: 5px;
  border-style: solid;
  opacity: 0;
  transition: opacity 1s;
  border-color: #13c2c2 transparent transparent transparent;
  visibility: hidden;
}

.tooltip:hover:before,
.tooltip:hover:after {
  opacity: 1;
  visibility: visible;
}

优点:

  1. 不受限制:自定义外观和行为,使工具提示与网站或应用程序的设计完全匹配
  2. 提升网页性能:不依赖任何第三方库或框架,加载速度更快

缺点: 需要在文本内容过长时,增加属性会比较麻烦。

为元素增加属性的方式:

const targetElement = document.getElementsByClassName('#tooltip'); // 替换为实际选择器 
targetElement.setAttribute('data-tooltip', 'Tooltip Content');

最后

如果你觉得内容有帮助的话,点点关注点点赞吧!欢迎得到反馈和共同讨论~👏