如何使用 RecyclerView 构建水平 ListView
Posted
技术标签:
【中文标题】如何使用 RecyclerView 构建水平 ListView【英文标题】：How to build a horizontal ListView with RecyclerView 【发布时间】：2015-04-12 04:12:18 【问题描述】：我需要在我的 android 应用程序中实现一个水平列表视图。我做了一些研究，发现了 How can I make a horizontal ListView in Android? 和 Horizontal ListView in Android?。但是，这些问题是在 Recyclerview 发布之前提出的。现在有没有更好的方法来使用 Recyclerview 实现这一点？
【问题讨论】：
只需使用LinearLayoutManager 并将方向设置为 HORIZONTAL。
@EgorN 我试过了，它确实使它成为水平的，但它似乎甚至将适配器行的子项也更改为水平。我有一个相对布局。我不知道如何解决这个问题？
4 Ways To Create Horizontal RecyclerView
【参考方案1】：
现在有没有更好的方法来使用 RecyclerView 实现这一点？
是的。
当你使用RecyclerView 时，你需要指定一个LayoutManager 负责布局视图中的每个项目。 LinearLayoutManager 允许您指定方向，就像普通的 LinearLayout 一样。
要使用RecyclerView 创建一个水平列表，您可以执行以下操作：
LinearLayoutManager layoutManager
= new LinearLayoutManager(requireContext(), LinearLayoutManager.HORIZONTAL, false);
RecyclerView myList = (RecyclerView) findViewById(R.id.my_recycler_view);
myList.setLayoutManager(layoutManager);
【讨论】：
我试过了，它确实使它水平，但似乎它甚至将适配器行的子级也更改为水平。我有一个相对布局。我不知道如何解决这个问题？RelativeLayout 没有水平与垂直的概念，所以我不太明白这个问题。
显然 RecyclerView 和水平滚动的 LayoutManager 存在一些问题...code.google.com/p/android/issues/detail?id=74772 - 发现它是因为我在实际使用水平滚动的 RecyclerView 时也遇到了困难
Zainodis 你想好用什么了吗？ LinearLayoutManager 甚至没有显示为我的导入？我错过了什么
@Tanis.7x 这对我很有用，但它会从左到右填充列表。有谁知道是否有办法从右到左填充？ （第一项在列表中最右侧，索引 1 处的项在左侧，依此类推...）【参考方案2】：
<android.support.v7.widget.RecyclerView
android:layout_
android:layout_
android:orientation="horizontal"
app:layoutManager="android.support.v7.widget.LinearLayoutManager" />
【讨论】：
那么如何设置LayoutManager呢？ @kaiwang 请参阅上面的“Tanis.7x”答案。app:layoutManager="android.support.v7.widget.LinearLayoutManager" 不适用于发布版本。我遇到了这个问题发布版本。
我正在寻找如何在界面构建器中显示它。 tools:orientation="horizontal" tools:layoutManager="android.support.v7.widget.LinearLayoutManager" 救了我谢谢。
' '【参考方案3】：
完整示例
垂直RecyclerView 和水平RecyclerView 之间的唯一真正区别在于您如何设置LinearLayoutManager。这是代码sn-p。完整示例如下。
LinearLayoutManager horizontalLayoutManagaer = new LinearLayoutManager(MainActivity.this, LinearLayoutManager.HORIZONTAL, false);
recyclerView.setLayoutManager(horizontalLayoutManagaer);
这个更完整的例子是在my vertical RecyclerView answer 之后建模的。
更新 Gradle 依赖项
确保您的应用程序gradle.build 文件中有以下依赖项：
implementation 'com.android.support:appcompat-v7:27.1.1'
implementation 'com.android.support:recyclerview-v7:27.1.1'
您可以将版本号更新为the most current。
创建活动布局
将RecyclerView 添加到您的 xml 布局中。
activity_main.xml
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_
android:layout_>
<android.support.v7.widget.RecyclerView
android:id="@+id/rvAnimals"
android:layout_
android:layout_/>
</RelativeLayout>
创建项目布局
RecyclerView 中的每个项目都将在TextView 上加上一个彩色的View。创建一个新的布局资源文件。
recyclerview_item.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_
android:layout_
android:orientation="vertical"
android:padding="10dp">
<View
android:id="@+id/colorView"
android:layout_
android:layout_/>
<TextView
android:id="@+id/tvAnimalName"
android:layout_
android:layout_
android:textSize="20sp"/>
</LinearLayout>
创建适配器
RecyclerView 需要一个适配器来使用您的数据填充每一行（水平项）中的视图。创建一个新的 java 文件。
MyRecyclerViewAdapter.java
public class MyRecyclerViewAdapter extends RecyclerView.Adapter<MyRecyclerViewAdapter.ViewHolder>
private List<Integer> mViewColors;
private List<String> mAnimals;
private LayoutInflater mInflater;
private ItemClickListener mClickListener;
// data is passed into the constructor
MyRecyclerViewAdapter(Context context, List<Integer> colors, List<String> animals)
this.mInflater = LayoutInflater.from(context);
this.mViewColors = colors;
this.mAnimals = animals;
// inflates the row layout from xml when needed
@Override
@NonNull
public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType)
View view = mInflater.inflate(R.layout.recyclerview_item, parent, false);
return new ViewHolder(view);
// binds the data to the view and textview in each row
@Override
public void onBindViewHolder(@NonNull ViewHolder holder, int position)
int color = mViewColors.get(position);
String animal = mAnimals.get(position);
holder.myView.setBackgroundColor(color);
holder.myTextView.setText(animal);
// total number of rows
@Override
public int getItemCount()
return mAnimals.size();
// stores and recycles views as they are scrolled off screen
public class ViewHolder extends RecyclerView.ViewHolder implements View.OnClickListener
View myView;
TextView myTextView;
ViewHolder(View itemView)
super(itemView);
myView = itemView.findViewById(R.id.colorView);
myTextView = itemView.findViewById(R.id.tvAnimalName);
itemView.setOnClickListener(this);
@Override
public void onClick(View view)
if (mClickListener != null) mClickListener.onItemClick(view, getAdapterPosition());
// convenience method for getting data at click position
public String getItem(int id)
return mAnimals.get(id);
// allows clicks events to be caught
public void setClickListener(ItemClickListener itemClickListener)
this.mClickListener = itemClickListener;
// parent activity will implement this method to respond to click events
public interface ItemClickListener
void onItemClick(View view, int position);
注意事项
虽然不是绝对必要的，但我包含了监听项目点击事件的功能。这在旧的ListViews 中可用，是一种常见的需求。如果不需要，可以删除此代码。
在Activity中初始化RecyclerView
将以下代码添加到您的主要活动中。
MainActivity.java
public class MainActivity extends AppCompatActivity implements MyRecyclerViewAdapter.ItemClickListener
private MyRecyclerViewAdapter adapter;
@Override
protected void onCreate(Bundle savedInstanceState)
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// data to populate the RecyclerView with
ArrayList<Integer> viewColors = new ArrayList<>();
viewColors.add(Color.BLUE);
viewColors.add(Color.YELLOW);
viewColors.add(Color.MAGENTA);
viewColors.add(Color.RED);
viewColors.add(Color.BLACK);
ArrayList<String> animalNames = new ArrayList<>();
animalNames.add("Horse");
animalNames.add("Cow");
animalNames.add("Camel");
animalNames.add("Sheep");
animalNames.add("Goat");
// set up the RecyclerView
RecyclerView recyclerView = findViewById(R.id.rvAnimals);
LinearLayoutManager horizontalLayoutManager
= new LinearLayoutManager(MainActivity.this, LinearLayoutManager.HORIZONTAL, false);
recyclerView.setLayoutManager(horizontalLayoutManager);
adapter = new MyRecyclerViewAdapter(this, viewColors, animalNames);
adapter.setClickListener(this);
recyclerView.setAdapter(adapter);
@Override
public void onItemClick(View view, int position)
Toast.makeText(this, "You clicked " + adapter.getItem(position) + " on item position " + position, Toast.LENGTH_SHORT).show();
注意事项
请注意，该活动实现了我们在适配器中定义的ItemClickListener。这使我们能够处理onItemClick 中的项目点击事件。
完成
就是这样。您现在应该能够运行您的项目并获得类似于顶部图像的内容。
注意事项
我的示例中的彩色视图当然可以替换为实际项目中的图像。 Vertical RecyclerView example【讨论】：
【参考方案4】：如果你想使用RecyclerView 和GridLayoutManager，这是实现水平滚动的方式。
recyclerView.setLayoutManager(
new GridLayoutManager(recyclerView.getContext(), rows, GridLayoutManager.HORIZONTAL, false));
【讨论】：
这对我很有效...主要是因为您可以设置行数...在 LinearLayoutManager 中也可以这样做吗？【参考方案5】：尝试构建水平 ListView 需要花费太多时间。我已经通过两种方式解决了。
通过使用其适配器从 PagerAdapter 扩展而来的 ViewPager。
通过使用 RecyclerView 就像上面一样。我们需要在下面的代码中应用 LayoutManager：
LinearLayoutManager layoutManager = new LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false);
RecyclerView myList = (RecyclerView) findViewById(R.id.my_recycler_view);
myList.setLayoutManager(layoutManager);
【讨论】：
【参考方案6】：如果您希望使用 Horizontal Recycler View 作为 ViewPager，那么现在可以借助支持库版本 24.2.0 中添加的 LinearSnapHelper。
首先将 RecyclerView 添加到您的 Activity/Fragment
<android.support.v7.widget.RecyclerView
android:layout_below="@+id/sign_in_button"
android:layout_
android:orientation="horizontal"
android:id="@+id/blog_list"
android:layout_>
</android.support.v7.widget.RecyclerView>
就我而言，我在RecyclerView 中使用了CardView
blog_row.xml
<?xml version="1.0" encoding="utf-8"?>
<android.support.v7.widget.CardView
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_
android:layout_
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_margin="15dp"
android:orientation="vertical">
<LinearLayout
android:layout_
android:layout_
android:gravity="center"
android:orientation="vertical">
<com.android.volley.toolbox.NetworkImageView
android:id="@+id/imageBlogPost"
android:layout_
android:layout_
android:adjustViewBounds="true"
android:paddingBottom="15dp"
android:src="@drawable/common_google_signin_btn_text_light_normal" />
<TextView
android:id="@+id/TitleTextView"
android:layout_
android:layout_
android:layout_marginBottom="20dp"
android:text="Post Title Here"
android:textSize="16sp" />
<TextView
android:id="@+id/descriptionTextView"
android:layout_
android:layout_
android:text="Post Description Here"
android:paddingBottom="15dp"
android:textSize="14sp" />
</LinearLayout>
</android.support.v7.widget.CardView>
在您的活动/片段中
private RecyclerView mBlogList;
LinearLayoutManager layoutManager =
new LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false);
mBlogList = (RecyclerView) findViewById(R.id.blog_list);
mBlogList.setHasFixedSize(true);
mBlogList.setLayoutManager(layoutManager);
LinearSnapHelper snapHelper = new LinearSnapHelper()
@Override
public int findTargetSnapPosition(RecyclerView.LayoutManager lm, int velocityX, int velocityY)
View centerView = findSnapView(lm);
if (centerView == null)
return RecyclerView.NO_POSITION;
int position = lm.getPosition(centerView);
int targetPosition = -1;
if (lm.canScrollHorizontally())
if (velocityX < 0)
targetPosition = position - 1;
else
targetPosition = position + 1;
if (lm.canScrollVertically())
if (velocityY < 0)
targetPosition = position - 1;
else
targetPosition = position + 1;
final int firstItem = 0;
final int lastItem = lm.getItemCount() - 1;
targetPosition = Math.min(lastItem, Math.max(targetPosition, firstItem));
return targetPosition;
;
snapHelper.attachToRecyclerView(mBlogList);
最后一步是将适配器设置为 RecyclerView
mBlogList.setAdapter(firebaseRecyclerAdapter);
【讨论】：
【参考方案7】：随着 RecyclerView 库的发布，现在您可以轻松地对齐与文本绑定的图像列表。您可以使用 LinearLayoutManager 来指定列表的方向，垂直或水平，如下所示。
您可以下载完整的working demo from this post。
【讨论】：
【参考方案8】： <HorizontalScrollView
android:layout_
android:layout_
>
<android.support.v7.widget.RecyclerView
android:id="@+id/recycler_view"
android:layout_
android:layout_
android:orientation="horizontal"
android:scrollbars="vertical|horizontal" />
</HorizontalScrollView>
import androidx.appcompat.app.AppCompatActivity;
import android.content.Context;
import android.content.ContextWrapper;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.os.AsyncTask;
import android.os.Bundle;
import android.os.Environment;
import android.view.View;
import android.widget.ImageView;
import android.widget.Toast;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.HttpURLConnection;
public class MainActivity extends AppCompatActivity
ImageView mImageView1;
Bitmap bitmap;
String mSavedInfo;
@Override
protected void onCreate(Bundle savedInstanceState)
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mImageView1 = (ImageView) findViewById(R.id.image);
public Bitmap getBitmapFromURL(String src)
try
java.net.URL url = new java.net.URL(src);
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setDoInput(true);
connection.connect();
InputStream input = connection.getInputStream();
Bitmap myBitmap = BitmapFactory.decodeStream(input);
return myBitmap;
catch (IOException e)
e.printStackTrace();
return null;
public void button2(View view)
new DownloadImageFromTherad().execute();
private class DownloadImageFromTherad extends AsyncTask<String, Integer, String>
@Override
protected String doInBackground(String... params)
bitmap = getBitmapFromURL("https://cdn.pixabay.com/photo/2016/08/08/09/17/avatar-1577909_960_720.png");
return null;
@Override
protected void onPostExecute(String s)
super.onPostExecute(s);
File sdCardDirectory = Environment.getExternalStorageDirectory();
File image = new File(sdCardDirectory, "test.png");
boolean success = false;
FileOutputStream outStream;
mSavedInfo = saveToInternalStorage(bitmap);
if (success)
Toast.makeText(getApplicationContext(), "Image saved with success", Toast.LENGTH_LONG).show();
else
Toast.makeText(getApplicationContext(), "Error during image saving" + mSavedInfo, Toast.LENGTH_LONG).show();
private String saveToInternalStorage(Bitmap bitmapImage)
ContextWrapper cw = new ContextWrapper(getApplicationContext());
// path to /data/data/yourapp/app_data/imageDir
File directory = cw.getDir("imageDir", Context.MODE_PRIVATE);
File mypath = new File(directory, "profile.jpg");
FileOutputStream fos = null;
try
fos = new FileOutputStream(mypath);
bitmapImage.compress(Bitmap.CompressFormat.PNG, 100, fos);
catch (Exception e)
e.printStackTrace();
finally
try
fos.close();
catch (IOException e)
e.printStackTrace();
return directory.getAbsolutePath();
private void loadImageFromStorage(String path)
try
File f = new File(path, "profile.jpg");
Bitmap b = BitmapFactory.decodeStream(new FileInputStream(f));
mImageView1.setImageBitmap(b);
catch (FileNotFoundException e)
e.printStackTrace();
public void showImage(View view)
loadImageFromStorage(mSavedInfo);
【讨论】：
【参考方案9】：它适用于水平和垂直。
RecyclerView recyclerView;
@Override
protected void onCreate(Bundle savedInstanceState)
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_test_recycler);
recyclerView = (RecyclerView)findViewById(R.id.recyclerViewId);
RecyclAdapter adapter = new RecyclAdapter();
//Vertical RecyclerView
RecyclerView.LayoutManager mLayoutManager = new LinearLayoutManager(getApplicationContext());
recyclerView.setLayoutManager(mLayoutManager);
//Horizontal RecyclerView
//recyclerView.setLayoutManager(new LinearLayoutManager(getApplicationContext(),LinearLayoutManager.HORIZONTAL,false));
recyclerView.setAdapter(adapter);
【讨论】：
【参考方案10】：水平动态中的回收站视图。
回收站视图实现
RecyclerView musicList = findViewById(R.id.MusicList);
// RecyclerView musiclist = findViewById(R.id.MusicList1);
// RecyclerView musicLIST = findViewById(R.id.MusicList2);
LinearLayoutManager layoutManager = new LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false);
musicList.setLayoutManager(layoutManager);
String[] names = "RAP", "CH SHB", "Faheem", "Anum", "Shoaib", "Laiba", "Zoki", "Komal", "Sultan","Mansoob Gull";
musicList.setAdapter(new ProgrammingAdapter(names));'
回收器视图的适配器类，其中有一个视图持有者用于保存该回收器的视图
public class ProgrammingAdapter
extendsRecyclerView.Adapter<ProgrammingAdapter.programmingViewHolder>
private String[] data;
public ProgrammingAdapter(String[] data)
this.data = data;
@Override
public programmingViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType)
LayoutInflater inflater = LayoutInflater.from(parent.getContext());
View view = inflater.inflate(R.layout.list_item_layout, parent, false);
return new programmingViewHolder(view);
@Override
public void onBindViewHolder(@NonNull programmingViewHolder holder, int position)
String title = data[position];
holder.textV.setText(title);
@Override
public int getItemCount()
return data.length;
public class programmingViewHolder extends RecyclerView.ViewHolder
ImageView img;
TextView textV;
public programmingViewHolder(View itemView)
super(itemView);
img = itemView.findViewById(R.id.img);
textV = itemView.findViewById(R.id.textt);
【讨论】：
【参考方案11】：recyclerView.setLayoutManager(new LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false));
recyclerView.setAdapter(adapter);
【讨论】：
解释一下。【参考方案12】：您可以在代码或布局 xml 文件中更改方向。
在xml文件中
在您的布局 xml 文件中，将 orientation 设置为 horizontal 并将 layoutManager 设置为 LinearLayoutManager、GridLayoutManager、StaggeredGridLayoutManager 之一。根据您的要求选择。
<androidx.recyclerview.widget.RecyclerView
android:layout_
android:layout_
android:orientation="horizontal"
app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager" />
在代码中
如果您想以编程方式更改方向，请将layoutManager 设置为水平方向。
recyclerView.layoutManager = LinearLayoutManager(context, RecyclerView.HORIZONTAL, false)
【讨论】：
【参考方案13】：试试这个：
myrecyclerview.setLayoutManager(
new LinearLayoutManager(getActivity(),
LinearLayoutManager.HORIZONTAL,false));
myrecyclerview.setAdapter(recyclerAdapter);
仅在您获得带有一些片段的回收站视图时。
【讨论】：
【参考方案14】：有一个名为 HorizontalGridView 的 RecyclerView 子类。您可以使用它来获得水平方向。 VerticalGridView 垂直方向。
【讨论】：
HorizontalGridView 是否意味着用于非电视设备？ Afaik，leanback 库是为电视设计的 使用leanback 会将应用的minSdkVersion 提高到17以上是关于如何使用 RecyclerView 构建水平 ListView的主要内容，如果未能解决你的问题，请参考以下文章
如何使用垂直 GridLayoutManager 水平居中 RecyclerView 项目
Android 布局：具有滚动行为的 Viewpager 内的垂直 Recyclerview 内的水平 Recyclerview
如何仅显示从当前位置到水平 RecyclerView 的一项？