Anchor add Find

Author: fengpeng

app/src/main/java/com/pizzk/overlay/app/MainActivity.kt

@@ -1,10 +1,13 @@
 package com.pizzk.overlay.app
 
+import android.graphics.Color
 import androidx.appcompat.app.AppCompatActivity
 import android.os.Bundle
 import android.view.View
-import android.widget.Toast
+import android.view.ViewGroup
 import androidx.constraintlayout.widget.ConstraintSet
+import androidx.recyclerview.widget.LinearLayoutManager
+import androidx.recyclerview.widget.RecyclerView
 import com.pizzk.overlay.*
 import com.pizzk.overlay.el.Anchor
 import com.pizzk.overlay.el.Marker
@@ -16,30 +19,32 @@ class MainActivity : AppCompatActivity() {
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_main)
+        val rv: RecyclerView = findViewById(R.id.vRecycler)
+        rv.layoutManager = LinearLayoutManager(baseContext)
+        rv.adapter = ListAdapter()
+        //
         val vOverlay: OverlayLayout = findViewById(R.id.vOverlay)
         vOverlay.setMaskColor(R.color.overlay_mask)
         vOverlay.setVisibility(false)
         adapter.with(vOverlay)
         findViewById<View>(R.id.tv1).setOnClickListener {
-            Toast.makeText(baseContext, "TV1 clicked", Toast.LENGTH_SHORT).show()
             buildMultiOverlay()
             adapter.next()
         }
         findViewById<View>(R.id.tv2).setOnClickListener {
-            Toast.makeText(baseContext, "TV2 clicked", Toast.LENGTH_SHORT).show()
             buildMultiAnchor()
             adapter.next()
         }
     }
 
     private fun buildMultiOverlay() {
         val overlay1 = Overlay.Builder()
-            .anchor(Anchor.rect(R.id.tv1, radius = 10, inset = 10))
+            .anchor(Anchor.rect(R.id.tv1, radius = 10, outset = 10))
             .marker(R.layout.tv1_marker)
             .build()
         overlay1.marker(R.layout.tv1_marker, m1Layout)
         val overlay2 = Overlay.Builder()
-            .anchor(Anchor.circle(R.id.tv2, inset = 30))
+            .anchor(Anchor.circle(R.id.tv2, outset = 30))
             .marker(R.layout.tv2_marker)
             .build()
         overlay2.marker(R.layout.tv2_marker, m2Layout)
@@ -48,14 +53,23 @@ class MainActivity : AppCompatActivity() {
 
     private fun buildMultiAnchor() {
         val overlay = Overlay.Builder()
-            .anchor(Anchor.rect(R.id.tv1, radius = 10, inset = 5))
+            .anchor(Anchor.rect(R.id.tv1, radius = 10, outset = 5))
             .marker(R.layout.tv1_marker)
-            .anchor(Anchor.circle(R.id.tv2, inset = 20))
+            .anchor(Anchor.circle(R.id.tv2, outset = 20))
             .marker(R.layout.tv2_marker)
+            //
+            .anchor(Anchor.rect(R.id.vRecycler, radius = 10, outset = 5))
             .build()
         overlay.marker(R.layout.tv1_marker, m1Layout)
         overlay.marker(R.layout.tv2_marker, m2Layout)
-        adapter.overlays(listOf(overlay))
+        //特殊情况：从RecyclerView中获取定位子元素，不能使用使用常规的findViewById
+        overlay.anchor(R.id.vRecycler, object : Anchor.Find {
+            override fun onFind(parent: ViewGroup, id: Int): View? {
+                val v: ViewGroup? = findViewById(id)
+                return v?.getChildAt(2)
+            }
+        })
+        adapter.overlays(overlay)
     }
 
     private val m1Layout: Marker.MarkerLayout = object : Marker.MarkerLayout() {
@@ -77,4 +91,21 @@ class MainActivity : AppCompatActivity() {
             setParentClickListener { adapter.next() }
         }
     }
+
+    private class ListAdapter : RecyclerView.Adapter<RecyclerView.ViewHolder>() {
+        private val colors: List<Int> = listOf(Color.RED, Color.GREEN, Color.BLUE)
+
+        override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): RecyclerView.ViewHolder {
+            val v = View(parent.context)
+            val lp = ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, 200)
+            v.layoutParams = lp
+            return object : RecyclerView.ViewHolder(v) {}
+        }
+
+        override fun onBindViewHolder(holder: RecyclerView.ViewHolder, position: Int) {
+            holder.itemView.setBackgroundColor(colors[position % colors.size])
+        }
+
+        override fun getItemCount(): Int = 4
+    }
 }

app/src/main/res/layout/activity_main.xml

@@ -37,6 +37,15 @@
         app:layout_constraintTop_toTopOf="parent"
         tools:ignore="HardcodedText" />
 
+    <androidx.recyclerview.widget.RecyclerView
+        android:id="@+id/vRecycler"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="60dp"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toBottomOf="@+id/tv2" />
+
 
     <com.pizzk.overlay.OverlayLayout
         android:id="@+id/vOverlay"

lib/src/main/java/com/pizzk/overlay/OverlayAdapter.kt

