萬盛學電腦網

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

JavaScript 實現雙 iframe 拖拽調整寬高(分欄佈局)

效果預覽

左側 iframe 載入樹形目錄,右側 iframe 載入內容頁。通過拖動中間分隔條,同時調整兩個 iframe 的寬度與高度,實現經典的「左右分欄可拖拽」佈局。

核心實現原理

  1. 透明拖拽手柄:利用 `filter: alpha(opacity=0)` (IE) / `opacity: 0` 創建一個覆蓋在分隔區域的透明 `div`,捕獲鼠標事件。
  2. 鼠標事件三部曲:`mousedown` 記錄起始座標 → `mousemove` 計算偏移並實時更新尺寸 → `mouseup` 釋放捕獲。
  3. 雙 iframe 聯動:左框寬度變化 → 右框 `left` 和 `width` 同步重算;高度以左框為準同步右框。

完整代碼(優化版)

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>雙 iframe 拖拽分欄</title>
<style>
  * { margin: 0; padding: 0; box-sizing: border-box; }
  html, body { height: 100%; overflow: hidden; background: #f0f0f0; }
  .container { height: 100%; display: flex; }
  .iframe-wrap { position: relative; flex: 1; overflow: hidden; }
  iframe { width: 100%; height: 100%; border: none; background: #fff; }
  .splitter {
    width: 6px;
    cursor: col-resize;
    background: #ddd;
    position: relative;
    z-index: 10;
    touch-action: none; /* 防止移動端滾動干擾 */
  }
  .splitter:hover, .splitter.dragging { background: #007bff; }
  .splitter::before {
    content: '';
    position: absolute;
    top: 0; bottom: 0; left: -4px; right: -4px; /* 擴大點擊區域 */
  }
</style>
</head>
<body>
  <div class="container">
    <div class="iframe-wrap" id="leftWrap">
      <iframe id="leftFrame" src="https://example.com/tree"></iframe>
    </div>
    <div class="splitter" id="splitter"></div>
    <div class="iframe-wrap" id="rightWrap">
      <iframe id="rightFrame" src="https://example.com/content"></iframe>
    </div>
  </div>

  <script>
    (function() {
      var splitter = document.getElementById('splitter');
      var leftWrap = document.getElementById('leftWrap');
      var rightWrap = document.getElementById('rightWrap');
      var container = document.querySelector('.container');
      
      var startX, startLeftWidth;
      var minWidth = 150; // 最小寬度限制
      var maxWidth = 800; // 最大寬度限制
      
      splitter.addEventListener('mousedown', function(e) {
        e.preventDefault();
        startX = e.clientX;
        startLeftWidth = leftWrap.offsetWidth;
        splitter.classList.add('dragging');
        document.addEventListener('mousemove', onMouseMove);
        document.addEventListener('mouseup', onMouseUp);
      });
      
      function onMouseMove(e) {
        var dx = e.clientX - startX;
        var newLeftWidth = startLeftWidth + dx;
        
        // 限制範圍
        newLeftWidth = Math.max(minWidth, Math.min(maxWidth, newLeftWidth));
        
        // 更新佈局(使用 flex-basis 或 width)
        leftWrap.style.flex = '0 0 ' + newLeftWidth + 'px';
        // 右側自動撐滿剩餘空間
      }
      
      function onMouseUp() {
        splitter.classList.remove('dragging');
        document.removeEventListener('mousemove', onMouseMove);
        document.removeEventListener('mouseup', onMouseUp);
      }
      
      // 高度自適應:容器已是 100% 高度,iframe 撐滿即可
      // 若需同步滾動高度,可在 iframe load 事件中調整
    })();
  </script>
</body>
</html>

關鍵優化點

  • Flex 佈局替代絕對定位:簡化寬度計算,右側自動適應,無需手動設 `left`/`width`。
  • 擴大點擊區域:`::before` 偽元素向左右擴展 4px,解決分隔條太細難拖動問題。
  • 最小/最大寬度限制:防止拖拽過度導致佈局崩壞。
  • 事件綁定在 document:滑出分隔條外仍能繼續拖動,體驗更順滑。
  • touch-action: none:移動端防止瀏覽器默認滾動攔截拖拽。

已知問題與改進方向

  1. 實時重繪性能:頻繁修改寬度觸發重排。可改用 `requestAnimationFrame` 節流,或拖拽時僅顯示「幽靈線」,釋放時再重排。
  2. iframe 跨域高度同步:若需雙框高度聯動且跨域,需使用 `postMessage` 通信獲取內容高度。
  3. 持久化:將用戶調整的寬度存入 `localStorage`,下次打開恢復。

結語

雖然現代前端多採用 Vue/React + CSS Grid/Flex 實現可調整佈局,但理解原生 JS 拖拽邏輯對於維護舊項目、構建無依賴輕量組件仍有價值。核心在於「事件捕獲 + 座標計算 + 佈局更新」三步走。

copyright © 萬盛學電腦網 all rights reserved