SwipeCell 滑动单元格
WebH5
滑动单元格。左滑内容跟手左移露出右侧操作区,超过操作区宽度一半松手自动展开,否则弹回。
何时使用
列表项需要隐藏的快捷操作(删除、置顶、标记已读)时。
何时不使用
操作需要始终可见时用普通按钮;操作超过 3 个时用 ActionSheet。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
disabled | boolean | false | 禁用滑动 |
threshold | number | 30 | 松手后判定「展开」所需滑动的距离(px),超过则吸附展开,否则弹回 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
open | void | 操作区完全展开时触发 |
close | void | 操作区收起(弹回 / 点击内容收起 / 程序化 close)时触发 |
Slots
| 名称 | 说明 |
|---|---|
default | 单元格内容,通常放一个 Cell |
right | 右侧滑出的操作区,调用方放按钮(如删除:红底白字) |
Methods
| 名称 | 签名 | 说明 |
|---|---|---|
close | close(): void | 程序化收起操作区(配合列表「同时只展开一个」等场景) |
open | open(): void | 程序化展开操作区 |
示例
左滑删除
示例加载中…
多个操作按钮
示例加载中…
禁用滑动
示例加载中…
列表场景
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 SwipeCell 文档(含手机预览)。