217

How to set RecyclerView layoutManager from XML?

    <android.support.v7.widget.RecyclerView
        app:layoutManager="???"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>
3
  • See documentation: recyclerview:layoutManager
    – dieter_h
    Feb 28, 2016 at 8:27
  • 1
    @dieter_h can you provide an answer with GridLayoutManager example? Feb 28, 2016 at 8:31
  • 4
    You can use app:layoutManager="android.support.v7.widget.GridLayoutManager". Constructor with four arguments will be used (Context, AttributeSet, int, int). According to documentation this is the constructor used when layout manager is set in XML by RecyclerView attribute layoutManager. If spanCount is not specified in the XML, it defaults to a single column Feb 28, 2016 at 8:49

7 Answers 7

360

As you can check in the doc:

Class name of the Layout Manager to be used.

The class must extend androidx.recyclerview.widget.RecyclerViewView$LayoutManager and have either a default constructor or constructor with the signature (android.content.Context, android.util.AttributeSet, int, int)

If the name starts with a '.', application package is prefixed. Else, if the name contains a '.', the classname is assumed to be a full class name. Else, the recycler view package (androidx.appcompat.widget) is prefixed

With androidx you can use:

<androidx.recyclerview.widget.RecyclerView
     xmlns:app="http://schemas.android.com/apk/res-auto"
     app:layoutManager="androidx.recyclerview.widget.GridLayoutManager">

With the support libraries you can use:

<android.support.v7.widget.RecyclerView
    xmlns:app="http://schemas.android.com/apk/res-auto"
    app:layoutManager="android.support.v7.widget.GridLayoutManager" >

Also you can add these attributes:

  • android:orientation = "horizontal|vertical": to control the orientation of the LayoutManager (eg:LinearLayoutManager)
  • app:spanCount: to set the number of columns for GridLayoutManager

Example:

<androidx.recyclerview.widget.RecyclerView
    app:layoutManager="androidx.recyclerview.widget.GridLayoutManager"
    app:spanCount="2"
    ...>

or:

<androidx.recyclerview.widget.RecyclerView
    app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
    android:orientation="vertical"
    ...>

You can also add them using the tools namespace (i.e. tools:orientation and tools:layoutManager) and then it only impacts the IDE preview and you can continue setting those values in code.

10
  • 84
    And you can use android:orientation on the RecyclerView element to control the orientation of e.g. LinearLayoutManager
    – androidguy
    Nov 10, 2016 at 1:17
  • 3
    @Gabriele Mariotti I checked the implementation and it uses reflection. Is that okay from performance wise?
    – Fadli
    Mar 6, 2017 at 7:06
  • 4
    Are there more available attributes in case I use GridLayoutManager ? Is it possible to set its number of columns (spanCount) ? Mar 18, 2018 at 12:07
  • 8
    @androiddeveloper Yes, e.g. to set it to three columns use app:spanCount="3"
    – jauser
    Apr 26, 2018 at 1:12
  • 2
    you can also use tools:layoutManager, tools:spanCount (even though the auto-complete doesn't show it) and if you don't want to override any of your recyclerview setup (or prefer programatically)
    – mochadwi
    Jan 16, 2020 at 4:45
94

if you want use it with LinearLayoutManager

<android.support.v7.widget.RecyclerView
    xmlns:app="http://schemas.android.com/apk/res-auto"
    app:layoutManager="android.support.v7.widget.LinearLayoutManager" >

that equivalent to

LinearLayoutManager mLayoutManager = new LinearLayoutManager(getApplicationContext());
mRecyclerView.setLayoutManager(mLayoutManager);
4
  • 3
    What is your addition to Gabriele Mariotti answer? Feb 23, 2017 at 14:26
  • 4
    explain what equivalent to in code but with anther example LinearLayout
    – Mina Fawzy
    Feb 23, 2017 at 14:30
  • 8
    @UdiOshi to make it horizontal, you need to add android:orientation="horizontal" to the RecyclerView xml
    – rf43
    Feb 19, 2018 at 23:09
  • 9
    androidx.recyclerview.widget.LinearLayoutManager for androidX
    – frapeti
    Aug 21, 2018 at 17:30
94

And I came here looking for androidx version though it was pretty easy to figure out, here it is

LinearLayoutManager:

app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"

Example:

<androidx.recyclerview.widget.RecyclerView
    android:id="@+id/recyclerView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"/>

GridLayoutManager:

app:layoutManager="androidx.recyclerview.widget.GridLayoutManager"

Example:

<androidx.recyclerview.widget.RecyclerView
    android:id="@+id/recyclerView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    app:spanCount="2"
    app:layoutManager="androidx.recyclerview.widget.GridLayoutManager"/>

As you can see in examples above you can control the orientation from within xml using

android:orientation="vertical"

and

android:orientation="horizontal"

And to set the number of columns for GridLayoutManager using

app:spanCount="2"
4
  • 12
    You can set no. of columns when you use GridLayoutManager by adding app:spanCount="2" Jan 19, 2019 at 8:43
  • future compatible approach. Feb 19, 2019 at 3:17
  • Same here... Androidx about to take off 🚀
    – Robin Hood
    Apr 16, 2019 at 15:55
  • 1
    Thanks I was looking for spanCount found it here. Thats why upvote to the answer :) Jun 7, 2019 at 7:38
18

The most common ones that I use are:

<androidx.recyclerview.widget.RecyclerView
    app:layoutManager="androidx.recyclerview.widget.GridLayoutManager" 
    tools:listitem="@layout/grid_item"
    android:orientation="vertical" app:spanCount="3"/>

And:

<androidx.recyclerview.widget.RecyclerView
    app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
    tools:listitem="@layout/grid_item"
    android:orientation="vertical"/>

It's recommended to set listitem , so that you'd see how it could look in the preview of the layout editor.

If you want to have the order reversed though, I think you have to do it in code instead, and use "tools" in XML if you really want to see something...

3
  • which is apps and app namespaces you have used in above xml? because I am getting build time error Android resource linking failed - AAPT: error: attribute orientation, if I use app:orientation.
    – Omkar
    Apr 24, 2019 at 12:39
  • thanks, but still it is wrong namespace. It should be android for orientation. It doesn't work with app namespace everything else is perfect.
    – Omkar
    Apr 25, 2019 at 12:14
  • @Omkar Correct again. Sorry. Updated. Apr 25, 2019 at 14:58
3

This worked for me - just add app:layoutManager="LinearLayoutManager" and you're good to go

    <android.support.v7.widget.RecyclerView
        android:id="@+id/recordItemList"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical"
        android:clipToPadding="false"
        android:scrollbars="none"
        app:layoutManager="LinearLayoutManager"
        app:stackFromEnd="true"
        app:reverseLayout="true"/>
1

You can set the layout manager for recyclerview like this, app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"

0

Example

implementation 'com.android.support:recyclerview-v7:28.0.0'
<android.support.v7.widget.RecyclerView
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"

    tools:layoutManager="android.support.v7.widget.LinearLayoutManager"
    />

layoutManager can be android.support.v7.widget.LinearLayoutManager, android.support.v7.widget.GridLayoutManager

[Read more here]

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.