How to set RecyclerView app:layoutManager="" from XML?

Question

How to set RecyclerView layoutManager from XML?

    <android.support.v7.widget.RecyclerView
        app:layoutManager="???"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

See documentation: [recyclerview:layoutManager](http://developer.android.com/reference/android/support/v7/widget/RecyclerView.html#attr_android.support.v7.recyclerview:layoutManager) — dieter_h, Feb 28 '16 at 08:27
@dieter_h can you provide an answer with GridLayoutManager example? — Ilya Gazman, Feb 28 '16 at 08:31
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_ — andrea.petreri, Feb 28 '16 at 08:49

score 360 · Accepted Answer · edited Jun 20 '20 at 09:12

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.

edited Jun 20 '20 at 09:12

Community

1
1

answered Feb 28 '16 at 09:18

Gabriele Mariotti

320,139
94
887
841

84

And you can use `android:orientation` on the RecyclerView element to control the orientation of e.g. LinearLayoutManager – androidguy Nov 10 '16 at 01:17
3

@Gabriele Mariotti I checked the implementation and it uses reflection. Is that okay from performance wise? – Fadli Mar 06 '17 at 07:06
1

As of this comment it seems the docs no longer have that useful explanation. So frustrating that @Google can't even keep their docs correct. – Tony Chan Nov 06 '17 at 22:17
1

Regarding my previous comment I've created an [**issue ticket for it here.**](https://issuetracker.google.com/68949138) – Tony Chan Nov 06 '17 at 22:24
4

Are there more available attributes in case I use GridLayoutManager ? Is it possible to set its number of columns (spanCount) ? – android developer Mar 18 '18 at 12:07
8

@androiddeveloper Yes, e.g. to set it to three columns use app:spanCount="3" – jauser Apr 26 '18 at 01:12
is there a way to define number of columns? – Aaditya Brahmbhatt Sep 14 '18 at 11:39
1

@nimi0112 use this app:layoutManager="androidx.recyclerview.widget.GridLayoutManager" – mhemdan Feb 13 '19 at 19:15
1

Please switch to AndroidX. – Abhinav Saxena Feb 19 '19 at 03:11
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 '20 at 04:45

score 94 · Answer 2 · answered Feb 23 '17 at 12:27

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);

answered Feb 23 '17 at 12:27

Mina Fawzy

20,852
17
133
156

3

What is your addition to Gabriele Mariotti answer? – Ilya Gazman Feb 23 '17 at 14:26
4

explain what equivalent to in code but with anther example LinearLayout – Mina Fawzy Feb 23 '17 at 14:30
8

@UdiOshi to make it horizontal, you need to add `android:orientation="horizontal"` to the RecyclerView xml – rf43 Feb 19 '18 at 23:09
9

androidx.recyclerview.widget.LinearLayoutManager for androidX – frapeti Aug 21 '18 at 17:30

Atiq · Answer 3 · 2019-05-31T12:21:32.267

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"

edited May 31 '19 at 12:21

answered Oct 22 '18 at 00:26

Atiq

14,435
6
54
69

12

You can set no. of columns when you use `GridLayoutManager` by adding `app:spanCount="2"` – Pratik Butani Jan 19 '19 at 08:43
future compatible approach. – Abhinav Saxena Feb 19 '19 at 03:17
Same here... Androidx about to take off – Robin Hood Apr 16 '19 at 15:55
1

Thanks I was looking for `spanCount` found it here. Thats why upvote to the answer :) – Jimit Patel Jun 07 '19 at 07:38

android developer · Answer 4 · 2019-04-25T14:57:44.403

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...

edited Apr 25 '19 at 14:57

answered Feb 20 '19 at 14:38

android developer

114,585
152
739
1,270

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 '19 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 '19 at 12:14
@Omkar Correct again. Sorry. Updated. – android developer Apr 25 '19 at 14:58

Akinyemi Jamiu · Answer 5 · 2020-09-15T02:14:49.743

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"/>

score 1 · Answer 6 · edited Sep 15 '20 at 13:08

1

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

edited Sep 15 '20 at 13:08

kk.

3,747
12
36
67

answered Sep 15 '20 at 11:40

G Ganesh

103
7

score 0 · Answer 7 · answered Oct 07 '22 at 13:50

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]

How to set RecyclerView app:layoutManager="" from XML?

7 Answers7

Linked

Related