swipe-action点不动或不显示，根本原因是版本低于3.0、H5端不支持、未用nvue页面、未包裹swipe-action-item、平台不兼容（如H5静默降级）或父容器拦截touch事件。
uni-app 中 swipe-action 组件为什么点不动或不显示？
uni-app 官方从 3.0+ 版本起内置了 swipe-action 组件，但很多人引入后发现左滑无反应、菜单不弹出，甚至控制台报 Unknown custom element。根本原因通常是版本或平台限制没看清。
-
swipe-action仅支持 App（nvue 渲染）、微信小程序、支付宝小程序，H5 端完全不支持（会静默降级为普通 view） - 必须用在
uni-app的非 H5 编译模式下，且 App 端需使用 nvue 页面（不是 vue 页面）才能触发原生滑动效果 - 组件必须包裹在
swipe-action-item内，且每个swipe-action-item只能有一个直接子元素（比如一个view），否则滑动区域识别异常 - 微信小程序中若开启
enablePullDownRefresh，可能干扰滑动手势，建议关闭或用catchtouchmove阻断冲突
不用 swipe-action 怎么手动实现左滑菜单？
当需要 H5 兼容、或对动画/交互有定制需求（比如多级菜单、长按触发、阻力反馈），就得手写滑动逻辑。核心是监听 touch 事件 + 动态计算 translateX。
- 用
touchstart/touchmove/touchend捕获位移，避免用bind:touch*（容易被父容器拦截） - 滑动阈值建议设为
60px，过小易误触，过大难触发；回弹临界点用Math.abs(translateX) > 120判断是否展开 - 务必在
touchmove中调用event.preventDefault()，否则 iOS 微信里会触发页面滚动 - 用
transform: translateX({{offset}}px)实现位移，不要用left或margin-left，否则动画卡顿
<view class="list-item" @touchstart="onTouchStart" @touchmove="onTouchMove" @touchend="onTouchEnd">
<view class="content">{{item.title}}</view>
<view class="actions" :style="{ transform: 'translateX(' + offset + 'px)' }">
<button @tap="onDelete(item.id)">删除</button>
</view>
</view>
swipe-action 和手写方案性能与体验差异在哪？
看似都是“左滑出菜单”，但底层机制完全不同：前者是平台原生控件（App 是原生侧滑，小程序是 WebView 原生组件），后者是 Web 层纯 CSS + JS 模拟。
- App 端：nvue 下
swipe-action滑动丝滑、跟手、可中断，手写方案在长列表中易掉帧（尤其 Android 低端机） - 小程序端：
swipe-action在微信中实际是 WebView 层模拟，但由基础库优化，比手写更稳定；支付宝则真正调用原生能力 - H5 端：只能手写，且要注意
touch-action: pan-y样式防止和页面滚动冲突，否则一滑就滚屏 - 内存占用：手写方案每个 item 都要维护
offset、isMoving等状态，列表项多时注意用key复用或节流touchmove
左滑菜单里点击按钮没反应？常见绑定陷阱
滑动容器的 transform 会改变层叠上下文，导致子元素点击区域偏移或被遮挡，尤其在 iOS Safari 和微信 WebView 中高频出现。
- 确保操作按钮的
z-index足够高（如z-index: 999），且父容器没设overflow: hidden（会裁剪按钮） - 不要把
@tap写在swipe-action-item上，而要写在内部按钮或view上；swipe-action-item只负责滑动，不响应点击 - 手写方案中，若用
position: absolute定位菜单，需确认其父容器是relative，否则定位基准错乱 - 真机调试时，iOS 上
click事件有 300ms 延迟，必须用@tap或fastclick库，否则点一下像没点
touchmove，整个列表就变成无法滚动的“铁板”。 
