使用 MultiClamp 实现文本块的智能折叠与展开-html教程-PHP中文网

使用 multiclamp 实现文本块的智能折叠与展开

本文详细介绍了如何利用 `MultiClamp` 库在前端实现文本内容的智能折叠与展开功能。通过设置初始行数对文本进行截断，并在用户点击“阅读更多”按钮或文本块时，动态解除限制，展示完整内容。教程涵盖了 `MultiClamp` 的初始化、`reload` 方法的使用，以及结合事件监听实现交互的完整步骤，旨在提供一个清晰、实用的文本内容管理解决方案。

在现代网页设计中，为了优化用户体验和布局美观，经常需要对过长的文本内容进行截断，并提供“阅读更多”的选项供用户展开查看完整内容。MultiClamp 是一个轻量级的 JavaScript 库，能够帮助开发者轻松实现多行文本的截断与展开功能，兼容性良好，并支持自定义省略符。本教程将指导您如何结合 MultiClamp 和原生 JavaScript（或 jQuery）来实现这一交互。

1. 引入 MultiClamp 库

首先，确保您的项目中已经引入了 MultiClamp 库。您可以直接在 HTML 文件中通过 CDN 引入，或者通过 npm/yarn 安装后打包使用。本例中我们使用 CDN 引入。同时，由于原始问题中提到了 jQuery，我们也会引入 jQuery，尽管 MultiClamp 也可以完全独立于 jQuery 使用。

<!-- 引入 jQuery (如果需要) -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
<!-- 引入 MultiClamp 库 -->
<script src="https://unpkg.com/multi-clamp@1.0.1/multi-clamp.min.js"></script>

登录后复制

2. HTML 结构准备

为了演示文本折叠与展开功能，我们需要一个包含多个文本块的 HTML 结构。每个文本块应包含标题、描述内容以及一个“阅读更多”按钮。

<div id="info" class="container">
  <div class="row">
    <!-- 示例文本块 1 -->
    <div class="col">
      <a href="#">
        <div class="wrap">
          <h3>Heading 1</h3>
          <div class="descr">
            Lorem ipsum dolor sit amet<br /> Morbi hendrerit justo non<br /> Mauris et ligula efficitur<br /> Suspendisse eget nulla lobortis<br /> Proin vel quam ornare, commodo sem<br /> Suspendisse luctus nisi nec<br /> Nullam volutpat mi ut metus
            rutrum<br /> Fusce vehicula ipsum in mauris<br /> Suspendisse consequat leo
          </div>
          <div class="btn">
            Read More
          </div>
        </div>
      </a>
    </div>
    <!-- 示例文本块 2 -->
    <div class="col">
      <a href="#">
        <div class="wrap">
          <h3>Heading 2</h3>
          <div class="descr">
            Lorem ipsum dolor sit amet<br /> Morbi hendrerit justo non<br /> Mauris et ligula efficitur<br /> Suspendisse eget nulla lobortis
          </div>
          <div class="btn">
            Read More
          </div>
        </div>
      </a>
    </div>
    <!-- 更多文本块... -->
  </div>
</div>

登录后复制

请注意，每个可折叠的文本内容都放置在 div 元素中，并带有 descr 类。同时，每个文本块的容器（a 标签）将作为点击展开的触发区域。

3. CSS 样式定义

为了使页面布局和文本块样式更具可读性，我们需要添加一些基本的 CSS 样式。

* {
  margin: 0;
  padding: 0;
}

.container {
  max-width: 480px;
  margin: 10px auto;
  padding: 0;
  width: 100%;
}

.container:after,
.container:before {
  display: table;
  content: " ";
}

.row {
  margin-bottom: 10px;
}

.row:after {
  content: '';
  display: block;
  height: 0;
  clear: both;
}

.col {
  display: inline;
  float: left;
  margin: 0 5px;
  width: 100%;
  max-width: 150px;
  text-align: left;
}

a {
  color: #000000;
  text-decoration: none;
}

.wrap {
  position: relative;
  min-height: 100%;
  padding: 10px 10px 10px;
  -webkit-box-sizing: border-box;
  box-sizing: border-box;
  background-color: yellow;
}

h3 {
  margin-bottom: 10px;
}

