DIV CSS 佈局教程網

用 HTML5 touchmove 實作左滑刪除互動插件
編輯:JavaScript基礎知識     

手機 QQ 的聊天列表有個經典互動:往左滑動,滑出刪除按鈕;放手時若滑過一半就自動滑到底,不到一半則退回原位。本文記錄從純 JS 實作到封裝成可複用插件的完整過程,包含踩過的坑。

請使用觸控裝置開啟效果頁:https://hovertree.com/texiao/mobile/8/ ,插件版效果:https://hovertree.com/texiao/hewenqi/

需求描述

插件命名為 hewenqi,核心行為:

  • 列表項向左拖曳,露出右側的刪除按鈕
  • 拖曳距離以按鈕寬度為上限
  • 放手時以「一半」為臨界值決定吸附位置

一、純 JS 實作

核心思路:用 H5 的 touchstart / touchmove / touchend 三個事件追蹤手指位移,再用 JS 動態修改 CSS3 的 translateX 達到動畫效果。

<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<meta name="viewport" id="viewport" content="width=device-width, initial-scale=1">
<title>html5 向左滑動刪除特效</title>
<style>
* { padding: 0; margin: 0; list-style: none; }
header { background: #f7483b; border-bottom: 1px solid #ccc }
header h2 { text-align: center; line-height: 54px; font-size: 16px; color: #fff }
.list-ul { overflow: hidden }
.list-li {
  line-height: 60px;
  border-bottom: 1px solid #fcfcfc;
  position: relative;
  padding: 0 12px;
  color: #666;
  background: #f2f2f2;
  -webkit-transform: translateX(0px);
}
.btn {
  position: absolute;
  top: 0;
  right: -80px;
  text-align: center;
  background: #ffcb20;
  color: #fff;
  width: 80px;
}
</style>
<script>
window.addEventListener('load', function () {
  var initX;    // 觸摸起始位置
  var moveX;    // 滑動時的位置
  var X = 0;    // 移動距離
  var objX = 0; // 目標物件當前位置

  window.addEventListener('touchstart', function (event) {
    event.preventDefault();
    var obj = event.target.parentNode;
    if (obj.className == "list-li") {
      initX = event.targetTouches[0].pageX;
      objX = (obj.style.WebkitTransform
                 .replace(/translateX\(/g, "")
                 .replace(/px\)/g, "")) * 1;
    }
    if (objX == 0) {
      window.addEventListener('touchmove', function (event) {
        event.preventDefault();
        var obj = event.target.parentNode;
        if (obj.className == "list-li") {
          moveX = event.targetTouches[0].pageX;
          X = moveX - initX;
          if (X >= 0) {
            obj.style.WebkitTransform = "translateX(0px)";
          } else {
            var l = Math.abs(X);
            if (l > 80) l = 80;
            obj.style.WebkitTransform = "translateX(" + (-l) + "px)";
          }
        }
      });
    } else if (objX < 0) {
      window.addEventListener('touchmove', function (event) {
        event.preventDefault();
        var obj = event.target.parentNode;
        if (obj.className == "list-li") {
          moveX = event.targetTouches[0].pageX;
          X = moveX - initX;
          if (X >= 0) {
            var r = -80 + Math.abs(X);
            if (r > 0) r = 0;
            obj.style.WebkitTransform = "translateX(" + r + "px)";
          } else {
            obj.style.WebkitTransform = "translateX(-80px)";
          }
        }
      });
    }
  });

  window.addEventListener('touchend', function (event) {
    event.preventDefault();
    var obj = event.target.parentNode;
    if (obj.className == "list-li") {
      objX = (obj.style.WebkitTransform
                 .replace(/translateX\(/g, "")
                 .replace(/px\)/g, "")) * 1;
      if (objX > -40) {     // 未過半,回位
        obj.style.WebkitTransform = "translateX(0px)";
        objX = 0;
      } else {              // 過半,滑到底
        obj.style.WebkitTransform = "translateX(-80px)";
        objX = -80;
      }
    }
  });
});
</script>
</head>
<body>
<header><h2>消息列表</h2></header>
<section class="list">
  <ul class="list-ul">
    <li class="list-li">
      <div class="con">你的快遞到了,請到樓下簽收</div>
      <div class="btn">刪除</div>
    </li>
    <li class="list-li">
      <div class="con">哇,你在干嘛,快點來啊就等你了</div>
      <div class="btn">刪除</div>
    </li>
  </ul>
</section>
</body>
</html>

二、封裝成 hewenqi 插件

實際專案中這個功能會被用在多處,因此封裝成插件,把「按鈕寬度」抽成參數,由 JS 計算滑動距離而非寫死 80。

插件展示頁:https://hovertree.com/texiao/hewenqi/

zepto.touchWipe.js

/**
 * zepto 插件:向左滑動刪除動效
 * 使用方法:$('.itemWipe').touchWipe({itemDelete: '.item-delete'});
 * 參數:itemDelete 刪除按鈕的樣式名
 */
;(function ($) {
  $.fn.touchWipe = function (option) {
    var defaults = {
      itemDelete: '.item-delete'   // 刪除元素
    };
    var opts = $.extend({}, defaults, option);
    var delWidth = $(opts.itemDelete).width();   // 動態取得按鈕寬度

    var initX, moveX, X = 0, objX = 0;

    $(this).on('touchstart', function (event) {
      event.preventDefault();
      var obj = this;
      initX = event.targetTouches[0].pageX;
      objX = (obj.style.WebkitTransform
                 .replace(/translateX\(/g, "")
                 .replace(/px\)/g, "")) * 1;

      if (objX == 0) {
        $(this).on('touchmove', function (event) {
          event.preventDefault();
          moveX = event.targetTouches[0].pageX;
          X = moveX - initX;
          if (X >= 0) {
            obj.style.WebkitTransform = "translateX(0px)";
          } else {
            var l = Math.abs(X);
            if (l > delWidth) l = delWidth;
            obj.style.WebkitTransform = "translateX(" + (-l) + "px)";
          }
        });
      } else if (objX < 0) {
        $(this).on('touchmove', function (event) {
          event.preventDefault();
          moveX = event.targetTouches[0].pageX;
          X = moveX - initX;
          if (X >= 0) {
            var r = -delWidth + Math.abs(X);
            if (r > 0) r = 0;
            obj.style.WebkitTransform = "translateX(" + r + "px)";
          } else {
            obj.style.WebkitTransform = "translateX(" + (-delWidth) + "px)";
          }
        });
      }
    });

    $(this).on('touchend', function (event) {
      event.preventDefault();
      var obj = this;
      objX = (obj.style.WebkitTransform
                 .replace(/translateX\(/g, "")
                 .replace(/px\)/g, "")) * 1;

      if (objX > -delWidth / 2) {
        obj.style.transition = "all 0.2s";
        obj.style.WebkitTransform = "translateX(0px)";
        obj.style.transition = "all 0";
        objX = 0;
      } else {
        obj.style.transition = "all 0.2s";
        obj.style.WebkitTransform = "translateX(" + (-delWidth) + "px)";
        obj.style.transition = "all 0";
        objX = -delWidth;
      }
    });

    return this;   // 鏈式呼叫
  };
})(Zepto);

這裡有兩個改進:一是用 $(opts.itemDelete).width() 動態取得按鈕寬度;二是放手時加上 transition 讓吸附動作有過渡動畫,動完再清掉,避免拖曳時產生延遲。

touchWipe.html

<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<meta name="viewport" id="viewport" content="width=device-width, initial-scale=1">
<title>html5 向左滑動刪除特效</title>
<style>
*{ padding:0; margin:0; list-style: none;}
header{ background: #f7483b; border-bottom: 1px solid #ccc}
header h2{ text-align: center; line-height: 54px; font-size: 16px; color: #fff}
.list-ul{ overflow: hidden}
.list-li{
  line-height: 60px;
  border-bottom: 1px solid #fcfcfc;
  position: relative;
  padding: 0 12px;
  color: #666;
  background: #f2f2f2;
  -webkit-transform: translateX(0px);
}
.btn{
  position: absolute;
  top: 0;
  right: -80px;
  text-align: center;
  background: #ffcb20;
  color: #fff;
  width: 80px;
}
</style>
</head>
<body>
<header><h2>消息列表</h2></header>
<section class="list">
  <ul class="list-ul">
    <li class="list-li">
      <div class="con">你的快遞到了,請到樓下簽收</div>
      <div class="btn">刪除</div>
    </li>
    <li class="list-li">
      <div class="con">哇,你在干嘛,快點來啊就等你了</div>
      <div class="btn">刪除</div>
    </li>
  </ul>
</section>
<script type="text/javascript" src="https://apps.bdimg.com/libs/zepto/1.1.4/zepto.min.js"></script>
<script type="text/javascript" src="zepto.touchWipe.js"></script>
<script type="text/javascript">
$(function () {
  $('.list-li').touchWipe({ itemDelete: '.btn' });
});
</script>
</body>
</html>

實際專案中的應用效果:

三、踩坑與修正

功能看似完成,但有兩個必須解決的問題:

問題一:刪除按鈕點擊失靈。因為按鈕內的 span 無法把點擊事件冒泡到大按鈕上。

解法很簡單,把 span 去掉,改用 CSS 的偽元素寫入文字:

.itemWipe .item-delete:before {
  content: '刪除';
  color: #fff;
}

問題二(嚴重):頁面無法上下滾動。我們在 touchmove 裡呼叫了 preventDefault() 屏蔽瀏覽器原生行為,導致使用者上下滑動列表時頁面完全滾不動。

網上常見的建議是引入 iScroll,但我們選擇參考手機 QQ 的做法,用更輕量的方案:

原理:在滑動剛開始時判斷方向——比較 Y 軸位移與 X 軸位移哪個更大。若 X 軸位移明顯較大,判定為「橫向滑動刪除」,此時才呼叫 preventDefault();若 Y 軸佔優勢,就讓頁面正常滾動。

var startX, startY, isHorizontal = null;

el.addEventListener('touchstart', function (e) {
  startX = e.targetTouches[0].pageX;
  startY = e.targetTouches[0].pageY;
  isHorizontal = null;
});

el.addEventListener('touchmove', function (e) {
  var dx = e.targetTouches[0].pageX - startX;
  var dy = e.targetTouches[0].pageY - startY;

  // 第一次判定方向,之後鎖定,避免中途抖動
  if (isHorizontal === null && (Math.abs(dx) > 5 || Math.abs(dy) > 5)) {
    isHorizontal = Math.abs(dx) > Math.abs(dy);
  }

  if (isHorizontal) {
    e.preventDefault();   // 只有橫向才攔截原生滾動
    // ... translateX 邏輯
  }
});

加上這段方向判定後,頁面可以正常滾動、連結也能點擊。

請掃描二維碼體驗效果:

說明頁:https://hovertree.com/h/bjaf/rfsnyuyo.htm

小結

這個效果技術難度不高,但細節很多:拖曳上限、放手臨界值、動畫過渡、事件冒泡、方向判定。真正花時間的是把「像 QQ 一樣順手」這個模糊要求,拆解成一條條可驗證的具體行為。這也是互動開發的常態。

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