產品描述、文章摘要、用戶評論等長文本,在有限 UI 空間中需要「預覽 + 展開」交互,兼顧信息密度與用戶體驗。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>文本展開收縮演示</title>
<style>
#limittext {
width: 640px;
height: auto;
position: relative;
background-color: #f5f5f5;
color: #333;
padding: 20px;
font-family: "Microsoft YaHei", sans-serif;
line-height: 1.6;
}
.content {
overflow: hidden; /* 關鍵:配合高度動畫截斷內容 */
}
.switch {
font-size: 14px;
text-align: center;
cursor: pointer;
font-weight: 600;
position: absolute;
bottom: 0;
left: 0;
right: 0;
height: 40px;
line-height: 40px;
background: linear-gradient(to top, #fff 0%, rgba(255,255,255,0) 100%);
color: #007bff;
user-select: none;
transition: color 0.2s;
}
.switch:hover {
color: #0056b3;
}
</style>
</head>
<body>
<div id="limittext">
<div class="content" style="padding-bottom: 50px;">
這是一段很長的文字內容,用於演示展開收縮效果。在實際項目中,這可能是一篇文章的摘要、商品的詳細描述、或者用戶的長評論。
當字符數超過限制時,會自動截斷並顯示「展開」按鈕。用戶點擊後通過平滑動畫展示完整內容,
再次點擊則收縮回預覽狀態。這種交互方式既節省空間,又不犧牲信息完整性,是移動端和響應式設計中常見的模式。
這是一段很長的文字內容,用於演示展開收縮效果。在實際項目中,這可能是一篇文章的摘要、商品的詳細描述、或者用戶的長評論。
當字符數超過限制時,會自動截斷並顯示「展開」按鈕。用戶點擊後通過平滑動畫展示完整內容,
再次點擊則收縮回預覽狀態。這種交互方式既節省空間,又不犧牲信息完整性,是移動端和響應式設計中常見的模式。
</div>
<div class="switch">展開</div>
</div>
<script src="https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js"></script>
<script>
(function($) {
$.fn.textToggle = function(options) {
var settings = $.extend({
limit: 100, // 預覽字符數
speed: 300, // 動畫時長(ms)
expandedText: "收縮", // 展開狀態按鈕文字
collapsedText: "展開" // 收縮狀態按鈕文字
}, options);
return this.each(function() {
var $container = $(this);
var $content = $container.find(".content");
var $switch = $container.find(".switch");
var fullText = $content.html();
var fullHeight = $content.height(); // 需先顯示完整內容獲取高度
// 暫時顯示完整內容獲取真實高度
$content.css("height", "auto");
var actualHeight = $content.height();
$content.css("height", ""); // 恢復
if (fullText.length <= settings.limit) {
$switch.hide(); // 內容較短,無需展開
return;
}
// 生成預覽文本
var previewText = fullText.substring(0, settings.limit);
$content.html(previewText);
var previewHeight = $content.height();
var isExpanded = false;
$switch.on("click", function() {
if (!isExpanded) {
// 展開
$content.html(fullText);
$content.animate({ height: actualHeight }, settings.speed);
$switch.text(settings.expandedText);
} else {
// 收縮
$content.animate({ height: previewHeight }, settings.speed, function() {
$content.html(previewText); // 動畫結束後替換文本,避免抖動
});
$switch.text(settings.collapsedText);
}
isExpanded = !isExpanded;
});
});
};
$(function() {
$("#limittext").textToggle({
limit: 200,
speed: 400
});
});
})(jQuery);
</script>
</body>
</html>
容器必須設置 overflow: hidden,配合 height 動畫實現視覺上的截斷/展開效果。
// 臨時設置 height: auto 獲取自然高度
$content.css("height", "auto");
var actualHeight = $content.height();
$content.css("height", "");
// 方案一:閉包變量(簡單場景)
var isExpanded = false;
// 方案二:jQuery data(複雜場景,支持多實例)
$container.data("expanded", false);
// 讀取:$container.data("expanded")
// 寫入:$container.data("expanded", true)
$content.animate({ height: previewHeight }, speed, function() {
// 動畫完成回調中替換文本,避免動畫過程中文本跳動
$content.html(previewText);
});
<style>
.css-truncate {
display: -webkit-box;
-webkit-line-clamp: 3; /* 顯示行數 */
-webkit-box-orient: vertical;
overflow: hidden;
transition: max-height 0.3s ease;
}
.css-truncate.expanded {
-webkit-line-clamp: unset;
height: auto;
}
/* 配合 checkbox hack 實現無 JS 切換 */
.toggle-input { display: none; }
.toggle-input:checked + .css-truncate { ... }
.toggle-label { cursor: pointer; }
</style>
<div class="card">
<input type="checkbox" id="toggle1" class="toggle-input">
<div class="content css-truncate">長文本內容...</div>
<label for="toggle1" class="toggle-label">展開/收縮</label>
</div>
優點: 無 JS 依賴、性能極佳、CSS 動畫更流暢。
缺點: 行數固定(非字符數)、IE 不支持 line-clamp、無法精確控制字符截斷。
localStorage 記住用戶偏好文本展開收縮是經典 UI 模式。jQuery 版本兼容性好、邏輯靈活,適合需要精確字符控制、複雜動畫的場景;CSS 方案現代、高性能,適合移動端、行數固定的簡單場景。根據項目技術棧、兼容性要求、交互複雜度選擇方案,並注意「動畫結束後替換內容」「狀態管理」「無障礙訪問」等細節,打造流暢體驗。