RecyclerView 改进：巧妙解决 maxHeight 属性失效问题

2023-11-23 12:42:14

掌控 RecyclerView 的高度：巧妙解决 maxHeight 难题

在构建流畅、高效的 Android 应用时，RecyclerView 组件凭借其处理大型数据集的能力备受青睐。然而，当您试图设置 RecyclerView 的 maxHeight 属性时，却可能遭遇意外的难题：它不起作用！

别担心！本文将揭开这一谜题，为您提供一种巧妙的解决方案，助您轻松掌控 RecyclerView 的高度。

问题根源：RecyclerView 中缺失的 maxHeight 属性

RecyclerView 本身并没有 maxHeight 属性。在 Android 布局系统中，高度通常通过 layout_height 指定。当您试图设置 maxHeight 时，实际上是在覆盖 layout_height，导致了不可预期的行为。

解决之道：自定义属性的强大力量

为了解决这个难题，我们将借助自定义属性的力量。通过创建自定义属性，我们可以扩展 RecyclerView 的功能，使其支持 maxHeight 行为。

步骤 1：创建自定义属性

在 res/values/attrs.xml 文件中创建自定义属性：

<resources>
    <declare-styleable name="RecyclerViewMaxHeight">
        <attr name="maxHeight" format="dimension" />
    </declare-styleable>
</resources>

步骤 2：应用自定义属性

在 RecyclerView 布局中应用自定义属性：

<androidx.recyclerview.widget.RecyclerView
    android:id="@+id/recyclerView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:maxHeight="300dp" />

请注意：app: 前缀用于引用自定义属性。

步骤 3：自定义属性处理

在 RecyclerView 类中重写 onMeasure 方法，以处理自定义属性：

@Override
protected void onMeasure(int widthSpec, int heightSpec) {
    int maxHeight = getAttributeValue(this, R.styleable.RecyclerViewMaxHeight_maxHeight, 0);
    int heightMode = MeasureSpec.getMode(heightSpec);
    int heightSize = MeasureSpec.getSize(heightSpec);
    int newHeightSpec = 0;
    if (heightMode == MeasureSpec.AT_MOST && maxHeight > 0) {
        newHeightSpec = MeasureSpec.makeMeasureSpec(Math.min(heightSize, maxHeight), MeasureSpec.AT_MOST);
    } else {
        newHeightSpec = heightSpec;
    }
    super.onMeasure(widthSpec, newHeightSpec);
}

实例演示

为了展示这个解决方案的实际效果，我们编写了一个简单的示例应用程序：

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val recyclerView = findViewById<RecyclerView>(R.id/recyclerView)
        recyclerView.layoutManager = LinearLayoutManager(this)
        recyclerView.adapter = SimpleAdapter()
    }
}

class SimpleAdapter : RecyclerView.Adapter<SimpleViewHolder>() {

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): SimpleViewHolder {
        val view = LayoutInflater.from(parent.context).inflate(R.layout.item_simple, parent, false)
        return SimpleViewHolder(view)
    }

    override fun onBindViewHolder(holder: SimpleViewHolder, position: Int) {}

    override fun getItemCount(): Int = 20
}

class SimpleViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView)

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recyclerView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:maxHeight="200dp" />

</LinearLayout>