萬盛學電腦網

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

使用 div + jQuery 打造自訂樣式捲軸的兩種核心思路與實作細節

背景與痛點

專案中左側選單使用 dtree.js 動態載入大量設備名稱,部分名稱過長導致容器寬度不足。雖然設定 overflow: auto 即可產生原生捲軸,但原生樣式難以符合設計需求,且跨瀏覽器一致性差。

方案一:CSS 原生捲軸樣式化(WebKit/Blink 專屬)

利用 ::-webkit-scrollbar 等偽元素,共 8 個屬性可控制軌道、滑塊、按鈕等外觀。優點是零 JS 依賴、效能最佳;缺點是 僅支援 WebKit 核心瀏覽器,Firefox 需用 scrollbar-width/color,IE/Edge 早期版本不支援。

/* WebKit 範例 */
.custom-scroll::-webkit-scrollbar { width: 8px; height: 8px; }
.custom-scroll::-webkit-scrollbar-track { background: #f1f1f1; }
.custom-scroll::-webkit-scrollbar-thumb { background: #888; border-radius: 4px; }
.custom-scroll::-webkit-scrollbar-thumb:hover { background: #555; }

方案二:完全自訂捲軸元件(跨瀏覽器通用)

核心思想:隱藏原生捲軸,用自建的 DOM 元素模擬捲軸行為。

DOM 結構設計

<div class="scroll-container">
  <div class="content-wrapper"> 實際內容 </div>
  <div class="scrollbar-v">      <div class="thumb-v"></div> </div>
  <div class="scrollbar-h">      <div class="thumb-h"></div> </div>
</div>

關鍵實作步驟

  1. 初始化:計算內容高度/寬度與容器比例,決定捲軸顯示與否及滑塊大小。
  2. 事件綁定:
    • 滑鼠拖曳滑塊 → 同步更新 content-wrapper 的 scrollTop/scrollLeft
    • 滑鼠滾輪 / 觸控滑動 → 同步更新滑塊位置
    • 鍵盤方向鍵支援
  3. 尺寸變更監聽:使用 ResizeObserver 或定時檢查,內容動態增減時重新計算。

核心數學公式

// 垂直捲軸
thumbHeight = (containerHeight / contentHeight) * containerHeight;
maxThumbTop = containerHeight - thumbHeight;
scrollRatio = contentHeight / containerHeight; // 內容捲動 1px = 滑塊移動 1/scrollRatio px

// 滑塊拖曳時
contentWrapper.scrollTop = thumbTop * scrollRatio;

// 內容捲動時
thumbTop = contentWrapper.scrollTop / scrollRatio;

原始碼片段解析(來自文章)

文章提供的 jQuery 動態注入碼展示了如何以程式化方式建立垂直/水平捲軸結構:

// 簡化版邏輯
$(_self).wrapInner("<div class='jscroll-c'></div>"); // 包裹內容
$(_self).append(verticalScrollbarHtml); // 注入垂直捲軸 DOM
$(_self).append(horizontalScrollbarHtml); // 注入水平捲軸 DOM

後續需補上拖曳、滾輪、鍵盤等互動邏輯,文章提及完整碼見下載資源。

現代替代方案推薦

  • SimpleBar:輕量、無依賴、支援 SSR
  • OverlayScrollbars:功能豐富、高度可配置
  • CSS overflow: overlay:新標準,漸進增強原生捲軸

結語

自訂捲軸看似簡單,實則涉及座標轉換、事件節流、邊界檢測等細節。若專案允許,優先使用成熟函式庫;若須自行實作,建議採用「內容與捲軸解耦」的架構,分別處理「資料同步」與「視覺回饋」。

copyright © 萬盛學電腦網 all rights reserved