### Android 中 RecyclerView 组件的
使用指南
#### 1
. 配置 build
.gradle 文件
为了在项目中
使用 `RecyclerView`，需要确保模块级别的 `build
.gradle` 文件中引入了正确的依赖项。以下是配置方法：
```gradle
dependencies {
implementati
on 'androidx
.recyclerview:recyclerview:1
.3
.2'
}
```
此版本为当前最新的稳定版[^1]。
#### 2
. 创建 XML 布局文件
定义一个包含 `RecyclerView` 的布局文件。以下是一个简单的例子：
```xml
<LinearLayout xmlns:android="http://schemas
.android
.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientati
on="vertical">
<androidx
.recyclerview
.widget
.RecyclerView
android:id="@+id/recyclerView"
android:layout_width="match_parent"
android:layout_height="wrap_c
ontent" />
</LinearLayout>
```
手动检查并确认 XML 文件无误[^1]。
#### 3
. 初始化 RecyclerView 并设置属性
在 Activity 或 Fragment 中初始化 `RecyclerView` 并为其设置必要的属性。具体操作如下所示：
```java
import androidx
.appcompat
.app
.AppCompatActivity;
import androidx
.recyclerview
.widget
.LinearLayoutManager;
import androidx
.recyclerview
.widget
.RecyclerView;
public class MainActivity extends AppCompatActivity {
private RecyclerView recyclerView;
@Override
protected void
onCreate(Bundle savedInstanceState) {
super
.onCreate(savedInstanceState);
setC
ontentView(R
.layout
.activity_main);
recyclerView = findViewById(R
.id
.recyclerView);
// 设置 LayoutManager
LinearLayoutManager layoutManager = new LinearLayoutManager(this);
layoutManager
.setOrientati
on(RecyclerView
.VERTICAL); // 默认垂直方向
recyclerView
.setLayoutManager(layoutManager);
// 设置 Adapter
MyRecyclerAdapter adapter = new MyRecyclerAdapter(getData
());
recyclerView
.setAdapter(adapter);
// 添加分割线
recyclerView
.addItemDecorati
on(new DividerGridItemDecorati
on(this));
// 设置 Item 动画效果
recyclerView
.setItemAnimator(new DefaultItemAnimator
());
}
private List<String> getData
() {
List<String> data = new ArrayList<>
();
for (int i = 0; i < 50; i++) {
data
.add("Item " + i);
}
return data;
}
}
```
以上代码展示了如何创建适配器、绑定数据以及应用一些常见的功能[^2]。
#### 4
. 定义自定义适配器
适配器负责将数据源与视图绑定在一起。下面是一个基本的适配器实现示例：
```java
import android
.view
.LayoutInflater;
import android
.view
.View;
import android
.view
.ViewGroup;
import android
.widget
.TextView;
import androidx
.annotati
on.N
onNull;
import androidx
.recyclerview
.widget
.RecyclerView;
import java
.util
.List;
public class MyRecyclerAdapter extends RecyclerView
.Adapter<MyRecyclerAdapter
.ViewHolder> {
private final List<String> dataList;
public static class ViewHolder extends RecyclerView
.ViewHolder {
TextView textView;
public ViewHolder(View itemView) {
super(itemView);
this
.textView = itemView
.findViewById(android
.R
.id
.text1);
}
}
public MyRecyclerAdapter(List<String> dataList) {
this
.dataList = dataList;
}
@N
onNull
@Override
public ViewHolder
onCreateViewHolder(@N
onNull ViewGroup parent, int viewType) {
View view = LayoutInflater
.from(parent
.getC
ontext
())
.inflate(android
.R
.layout
.simple_list_item_1, parent, false);
return new ViewHolder(view);
}
@Override
public void
onBindViewHolder(@N
onNull ViewHolder holder, int positi
on) {
String itemText = dataList
.get(positi
on);
holder
.textView
.setText(itemText);
}
@Override
public int getItemCount
() {
return dataList
.size
();
}
}
```
通过该类可以完成列表项的数据填充和显示逻辑[^2]。
#### 5
. 处理边缘到边缘支持（可选）
如果希望界面支持全屏模式，则可以在活动中启用 `EdgeToEdge` 支持。例如：
```java
import androidx
.activity
.EdgeToEdge;
import androidx
.core
.graphics
.Insets;
import androidx
.core
.view
.ViewCompat;
import androidx
.core
.view
.WindowInsetsCompat;
@Override
protected void
onCreate(Bundle savedInstanceState) {
super
.onCreate(savedInstanceState);
EdgeToEdge
.enable(this);
setC
ontentView(R
.layout
.activity_
recycleview);
ViewCompat
.set
OnApplyWindowInsetsListener(findViewById(R
.id
.main), (v, insets) -> {
Insets systemBars = insets
.getInsets(WindowInsetsCompat
.Type
.systemBars
());
v
.setPadding(systemBars
.left, systemBars
.top, systemBars
.right, systemBars
.bottom);
return insets;
});
}
```
这一步骤有助于优化用户体验[^3]。
---
### 示例总结
上述内容涵盖了从 Gradle 配置到实际编码的过程，帮助开发者快速掌握 `RecyclerView` 的基础用法及其扩展特性。
本文详细解析了在使用RecyclerView时遇到的NullPointerException异常原因，并提供了解决方案。问题源于inflate函数默认attachToRoot属性，导致rootview被设置为RecyclerView.LayoutParams。通过修改onCreateViewHolder方法中inflate函数的第三个参数为false，成功解决了这一问题。
扫一扫
5079
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
