feat: #412 支持全局点击防抖动

README.md

@@ -91,7 +91,7 @@ Module 的 build.gradle 添加依赖框架
 
 ```groovy
 dependencies {
-    implementation 'com.github.liangjingkanji:BRV:1.5.7'
+    implementation 'com.github.liangjingkanji:BRV:1.5.8'
 }
 ```
 

README_EN.md

@@ -88,7 +88,7 @@ Then, add the framework dependency to the module's build.gradle file:
 
 ```groovy
 dependencies {
-    implementation 'com.github.liangjingkanji:BRV:1.5.6'
+    implementation 'com.github.liangjingkanji:BRV:1.5.8'
 }
 ```
 

brv/src/main/java/com/drake/brv/BindingAdapter.kt

@@ -287,7 +287,7 @@ open class BindingAdapter : RecyclerView.Adapter<BindingAdapter.BindingViewHolde
         }
 
     /** 防抖动点击事件的间隔时间, 单位毫秒 */
-    var clickThrottle: Long = BRV.clickThrottle
+    var debounceClickInterval: Long = BRV.debounceClickInterval
 
     /**
      * 监听指定Id控件的点击事件, 包含防抖动
@@ -1096,7 +1096,7 @@ open class BindingAdapter : RecyclerView.Adapter<BindingAdapter.BindingViewHolde
                         (clickListener.value.first ?: onClick)?.invoke(this, it.id)
                     }
                 } else {
-                    view.throttleClick(clickThrottle) {
+                    view.setOnDebounceClickListener(debounceClickInterval) {
                         (clickListener.value.first ?: onClick)?.invoke(this@BindingViewHolder, id)
                     }
                 }

brv/src/main/java/com/drake/brv/listener/ThrottleClickListener.kt → brv/src/main/java/com/drake/brv/listener/OnDebounceClickListener.kt

@@ -25,21 +25,27 @@
 package com.drake.brv.listener
 
 import android.view.View
+import com.drake.brv.utils.BRV
 
 
-internal fun View.throttleClick(period: Long = 500, block: View.() -> Unit) {
-    setOnClickListener(ThrottleClickListener(period, block))
+internal fun View.setOnDebounceClickListener(interval: Long = 500, block: View.() -> Unit) {
+    setOnClickListener(OnDebounceClickListener(interval, block))
 }
 
-private class ThrottleClickListener(private val period: Long = 500, private var block: View.() -> Unit) :
-        View.OnClickListener {
+private class OnDebounceClickListener(
+    private val interval: Long = 500,
+    private var block: View.() -> Unit
+) : View.OnClickListener {
 
-    private var lastTime: Long = 0
+    private var _lastDebounceClickTime: Long = 0
+    private var lastDebounceClickTime: Long
+        get() = if (BRV.debounceGlobalEnabled) BRV.lastDebounceClickTime else _lastDebounceClickTime
+        set(value) = if (BRV.debounceGlobalEnabled) BRV.lastDebounceClickTime = value else _lastDebounceClickTime = value
 
     override fun onClick(v: View) {
         val currentTime = System.currentTimeMillis()
-        if (currentTime - lastTime > period) {
-            lastTime = currentTime
+        if (currentTime - lastDebounceClickTime > interval) {
+            lastDebounceClickTime = currentTime
             block(v)
         }
     }

brv/src/main/java/com/drake/brv/utils/BRV.kt

@@ -43,5 +43,21 @@ object BRV {
      * 防抖动点击事件默认的间隔时间, 单位毫秒
      * @see com.drake.brv.BindingAdapter.onClick
      */
+    var debounceClickInterval: Long = 500
+
+    @Deprecated("命名规范", ReplaceWith("BRV.debounceClickInterval"), DeprecationLevel.ERROR)
     var clickThrottle: Long = 500
+
+    /**
+     * 启用item所有view点击事件共享防抖动间隔, BRV默认防抖动仅针对单个view
+     * @see com.drake.brv.BindingAdapter.onClick
+     */
+    var debounceGlobalEnabled: Boolean = false
+
+    /**
+     * 此变量用于支持全局控件防抖动
+     * @see com.drake.brv.BindingAdapter.onClick
+     * @see debounceGlobalEnabled 要求先启用全局共享防抖动
+     */
+    var lastDebounceClickTime: Long = 0
 }

docs/click.md

@@ -57,17 +57,27 @@ BRV使用`onClick`函数设置监听事件即包含防抖动, 以下为修改防
 
 === "全局"
     ```kotlin
-    BRV.clickThrottle = 1000 // 单位毫秒
+    BRV.debounceClickInterval = 1000 // 单位毫秒
     ```
 
 === "单例"
     ```kotlin hl_lines="2"
     binding.rv.linear().setup {
-        clickThrottle = 1000 // 覆盖全局设置
+        debounceClickInterval = 1000 // 覆盖全局设置
 
         addType<SimpleModel>(R.layout.item_simple)
         R.id.item.onClick {
             toast("点击文本")
         }
     }.models = getData()
-    ```
+    ```
+=== "共享防抖动"
+    ```kotlin
+    // 启用item所有view点击事件共享防抖动间隔, BRV默认防抖动仅针对单个view
+    BRV.debounceGlobalEnabled = true
+    ```
+
+!!! question "全局防抖动"
+    使用`BRV.lastDebounceClickTime`来判断抖动间隔时间, 即可统一BRV和你实现的防抖动点击事件监听
+
+    - [防抖动示例](https://github.com/liangjingkanji/BRV/blob/master/brv/src/main/java/com/drake/brv/listener/OnDebounceClickListener.kt)

docs/updates.md

@@ -1,5 +1,8 @@
+## 1.5.8
+- feat: #412 支持全局点击防抖动
+
 ## 1.5.7
-fix: #409 修复单一展开模式下删除数据后展开导致崩溃
+- fix: #409 修复单一展开模式下删除数据后展开导致崩溃
 
 ## 1.5.6
 - fix: #402 修复Staggered布局+分割线添加数据崩溃