萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 文本展開收縮效果:長文本優雅交互實現

需求場景:有限空間展示長文本

產品描述、文章摘要、用戶評論等長文本,在有限 UI 空間中需要「預覽 + 展開」交互,兼顧信息密度與用戶體驗。

核心思路

  1. 獲取完整文本與容器原始高度
  2. 截取指定字數/高度作為預覽態
  3. 點擊「展開」動畫恢復原文與高度
  4. 點擊「收縮」動畫回到預覽態
  5. 文本較短時自動隱藏控制按鈕

完整實現方案(方法一:jQuery 動畫版)

<!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>

關鍵技術點解析

1. 高度動畫的關鍵:overflow: hidden

容器必須設置 overflow: hidden,配合 height 動畫實現視覺上的截斷/展開效果。

2. 獲取真實高度技巧

// 臨時設置 height: auto 獲取自然高度
$content.css("height", "auto");
var actualHeight = $content.height();
$content.css("height", "");

3. 狀態管理:閉包變量 vs data()

// 方案一:閉包變量(簡單場景)
var isExpanded = false;

// 方案二:jQuery data(複雜場景,支持多實例)
$container.data("expanded", false);
// 讀取:$container.data("expanded")
// 寫入:$container.data("expanded", true)

4. 文本替換時機:動畫結束後

$content.animate({ height: previewHeight }, speed, function() {
    // 動畫完成回調中替換文本,避免動畫過程中文本跳動
    $content.html(previewText);
});

方法二:CSS 純樣式方案(無 JS 邏輯,現代瀏覽器)

<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、無法精確控制字符截斷。

進階增強功能

  • HTML 內容安全截斷: 避免截斷標籤導致布局崩壞,需用 DOM 解析器按節點截取
  • 「查看更多」跳轉鏈接: 長文本提供完整頁面鏈接
  • 展開記憶: localStorage 記住用戶偏好
  • 無限滾動加載: 結合 IntersectionObserver 實現懶加載

總結

文本展開收縮是經典 UI 模式。jQuery 版本兼容性好、邏輯靈活,適合需要精確字符控制、複雜動畫的場景;CSS 方案現代、高性能,適合移動端、行數固定的簡單場景。根據項目技術棧、兼容性要求、交互複雜度選擇方案,並注意「動畫結束後替換內容」「狀態管理」「無障礙訪問」等細節,打造流暢體驗。

copyright © 萬盛學電腦網 all rights reserved