.btn {
  margin-top: 10px;
  background-color: #000000;
  color: #ffffff;
  display: inline-block;
  padding: 5px 10px;
  cursor: pointer; /* 添加光标样式，提示可点击 */
}

登录后复制

4. JavaScript 实现：初始化折叠与点击展开

现在，我们将使用 JavaScript 来实现文本的初始折叠和点击展开功能。

4.1 初始化文本折叠

首先，遍历所有 .descr 元素，并使用 MultiClamp 将它们折叠到三行。

Tellers AI

Tellers是一款自动视频编辑工具，可以将文本、文章或故事转换为视频。

查看详情

// MultiClamp 库的源码（省略，已在顶部引入）
// ... (此处为MultiClamp库的minified源码，实际使用时无需再次粘贴)
// ...

// 初始化 MultiClamp 实例
document.querySelectorAll("#info .descr").forEach(el => {
    // 为每个 .descr 元素创建一个 MultiClamp 实例
    let instance = new MultiClamp(el, {
        ellipsis: '...', // 省略符
        clamp: 3         // 初始折叠到 3 行
    });

    // 将 MultiClamp 实例存储在元素的数据属性中，以便后续访问
    el.multiClampInstance = instance;
});

登录后复制

在上述代码中，我们遍历了所有具有 id="info" 且类名为 descr 的元素，并为每个元素创建了一个 MultiClamp 实例。clamp: 3 参数指示库将文本截断为三行，并使用 ellipsis: '...' 作为省略符。为了在后续的展开操作中能够访问到这个实例，我们将其存储在了 DOM 元素的自定义属性 multiClampInstance 中。

4.2 实现点击展开功能

MultiClamp 库提供了一个 reload(options) 方法，允许我们动态更改截断选项并重新应用。当 clamp 选项设置为一个非常大的数字时，它将有效地解除文本截断，显示所有内容。

我们将为每个文本块的父链接（a 标签）添加一个点击事件监听器。当用户点击时，我们将调用对应 MultiClamp 实例的 reload 方法，并设置一个足够大的 clamp 值（例如 40000），以确保显示所有文本。同时，我们将隐藏“阅读更多”按钮。

document.querySelectorAll("#info .descr").forEach(el => {
    // 获取之前存储的 MultiClamp 实例
    let instance = el.multiClampInstance || new MultiClamp(el, {
        ellipsis: '...',
        clamp: 3
    });

    let a = el.closest('a'); // 获取最近的父级 <a> 元素
    a.addEventListener('click', e => {
        e.preventDefault(); // 阻止链接的默认跳转行为

        // 展开文本：将 clamp 设置为一个非常大的值
        instance.reload({ clamp: 40000, useOriginalText: true });

        // 隐藏“阅读更多”按钮
        const readMoreBtn = a.querySelector('.btn');
        if (readMoreBtn) {
            readMoreBtn.style.display = 'none';
        }
    }, { once: true }); // 使用 { once: true } 确保事件只触发一次
});

登录后复制

代码解析：

el.closest('a'): 找到当前 descr 元素最近的父级 <a> 标签，作为点击事件的触发器。
e.preventDefault(): 阻止 <a> 标签的默认点击行为（例如跳转页面）。
instance.reload({ clamp: 40000, useOriginalText: true }): 这是实现展开的关键。通过调用 reload 方法并传入一个非常大的 clamp 值，MultiClamp 会重新计算并显示所有文本。useOriginalText: true 确保在重新加载时使用原始未截断的文本。
a.querySelector('.btn').style.display = 'none': 展开后，隐藏“阅读更多”按钮，因为所有内容都已可见。
{ once: true }: 这是一个事件监听器的选项，表示该事件监听器只会被调用一次。当文本展开后，再次点击同一区域将不再触发展开逻辑，避免不必要的重复操作。

5. 完整示例代码

将上述 HTML、CSS 和 JavaScript 片段整合到一起，即可得到一个完整的、可运行的示例。

