DIV CSS 佈局教程網

jQuery 行動端拖拽實作:觸控事件、模組化與 webpack 打包
編輯:JQuery入門技巧     

PC 端用 jQuery 做拖拽很輕鬍,但同一套程式碼搬到行動裝置就完全失效——手機沒有滑鼠,只有觸控。以下示範一個完整的行動端拖拽方案,用 touchstart、touchmove、touchend 三個事件打造,並以 webpack 做模組化打包。

功能目標:列表中的圖片可以被拖到下方的「控制台」區域;放開手指後,控制台裡出現一份複本,原本位置的元素自動歸位;控制台中的元素仍可繼續拖動,也能再拖出控制台外(此時移除)。

一、觸控事件基礎

三個事件分工明確:touchstart 在手指接觸螢幕時觸發,touchmove 在手指移動時連續觸發(在這個事件裡呼叫 preventDefault() 可以阻止頁面滾動),touchend 在手指離開螢幕時觸發。

三者的 event 物件除了具備滑鼠事件的常見屬性外,還多了三個清單:

  • touches:目前所有仍在螢幕上的觸控點
  • targetTouches:只包含事件目標上的觸控點
  • changeTouches:自上次事件以來發生變化的觸控點

本例需要觸控點相對於視窗的位置,取 event.targetTouches[0].clientX / clientY 即可。

二、ajax 模組:取得初始圖片清單

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(),算出來的值會是錯的。

三、position 模組:位置初始化、歸位與範圍判定

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;

四、drag 模組:三個觸控事件的接力

這裡有個關鍵技巧: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;

五、入口檔 index.js

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');

六、webpack 打包

上面用了 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 區域判定」抽成可注入的函式,彈性會好很多。

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