看到一個不錯的 jQuery 拖曳排序外掛,能把清單順序存到資料庫。這裡用它的 PHP 範例簡單說明運作方式,概念換成任何後端語言都一樣。
<?php
// post 到後台的資料
if ($_POST) {
$ids = $_POST["ids"];
for ($idx = 0; $idx < count($ids); $idx += 1) {
$id = $ids[$idx];
$ordinal = $idx; // 這就是新的排序權重
// ... 寫入資料庫 ...
}
return;
}
?>
前端送來的是一個 id 陣列,陣列的索引就是新的順序。後端只要把 index 當成排序欄位寫回去即可,邏輯非常單純。
<style type="text/css">
body { font-family:Arial; font-size:12pt; padding:20px; width:800px;
margin:20px auto; border:solid 1px black; }
ul { width:350px; list-style-type:none; margin:0; padding:0; }
li { float:left; padding:5px; width:100px; height:100px; }
li div { width:90px; height:50px; border:solid 1px black;
background-color:#E0E0E0; text-align:center; padding-top:40px; }
.placeHolder div { background-color:white !important;
border:dashed 1px gray !important; }
</style>
<ul id="gallery">
<?php
$list = array("blue", "orange", "brown", "red", "yellow", "green", "black", "white", "purple");
for ($idx = 0; $idx < count($list); $idx += 1) {
echo "<li data-itemid='" . $idx . "'>";
echo "<div>" . $list[$idx] . "</div>";
echo "</li>";
}
?>
</ul>
<script type="text/javascript" src="jquery.dragsort-0.5.1.min.js"></script>
<script type="text/javascript">
// saveOrder 為拖曳結束後的回呼
$("#gallery").dragsort({
dragSelector: "div",
dragEnd: saveOrder,
placeHolderTemplate: "<li class='placeHolder'><div></div></li>"
});
function saveOrder() {
var data = $("#gallery li").map(function() {
return $(this).data("itemid");
}).get();
// 以 ajax 模擬 post,格式為 [0, 1, 2, 5, 4, 3, 8, 6, 7]
$.post("example.php", { "ids[]": data });
}
</script>
一、data-itemid 承載穩定識別碼。 每個 li 上寫入的 data-itemid 是該項目在資料庫中的真實 id,而它在畫面上的位置才是排序值。把兩者分開,才能正確回答「哪個項目被移到第幾位」。
二、map().get() 轉出純陣列。 .map() 回傳的是 jQuery 物件,加上 .get() 才會得到真正的 JavaScript 陣列,才能安全地當參數傳出去。
三、placeHolderTemplate 提供視覺回饋。 拖曳時在目標位置留下一個虛線框佔位,使用者才知道放開後會落在哪裡。少了這個,拖曳體驗會差很多。
範例中的 $.post 沒有 error 回呼,代表儲存失敗時使用者完全不會知道,畫面上順序已經變了但資料庫沒更新,重新整理後又跑回舊的——這是這類功能最常見的抱怨來源。請務必加上失敗提示,並在成功後才更新前端狀態,或提供回滾。
另外建議加上防抖(debounce)避免連續拖曳造成請求洗版,並在後端驗證 ids 確實是數字陣列、長度與項目數相符,同時確認該使用者有權修改這些項目,否則任何人都能改寫排序。無障礙方面,純拖曳對鍵盤使用者不友善,最好一併提供上移/下移按鈕作為替代操作。