自己开发的 vue 滑动按钮组件 vue-better-slider

2022-10-14 15:38:45

写在前面的

这个人第一次尝试开发并发布一个 vue 的组件，该组件实现了类似 ios 手机淘宝客户端 -> 消息界面中消息的滑动删除功能等，如下为该组件的文档。

一个 Vue 的滑动按钮组件，有关滑动方面的处理借鉴 better-scroll 的实现。

起步

安装

npm i --save vue-sliding-button

引入

import Vue from 'vue'
import SlidingButton from 'vue-sliding-button'

Vue.use(SlidingButton)

使用

<template>
    <div>
      <better-slider>
        <div slot="front" class="front">
          前面的内容
        </div>
        <div slot="back" class="back">
          后面的内容
        </div>
      </better-slider>
    </div>
</template>
<script>

</script>

原理

布局

绿色部分为 wrapper，它拥有两个子元素为 back 和 front，它的高度会被 front 撑起。黄色部分为 back，它使用绝对定位，它的高度与 wrapper 相同，值得注意的是为了提高性能，back 在用户触摸该控件是才被插入。front 与 back 同级。

关闭

组件提供关闭动画，调用组件的 close 方法使用，可以通过监听 clickBackEvent 等事件，通过传入的组件引用已调用该方法。需要注意的是，该方法并不会删除该组件，可以通过监听 closeTransitionEndEvent 事件，在其中进行自己的处理。

选项

SlidingButton 支持很多属性。

right

类型：Number
默认值：80
作用：从左向右滑动时，右边展示宽度

left

类型：Number
默认值：80
作用：从右向左滑动时，左边展示宽度

rightBackgroundColor

类型：Number
默认值：80
作用：从左向右滑动时，组件底色，主要用于关闭动画

leftBackgroundColor

类型：Number
默认值：0
作用：从右向左滑动时，组件底色，主要用于关闭动画

momentum

类型：Boolean
默认值：true
作用：表示是否开启惯性动画

momentumTime

类型：Number
默认值：100
作用：表示惯性动画持续时间

deceleration

类型：Number
默认值：0.01
作用：表示惯性动画的减速度

closeTime

类型：Number
默认值：300
作用：表示关闭动画的持续时间

trigger

类型：Boolean
默认值：true
作用：该属性为 true 或 false 并无区别，只要该值发生改变，且用户没有触摸该组件时，就会将组件的 front 置于原始位置。当在列表中使用多个该组件时，可以使用该属性。

事件

注意：event 是事件原生参数，component 是指向该组件的引用。

clickBackEvent

参数：{ Object }.{ event, component }
触发时机：用户点击 back 时

clickFrontEvent

参数：{ Object }.{ event, component }
触发时机：用户点击 front 时

touchStartEvent

参数：{ Object }.{ event, component }
触发时机：用户开始触摸该组件时

closeTransitionEndEvent

参数：{ Object }.{ event, component }
触发时机：关闭动画结束时调用

码农公寓