HTML:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>MultiClamp 文本折叠与展开教程</title>
    <!-- 引入 CSS 样式 -->
    <style>
        * {
            margin: 0;
            padding: 0;
        }

        .container {
            max-width: 480px;
            margin: 10px auto;
            padding: 0;
            width: 100%;
        }

        .container:after,
        .container:before {
            display: table;
            content: " ";
        }

        .row {
            margin-bottom: 10px;
        }

        .row:after {
            content: '';
            display: block;
            height: 0;
            clear: both;
        }

        .col {
            display: inline;
            float: left;
            margin: 0 5px;
            width: 100%;
            max-width: 150px;
            text-align: left;
        }

        a {
            color: #000000;
            text-decoration: none;
        }

        .wrap {
            position: relative;
            min-height: 100%;
            padding: 10px 10px 10px;
            -webkit-box-sizing: border-box;
            box-sizing: border-box;
            background-color: yellow;
        }

        h3 {
            margin-bottom: 10px;
        }

        .btn {
            margin-top: 10px;
            background-color: #000000;
            color: #ffffff;
            display: inline-block;
            padding: 5px 10px;
            cursor: pointer;
        }
    </style>
</head>
<body>

    <div id="info" class="container">
        <div class="row">
            <div class="col">
                <a href="#">
                    <div class="wrap">
                        <h3>Heading 1</h3>
                        <div class="descr">
                            Lorem ipsum dolor sit amet<br /> Morbi hendrerit justo non<br /> Mauris et ligula efficitur<br /> Suspendisse eget nulla lobortis<br /> Proin vel quam ornare, commodo sem<br /> Suspendisse luctus nisi nec<br /> Nullam volutpat mi ut metus
                            rutrum<br /> Fusce vehicula ipsum in mauris<br /> Suspendisse consequat leo
                        </div>
                        <div class="btn">
                            Read More
                        </div>
                    </div>
                </a>
            </div>
            <div class="col">
                <a href="#">
                    <div class="wrap">
                        <h3>Heading 2</h3>
                        <div class="descr">
                            Lorem ipsum dolor sit amet<br /> Morbi hendrerit justo non<br /> Mauris et ligula efficitur<br /> Suspendisse eget nulla lobortis
                        </div>
                        <div class="btn">
                            Read More
                        </div>
                    </div>
                </a>
            </div>
            <div class="col">
                <a href="#">
                    <div class="wrap">
                        <h3>Heading 3</h3>
                        <div class="descr">
                            Lorem ipsum dolor sit amet<br /> Morbi hendrerit justo non<br /> Mauris et ligula efficitur<br /> Suspendisse eget nulla lobortis<br /> Proin vel quam ornare, commodo sem<br /> Suspendisse luctus nisi nec<br /> Nullam volutpat mi ut metus
                            rutrum<br /> Fusce vehicula ipsum in mauris
                        </div>
                        <div class="btn">
                            Read More
                        </div>
                    </div>
                </a>
            </div>
        </div>
        <div class="row">
            <div class="col">
                <a href="#">
                    <div class="wrap">
                        <h3>Heading 4</h3>
                        <div class="descr">
                            Lorem ipsum dolor sit amet<br /> Morbi hendrerit justo non<br /> Mauris et ligula efficitur<br /> Suspendisse eget nulla lobortis<br /> Proin vel quam ornare, commodo sem
                        </div>
                        <div class="btn">
                            Read More
                        </div>
                    </div>
                </a>
            </div>
            <div class="col">
                <a href="#">
                    <div class="wrap">
                        <h3>Heading 5</h3>
                        <div class="descr">
                            Lorem ipsum dolor sit amet<br /> Morbi hendrerit justo non<br /> Mauris et ligula efficitur<br /> Suspendisse eget nulla lobortis<br /> Proin vel quam ornare, commodo sem<br /> Suspendisse luctus nisi nec<br /> Nullam volutpat mi ut metus
                            rutrum<br /> Fusce vehicula ipsum in mauris
                        </div>
                        <div class="btn">
                            Read More
                        </div>
                    </div>
                </a>
            </div>
            <div class="col">
                <a href="#">
                    <div class="wrap">
                        <h3>Heading 6</h3>
                        <div class="descr">
                            Lorem ipsum dolor sit amet<br /> Morbi hendrerit justo non<br /> Mauris et ligula efficitur
                        </div>
                        <div class="btn">
                            Read More
                        </div>
                    </div>
                </a>
            </div>
        </div>
    </div>

    <!-- 引入 jQuery (如果需要) -->
    <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
    <!-- 引入 MultiClamp 库 -->
    <script src="https://unpkg.com/multi-clamp@1.0.1/multi-clamp.min.js"></script>

    <script>
        // MultiClamp 库的源码（此处为minified源码，实际使用时无需再次粘贴）
        // "use strict";!function(t,e){"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?module.exports=e():t.MultiClamp=t.MultiClamp||e()}(this,function(){function a(t){return parseInt(t,10)}function l(t){return(t+"").replace(/[^\d.]/g,"")-0}function h(t){return Math.round(100*t)/100}function m(t,e){return"textContent"in t?t.textContent=e:t.innerText=e}function o(t,e){return window.getComputedStyle?window.getComputedStyle(t,null).getPropertyValue(e):t.currentStyle.getAttribute(e.replace(/-(\w)/g,function(t,e){return e.toUpperCase()}))}function c(t){var e=o(t,"height");return-1<e.indexOf("px")?l(e):h(l(t.clientHeight)-l(o(t,"padding-top"))-l(o(t,"padding-bottom")))}var t=function(t,e){t&&(this.element=t.length?t[0]:t,this.originalOption=e||{},this.originalElement=this.element.cloneNode(!0),this.preInit(this.originalOption),this.init())};return t.prototype={constructor:t,reload:function(t){if(t){if(t.useOriginalText&&(this.element.innerHTML=this.originalElement.innerHTML),"-webkit-box"===this.element.style.display)for(var e=["display","overflow","WebkitLineClamp","WebkitBoxOrient"],i=0;i<e.length;i++)this.element.style[e[i]]=this.originalElement.style[e[i]];var n={};for(var l in this.originalOption)n[l]=this.originalOption[l];for(var o in t)n[o]=t[o];this.preInit(n)}this.init()},preInit:function(t){if(this.option={ellipsis:"ellipsis"in t?t.ellipsis:"...",clamp:"clamp"in t?t.clamp:3,reverse:"reverse"in t&&!!t.reverse,splitByWords:"splitByWords"in t&&!!t.splitByWords,disableCssClamp:"disableCssClamp"in t&&!!t.disableCssClamp,onClampStart:"onClampStart"in t&&"function"==typeof t.onClampStart?t.onClampStart:function(){},onClampEnd:"onClampEnd"in t&&"function"==typeof t.onClampEnd?t.onClampEnd:function(){}},"lineTextLen"in t&&(this.option.lineTextLen=t.lineTextLen),"auto"===this.option.clamp)this.autoClamp=!0;else{if(this.option.clamp=a(this.option.clamp),isNaN(this.option.clamp)||this.option.clamp<1)throw new Error("Invaild clamp number!");this.autoClamp=!1}this.useCssClamp=!(this.option.disableCssClamp||this.autoClamp||this.option.reverse||this.option.splitByWords||"..."!==this.option.ellipsis||void 0===document.body.style.webkitLineClamp)},init:function(){if(this.useCssClamp){var t={display:"-webkit-box",overflow:"hidden",WebkitLineClamp:this.option.clamp,WebkitBoxOrient:"vertical"};for(var e in t)this.element.style[e]=t[e]}else this.contentText="textContent"in(i=this.element)?i.textContent:i.innerText,this.ellipsis=function(t){if(/^<[\w\W]+>$/.test(t)){var e=document.createElement("div");return e.innerHTML=t,e.firstElementChild||e.firstChild}return t}(this.option.ellipsis),this.clamp();var i},getSingleLineHeight:function(){var t=o(this.element,"line-height"),i=this;if(-1<t.indexOf("px"))return l(t);if(isNaN(t))return n();var e=o(this.element,"font-size");return-1<e.indexOf("px")?h(l(e)*t):-1<e.indexOf("pt")?h(4*l(e)/3*t):n();function n(){var t=i.element.innerHTML;i.element.innerHTML=".";var e=c(i.element);return i.element.innerHTML=t,e}},clamp:function(){var t,e,i,n,l=this;if(t=this.getSingleLineHeight(),""!==this.contentText&&t){if(this.autoClamp?(i=c(this.element),this.option.clamp=a(i/t),n=this.element.style.height,this.element.style.height="auto"):i=h(t*this.option.clamp),!(e=c(this.element))||!i||e<=i)return this.autoClamp&&(this.element.style.height=n

登录后复制

以上就是使用 MultiClamp 实现文本块的智能折叠与展开的详细内容，更多请关注php中文网其它相关文章！