萬盛學電腦網

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

JavaScript 文字溢出自動分頁渲染至多個 Div 實現(定高容器文本分頁)

需求場景

長文本需在固定高度容器(如 96px)中分頁顯示,超出部分自動創建新 `div` 容器繼續承接,實現類似電子書/報紙排版的「文本流」效果。

核心算法思想

  1. 創建一個**測量用隱藏 div**(樣式與目標容器完全一致)。
  2. 逐字/逐段追加文本到測量 div,監測其 `offsetHeight`。
  3. 當高度超過容器限高 → 回退一步,當前容器裝滿,剩余文本遞歸處理下一個容器。
  4. 最後一個容器不足高度時,可選擇補白或保持原高。

完整實現代碼

<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>文本自動分頁渲染</title>
  <style>
    .page-box {
      width: 400px;
      height: 96px;           /* 固定高度:4 行 × 24px */
      line-height: 24px;
      font-size: 14px;
      font-family: SimSun, sans-serif;
      border: 1px solid #ccc;
      margin: 10px auto;
      overflow: hidden;
      background: #fafafa;
      position: relative;
    }
    .page-box:last-child::after {
      content: '— END —';
      position: absolute;
      right: 10px;
      bottom: 5px;
      color: #999;
      font-size: 12px;
    }
  </style>
</head>
<body>
  <div id="pagesContainer"></div>

  <script>
    var longText = "這裡是一段很長的話,這段話的文字可以很隨意的哦,只要達到一定數量,就自動會分頁,你信不信?不信也得信啊,這是真的,哪怕再長的文字,我復制一段話吧,下面這一段話就是復制過來的,我要准備復制了哦,準備好了沒呢?這裡是一段話,這短話的文字可以很隨意的哦,只要達到一定數量,就自動會分頁,你信不信?不信也得信啊,這是真的,哪怕再長的文字,我復制一段話吧,下面這一段話就是復制過來的,我要準備復制了哦,準備好了沒呢?還有更多更多的內容繼續填充,直到填滿多個分頁容器為止。";

    /**
     * 文本自動分頁渲染
     * @param {string} text - 完整文本
     * @param {Object} options
     *   - containerSelector: 容器選擇器 (父元素)
     *   - boxClass: 分頁盒子 class
     *   - boxHeight: 盒子高度 (px)
     *   - lineHeight: 行高 (px)
     */
    function paginateText(text, options) {
      var opts = $.extend({
        containerSelector: '#pagesContainer',
        boxClass: 'page-box',
        boxHeight: 96,
        lineHeight: 24
      }, options);
      
      var $container = $(opts.containerSelector);
      $container.empty(); // 清空舊內容
      
      // 創建測量用 div (隱藏、樣式同步)
      var $measure = $('
').addClass(opts.boxClass).css({ position: 'absolute', left: -9999, top: -9999, visibility: 'hidden', height: 'auto', // 自動高度以便測量 width: $container.width() // 同步寬度 }).appendTo('body'); // 同步關鍵樣式 (從 CSS 類獲取或傳入) var styleProps = ['font-size', 'font-family', 'line-height', 'letter-spacing', 'padding', 'border', 'box-sizing', 'word-wrap', 'word-break']; var computed = getComputedStyle(document.querySelector('.' + opts.boxClass)); styleProps.forEach(function(p) { $measure.css(p, computed[p]); }); var start = 0; var len = text.length; function fillPage(startIdx) { // 創建新頁面容器 var $page = $('
').addClass(opts.boxClass).appendTo($container); var pageText = ''; // 二分查找優化:比逐字追加快得多 var low = startIdx, high = len, best = startIdx; while (low <= high) { var mid = Math.floor((low + high) / 2); $measure.text(text.substring(startIdx, mid)); if ($measure[0].offsetHeight <= opts.boxHeight) { best = mid; low = mid + 1; } else { high = mid - 1; } } // best 是能容納的最大索引 (不含) pageText = text.substring(startIdx, best); $page.text(pageText); // 如果還有剩余文本,遞歸創建下一頁 if (best < len) { fillPage(best); } else { // 最後一頁:可選設置固定高度 $page.css('height', opts.boxHeight + 'px'); } } fillPage(0); $measure.remove(); // 清理測量元素 } // 執行 $(function() { paginateText(longText, { containerSelector: '#pagesContainer', boxClass: 'page-box', boxHeight: 96, lineHeight: 24 }); }); </script> <script src="https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js"></script> </body> </html>

關鍵優化點

  1. 二分查找替代線性遍歷:從 O(n) 降為 O(log n),長文本性能提升百倍。
  2. 測量元素樣式完全同步:用 `getComputedStyle` 複製所有影響佈局的 CSS 屬性,確保測量精準。
  3. 隱藏測量元素:`position:absolute; left:-9999px; visibility:hidden` 不佔據文檔流、不觸發重排、不被用戶看見。
  4. 遞歸分頁:代碼簡潔,自然處理任意頁數。
  5. 寬度自適應**:測量元素寬度跟隨容器寬度,支持響應式。

擴展功能建議

  • 分頁導航:生成頁碼按鈕,點擊滾動到對應 `.page-box`。
  • 圖文混排**:測量元素需支持 `inline-block` 圖片,計算高度時考慮圖片加載(需 `onload` 重測)。
  • CSS Regions / Exclusions**:現代 CSS 標準原生支持文本流入多容器,但瀏覽器支持極有限(僅 IE/Edge 旧版、Safari 部分支持)。
  • Canvas 測量**:`ctx.measureText()` 更輕量,但需手動處理換行、標點禁則、行高等排版邏輯。

結語

定高容器文本自動分頁是「測量 + 二分 + 遞歸」的經典應用。關鍵在於**測量環境與顯示環境完全一致**。此方案純前端、無依賴 (除 jQuery 可換原生)、性能優異,適合報表打印預覽、電子書閱讀、長文本分頁展示等場景。

copyright © 萬盛學電腦網 all rights reserved