uView Pro
npm

主题

SwipeAction 滑动操作 ​

13:10

该组件一般用于左滑唤出操作菜单的场景，用的最多的是左滑删除操作。

注意

如果把该组件通过 v-for 用于左滑删除的列表，请保证循环的:key是一个唯一值，可以用数据的 id 或者 title 替代。 不能是数组循环的 index，否则删除的时候，可能会出现数据错乱

平台差异说明 ​

AppH5微信小程序支付宝小程序百度小程序头条小程序QQ 小程序
√√√√√√√

基本使用 ​

  • 通过 slot 传入内部内容即可，可以将v-for的"index"索引值传递给index参数，用于点击时，在回调方法中对某一个数据进行操作(点击回调时第一个参数会返回此索引值)
  • 内部的按钮通过options参数配置，此参数为一个数组，元素为对象，可以配置按钮的文字，背景颜色(建议只配置此两个参数即可)，请勿配置宽高等属性。

说明：有时候，我们在打开一个 swipeAction 的同时，需要自动关闭其他的 swipeAction，这时需要通过open事件实现，见如下：

html
<template>
  <view>
    <u-swipe-action
      :show="item.show"
      :index="index"
      v-for="(item, index) in list"
      :key="item.id"
      @click="click"
      @open="open"
      :options="options"
    >
      <view class="item u-border-bottom">
        <image mode="aspectFill" :src="item.images" />
        <!-- 此层wrap在此为必写的，否则可能会出现标题定位错误 -->
        <view class="title-wrap">
          <text class="title u-line-2">{{ item.title }}</text>
        </view>
      </view>
    </u-swipe-action>
  </view>
</template>

<script setup lang="ts">
import { ref } from 'vue'

// 定义列表项接口
interface ListItem {
  id: number
  title: string
  images: string
  show: boolean
}

// 定义选项按钮接口
interface OptionButton {
  text: string
  style: {
    backgroundColor: string
  }
}

// 定义响应式数据
const list = ref<ListItem[]>([
  {
    id: 1,
    title: "长安回望绣成堆，山顶千门次第开，一骑红尘妃子笑，无人知是荔枝来",
    images: "https://ik.imagekit.io/anyup/uview-pro/common/logo.png",
    show: false,
  },
  {
    id: 2,
    title: "新丰绿树起黄埃，数骑渔阳探使回，霓裳一曲千峰上，舞破中原始下来",
    images: "https://ik.imagekit.io/anyup/uview-pro/common/logo.png",
    show: false,
  },
  {
    id: 3,
    title: "登临送目，正故国晚秋，天气初肃。千里澄江似练，翠峰如簇",
    images: "https://ik.imagekit.io/anyup/uview-pro/common/logo.png",
    show: false,
  },
])

const disabled = ref<boolean>(false)
const btnWidth = ref<number>(180)
const show = ref<boolean>(false)

const options = ref<OptionButton[]>([
  {
    text: "收藏",
    style: {
      backgroundColor: "#007aff",
    },
  },
  {
    text: "删除",
    style: {
      backgroundColor: "#dd524d",
    },
  },
])

// 定义点击事件回调函数
const click = (index: number, index1: number) => {
  if (index1 == 1) {
    list.value.splice(index, 1)
    // uni.$u.toast(`删除了第${index}个cell`)
  } else {
    list.value[index].show = false
    // uni.$u.toast(`收藏成功`)
  }
}

// 定义打开事件回调函数
const open = (index: number) => {
  // 先将正在被操作的swipeAction标记为打开状态，否则由于props的特性限制，
  // 原本为'false'，再次设置为'false'会无效
  list.value[index].show = true
  list.value.map((val, idx) => {
    if (index != idx) list.value[idx].show = false
  })
}
</script>

<style lang="scss" scoped>
.item {
  display: flex;
  padding: 20rpx;
}

image {
  width: 120rpx;
  flex: 0 0 120rpx;
  height: 120rpx;
  margin-right: 20rpx;
  border-radius: 12rpx;
}

.title {
  text-align: left;
  font-size: 28rpx;
  color: $u-content-color;
  margin-top: 20rpx;
}
</style>

修改按钮样式 ​

  • 通过options参数配置按钮的数量和样式，见上方说明
  • 通过btn-width设置按钮的宽度，单位 rpx
html
<u-swipe-action btn-width="180" :options="options"> ... </u-swipe-action>

点击事件 ​

click点击事件回调中，有两个参数，第一个参数为通过 Props 传入的index参数，第二个参数为滑动按钮的索引，即options数组的索引， 用于标识第几个按钮被点击。

API ​

Props ​

参数说明类型默认值可选值
bg-color整个组件背景颜色String#ffffff-
index标识符，点击时候用于区分点击了哪一个，用v-for循环时的 index 即可String | Number--
btn-width按钮宽度，单位 rpxString | Number180-
disabled是否禁止某个 swipeAction 滑动Booleanfalsetrue
vibrate-short是否使手机发生短促震动，目前只在 iOS 的微信小程序和微信小程序开发工具有效Booleanfalsetrue
show打开或者关闭某个组件Booleanfalsetrue
options按钮组的配置参数，数组形式，见上方说明Array[ ]-

Event ​

事件名说明回调参数
click点击组件时触发(index1, index)，见上方"点击事件"的说明
close组件触发关闭状态时index: 通过 props 传递的index
open组件触发打开状态时index: 通过 props 传递的index
content-click点击内容时触发index: 通过 props 传递的index