基于getClientRects()实现行内元素多行文本展开收起
一般的省略实现方式
经常会遇到多行文本省略变成...的形式的开发要求,并且基于用户体验的角度出发,还需要对于文本有对应展开与收起的操作按钮。
1.使用css属性
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
或者
overflow: hidden;
display: -webkit-box;
-webkit-box-orient: vertical;
-webkit-line-clamp: 3;
都只是实现了...的省略功能,达不到需求的目的。
2.通过js都是判断固定的长度(但是div或者span往往长度不固定)切割省略,总是会有一个字符或者两个字符留白或者部分机型刚好换行的,没有很好实现需求。
通过js切割固定的长度.png
基于getClientRects()的实现方式
1.getClientRects()的作用就是获取元素占据页面的所有矩形区域。
var rect = document.getElementById('#rect');
console.log(rect)
//bottom: 58 height: 19 left: 20 right: 330.578125 top: 39 width: 310.578125 x: 20 y: 39
返回值是ClientRect对象集合,该对象是与该元素相关的CSS边框。每个ClientRect对象包含一组描述该边框的只读属性——left、top、right和bottom,单位为像素,这些属性值是相对于视口的top-left的。即使当表格的标题在表格的边框外面,该标题仍会被计算在内。
起初,微软打算让这个方法给文本的每一行都返回一个TextRectangle,但是,CSSOM工作草案规定它应该给每个边框返回一个ClientRect。因此,对于行内元素这两个定义是相同的,但是对于块级元素,Mozilla只会返回一个矩形。(译者注:对于行内元素,元素内部的每一行都会有一个边框;对于块级元素,如果里面没有其他元素,一整块元素只有一个边框)。
2.行内元素通过getClientRects()就能获取到当前文本多少行,只要通过遍历,每次减少1个长度(br标签减少5),不断计算是否是所需要的行数即可(例如文本5行,我需要3行省略,只要让对于的span刚好是3行就可以,这样就得到一个省略的文本了)
基于jQuery的方法实现如下:
html:
<!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>完美版本的展开收起...</title>
<style>
*{margin: 0;
padding: 0;}
div {
width: 700px;
height: auto;
font-size: 14px;
color: #333;
background-color: #fafafa;
padding: 20px;
}
span.text-fold {
display: inline;
color: #4293f4;
cursor: pointer;
}
span.col-333 {
color: #333;
font-size: 14px;
line-height: 20px;
}
</style>
</head>
<body>
<div>
<span class="">春 ——朱自清:<br /></span>
<span class="break-word col-333" id="txt" style="display: inline;"
> 盼望着,盼望着,东风来了,春天的脚步近了。<br>
一切都像刚睡醒的样子,欣欣然张开了眼。山朗润起来了,水涨起来了,太阳的脸红起来了。<br>
小草偷偷地从土地里钻出来,嫩嫩的,绿绿的。园子里,田野里,瞧去,一大片一大片满是的。坐着,躺着,打两个滚,踢几脚球,赛几趟跑,捉几回迷藏。风轻悄悄的,草软绵绵的。<br>
桃树,杏树,梨树,你不让我,我不让你,都开满了花赶趟儿。红的像火,粉的像霞,白的像雪。花里带着甜味;闭了眼,树上仿佛已经满是桃儿,杏儿,梨儿。花下成千成百的蜜蜂嗡嗡的闹着,大小的蝴蝶飞来飞去。野花遍地是:杂样儿,有名字的,没名字的,散在草丛里像眼睛像星星,还眨呀眨的。<br>
“吹面不寒杨柳风”,不错的,像母亲的手抚摸着你,风里带着些新翻的泥土的气息,混着青草味儿,还有各种花的香,都在微微润湿的空气里酝酿。鸟儿将巢安在繁花嫩叶当中,高兴起来了,呼朋引伴的卖弄清脆的歌喉,唱出婉转的曲子,跟清风流水应和着。牛背上牧童的短笛,这时候也成天嘹亮的响着。<br>
雨是最寻常的,一下就是三两天。可别恼。看,像牛毛,像花针,像细丝,密密地斜织着,人家屋顶上全笼着一层薄烟。树叶却绿得发亮,小草也青得逼你的眼。傍晚时候,上灯了,一点点黄晕的光,烘托出一片安静而和平的夜。在乡下,小路上,石桥边,有撑着伞慢慢走着的人,地里还有工作的农民,披着蓑戴着笠。他们的房屋稀稀疏疏的,在雨里静默着。<br>
天上的风筝渐渐多了,地上的孩子也多了。城里乡下,家家户户,老老小小,也赶趟似的,一个个都出来了。舒活舒活筋骨,抖擞抖擞精神,各做各的一份事儿去。
“一年之计在于春”,刚起头儿,有的是功夫,有的是希望。<br>
春天像刚落地的娃娃,从头到脚都是新的,它生长着。<br>
春天像小姑娘,花枝招展的,笑着走着。<br>
春天像健壮的青年,有铁一般的胳膊和腰脚,领着我们向前去。</span
>
<script src="http://libs.baidu.com/jquery/1.11.1/jquery.min.js"></script>
<script src="../js/rectOmitText.js"></script>
<script>
$(function(){
$('#txt').rectOmitText({
line: 5,
foldText: '隐藏',
unfoldText: '更多',
foldClass: 'text-fold'
});
})
</script>
</div>
</body>
</html>
基于jquery实现的rectOmitText.js:
/*
* getClientRects()只是支持行内元素,非行内元素不支持该方法
* unfoldText 展开文本
* foldText 收起文本
* unfoldClass 展开类名
* foldClass 收起类名
* line 多少行省略
* color 默认样式颜色
*/
(function ($) {
$.fn.rectOmitText = function (options) {
if ($(this).css("display") != "inline") {
console.warn(
"该方法不支持非行内(inline)元素展开收起以及省略,!请把对应的元素转为inline元素"
);
return false;
}
var defaluts = {
unfoldText: "展开",
foldText: "收起",
unfoldClass: "",
foldClass: "",
line: 1,
color: "style='color: #2a68c9;'",
};
var opt = $.extend(defaluts, options);
var txtHtml = $(this).html(); //所有文本
var omitHtml = $(this).html(); //省略文本
var rect = $(this)[0].getClientRects(); //获取元素占据页面的所有矩形区域
console.log(rect)
var line = getLineLen(rect); //文本真实的行数
//展开显示文本
var unfold = opt.unfoldClass
? "<span>... </span><span class='rect-unfold " +
opt.unfoldClass +
"'>" +
opt.unfoldText +
"</span>"
: "<span>... </span><span " +
opt.color +
" class='rect-unfold " +
opt.unfoldClass +
"'>" +
opt.unfoldText +
"</span>";
//收起显示文本
var fold = opt.foldClass
? "<span class='rect-fold " +
opt.foldClass +
"'>" +
opt.foldText +
"</span>"
: "<span " +
opt.color +
"class='rect-fold " +
opt.foldClass +
"'>" +
opt.foldText +
"</span>";
if (line && line == 1) {
console.warn("标签文本内容只有一行,不作省略!");
return false;
}
if (opt.line >= line) {
console.warn("传入的省略行数大于文本行数,不作省略");
return false;
}
//行数大于5行,显示... 展开按钮
while (line > opt.line) {
var step = 1;
if (/<br\/>$/.test(omitHtml)) {
//回退的时候,如果碰到换行要整体替换
step = 5;
}
//每次减少文本数组最后以为参数(br标签直接减少整个br标签的长度)
omitHtml = omitHtml.slice(0, -step);
txt.innerHTML = omitHtml + unfold;
//更新行数
line = getLineLen($(this)[0].getClientRects());
if (omitHtml.length <= 0) {
//强制停止循环
break;
}
}
//展开点击
$("#txt").on("click", "span.rect-unfold", function () {
$("#txt").html(txtHtml + fold);
});
//收起点击
$("#txt").on("click", "span.rect-fold", function () {
$("#txt").html(omitHtml + unfold);
});
function getLineLen(arr) {
//获取当前文本真实的行数,如果是<br>符号getClientRects()方法也会变成一个区域
var line = 0;
var bottom = 0;
for (var i = 0; i < arr.length; i++) {
if (arr[i].bottom != bottom) {
bottom = arr[i].bottom;
line++;
}
}
return line;
}
};
})(jQuery);
隐藏效果:
隐藏.png
展开效果
展开.png
注意
getClientRects()的方式仅仅支持行内元素(inline),块级元素或者行内块级元素都只是识别为一个矩形区域,需要使用先把对应的标签转化为行内元素(inline)