本文详细介绍了如何利用 `MultiClamp` 库在前端实现文本内容的智能折叠与展开功能。通过设置初始行数对文本进行截断，并在用户点击“阅读更多”按钮或文本块时，动态解除限制，展示完整内容。教程涵盖了 `MultiClamp` 的初始化、`reload` 方法的使用，以及结合事件监听实现交互的完整步骤，旨在提供一个清晰、实用的文本内容管理解决方案。
在现代网页设计中，为了优化用户体验和布局美观，经常需要对过长的文本内容进行截断，并提供“阅读更多”的选项供用户展开查看完整内容。MultiClamp 是一个轻量级的 JavaScript 库，能够帮助开发者轻松实现多行文本的截断与展开功能，兼容性良好，并支持自定义省略符。本教程将指导您如何结合 MultiClamp 和原生 JavaScript（或 jQuery）来实现这一交互。
1. 引入 MultiClamp 库
首先，确保您的项目中已经引入了 MultiClamp 库。您可以直接在 HTML 文件中通过 CDN 引入，或者通过 npm/yarn 安装后打包使用。本例中我们使用 CDN 引入。同时，由于原始问题中提到了 jQuery，我们也会引入 jQuery，尽管 MultiClamp 也可以完全独立于 jQuery 使用。
2. HTML 结构准备
为了演示文本折叠与展开功能，我们需要一个包含多个文本块的 HTML 结构。每个文本块应包含标题、描述内容以及一个“阅读更多”按钮。
请注意，每个可折叠的文本内容都放置在 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 文本折叠与展开教程
