vue3中实现文本显示省略号和tooltips提示框

本文主要是介绍vue3中实现文本显示省略号和tooltips提示框,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

前言

在 B 端业务中,我们经常会遇到文本内容超出容器区域需显示省略号的需求。当鼠标移入文本时,会出现 Tooltip 显示完整内容。最近,我也遇到了这样的场景。为了提高业务通用性,我已将其封装为组件、Hook 和指令等形式供使用。

使用方式

npm install vue-ellipsis-tooltip --save

技术细节

如何判断文本超出了父容器

  1. 首先创建一个空白的 div,将当前父元素的样式全部复制到这个 div 上。将全部文字填充到空白 div 中,获取当前全部文案的高度。然后使用定位和层级使其在当前屏幕上不可见。
  2. 通过二分法,递归地找出期望目标元素的行数的高度(lineHeight * rows)所能容纳的最大字符串数量。

image.png

基础的伪代码如下:
代码地址

export const getEllipsisText = (parentNode: HTMLElement, fullText: string, maxHeight: number) => {const ellipsisContainer = createMeasureContainer(parentNode)ellipsisContainer.innerHTML = ""const textNode = document.createTextNode(fullText)ellipsisContainer.appendChild(textNode)// 检查当前文本是否满足高度条件function inRange() {return ellipsisContainer.offsetHeight <= maxHeight}if (inRange()) {return {ellipsis: false,text: fullText}}// 寻找最多的文字function measureText(startLoc = 0, endLoc = fullText.length, lastSuccessLoc = 0) {if (startLoc > endLoc) {// 找到满足条件的最长文本,清理并返回结果const finalText = fullText.slice(0, lastSuccessLoc) + "..."return {ellipsis: true,text: finalText}// return finalText}const midLoc = Math.floor((startLoc + endLoc) / 2)textNode.textContent = fullText.slice(0, midLoc) + "..."if (inRange()) {return measureText(midLoc + 1, endLoc, midLoc)} else {return measureText(startLoc, midLoc - 1, lastSuccessLoc)}}return measureText()
}
  • 时间复杂度主要取决于 measureText 函数,它使用二分查找法来确定满足条件的最长文本。二分查找的时间复杂度是 O(log n),其中 n 是字符串 fullText 的长度。在这个过程中,每一步都会将搜索范围减半,直到找到最合适的文本长度。
  • 空间复杂度由于 measureText 使用了递归调用,空间复杂度受到递归深度的影响。在最坏的情况下,递归深度与二分查找的步骤数相同,即 O(log n)

创建ToolTip弹窗

ToolTip主要是通过@popperjs/core进行实现

  • 代码地址

怎么使用

例子

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Document</title><link rel="stylesheet" href="./style.css"><style>.wrapper{margin: 0 auto;}</style><script src="https://cdn.bootcdn.net/ajax/libs/vue/3.3.4/vue.cjs.prod.min.js"></script><script src="./vEllipsis.js"></script>
</head>
<body><div id="app"><div class="wrapper" :style="{ width: '200px' }"><span  v-ellipsis="{ rows: 1, text: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaazzzzzzzzzz' }" /></div><div class="wrapper" :style="{ width: `200px` }"><vue-ellipsis-tooltip :rows="3" text=" A design is a plan or specification for the" /></div></div><script>const App = {data() {return {message: "Hello Element Plus",};},};const app = Vue.createApp(App);app.use(vEllipsis);app.mount("#app");</script>
</body>
</html>

组件形式

<template><div class="wrapper" :style="{ width: `${width}px` }"><vue-ellipsis-tooltip:rows="options.rows":text="options.text":poperOptions="{effect: 'light'}"/></div>
</template><script setup lang="ts">
import { ref } from "vue"
import {vue-ellipsis-tooltip} from "vue-ellipsis-tooltip"
const options = ref({rows: 1,text: "你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好"
})const width = ref(200)
</script>

指令形式

<template><div class="wrapper" :style="{ width: `${width}px` }"><span ref="targetRef" v-ellipsis="{ rows: options.rows, text: options.text }" /></div>
</template><script setup lang="ts">
import { ref } from "vue"
const options = ref({rows: 1,text: "你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好"
})const width = ref(200)
</script>

hook形式

<template><div class="wrapper" :style="{ width: `${width}px` }"  ref="wrapperRef"><span ref="targetRef" /></div>
</template><script setup lang="ts">
import { useEllipsis } from "vue-ellipsis-tooltip"
import { ref } from "vue"
const targetRef = ref()
const width = ref(200)
const options = ref({rows: 1,text: "你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好"
})
useEllipsis(targetRef, options.value, {effect: "dark"
})
</script>

在vite中使用

main.ts

import { createApp } from 'vue'
import "vue-ellipsis-tooltip/dist/style.css"
import vEllipsis from "vue-ellipsis-tooltip"
import App from './App.vue'
const app = createApp(App)
app.use(vEllipsis)
app.mount('#app')

