DIV CSS 佈局教程網

jQuery UI 拖拽功能全方位實踐指南
編輯:JQuery特效代碼     

jQuery UI 提供的 API 大幅簡化了拖拽功能的開發門檻。只要在拖拽源(source)與放置目標(target)分別呼叫 draggable 與 droppable 兩個方法,就能快速搭建出流暢的拖放體驗。本文從原理到實作,系統性地整理各類常見用法。

拖拽的基本原理

先釐清兩個核心概念:

  • source(拖拽源):要被拖動的元素。
  • target(放置目標):能接收 source 的容器。

一個完整的拖拽動作可以拆解為:drag start(按下並開始移動)、drag move(移動中)、drag enter(進入目標)、drag leave(離開目標)、drop(在目標上釋放)、drag end(結束)。在 HTML5 問世之前,頁面元素並不直接支援拖拽事件,因此都是靠監聽滑鼠事件並記錄狀態來達成。

最簡單的例子:改變位置

最基礎的拖拽不換容器,只改變元素位置:

<html>
<head></head>
<body>
<div id="container">
<div id="dragsource">
<p>拽我!</p>
</div>
</div><!-- End container -->
<script type="text/javascript" src="js/jquery-1.7.min.js"></script>
<script type="text/javascript" src="js/jquery-ui-1.8.16.custom.min.js"></script>
<script>
$(function() {
$( "#dragsource" ).draggable();
})
</script>
</body>
</html>

拖動到另一個容器

更常見的場景是把元素拖進另一個容器,這時需要在目標上套用 droppable:

<html>
<head></head>
<body>
<div id="container">
<div id="dragsource">
<p>拽我!</p>
</div>
</div><!-- End container -->
<div id="droppalbe" style="width: 300px;height:300px;background-color:gray">
<p>Drop here</p>
</div>
<script type="text/javascript" src="js/jquery-1.7.min.js"></script>
<script type="text/javascript" src="js/jquery-ui-1.8.16.custom.min.js"></script>
<script>
$(function() {
$( "#dragsource" ).draggable();
$( "#droppable" ).droppable();
})
</script>
</body>
</html>

事件監聽與回顯(Feedback)

為了讓使用者清楚知道拖放結果,可以監聽拖拽過程中的事件並給予可見的回饋。source 端可監聽 create、start、drag、stop;target 端則可監聽 create、activate、deactivate、over、out、drop。以下範例透過表情符號變化來呈現回顯:

<html>
<head></head>
<body>
<div id="dragsource">
<p id="targetMsg">:-|</p>
</div>
<div id="droppable" style="background-color:gray;height:300">
<p>Can drop! </p>
</div>
<script type="text/javascript" src="js/jquery-1.7.min.js"></script>
<script type="text/javascript" src="js/jquery-ui-1.8.16.custom.min.js"></script>
<script>
$(function() {
$( "#dragsource" ).draggable({
start: function(event,ui) {
$(this).find("p").html(":-S");
},
stop:function(event,ui){
$(this).find("p").html(":-|");
}
});
$( "#droppable" ).droppable({
activate: function(event,ui) {
$(this).find("p").html( "Drop here !" );
},
over: function(event,ui) {
$( this ).find( "p" ).html( "Oh, Yeah!" );
},
out: function(event,ui) {
$( this ).find( "p" ).html( "Don't leave me!" );
},
drop: function( event, ui ) {
$( this ).find( "p" ).html( "I've got it!" );
}
});
})
</script>
</body>
</html>

複製拖動

除了移動,另一種常見需求是複製拖動(例如 Visio 從圖板拖元素到畫布)。這透過 draggable 的 helper 參數設定,可指定為 "original"(預設,拖動自身)或 "clone"(建立克隆體拖拽),也可傳入自訂函式。使用 clone 時,需在 target 的 drop 事件中手動把元素加入容器,否則放開時不會有任何變化:

<html>
<head></head>
<body>
<div id="dragsource">
<p>拽我!</p>
</div>
<div id="container" style="background-color:gray;height:300">
</div><!-- End container -->
<script type="text/javascript" src="js/jquery-1.7.min.js"></script>
<script type="text/javascript" src="js/jquery-ui-1.8.16.custom.min.js"></script>
<script>
$(function() {
$( "#dragsource" ).draggable({
helper:"clone"
});
$("#container").droppable({
drop:function(event,ui){
$(this).append($("<p style='position:absolute;left:"+
ui.offset.left+";top:"+ui.offset.top+"'>clone</p>"));
}
});
})
</script>
</body>
</html>

