本文详细介绍了如何利用 `MultiClamp` 库在前端实现文本内容的智能折叠与展开功能。通过设置初始行数对文本进行截断，并在用户点击“阅读更多”按钮或文本块时，动态解除限制，展示完整内容。教程涵盖了 `MultiClamp` 的初始化、`reload` 方法的使用，以及结合事件监听实现交互的完整步骤，旨在提供一个清晰、实用的文本内容管理解决方案。
在现代网页设计中，为了优化用户体验和布局美观，经常需要对过长的文本内容进行截断，并提供“阅读更多”的选项供用户展开查看完整内容。MultiClamp 是一个轻量级的 JavaScript 库，能够帮助开发者轻松实现多行文本的截断与展开功能，兼容性良好，并支持自定义省略符。本教程将指导您如何结合 MultiClamp 和原生 JavaScript（或 jQuery）来实现这一交互。
1. 引入 MultiClamp 库
首先，确保您的项目中已经引入了 MultiClamp 库。您可以直接在 HTML 文件中通过 CDN 引入，或者通过 npm/yarn 安装后打包使用。本例中我们使用 CDN 引入。同时，由于原始问题中提到了 jQuery，我们也会引入 jQuery，尽管 MultiClamp 也可以完全独立于 jQuery 使用。
2. HTML 结构准备
为了演示文本折叠与展开功能，我们需要一个包含多个文本块的 HTML 结构。每个文本块应包含标题、描述内容以及一个“阅读更多”按钮。
Heading 1
Lorem ipsum dolor sit amet
Morbi hendrerit justo non
Mauris et ligula efficitur
Suspendisse eget nulla lobortis
Proin vel quam ornare, commodo sem
Suspendisse luctus nisi nec
Nullam volutpat mi ut metus
rutrum
Fusce vehicula ipsum in mauris
Suspendisse consequat leo
Read More
Heading 2
Lorem ipsum dolor sit amet
Morbi hendrerit justo non
Mauris et ligula efficitur
Suspendisse eget nulla lobortis
Read More
请注意，每个可折叠的文本内容都放置在 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 将它们折叠到三行。
// 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.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 元素最近的父级 标签，作为点击事件的触发器。
- e.preventDefault(): 阻止 标签的默认点击行为（例如跳转页面）。
- instance.reload({ clamp: 40000, useOriginalText: true }): 这是实现展开的关键。通过调用 reload 方法并传入一个非常大的 clamp 值，MultiClamp 会重新计算并显示所有文本。useOriginalText: true 确保在重新加载时使用原始未截断的文本。
- a.querySelector('.btn').style.display = 'none': 展开后，隐藏“阅读更多”按钮，因为所有内容都已可见。
- { once: true }: 这是一个事件监听器的选项，表示该事件监听器只会被调用一次。当文本展开后，再次点击同一区域将不再触发展开逻辑，避免不必要的重复操作。
5. 完整示例代码
将上述 HTML、CSS 和 JavaScript 片段整合到一起，即可得到一个完整的、可运行的示例。
HTML:
MultiClamp 文本折叠与展开教程
Heading 1
Lorem ipsum dolor sit amet
Morbi hendrerit justo non
Mauris et ligula efficitur
Suspendisse eget nulla lobortis
Proin vel quam ornare, commodo sem
Suspendisse luctus nisi nec
Nullam volutpat mi ut metus
rutrum
Fusce vehicula ipsum in mauris
Suspendisse consequat leo
Read More
Heading 2
Lorem ipsum dolor sit amet
Morbi hendrerit justo non
Mauris et ligula efficitur
Suspendisse eget nulla lobortis
Read More
Heading 3
Lorem ipsum dolor sit amet
Morbi hendrerit justo non
Mauris et ligula efficitur
Suspendisse eget nulla lobortis
Proin vel quam ornare, commodo sem
Suspendisse luctus nisi nec
Nullam volutpat mi ut metus
rutrum
Fusce vehicula ipsum in mauris
Read More
Heading 4
Lorem ipsum dolor sit amet
Morbi hendrerit justo non
Mauris et ligula efficitur
Suspendisse eget nulla lobortis
Proin vel quam ornare, commodo sem
Read More
Heading 5
Lorem ipsum dolor sit amet
Morbi hendrerit justo non
Mauris et ligula efficitur
Suspendisse eget nulla lobortis
Proin vel quam ornare, commodo sem
Suspendisse luctus nisi nec
Nullam volutpat mi ut metus
rutrum
Fusce vehicula ipsum in mauris
Read More
Heading 6
Lorem ipsum dolor sit amet
Morbi hendrerit justo non
Mauris et ligula efficitur
Read More
Lorem ipsum dolor sit amet