Frontend Development 3 min read

How to Implement Swipe‑to‑Delete in WeChat Mini Programs

This tutorial explains how to create a left‑swipe delete effect in a WeChat Mini Program list view by layering items, using absolute positioning, and handling touchstart, touchmove, and touchend events to move items and reveal action buttons based on swipe distance.

Tencent IMWeb Frontend Team
Tencent IMWeb Frontend Team
Tencent IMWeb Frontend Team
How to Implement Swipe‑to‑Delete in WeChat Mini Programs

Demo

When an item in a list view is swiped left, two buttons appear on the right, allowing the user to delete or perform other actions.

Interaction Logic

If the swipe distance exceeds half the button width, releasing the finger slides the item fully left to reveal the buttons; otherwise the item returns to its original position, hiding the buttons.

Implementation Idea

Each list item consists of two layers: the upper layer holds the normal content, the lower layer contains the hidden buttons. The upper layer is positioned absolutely, and its

left

property is adjusted to follow the finger.

The WeChat Mini Program API provides a

touch

object and three event handlers (

touchstart

,

touchmove

,

touchend

) to track finger movement and update the item position.

Page Layout

The layout is illustrated in the following image:

Page layout
Page layout

JavaScript Code

The core JavaScript code handling the touch events is shown in the images below:

JS code part 1
JS code part 1
JS code part 2
JS code part 2
JS code part 3
JS code part 3

That completes the implementation; feel free to comment with any issues.

JavaScriptWeChat Mini ProgramFrontend UItouch eventsSwipe Delete
Tencent IMWeb Frontend Team
Written by

Tencent IMWeb Frontend Team

IMWeb Frontend Community gathering frontend development enthusiasts. Follow us for refined live courses by top experts, cutting‑edge technical posts, and to sharpen your frontend skills.

0 followers
Reader feedback

How this landed with the community

login Sign in to like

Rate this article

Was this worth your time?

Sign in to rate
Discussion

0 Comments

Thoughtful readers leave field notes, pushback, and hard-won operational detail here.