Attributes

名称说明类型默认值
rows显示省略的行数number1
showTooltip配置省略时的弹出框booleanfalse
text显示的内容string‘’
disabled是否禁用booleanfalse

poperOptions(弹出窗属性)

名称说明类型默认值
effect主题dark / lightdark
teleported是否插入bodybooleanfalse
showArrow是否显示箭头booleantrue
popperClass弹出窗类名string‘’
offset出现位置的偏移量number12
showAfter在触发后多久显示内容,单位毫秒number0
hideAfter延迟关闭,单位毫秒number200
placementTooltip 组件出现的位置enum‘bottom’
zIndex弹窗层级number1024
popperOptionspopper.js 参数object{}

总结

该组件提供了一个灵活且易于集成的方式,以满足B端业务中处理文本溢出显示和Tooltip提示的需求,同时降低了开发成本并提高了用户体验。

Vue-Ellipsis

这篇关于vue3中实现文本显示省略号和tooltips提示框的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/873588

相关文章

Python使用python-can实现合并BLF文件

《Python使用python-can实现合并BLF文件》python-can库是Python生态中专注于CAN总线通信与数据处理的强大工具,本文将使用python-can为BLF文件合并提供高效灵活... 目录一、python-can 库:CAN 数据处理的利器二、BLF 文件合并核心代码解析1. 基础合

Python使用OpenCV实现获取视频时长的小工具

《Python使用OpenCV实现获取视频时长的小工具》在处理视频数据时,获取视频的时长是一项常见且基础的需求,本文将详细介绍如何使用Python和OpenCV获取视频时长,并对每一行代码进行深入解析... 目录一、代码实现二、代码解析1. 导入 OpenCV 库2. 定义获取视频时长的函数3. 打开视频文

golang版本升级如何实现

《golang版本升级如何实现》:本文主要介绍golang版本升级如何实现问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录golanwww.chinasem.cng版本升级linux上golang版本升级删除golang旧版本安装golang最新版本总结gola

SpringBoot中SM2公钥加密、私钥解密的实现示例详解

《SpringBoot中SM2公钥加密、私钥解密的实现示例详解》本文介绍了如何在SpringBoot项目中实现SM2公钥加密和私钥解密的功能,通过使用Hutool库和BouncyCastle依赖,简化... 目录一、前言1、加密信息(示例)2、加密结果(示例)二、实现代码1、yml文件配置2、创建SM2工具

Mysql实现范围分区表(新增、删除、重组、查看)

《Mysql实现范围分区表(新增、删除、重组、查看)》MySQL分区表的四种类型(范围、哈希、列表、键值),主要介绍了范围分区的创建、查询、添加、删除及重组织操作,具有一定的参考价值,感兴趣的可以了解... 目录一、mysql分区表分类二、范围分区(Range Partitioning1、新建分区表:2、分

MySQL 定时新增分区的实现示例

《MySQL定时新增分区的实现示例》本文主要介绍了通过存储过程和定时任务实现MySQL分区的自动创建,解决大数据量下手动维护的繁琐问题,具有一定的参考价值,感兴趣的可以了解一下... mysql创建好分区之后,有时候会需要自动创建分区。比如,一些表数据量非常大,有些数据是热点数据,按照日期分区MululbU

MySQL中查找重复值的实现

《MySQL中查找重复值的实现》查找重复值是一项常见需求,比如在数据清理、数据分析、数据质量检查等场景下,我们常常需要找出表中某列或多列的重复值,具有一定的参考价值,感兴趣的可以了解一下... 目录技术背景实现步骤方法一:使用GROUP BY和HAVING子句方法二:仅返回重复值方法三:返回完整记录方法四:

IDEA中新建/切换Git分支的实现步骤

《IDEA中新建/切换Git分支的实现步骤》本文主要介绍了IDEA中新建/切换Git分支的实现步骤,通过菜单创建新分支并选择是否切换,创建后在Git详情或右键Checkout中切换分支,感兴趣的可以了... 前提:项目已被Git托管1、点击上方栏Git->NewBrancjsh...2、输入新的分支的

Python实现对阿里云OSS对象存储的操作详解

《Python实现对阿里云OSS对象存储的操作详解》这篇文章主要为大家详细介绍了Python实现对阿里云OSS对象存储的操作相关知识,包括连接,上传,下载,列举等功能,感兴趣的小伙伴可以了解下... 目录一、直接使用代码二、详细使用1. 环境准备2. 初始化配置3. bucket配置创建4. 文件上传到os

关于集合与数组转换实现方法

《关于集合与数组转换实现方法》:本文主要介绍关于集合与数组转换实现方法,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1、Arrays.asList()1.1、方法作用1.2、内部实现1.3、修改元素的影响1.4、注意事项2、list.toArray()2.1、方