萬盛學電腦網

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

jQuery 拖拽彈窗庫 iDrag & iDialog 使用指南:特性、API、跨平台兼容

庫簡介

iDrag & iDialog 是基於 jQuery 的輕量級拖拽與對話框庫,特點:

  • 無依賴 (僅需 jQuery)
  • IE6+ 全兼容,支持 fixed 定位、覆蓋 select (IE6)
  • CSS3 漸進增強:陰影、圓角、動畫 (scale/slide)
  • 豐富接口:拖拽範圍、回調、對話框尺寸/位置/鎖屏/關閉控制

快速開始

引入資源


<script src="lib/js/jquery-1.8.3.min.js"></script>
<script src="lib/js/jquery.idialog.js" dialog-theme="default"></script>

dialog-theme="default" 自動加載 theme/default.css,需與 JS 同目錄下的 theme 文件夾。

iDrag 拖拽 API


iDrag({
  target: '#drag-demo',      // 可拖拽元素選擇器
  handle: '.title-bar',      // 可選:拖拽手柄 (默認整個元素)
  min: { x: 0, y: 0 },       // 可選:最小邊界
  max: { x: 658, y: 170 },   // 可選:最大邊界
  start: function(pos) {     // 開始拖拽回調
    console.log('start:', pos); // {x, y}
  },
  move: function(pos) {      // 拖拽中回調
    console.log('move:', pos);
  },
  end: function(pos) {       // 結束拖拽回調
    console.log('end:', pos);
  }
});

// 或簡寫
$('#drag-demo').drag({
  // 同樣配置
});

iDialog 對話框 API


iDialog({
  title: 'Hello World',      // 標題
  id: 'DemoDialog',          // 唯一 ID
  content: '

大家好:
我是 minDialog

', // HTML 內容 lock: true, // 模態鎖屏 (遮罩層) width: 500, // 寬度 height: 300, // 高度 fixed: true, // 固定定位 (視口居中,不隨滾動) // 可選參數 top: 100, // 具體 top 位置 (fixed:false 時) left: 200, // 具體 left 位置 drag: true, // 是否可拖拽 (默認 true) resize: false, // 是否可縮放 closeBtn: true, // 顯示關閉按鈕 esc: true, // ESC 鍵關閉 overlay: 0.3, // 遮罩透明度 onShow: function() {}, // 顯示後回調 onClose: function() {}, // 關閉前回調 onDragStart: function() {}, // 拖拽開始 onDragMove: function() {}, // 拖拽中 onDragEnd: function() {} // 拖拽結束 }); // 程序化控制 const dialog = iDialog({...}); dialog.close(); // 關閉 dialog.show(); // 顯示 dialog.hide(); // 隱藏 dialog.setContent('

新內容

'); // 更新內容 dialog.setTitle('新標題'); // 更新標題

CSS3 動畫主題擴展

在 theme/default.css 中定義動畫:


/* 縮放彈出 */
@keyframes scaleShow {
  from { transform: scale(0.5); opacity: 0; }
  to { transform: scale(1); opacity: 1; }
}

/* 超級縮放 */
@keyframes superScaleShow {
  0% { transform: scale(0); opacity: 0; }
  50% { transform: scale(1.1); }
  100% { transform: scale(1); opacity: 1; }
}

/* 右側滑入 */
@keyframes rightSlideShow {
  from { transform: translateX(100%); opacity: 0; }
  to { transform: translateX(0); opacity: 1; }
}

/* 應用動畫 */
.dialog-animate-scale { animation: scaleShow 0.3s ease-out; }
.dialog-animate-super { animation: superScaleShow 0.4s cubic-bezier(0.175, 0.885, 0.32, 1.275); }
.dialog-animate-slide { animation: rightSlideShow 0.3s ease-out; }

調用時指定:iDialog({..., animate: 'scale' }) (需庫支持對應類名)。

IE6 兼容性處理亮點

  • fixed 定位模擬:使用 expression 或定時器同步 scrollTop
  • 遮罩覆蓋 select:iframe 墊片技術 (同 bgiframe 原理)
  • PNG 透明:DD_belatedPNG 或 AlphaImageLoader

現代替代方案對比

庫體積依賴特色維護狀態
iDrag/iDialog~8KBjQuery簡單、IE6兼容停止維護
Draggable~12KB無原生、模塊化、現代活躍
SortableJS~20KB無拖拽排序專精活躍
React DnD~30KBReactReact 生態、後端佈局活躍
Vue Draggable~15KBVueVue 3 組合式 API活躍

遷移建議

新項目直接選用現代無依賴庫 (Draggable) 或框架專用庫。存量 jQuery 項目可繼續使用,但建議封裝為組件,便於未來替換底層實現。

copyright © 萬盛學電腦網 all rights reserved