v-prevent-dbclick
v0.1.3
Published
A component that avoids repeated clicks on the slot.
Downloads
11
Maintainers
wuchouchouReadme
v-prevent-dbclick
用于各种需要避免重复点击的地方。 比如
- 多个购买按钮，在其中一个购买完成前避免其他购买按钮的点击
- 保存按钮，保存成功前避免重复提交
- 各种 ajax 请求，避免因点击重复请求
example here
Install
npm 安装
npm i v-prevent-dbclick --saveInclude plugin in your main.js file.
import Vue from 'vue'
import PreventDbClick from 'v-prevent-dbclick';
Vue.use(PreventDbClick);使用链接引入
<script src="https://unpkg.com/v-prevent-dbclick/dist/v-prevent-dbclick.umd.js"></script><body>
<div id="app">
<v-prevent-dbclick></v-prevent-dbclick>
</div>
</body>
<!-- 先引入vue -->
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<!-- v-prevent-dbclick.js -->
<script src="./v-prevent-dbclick.umd.js"></script>
<script>
new Vue({
el: '#app',
})
</script>
</html>usage
<template>
<v-prevent-dbclick>
<template v-slot="{release,status}">
<button @click="save(release)">
{{status?`不可点击`:`可以点击`}}
</button>
</template>
</v-prevent-dbclick>
</template><script>
export default {
methods:{
save(release){
Promise.resolve('success').then(value=>{
// do something
release()
})
}
}
}
</script>props
下面中所指的
status 均为 slot-scope 中的 status
| param | required | type | default | describe |
| :-------------: | :------: | :-----: | :-------: | :------------------------------------------------------------- |
| debounce | ❌ | number | 0 | 就是 debounce啦 |
| group | ❌ | string | undefined | 分组名称，相同组的状态将会同步 |
| stopPropagation | ❌ | boolean | true | 阻止冒泡，默认在status为true时，阻止 slot 内所有的点击操作 |
| doNothing | ❌ | boolean | false | 什么都不做，可以接收同一个group传递的状态 |
如果你需要使用
throttle，只需要定时调用onTap即可
slot-scope
| param | type | describe |
| :--------: | :------------: | :----------------------------------------------------------- |
| status | Boolean | 代表当前状态是否是点击过 |
| isEmitter | Boolean | 代表当前状态的改变是否是当前 v-prevent-dbclick 触发 |
| customInfo | Any | 调用 sendInfo 时传入的数据，可以用来传递各种东西，比如消息 |
| release | Function | release 调用后将使状态变为未点击过， |
| sendInfo | Function(info) | 设置自定义的 customInfo |
caution
- 注意查看 vue 版本，不是 2.6 以上 vue 版本，不能直接使用 demo 中的 v-slot 的语法，需要使用旧的 slot 语法2.6 之前的 slot 语法
2.6+语法
<template>
<v-prevent-dbclick>
<template v-slot="{release,status}">
<button @click="clickTest(release)">
{{status?`不可点击`:`可以点击`}}
</button>
</template>
</v-prevent-dbclick>
</template>2.6之前的语法
<template>
<v-prevent-dbclick>
<template slot-scope="{data,item}">
<button @click="clickTest(release)">
{{status?`不可点击`:`可以点击`}}
</button>
</template>
</v-prevent-dbclick>
</template>changelog
0.1.2
- add test case
- fix isEmitter error
0.1.1
- 替换更恰当的命名
- 打包体积优化