拖動控制

限制拖動方向

預設可沿 x、y 兩軸自由拖動,透過 axis 參數可限制為水平或垂直:

<html>
<head></head>
<body>
<div id="dragX">
<p>--</p>
</div>
<div id="dragY">
<p>|</p>
</div>
<script type="text/javascript" src="js/jquery-1.7.min.js"></script>
<script type="text/javascript" src="js/jquery-ui-1.8.16.custom.min.js"></script>
<script>
$(function() {
$("#dragX").draggable({axis:"x"});
$("#dragY").draggable({axis:"y"});
});
</script>
</body>
</html>

限制拖動範圍

containment 參數可約束拖動範圍,接受 Selector、Element、String、Array。String 可為 parent、document、window;Array 則以 [x1,y1,x2,y2] 指定矩形區域:

<html>
<head></head>
<body>
<div id="container" style="background-color:gray;height:300">
<div id="draggable1" style="background-color:red;height:20;width:100">
<p>in parent</p>
</div>
<div id="draggable2" style="background-color:green;height:20;width:100">
<p>in regin</p>
</div>
<script type="text/javascript" src="js/jquery-1.7.min.js"></script>
<script type="text/javascript" src="js/jquery-ui-1.8.16.custom.min.js"></script>
<script>
$(function() {
$("#draggable1" ).draggable({containment: "parent" });
$("#draggable2").draggable({containment: [20,20,300,200] });
});
</script>
</body>
</html>

拖動吸附

使用 snap 可吸附到其他元素,使用 grid 則吸附到網格:

<html>
<head>
<style>
.draggable {background-color:green; width: 90px; height: 80px; padding: 5px; float: left; margin: 0 10px 10px 0; font-size: .9em; }
</style>
</head>
<body>
<div id="container" style="background-color:gray;height:300">
<div id="draggable1" class="draggable">
<p>吸附到其他可拖拽元素</p>
</div>
<div id="draggable2" class="draggable">
<p>吸附到容器</p>
</div>
<div id="draggable3" class="draggable">
<p>吸附到網格(30x30)</p>
</div>
</div><!--container-->
<script type="text/javascript" src="js/jquery-1.7.min.js"></script>
<script type="text/javascript" src="js/jquery-ui-1.8.16.custom.min.js"></script>
<script>
$(function() {
$("#draggable1").draggable({ snap: true });
$("#draggable2").draggable({ snap: "#container"});
$("#draggable3").draggable({grid: [30,30]});
});
</script>
</body>
</html>

拖動把手(handle)

預設整個元素都可拖動,也能指定某個子元素作為把手:

<div id="draggable">
<p>handle</p>
</div>
……
<script>
$("#draggable").draggable({handle:"p"});
</script>

Drop 限制

透過 accept 參數可限定只接受符合特定選擇器的元素:

$(".selector").droppable({ accept: '.special' })

增強用戶體驗

jQuery UI 還提供了不少提升體驗的參數,例如 cursor 指定游標樣式、cursorAt 指定游標在 source 的相對位置、revert 讓 drop 失敗時元素飄回原位。以下是一個綜合範例:

<html>
<head>
<style>
.draggable {background-color:green; width: 90px; height: 80px; padding: 5px; float: left; margin: 0 10px 10px 0; font-size: .9em; }
.droppable { width: 300px; height: 300px; background-color:red}
</style>
</head>
<body>
<div id="draggable2" class="draggable">
<p>I revert when I'm not dropped</p>
</div>
<div id="droppable" class="droppable">
<p>Drop me here</p>
</div>
<script type="text/javascript" src="js/jquery-1.7.min.js"></script>
<script type="text/javascript" src="js/jquery-ui-1.8.16.custom.min.js"></script>
<script>
$(function() {
$( "#draggable2" ).draggable({ revert: "invalid",cursor: "move", cursorAt: { top: 56, left: 56 } });
$( "#droppable" ).droppable({
activeClass: "ui-state-hover",
hoverClass: "ui-state-active",
drop: function( event, ui ) {
$( this )
.addClass( "ui-state-highlight" )
.find( "p" )
.html( "Dropped!" );
}
});
});
</script>
</body>
</html>

小結

jQuery UI 既提供了強大的拖拽能力,又兼顧良好的用戶體驗,同時使用門檻極低。掌握以上常用配置後,更多進階參數可參考官方文件的 Draggable 與 Droppable 章節。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved