iDrag & iDialog 是基於 jQuery 的輕量級拖拽與對話框庫,特點:
<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({
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({
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('新標題'); // 更新標題
在 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' }) (需庫支持對應類名)。
expression 或定時器同步 scrollTop| 庫 | 體積 | 依賴 | 特色 | 維護狀態 |
|---|---|---|---|---|
| iDrag/iDialog | ~8KB | jQuery | 簡單、IE6兼容 | 停止維護 |
| Draggable | ~12KB | 無 | 原生、模塊化、現代 | 活躍 |
| SortableJS | ~20KB | 無 | 拖拽排序專精 | 活躍 |
| React DnD | ~30KB | React | React 生態、後端佈局 | 活躍 |
| Vue Draggable | ~15KB | Vue | Vue 3 組合式 API | 活躍 |
新項目直接選用現代無依賴庫 (Draggable) 或框架專用庫。存量 jQuery 項目可繼續使用,但建議封裝為組件,便於未來替換底層實現。