jQuery UI 官方的購物車範例示範了「把商品拖進車裡」,但沒有處理「車內商品的順序調整」。本文要做的就是把官方範例再往前推一步:拖進去的項目,還可以在購物車裡自由排序。
原始參考範例來自 jsFiddle 上的 KyleMit 版本(該站台可能需要特殊網路環境才能開啟預覽)。
左側是可折疊的商品目錄,右側是一個有序列表充當購物車,並預先放一筆 placeholder 提示文字。
<div id="products">
<h1 class="ui-widget-header">Products</h1>
<div id="catalog">
<h2><a href="#">T-Shirts</a></h2>
<div>
<ul>
<li>Lolcat Shirt</li>
<li>Cheezeburger Shirt</li>
<li>Buckit Shirt</li>
</ul>
</div>
<h2><a href="#">Bags</a></h2>
<div>
<ul>
<li>Zebra Striped</li>
<li>Black Leather</li>
<li>Alligator Leather</li>
</ul>
</div>
<h2><a href="#">Gadgets</a></h2>
<div>
<ul>
<li>iPhone</li>
<li>iPod</li>
<li>iPad</li>
</ul>
</div>
</div>
</div>
<div id="cart">
<h1 class="ui-widget-header">Shopping Cart</h1>
<div class="ui-widget-content">
<ol>
<li class="placeholder">Add your items here</li>
</ol>
</div>
</div>
$(function () {
$("#catalog").accordion();
$("#catalog li").draggable({
appendTo: "body",
helper: "clone",
connectToSortable: "#cart ol" // 關鍵:把拖拽來源接到可排序列表
});
$("#cart ol").sortable({
items: "li:not(.placeholder)",
connectWith: "li",
sort: function () {
$(this).removeClass("ui-state-default");
},
over: function () {
// 有項目進入時,先把 placeholder 收起來
$(".placeholder").hide();
},
out: function () {
if ($(this).children(":not(.placeholder)").length == 0) {
// 車子空了,再把提示文字放回來
$(".placeholder").show();
}
}
});
});
1. draggable 的 connectToSortable
這是「拖進去之後還能排序」的核心。它把來源元素和目標 sortable 容器連成一條通道,因此放開滑鼠的瞬間,項目會被插入到列表的正確位置,而不是單純複製一份。
2. helper: "clone"
拖曳過程中顯示的是一個克隆的浮動副本,原始列表裡的項目不會消失。這樣商品目錄永遠保持完整,使用者可以重複拖同一項。
3. placeholder 的顯示與隱藏
items: "li:not(.placeholder)" 把提示列排除在排序對象之外;再用 over/out 兩個回呼,依購物車是否為空決定提示文字要不要出現。少了這一步,提示文字就會被使用者拖來拖去。
jQuery UI 內建了一組狀態樣式類別,分別對應不同的互動階段:
ui-state-default:元素的常態外觀。ui-state-hover:滑鼠懸停在「可拖曳物件」上時。ui-state-active/拖入容器時的高亮回饋。本文的範例程式碼沒有把這些狀態效果完整呈現出來,實務上你可以自行掛上 start、stop 等事件,讓使用者更清楚知道「現在能不能放」。
以上就是 jQuery UI 拖拽排序的完整分析。掌握 draggable 與 sortable 的互接方式之後,看板排序、模組化首頁、商品清單調整都能用同一套思路完成。