wxapp/uview-ui/components/u-swipe-action/u-swipe-action.vue
2024-08-03 19:57:17 +08:00

256 lines
8.8 KiB
Vue
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<template>
<view class="">
<movable-area class="u-swipe-action" :style="{ backgroundColor: bgColor }">
<movable-view
class="u-swipe-view"
@change="change"
@touchend="touchend"
@touchstart="touchstart"
direction="horizontal"
:disabled="disabled"
:x="moveX"
:style="{
width: movableViewWidth ? movableViewWidth : '100%'
}"
>
<view
class="u-swipe-content"
@tap.stop="contentClick"
>
<slot></slot>
</view>
<view class="u-swipe-del" v-if="showBtn" @tap.stop="btnClick(index)" :style="[btnStyle(item.style)]" v-for="(item, index) in options" :key="index">
<view class="u-btn-text">{{ item.text }}</view>
</view>
</movable-view>
</movable-area>
</view>
</template>
<script>
/**
* swipeAction 左滑单元格
* @description 该组件一般用于左滑唤出操作菜单的场景,用的最多的是左滑删除操作。
* @tutorial https://www.uviewui.com/components/swipeAction.html
* @property {String} bg-color 整个组件背景颜色(默认#ffffff
* @property {Array} options 数组形式,可以配置背景颜色和文字
* @property {String Number} index 标识符点击时候用于区分点击了哪一个用v-for循环时的index即可
* @property {String Number} btn-width 按钮宽度单位rpx默认180
* @property {Boolean} disabled 是否禁止某个swipeAction滑动默认false
* @property {Boolean} show 打开或者关闭某个组件默认false
* @event {Function} click 点击组件时触发
* @event {Function} close 组件触发关闭状态时
* @event {Function} content-click 点击内容时触发
* @event {Function} open 组件触发打开状态时
* @example <u-swipe-action btn-text="收藏">...</u-swipe-action>
*/
export default {
name: 'u-swipe-action',
props: {
// index值用于得知点击删除的是哪个按钮
index: {
type: [Number, String],
default: ''
},
// 滑动按钮的宽度单位为rpx
btnWidth: {
type: [String, Number],
default: 180
},
// 是否禁止某个action滑动
disabled: {
type: Boolean,
default: false
},
// 打开或者关闭组件
show: {
type: Boolean,
default: false
},
// 组件背景颜色
bgColor: {
type: String,
default: '#ffffff'
},
// 是否使手机发生短促震动目前只在iOS的微信小程序有效(2020-05-06)
vibrateShort: {
type: Boolean,
default: false
},
// 按钮操作参数
options: {
type: Array,
default() {
return [];
}
}
},
watch: {
show: {
immediate: true,
handler(nVal, oVal) {
if (nVal) {
this.open();
} else {
this.close();
}
}
}
},
data() {
return {
moveX: 0, // movable-view元素在x轴上需要移动的目标移动距离用于展开或收起滑动的按钮
scrollX: 0, // movable-view移动过程中产生的change事件中的x轴移动值
status: false, // 滑动的状态,表示当前是展开还是关闭按钮的状态
movableAreaWidth: 0, // 滑动区域
elId: this.$u.guid(), // id用于通知另外组件关闭时的识别
showBtn: false, // 刚开始渲染视图时不显示右边的按钮,避免视图闪动
};
},
computed: {
movableViewWidth() {
return this.movableAreaWidth + this.allBtnWidth + 'px';
},
innerBtnWidth() {
return uni.upx2px(this.btnWidth);
},
allBtnWidth() {
return uni.upx2px(this.btnWidth) * this.options.length;
},
btnStyle() {
return style => {
let css = {};
style.width = this.btnWidth + 'rpx';
return style;
};
}
},
mounted() {
this.getActionRect();
},
methods: {
// 点击按钮
btnClick(index) {
this.status = false;
// this.index为点击的几个组件index为点击某个组件的第几个按钮(options数组的索引)
this.$emit('click', this.index, index);
},
// movable-view元素移动事件
change(e) {
this.scrollX = e.detail.x;
},
// 关闭按钮状态
close() {
this.moveX = 0;
this.status = false;
},
// 打开按钮的状态
open() {
if (this.disabled) return;
this.moveX = -this.allBtnWidth;
this.status = true;
},
// 用户手指离开movable-view元素停止触摸
touchend() {
this.moveX = this.scrollX;
// 停止触摸时候,判断当前是展开还是关闭状态
// 关闭状态
// 这一步很重要需要先给this.moveX一个变化的随机值否则因为前后设置的为同一个值
// props单向数据流的原因导致movable-view元素不会发生变化切记详见文档
// https://uniapp.dcloud.io/use?id=%e5%b8%b8%e8%a7%81%e9%97%ae%e9%a2%98
this.$nextTick(function() {
if (this.status == false) {
// 关闭状态左滑产生的x轴位移为负值也就是说滑动的距离大于按钮的四分之一宽度自动展开按钮
if (this.scrollX <= -this.allBtnWidth / 4) {
this.moveX = -this.allBtnWidth; // 按钮宽度的负值即为展开状态movable-view元素左滑的距离
this.status = true; // 标志当前为展开状态
this.emitOpenEvent();
// 产生震动效果
if (this.vibrateShort) uni.vibrateShort();
} else {
this.moveX = 0; // 如果距离没有按钮宽度的四分之一,自动收起
this.status = false;
this.emitCloseEvent();
}
} else {
// 如果在打开的状态下右滑动的距离X轴偏移超过按钮的四分之一(负值反过来的四分之三),自动收起按钮
if (this.scrollX > (-this.allBtnWidth * 3) / 4) {
this.moveX = 0;
this.$nextTick(() => {
this.moveX = 101;
});
this.status = false;
this.emitCloseEvent();
} else {
this.moveX = -this.allBtnWidth;
this.status = true;
this.emitOpenEvent();
}
}
});
},
emitOpenEvent() {
this.$emit('open', this.index);
},
emitCloseEvent() {
this.$emit('close', this.index);
},
// 开始触摸
touchstart() {},
getActionRect() {
this.$uGetRect('.u-swipe-action').then(res => {
this.movableAreaWidth = res.width;
// 等视图更新完后,再显示右边的可滑动按钮,防止这些按钮会"闪一下"
this.$nextTick(() => {
this.showBtn = true;
})
});
},
// 点击内容触发事件
contentClick() {
// 点击内容时,如果当前为打开状态,收起组件
if (this.status == true) {
this.status = 'close';
this.moveX = 0;
}
this.$emit('content-click', this.index);
}
}
};
</script>
<style scoped lang="scss">
@import "../../libs/css/style.components.scss";
.u-swipe-action {
width: auto;
height: initial;
position: relative;
overflow: hidden;
}
.u-swipe-view {
@include vue-flex;
height: initial;
position: relative;
/* 这一句很关键,覆盖默认的绝对定位 */
}
.u-swipe-content {
flex: 1;
}
.u-swipe-del {
position: relative;
font-size: 30rpx;
color: #ffffff;
}
.u-btn-text {
position: absolute;
top: 50%;
left: 50%;
transform: translate(-50%, -50%);
}
</style>