平板模式下ViewPager2内RecyclerView部分条目无法点击问题求助

问题根因 #

该问题不是ViewPager2的官方BUG，大概率是布局测量边界和触摸事件分发不匹配导致的，核心触发点是：

1. 平板模式下你的ViewPager2/RecyclerView高度配置错误，使用了wrap_content，导致控件实际测量高度小于视觉渲染高度
2. 通常你可能给父布局开了android:clipChildren="false"/android:clipToPadding="false"，超出测量边界的内容可以正常显示，但触摸事件不会分发到超出区域，就会出现"看得见点不动"的现象
3. 文本长度会影响条目高度：短文本时4行总高度小于控件测量高度，所有条目都在触摸区域内；长文本时4行就占满了测量高度，后面的条目超出边界无法响应点击

解决方案 #

按优先级依次排查修改：

1. 修改ViewPager2的高度配置
   优先给ViewPager2设置android:layout_height="match_parent"，如果业务必须要ViewPager2自适应子页面高度，使用自定义测量逻辑的ViewPager2，示例代码如下：

   class WrapContentHeightViewPager2 @JvmOverloads constructor(
       context: Context,
       attrs: AttributeSet? = null
   ) : ViewPager2(context, attrs) {
   
       override fun onMeasure(widthMeasureSpec: Int, heightMeasureSpec: Int) {
           var heightSpec = heightMeasureSpec
           val currentPage = getChildAt(currentItem)
           currentPage?.measure(
               widthMeasureSpec,
               MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED)
           )
           val pageHeight = currentPage?.measuredHeight ?: 0
           if (pageHeight > 0) {
               heightSpec = MeasureSpec.makeMeasureSpec(pageHeight, MeasureSpec.EXACTLY)
           }
           super.onMeasure(widthMeasureSpec, heightSpec)
       }
   
       init {
           // 页面切换时重新测量高度
           registerOnPageChangeCallback(object : OnPageChangeCallback() {
               override fun onPageSelected(position: Int) {
                   requestLayout()
               }
           })
       }
   }
   

2. 修改RecyclerView和条目布局配置
   • RecyclerView的高度设置为android:layout_height="match_parent"，不要用wrap_content
   • 条目布局craft_item的根布局宽高都设为match_parent，可以给条目设置固定高度或最小高度，同时给TextView设置maxLines和ellipsize避免无限制换行拉高条目高度
3. 优化点击事件绑定
   你当前的点击事件绑定在container上，建议直接绑定到ViewHolder的itemView上，避免container没有占满条目导致点击区域缺失：
   把container.setOnClickListener(this)替换为itemView.setOnClickListener(this)
4. 排查裁剪配置
   检查ViewPager2的所有父布局，移除不必要的android:clipChildren="false"和android:clipToPadding="false"配置，避免超出边界的内容无法接收触摸事件

可选优化点 #

你当前点击条目后调用notifyDataSetChanged()全量刷新列表，效率很低，建议改成只刷新新旧选中的两个条目：

@Override
public void onClick(View v) {
    int oldSelected = selectedItem;
    selectedItem = getBindingAdapterPosition();
    if(selectedItem!= RecyclerView.NO_POSITION){
        mListener.OnButtonClick(v, getBindingAdapterPosition());
        if (oldSelected != -1) notifyItemChanged(oldSelected);
        notifyItemChanged(selectedItem);
    }
}

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