使用JavaScript实现文本收起展开(省略)功能
作者:猫头_
省略号,作为一种常见的文本处理方式,在很多情况下都十分常见。特别是当我们需要在省略号后面添加额外文字时,这种需求更是不少见。
然而,仅仅依赖 CSS 来实现兼容性、流畅的文本省略效果是不现实的。就拿 Vant4 的 TextEllipsis 文本省略功能来说,我们可以从中学到不少。
参考Vant4:TextEllipsis 文本省略,为大家分析一波案例(感觉麻烦可以去看下面的附带代码)。
在整个代码中,关键之处在于使用了 tail、middleTail 等关键手段。我们着重讨论 tail,即在文本尾部插入内容的操作。
简单的CSS隐藏
大家或多或少都曾编写过 CSS 省略文本的代码。比如,要将文本限制在四行内显示,可以使用以下 CSS 代码:
隐藏为四行
overflow: hidden; display: -webkit-box; -webkit-box-orient: vertical; -webkit-line-clamp: 4; /* 控制显示行数 */
其中的限制
尽管如此,这种方法有着一定的局限性:
- 如何在省略号后添加展开、收起等文字?
- 添加后,如何保证文字与省略号在同一行?
- 展开后,如何保证文字在合适位置显示?
纯 CSS 可以实现这些效果,但实际操作起来会比较困难。
既然 CSS 不够理想,我们可以考虑使用 JavaScript 来实现这些功能。
首先,让我们来分析一波:
- 收起时保留的高度是多少?
- 如何截取超出高度的文字内容?
- 如何确保截取后的文字内容不影响原来的渲染和展示?
完成以上三点,我们就完成了任务。
开始分析
<div class="root"> 散文是一种文学形式,与之相对的称为韵文或诗文。散文可分为广义与狭义的解释,其中,广义散文最容易辨识与定义的方式,是“松散”的结构。也就是说,扣除其它文学形式重叠部分,运用普通语法结构,不讲究音韵,不讲究排比,没有任何束缚及限制的文字梳理方式,都可称为散文。除此,狭义散文是单指文学范畴内,结构松散之非韵文作品。文学专指的散文,历代作品有着各时代不同流变的脉络,而正因为松散带来的自由,散文作品表达出的思想通常有着丰富与圆满的特色 </div>
<style> .root { line-height: 1.6; overflow-wrap: break-word; word-break: break-all; } </style>
首先解决:收起时要保留的高度是多少?
假设我们保留4行:
需要给予文本限高 : line-height: 1.6;
row = 4 const maxHeight = Math.ceil( (Number(rows) + 0.5) * pxToNum(lineHeight) + "一些其他的容器高度:比如padding" );
在这个计算中,0.5 是一个调整值,用于在计算最大高度时考虑到文本行数的不确定性。这个调整值的目的是为了确保即使行数计算稍微超过了预期的行数,也能够提前截断文本,以防止文本超出容器的高度限制。
得到了高度,如何切割文字
注意看:tail()
函数是一个递归函数,用于在给定的容器高度限制下,计算文本的截断位置。让我来详细解释一下 tail()
函数的工作原理:
const tail = (left, right) => { if (right - left <= 1) { return content.slice(0, left) + dots; } const middle = Math.round((left + right) / 2); container.innerText = content.slice(0, middle) + dots + actionText; if (container.offsetHeight > maxHeight) { return tail(left, middle); } return tail(middle, right); }; container.innerText = tail(0, end);
当递归结束时,函数会返回最终的截断位置,即最佳的截断位置。
递归都有自己结束判断,这个递归的结束点就在right - left <= 1
,
计算中间位置 middle
,并将文本内容从左边界到中间位置加上省略符号,然后设置到容器元素中
检查容器元素的高度是否超过了指定的最大高度限制。如果超过了,说明当前截断位置过早,需要继续向左边界靠近进行截断;否则,说明当前截断位置过晚,需要继续向右边界靠近进行截断。
最终找到,合适的middle值,在一起返回 content.slice(0, left) + dots
作为结点的 innerText
文字。
期间,一直在收缩,就算高度相同也在收缩右边界的内容, right - left <= 1
的作用就是刚刚好实现的截断位置以满足给定的最大高度限制,不会超出限制。
总结:这个 tail()
函数使用递归的方式,根据给定的容器高度限制,计算出文本的截断位置。递归的结束判断在 right - left <= 1
,通过不断调整 middle
的值,最终找到合适的截断位置以满足给定的最大高度限制,不会超出限制。
在切割下,保证文字内容不影响原来的渲染展示
为了不影响原文本的渲染展示,我们使用了克隆节点的方式。这里参考了 Vant 中的代码,并做了适当修改。
修改成了,更加适合JS宝宝体质的代码。
const rootNode = document.querySelector(".root"); const cloneContainer = () => { // cloneContainer就是为了得到文本的高度 if (!rootNode || !rootNode.isConnected) return; const originStyle = window.getComputedStyle(rootNode); const container = document.createElement('div'); const styleNames= Array.prototype.slice.apply(originStyle); styleNames.forEach((name) => { container.style.setProperty(name, originStyle.getPropertyValue(name)); }); container.style.position = 'fixed'; // 不在文档流中 container.style.zIndex = '-9999'; // 看不到 container.style.top = '-9999px'; // 看不到 container.style.height = 'auto'; container.style.minHeight = 'auto'; container.style.maxHeight = 'auto'; container.innerText = content; document.body.appendChild(container); return container; };
解析:window.getComputedStyle
是一个用于获取指定元素的所有计算样式的方法。它返回一个 CSSStyleDeclaration
对象,其中包含了指定元素的所有计算样式属性及其对应的值。
实现效果
实例代码
html
<style> .root { padding: 12px; line-height: 1.6; overflow-wrap: break-word; word-break: break-all; } </style> <body> <div class="root"> 散文是一种文学形式,与之相对的称为韵文或诗文。散文可分为广义与狭义的解释,其中,广义散文最容易辨识与定义的方式,是“松散”的结构。也就是说,扣除其它文学形式重叠部分,运用普通语法结构,不讲究音韵,不讲究排比,没有任何束缚及限制的文字梳理方式,都可称为散文。除此,狭义散文是单指文学范畴内,结构松散之非韵文作品。文学专指的散文,历代作品有着各时代不同流变的脉络,而正因为松散带来的自由,散文作品表达出的思想通常有着丰富与圆满的特色 </div> </body> <script src="TextEllipsis.js"> </script>
JS代码
document.addEventListener("DOMContentLoaded", function() { let expanded =true; let collapseText = "收起"; let expandText = "展开"; const rows = 3; let actionText = expanded ? collapseText : expandText; let hasAction = false; const rootNode = document.querySelector(".root"); const content = rootNode.innerText; let text = ""; const dots = "..."; const pxToNum = (value) => { if (!value) return 0; const match = value.match(/^\d*(\.\d*)?/); return match ? Number(match[0]) : 0; }; const cloneContainer = () => { // cloneContainer就是为了得到文本的高度 if (!rootNode || !rootNode.isConnected) return; const originStyle = window.getComputedStyle(rootNode); const container = document.createElement('div'); const styleNames= Array.prototype.slice.apply(originStyle); styleNames.forEach((name) => { container.style.setProperty(name, originStyle.getPropertyValue(name)); }); container.style.position = 'fixed'; container.style.zIndex = '-9999'; container.style.top = '-9999px'; container.style.height = 'auto'; container.style.minHeight = 'auto'; container.style.maxHeight = 'auto'; container.innerText = content; document.body.appendChild(container); return container; }; const calcEllipsised = () => { const calcEllipsisText = ( container, maxHeight ) => { const end = content.length; const calcEllipse = () => { const tail = (left, right) => { if (right - left <= 1) { return content.slice(0, left) + dots; } const middle = Math.round((left + right) / 2); container.innerText = content.slice(0, middle) + dots + actionText; if (container.offsetHeight > maxHeight) { return tail(left, middle); } return tail(middle, right); }; container.innerText = tail(0, end); }; calcEllipse(); return container.innerText; }; const container = cloneContainer(); if (!container) { needRecalculate = true; return; } let { paddingBottom, paddingTop, lineHeight } = container.style; const maxHeight = Math.ceil( (Number(rows) + 0.5) * pxToNum(lineHeight) + pxToNum(paddingTop) + pxToNum(paddingBottom), ); if (maxHeight < container.offsetHeight) { hasAction = true; text = calcEllipsisText(container, maxHeight); } else { hasAction = false; text = content; } document.body.removeChild(container); }; const toggle = (isExpanded = !expanded) => { expanded = isExpanded; actionText = expanded ? collapseText : expandText; }; const renderAction = () => { calcEllipsised(); const container = document.createElement('span'); container.classList.add("expend_txt"); container.addEventListener('click',()=>{ toggle(); container.innerText = hasAction ? actionText : null; rootNode.innerText = expanded ? content : text; rootNode.appendChild(container); }); container.innerText = hasAction ? actionText : null;; rootNode.appendChild(container); } renderAction() })
以上就是使用JavaScript实现文本收起展开(省略)功能的详细内容,更多关于JavaScript文本展开收起的资料请关注脚本之家其它相关文章!