在 Android 中打造水平列表视图：RecyclerView 实战指南

Android

2024-03-28 21:03:28

Android 中使用 RecyclerView 构建水平列表视图：终极指南

引言

在 Android 应用程序中，水平列表视图非常有用，可用于展示横向滚动的图片库、消息历史记录或其他类型的横向内容。

传统的 ListView 仅支持垂直滚动，因此，对于水平列表视图，我们需要使用替代方案，而 RecyclerView 正是实现此目的的理想组件。

什么是 RecyclerView？

RecyclerView 是 Android 中一个用于创建自定义列表的高级组件。它提供了 ListView 所没有的灵活性，允许开发人员完全控制列表的外观和行为。

使用 RecyclerView 创建水平列表视图

1. 创建布局文件

创建一个 RecyclerView 布局文件，将 orientation 属性设置为 horizontal：

<androidx.recyclerview.widget.RecyclerView
    android:id="@+id/horizontal_list"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="horizontal" />

2. 创建适配器

适配器是充当数据源和 RecyclerView 之间的桥梁。对于水平列表视图，我们需要创建自定义适配器：

public class HorizontalAdapter extends RecyclerView.Adapter<HorizontalAdapter.ViewHolder> {

    private List<String> data;

    public HorizontalAdapter(List<String> data) {
        this.data = data;
    }

    // 创建 ViewHolder
    @Override
    public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_horizontal, parent, false);
        return new ViewHolder(view);
    }

    // 绑定数据
    @Override
    public void onBindViewHolder(ViewHolder holder, int position) {
        holder.textView.setText(data.get(position));
    }

    // 获取数据量
    @Override
    public int getItemCount() {
        return data.size();
    }

    public static class ViewHolder extends RecyclerView.ViewHolder {

        TextView textView;

        public ViewHolder(View itemView) {
            super(itemView);
            textView = itemView.findViewById(R.id.text_view);
        }
    }
}

3. 在活动中设置 RecyclerView

在活动中，使用 RecyclerView 组件及其关联的布局管理器和适配器来设置水平列表视图：

RecyclerView horizontalList = findViewById(R.id.horizontal_list);

// 设置布局管理器
LinearLayoutManager layoutManager = new LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false);
horizontalList.setLayoutManager(layoutManager);

// 设置适配器
List<String> data = new ArrayList<>();
data.add("Item 1");
data.add("Item 2");
data.add("Item 3");
HorizontalAdapter adapter = new HorizontalAdapter(data);
horizontalList.setAdapter(adapter);