@@ -17,14 +17,24 @@ class OverlayAdapter {
         return this
     }
 
+    fun overlays(vararg vs: Overlay): OverlayAdapter {
+        return overlays(vs.toList())
+    }
+
     fun next(): Boolean {
         val view: OverlayLayout = view ?: return false
         if (overlays.isEmpty()) {
+            view.setOverlay(null)
             view.setVisibility(false)
             return false
         }
         view.setVisibility(true)
         view.setOverlay(overlays.removeAt(0))
         return true
     }
+
+    fun finish() {
+        overlays.clear()
+        next()
+    }
 }

lib/src/main/java/com/pizzk/overlay/OverlayLayout.kt

@@ -73,16 +73,16 @@ class OverlayLayout : ConstraintLayout {
         //
         val lf = LayoutInflater.from(viewGroup.context)
         overlay.anchors.forEach { e: Anchor ->
-            val vAnchor: View = viewGroup.findViewById(e.id)
+            val vAnchor: View = e.find.onFind(viewGroup, e.id) ?: return@forEach
             //计算宽度及位置
             vAnchor.getLocationOnScreen(vAnchorXY)
             rect.left = vAnchorXY[0] - vXY[0] - 0f
             rect.top = vAnchorXY[1] - vXY[1] - 0f
             rect.right = rect.left + vAnchor.width
             rect.bottom = rect.top + vAnchor.height
             //镂空样式
-            val inset = e.inset.toFloat()
-            rect.inset(-inset, -inset)
+            val outset = e.outset.toFloat()
+            rect.inset(-outset, -outset)
             //锚点生产及绘制
             e.draw.onDraw(canvas, paint, e, rect)
             val anchor = onFakeAnchor(e.id, rect.toRect())

lib/src/main/java/com/pizzk/overlay/el/Anchor.kt

@@ -3,6 +3,8 @@ package com.pizzk.overlay.el
 import android.graphics.Canvas
 import android.graphics.Paint
 import android.graphics.RectF
+import android.view.View
+import android.view.ViewGroup
 import androidx.annotation.IdRes
 
 /**
@@ -13,9 +15,10 @@ class Anchor(
     val id: Int,
     val radius: Int,
     val circle: Boolean,
-    val inset: Int
+    val outset: Int
 ) {
-    var draw: Draw = delegateDraw
+    internal var draw: Draw = delegateDraw
+    internal var find: Find = delegateFind
 
     /**
      * 锚点绘制接口
@@ -24,6 +27,13 @@ class Anchor(
         fun onDraw(canvas: Canvas, paint: Paint, e: Anchor, rect: RectF)
     }
 
+    /**
+     * 锚点查找接口，默认使用findViewById，可自定义实现查找匹配
+     */
+    interface Find {
+        fun onFind(parent: ViewGroup, @IdRes id: Int): View?
+    }
+
     /**
      * 默认支持绘制圆形和矩形
      */
@@ -46,21 +56,28 @@ class Anchor(
         }
     }
 
+    class AnchorFind : Find {
+        override fun onFind(parent: ViewGroup, @IdRes id: Int): View? {
+            return parent.findViewById(id)
+        }
+    }
+
     companion object {
         private val delegateDraw: Draw by lazy { AnchorDraw() }
+        private val delegateFind: Find by lazy { AnchorFind() }
 
         /**
          * 构建矩形锚点
          */
-        fun rect(@IdRes id: Int, radius: Int = 0, inset: Int = 0): Anchor {
-            return Anchor(id, radius, circle = false, inset)
+        fun rect(@IdRes id: Int, radius: Int = 0, outset: Int = 0): Anchor {
+            return Anchor(id, radius, circle = false, outset)
         }
 
         /**
          * 构建圆形锚点
          */
-        fun circle(@IdRes id: Int, inset: Int = 0): Anchor {
-            return Anchor(id, radius = 0, circle = true, inset)
+        fun circle(@IdRes id: Int, outset: Int = 0): Anchor {
+            return Anchor(id, radius = 0, circle = true, outset)
         }
     }
 }

lib/src/main/java/com/pizzk/overlay/el/Marker.kt

@@ -12,7 +12,7 @@ class Marker(
     @IdRes
     val anchor: Int
 ) {
-    var layout: Layout = delegateLayout
+    internal var layout: Layout = delegateLayout
 
     interface Layout {
         fun onLayout(cs: ConstraintSet, marker: View, anchor: View)

lib/src/main/java/com/pizzk/overlay/el/Overlay.kt

@@ -3,7 +3,6 @@ package com.pizzk.overlay.el
 import androidx.annotation.IdRes
 import androidx.annotation.LayoutRes
 
-
 class Overlay(val anchors: List<Anchor>, val markers: List<Marker>) {
 
     class Builder {
@@ -35,6 +34,11 @@ class Overlay(val anchors: List<Anchor>, val markers: List<Marker>) {
         anchor.draw = draw
     }
 
+    fun anchor(@IdRes id: Int, find: Anchor.Find) {
+        val anchor = anchors.find { it.id == id } ?: return
+        anchor.find = find
+    }
+
     fun marker(@LayoutRes id: Int, layout: Marker.Layout) {
         val marker = markers.find { it.id == id } ?: return
         marker.layout = layout