PC 端用 jQuery 做拖拽很輕鬍,但同一套程式碼搬到行動裝置就完全失效——手機沒有滑鼠,只有觸控。以下示範一個完整的行動端拖拽方案,用 touchstart、touchmove、touchend 三個事件打造,並以 webpack 做模組化打包。
功能目標:列表中的圖片可以被拖到下方的「控制台」區域;放開手指後,控制台裡出現一份複本,原本位置的元素自動歸位;控制台中的元素仍可繼續拖動,也能再拖出控制台外(此時移除)。
三個事件分工明確:touchstart 在手指接觸螢幕時觸發,touchmove 在手指移動時連續觸發(在這個事件裡呼叫 preventDefault() 可以阻止頁面滾動),touchend 在手指離開螢幕時觸發。
三者的 event 物件除了具備滑鼠事件的常見屬性外,還多了三個清單:
touches:目前所有仍在螢幕上的觸控點targetTouches:只包含事件目標上的觸控點changeTouches:自上次事件以來發生變化的觸控點本例需要觸控點相對於視窗的位置,取 event.targetTouches[0].clientX / clientY 即可。
var $ = require('jquery');
var ajax = {
getInitImg: function (parent) {
var num = 50; // 圖片統一高度
$.ajax({
type: "GET",
async: false, // 同步載入,確保圖片就位後才做後續定位
url: '/Home/picwall/index',
dataType: 'json',
success: function (result) {
if (result.status == 1) {
$.each(result.data, function (index, item) {
var src = item.pic_src;
var ratio = num / parseInt(item.height); // 等比縮放
var img = $('<img>')
.attr("src", src)
.height(num)
.width(parseInt(item.width * ratio));
parent.append(img);
});
}
}
});
}
};
module.exports = ajax;
這裡刻意用同步請求,因為後續的位置計算依賴元素已經具備實際尺寸;若圖片還沒載入就量 offset(),算出來的值會是錯的。
var $ = require('jquery');
var position = {
// 依 gap 間距把子元素排成初始版面
init: function (parent, gap) {
var dragElem = parent.children();
if (parent.css('position') !== "relative") {
parent.css('position', 'relative');
}
parent.css({ 'width': "100%", 'z-index': '10' });
var listWidth = 0;
dragElem.each(function (index, elem) {
var curEle = $(elem);
curEle.css({ position: "absolute", top: gap.Y, left: listWidth + gap.X });
curEle.attr('index', index); // 唯一標識,歸位時用
position.coord.push({ X: listWidth + gap.X, Y: gap.Y });
parent.height(parseInt(curEle.css('top')) + curEle.height() + gap.Y);
listWidth = curEle.offset().left + curEle.width();
});
},
// 把子元素插入父元素並指定落點
addTo: function (child, parent, target) {
var parentPos = { X: parent.offset().left, Y: parent.offset().top };
var targetPos = { X: target.offset().left, Y: target.offset().top };
if (parent.css('position') !== "relative") {
parent.css({ 'position': 'relative' });
}
parent.css({ 'z-index': '12' });
parent.append(child);
child.css({
position: "absolute",
top: targetPos.Y - parentPos.Y,
left: targetPos.X - parentPos.X,
width: target.width(),
height: target.height()
});
},
// 依 index 還原到初始座標
restore: function (elem) {
var index = parseInt(elem.attr('index'));
elem.css({ top: position.coord[index].Y, left: position.coord[index].X });
},
coord: [],
// 判定 target 是否完整落在 control 範圍內
isRang: function (control, dragListPar, $target) {
if (control.offset().top > dragListPar.offset().top) {
return $target.offset().top > control.offset().top
&& $target.offset().left > control.offset().left
&& ($target.offset().left + $target.width()) < (control.offset().left + control.width());
}
return ($target.offset().top + $target.height()) < (control.offset().top + control.height())
&& $target.offset().top > control.offset().top
&& $target.offset().left > control.offset().left
&& ($target.offset().left + $target.width()) < (control.offset().left + control.width());
}
};
module.exports = position;
這裡有個關鍵技巧:touchstart 只綁在元素上,touchmove 與 touchend 則在手指按下後才動態掛上,並在移動中持續更新座標。這樣可以避免頁面其他元素誤觸。
var $ = require('jquery');
var position = require('./position.js');
var drag = {
dragParent: undefined, // 拖拽清單的 id
control: undefined, // 控制台的 id
position: { X: undefined, Y: undefined }, // 元素相對視窗位置
touchPos: { X: undefined, Y: undefined }, // 觸控點相對視窗位置(持續更新)
startTouchPos: { X: undefined, Y: undefined }, // 起始觸控點
touchOffsetPos: { X: undefined, Y: undefined }, // 觸控點相對於元素左上角
setID: function (dragList, control) {
this.dragParent = dragList;
this.control = control;
},
touchStart: function (e) {
var $target = $(e.target);
e.stopPropagation();
e.preventDefault(); // 阻止頁面滾動與縮放
drag.startTouchPos.X = e.targetTouches[0].clientX;
drag.startTouchPos.Y = e.targetTouches[0].clientY;
drag.position.X = $target.offset().left;
drag.position.Y = $target.offset().top;
drag.touchPos.X = e.targetTouches[0].clientX;
drag.touchPos.Y = e.targetTouches[0].clientY;
// 手指按在元素內部的哪個相對位置,拖動時要保留這個偏移量
drag.touchOffsetPos.X = drag.touchPos.X - drag.position.X;
drag.touchOffsetPos.Y = drag.touchPos.Y - drag.position.Y;
$target.unbind('touchmove').on('touchmove', drag.touchMove);
},
touchMove: function (e) {
var $target = $(e.target);
e.stopPropagation();
e.preventDefault();
drag.touchPos.X = e.targetTouches[0].clientX;
drag.touchPos.Y = e.targetTouches[0].clientY;
$target.offset({
top: drag.touchPos.Y - drag.touchOffsetPos.Y,
left: drag.touchPos.X - drag.touchOffsetPos.X
});
$target.unbind('touchend').on('touchend', drag.touchEnd);
},
touchEnd: function (e) {
var $target = $(e.target);
e.stopPropagation();
e.preventDefault();
var parent = $target.parent();
var control = $("#" + drag.control);
var dragListPar = $('#' + drag.dragParent);
var sitControl = position.isRang(control, dragListPar, $target);
// 從清單拖進控制台:複製一份放進去,原本那份歸位
if (parent.attr('id') === drag.dragParent) {
if (sitControl) {
var dragChild = $target.clone();
dragChild.unbind('touchstart').on('touchstart', drag.touchStart);
position.addTo(dragChild, control, $target);
}
position.restore($target);
}
// 從控制台拖出界外:直接移除
if (parent.attr('id') === drag.control && !sitControl) {
$target.remove();
}
}
};
module.exports = drag;
require('../css/base.css');
require('../css/drag.css');
var $ = require('jquery');
var drag = require('./drag.js');
var position = require('./position.js');
var ajax = require('./ajax.js');
var dragList = $('#dragList');
var gap = { X: 20, Y: 10 };
ajax.getInitImg(dragList);
position.init(dragList, gap);
// 控制台高度 = 視窗高度 - 清單高度
var control = $('#control');
control.height($(window).height() - dragList.height());
// 為每個元素綁上 touchstart
dragList.children().each(function (index, elem) {
$(elem).unbind('touchstart').on('touchstart', drag.touchStart);
});
drag.setID('dragList', 'control');
上面用了 CommonJS 的 require,瀏覽器並不認識,所以必須先打包。設定檔如下:
var autoHtml = require('html-webpack-plugin');
var webpack = require('webpack');
var extractTextWebpack = require('extract-text-webpack-plugin');
module.exports = {
entry: {
'index': './app/js/index.js',
'jquery': ['jquery']
},
output: {
path: './build/',
filename: 'js/[name].js'
},
module: {
loaders: [
{ test: /\.css/, loader: extractTextWebpack.extract('style', 'css') }
]
},
plugins: [
new extractTextWebpack('css/[name].css', { allChunks: true }),
new webpack.optimize.CommonsChunkPlugin({ name: 'jquery', filename: 'js/jquery.js' }),
new autoHtml({
title: "拖拽",
filename: "drag.html",
template: './app/drag.html',
inject: true
})
]
};
CommonsChunkPlugin 把 jQuery 抽成獨立檔案,瀏覽器可以長期快取;extract-text-webpack-plugin 把 CSS 從 JS 裡分離出來,避免樣式延遲套用造成閃爍。
這個 demo 求的是把流程跑通,仍有幾處值得打磨:拖動時元素沒有層級提升,重疊時可能被壓住;isRang 的判定寫死在特定版面關係上,換版面就要改;多指觸控(例如縮放)完全沒有處理,preventDefault 一律阻止會讓使用者無法縮放頁面。實務上建議把整個 drag 模組再包一層,把「drop 區域判定」抽成可注入的函式,彈性會好很多。