手機 QQ 的聊天列表有個經典互動:往左滑動,滑出刪除按鈕;放手時若滑過一半就自動滑到底,不到一半則退回原位。本文記錄從純 JS 實作到封裝成可複用插件的完整過程,包含踩過的坑。
請使用觸控裝置開啟效果頁:https://hovertree.com/texiao/mobile/8/ ,插件版效果:https://hovertree.com/texiao/hewenqi/
插件命名為 hewenqi,核心行為:

核心思路:用 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>
實際專案中這個功能會被用在多處,因此封裝成插件,把「按鈕寬度」抽成參數,由 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 一樣順手」這個模糊要求,拆解成一條條可驗證的具體行為。這也是互動開發的常態。