前言
开发中,为保证界面优美,同时不影响用户体验的情况下,在各场景都会用到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;
}
优点:
- 不受限制:自定义外观和行为,使工具提示与网站或应用程序的设计完全匹配
- 提升网页性能:不依赖任何第三方库或框架,加载速度更快
缺点: 需要在文本内容过长时,增加属性会比较麻烦。
为元素增加属性的方式:
const targetElement = document.getElementsByClassName('#tooltip'); // 替换为实际选择器
targetElement.setAttribute('data-tooltip', 'Tooltip Content');
最后
如果你觉得内容有帮助的话,点点关注点点赞吧!欢迎得到反馈和共同讨论~👏