Android中带横向RecyclerView的粘性Header无法响应触摸及滚动求助

问题 #

实现多视图类型RecyclerView的粘性Header（通过自定义ItemDecoration），显示正常，但Header内部的横向RecyclerView无法响应触摸事件（点击、滚动均失效）。已尝试以下方案但未解决：

• 自定义ItemDecoration实现粘性Header
• 使用parent.addOnItemTouchListener()拦截触摸事件
• 添加TouchDelegate传递触摸事件

核心原因 #

通过ItemDecoration.onDrawOver()绘制的Header只是画布上的像素内容，并非真正添加到ViewGroup的子View，Android系统的触摸事件分发机制不会识别这类“虚拟View”，因此Header内部的横向RecyclerView无法接收到任何触摸事件。

解决方案 #

放弃仅靠画布绘制的方式，将Header View作为真实View添加到RecyclerView的父容器中，通过监听RecyclerView滚动事件控制Header的位置实现粘性效果，同时手动处理触摸事件的分发，确保Header内部的子View能正常响应交互。

修改后的完整代码 #

class HeaderItemDecoration(
    private val parent: RecyclerView,
    private val shouldFadeOutHeader: Boolean = false,
    private val isHeader: (itemPosition: Int) -> Boolean
) : RecyclerView.ItemDecoration() {

    private var currentHeader: Pair<Int, RecyclerView.ViewHolder>? = null
    private var headerView: View? = null
    private val parentView: ViewGroup = parent.parent as ViewGroup

    init {
        parent.adapter?.registerAdapterDataObserver(object : RecyclerView.AdapterDataObserver() {
            override fun onChanged() {
                currentHeader = null
                headerView?.let { parentView.removeView(it) }
                headerView = null
            }
        })

        parent.addOnScrollListener(object : RecyclerView.OnScrollListener() {
            override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
                updateHeaderPosition()
            }
        })

        // 处理触摸事件分发，确保Header内部View能接收事件
        parent.setOnTouchListener { _, event ->
            headerView?.let { header ->
                if (isTouchInHeader(event, header)) {
                    // 将触摸坐标转换为Header内部的相对坐标
                    val x = event.rawX - header.left
                    val y = event.rawY - header.top
                    val transformedEvent = MotionEvent.obtain(
                        event.downTime,
                        event.eventTime,
                        event.action,
                        x,
                        y,
                        event.metaState
                    )
                    // 分发事件给Header
                    header.dispatchTouchEvent(transformedEvent)
                    transformedEvent.recycle()
                    // 如果Header内部有可交互View，拦截事件不再向下传递
                    return@setOnTouchListener header.hasOnClickListeners() || 
                            (header as? ViewGroup)?.childCount?.let { count ->
                                count > 0 && header.getChildAt(0).isEnabled
                            } == true
                }
            }
            false
        }
    }

    private fun updateHeaderPosition() {
        val topChild = parent.findChildViewUnder(
            parent.paddingLeft.toFloat(),
            parent.paddingTop.toFloat()
        ) ?: return
        val topChildPosition = parent.getChildAdapterPosition(topChild)
        if (topChildPosition == RecyclerView.NO_POSITION) return

        val headerPosition = getHeaderPositionForItem(topChildPosition)
        if (headerPosition == RecyclerView.NO_POSITION) {
            // 没有Header时移除当前Header
            headerView?.let { parentView.removeView(it) }
            headerView = null
            currentHeader = null
            return
        }

        // 获取或复用Header View
        val targetHeader = getHeaderViewForItem(headerPosition) ?: return
        if (headerView != targetHeader) {
            headerView?.let { parentView.removeView(it) }
            headerView = targetHeader
            parentView.addView(targetHeader)
        }

        // 计算Header的Y轴位置
        val nextHeader = findNextHeaderView(headerPosition)
        val headerTop: Int = if (nextHeader != null && nextHeader.top <= parent.paddingTop + targetHeader.height) {
            // 下一个Header即将顶上来，跟随移动
            nextHeader.top - targetHeader.height
        } else {
            // 固定在顶部
            parent.paddingTop
        }

        // 更新Header的布局参数
        val layoutParams = targetHeader.layoutParams as ViewGroup.MarginLayoutParams
        layoutParams.leftMargin = parent.left + parent.paddingLeft
        layoutParams.topMargin = headerTop
        targetHeader.layoutParams = layoutParams

        // 处理渐变效果（保持原有逻辑）
        if (shouldFadeOutHeader && nextHeader != null) {
            val alpha = ((nextHeader.top - parent.paddingTop) / targetHeader.height.toFloat()).coerceIn(0f, 1f)
            targetHeader.alpha = alpha
        } else {
            targetHeader.alpha = 1f
        }
    }

    private fun getHeaderViewForItem(headerPosition: Int): View? {
        val adapter = parent.adapter ?: return null
        val headerType = adapter.getItemViewType(headerPosition)
        // 复用已有的Header ViewHolder
        if (currentHeader?.first == headerPosition && currentHeader?.second?.itemViewType == headerType) {
            return currentHeader?.second?.itemView
        }

        val headerHolder = adapter.createViewHolder(parent, headerType)
        adapter.onBindViewHolder(headerHolder, headerPosition)
        fixLayoutSize(parent, headerHolder.itemView)
        currentHeader = headerPosition to headerHolder
        return headerHolder.itemView
    }

    private fun findNextHeaderView(currentHeaderPosition: Int): View? {
        val adapter = parent.adapter ?: return null
        var nextPosition = currentHeaderPosition + 1
        while (nextPosition < adapter.itemCount) {
            if (isHeader(nextPosition)) {
                return parent.findViewHolderForAdapterPosition(nextPosition)?.itemView
            }
            nextPosition++
        }
        return null
    }

    private fun isTouchInHeader(event: MotionEvent, header: View): Boolean {
        val rect = Rect()
        header.getGlobalVisibleRect(rect)
        return rect.contains(event.rawX.toInt(), event.rawY.toInt())
    }

    private fun fixLayoutSize(parent: ViewGroup, view: View) {
        val widthSpec = View.MeasureSpec.makeMeasureSpec(parent.width, View.MeasureSpec.EXACTLY)
        val heightSpec = View.MeasureSpec.makeMeasureSpec(parent.height, View.MeasureSpec.UNSPECIFIED)
        val childWidthSpec = ViewGroup.getChildMeasureSpec(
            widthSpec,
            parent.paddingLeft + parent.paddingRight,
            view.layoutParams.width
        )
        val childHeightSpec = ViewGroup.getChildMeasureSpec(
            heightSpec,
            parent.paddingTop + parent.paddingBottom,
            view.layoutParams.height
        )
        view.measure(childWidthSpec, childHeightSpec)
        view.layout(0, 0, view.measuredWidth, view.measuredHeight)
    }

    private fun getHeaderPositionForItem(itemPosition: Int): Int {
        var headerPosition = RecyclerView.NO_POSITION
        var currentPosition = itemPosition
        do {
            if (isHeader(currentPosition)) {
                headerPosition = currentPosition
                break
            }
            currentPosition -= 1
        } while (currentPosition >= 0)
        return headerPosition
    }
}

inline fun View.doOnEachNextLayout(crossinline action: (view: View) -> Unit) {
    addOnLayoutChangeListener { view, _, _, _, _, _, _, _, _ ->
        action(view)
    }
}

关键修改点说明 #

1. 添加真实Header View：将Header View添加到RecyclerView的父容器中，而非仅在画布绘制，使其成为可接收触摸事件的真实View。
2. 滚动监听更新位置：通过RecyclerView的滚动监听，实时计算Header的Y轴位置，实现粘性固定和被下一个Header顶出的效果。
3. 触摸事件分发处理：重写RecyclerView的OnTouchListener，判断触摸点是否在Header区域，转换坐标后将事件分发给Header，确保内部横向RecyclerView能正常响应滚动和点击。
4. 数据变化清理：当Adapter数据更新时，移除旧的Header View并清空缓存，避免内存泄漏和显示异常。

注意事项 #

• 确保RecyclerView的父容器是ViewGroup（如FrameLayout、LinearLayout等），否则无法添加Header View。
• 确认Header内部的横向RecyclerView设置了isEnabled = true，且布局参数正确。
• 若Header有复杂交互逻辑，可根据需求调整触摸事件的拦截规则。

内容的提问来源于stack exchange，提问作者pepperlove