Простой пример сетки Android с использованием RecyclerView с GridLayoutManager (как старый GridView)

227

Я знаю, что RecyclerViewзаменил старый функционал ListViewи GridView. Я ищу очень простой пример, который показывает минимальную настройку сетки с использованием RecyclerView. Я не ищу длинных объяснений стиля учебника, просто минимальный пример. Я предполагаю, что самая простая сетка, которая имитирует старый GridView, состоит из следующих функций:

  • несколько ячеек в строке
  • один вид в каждой ячейке
  • реагирует на события клика
Suragch
источник

Ответы:

556

Короткий ответ

Для тех, кто уже знаком с настройкой a RecyclerViewдля составления списка , хорошая новость заключается в том, что создание сетки во многом одинаково. Вы просто используете GridLayoutManagerвместо, LinearLayoutManagerкогда вы настраиваете RecyclerView.

recyclerView.setLayoutManager(new GridLayoutManager(this, numberOfColumns));

Если вам нужна дополнительная помощь, посмотрите следующий пример.

Полный пример

Ниже приведен минимальный пример, который будет выглядеть как на рисунке ниже.

введите описание изображения здесь

Начните с пустой деятельности. Вы будете выполнять следующие задачи, чтобы добавить RecyclerViewсетку. Все, что вам нужно сделать, это скопировать и вставить код в каждый раздел. Позже вы можете настроить его под свои нужды.

  • Добавить зависимости в Gradle
  • Добавьте файлы макета xml для действия и для ячейки сетки
  • Сделайте адаптер RecyclerView
  • Инициализируйте RecyclerView в своей деятельности

Обновите зависимости Gradle

Убедитесь, что в вашем приложении есть следующие зависимости gradle.build:

compile 'com.android.support:appcompat-v7:27.1.1'
compile 'com.android.support:recyclerview-v7:27.1.1'

Вы можете обновить номера версий до самых актуальных .

Создать макет деятельности

Добавьте RecyclerViewк вашему XML-макету.

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <android.support.v7.widget.RecyclerView
        android:id="@+id/rvNumbers"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</RelativeLayout>

Создать макет ячейки сетки

Каждая ячейка в нашей RecyclerViewсетке будет иметь только одну ячейку TextView. Создайте новый файл ресурсов макета.

recyclerview_item.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="horizontal"
    android:padding="5dp"
    android:layout_width="50dp"
    android:layout_height="50dp">

        <TextView
            android:id="@+id/info_text"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:gravity="center"
            android:background="@color/colorAccent"/>

</LinearLayout>

Создать адаптер

RecyclerViewНужен адаптер для заполнения представлений в каждой ячейке с вашими данными. Создайте новый файл Java.

MyRecyclerViewAdapter.java

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

    private String[] mData;
    private LayoutInflater mInflater;
    private ItemClickListener mClickListener;

    // data is passed into the constructor
    MyRecyclerViewAdapter(Context context, String[] data) {
        this.mInflater = LayoutInflater.from(context);
        this.mData = data;
    }

    // inflates the cell 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 TextView in each cell
    @Override
    public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
        holder.myTextView.setText(mData[position]);
    }

    // total number of cells
    @Override
    public int getItemCount() {
        return mData.length;
    }


    // stores and recycles views as they are scrolled off screen
    public class ViewHolder extends RecyclerView.ViewHolder implements View.OnClickListener {
        TextView myTextView;

        ViewHolder(View itemView) {
            super(itemView);
            myTextView = itemView.findViewById(R.id.info_text);
            itemView.setOnClickListener(this);
        }

        @Override
        public void onClick(View view) {
            if (mClickListener != null) mClickListener.onItemClick(view, getAdapterPosition());
        }
    }

    // convenience method for getting data at click position
    String getItem(int id) {
        return mData[id];
    }

    // allows clicks events to be caught
    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);
    }
}

Ноты

  • Хотя это и не является строго необходимым, я включил функцию прослушивания событий щелчка по ячейкам. Это было доступно в старых GridViewи является общей потребностью. Вы можете удалить этот код, если он вам не нужен.

Инициализируйте RecyclerView в действии

Добавьте следующий код к вашей основной деятельности.

MainActivity.java

public class MainActivity extends AppCompatActivity implements MyRecyclerViewAdapter.ItemClickListener {

    MyRecyclerViewAdapter adapter;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // data to populate the RecyclerView with
        String[] data = {"1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "34", "35", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47", "48"};

        // set up the RecyclerView
        RecyclerView recyclerView = findViewById(R.id.rvNumbers);
        int numberOfColumns = 6;
        recyclerView.setLayoutManager(new GridLayoutManager(this, numberOfColumns));
        adapter = new MyRecyclerViewAdapter(this, data);
        adapter.setClickListener(this);
        recyclerView.setAdapter(adapter);
    }

    @Override
    public void onItemClick(View view, int position) {
        Log.i("TAG", "You clicked number " + adapter.getItem(position) + ", which is at cell position " + position);
    }
}

Ноты

  • Обратите внимание, что действие реализует то, ItemClickListenerчто мы определили в нашем адаптере. Это позволяет нам обрабатывать события щелчка в ячейке onItemClick.

Законченный

Вот и все. Вы должны быть в состоянии запустить ваш проект сейчас и получить что-то похожее на изображение вверху.

Продолжается

Закругленные углы

Авто-монтаж колонн

Дальнейшее обучение

Suragch
источник
2
@ MarianPaździoch, да, я просто сделал это как минимальный пример. Это может определенно использовать некоторые работы по украшению. Я постараюсь обновить этот ответ когда-нибудь в будущем.
Сурагч
1
Я вошел в систему только для того, чтобы указать, что такие люди, как вы, поддерживали этот портал и пинали его. Я застрял на нем два дня, прежде чем увидел это решение.
Большое
1
@androiddeveloper, Элементы сетки располагаются слева направо, сверху вниз. Прокрутка вертикальная, когда на экране больше элементов, чем может поместиться.
Сурагч
13
Будущие читатели, позвольте мне сэкономить вам время, главноеrecyclerView.setLayoutManager(new GridLayoutManager(this, numberOfColumns));
дака
1
@daka, хорошая мысль. Я отредактировал свой ответ, чтобы включить это в начале.
Сурагч
7

Хотя я , как и оценить Suragch ответ «S , я хотел бы оставить записку , потому что я обнаружил , что кодирование адаптера ( MyRecyclerViewAdapter) , чтобы определить и выставить метод прослушивателя onItemClickне лучший способ сделать это, из - за не используя класс инкапсуляцию правильно. Поэтому я предлагаю позволить адаптеру обрабатывать только операции прослушивания (это его цель!) И отделить их от действия, которое использует адаптер ( MainActivity). Итак, вот как я бы установил класс Adapter:

MyRecyclerViewAdapter.java

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

    private String[] mData = new String[0];
    private LayoutInflater mInflater;

    // Data is passed into the constructor
    public MyRecyclerViewAdapter(Context context, String[] data) {
        this.mInflater = LayoutInflater.from(context);
        this.mData = data;
    }

    // Inflates the cell layout from xml when needed
    @Override
    public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View view = mInflater.inflate(R.layout.recyclerview_item, parent, false);
        ViewHolder viewHolder = new ViewHolder(view);
        return viewHolder;
    }

    // Binds the data to the textview in each cell
    @Override
    public void onBindViewHolder(ViewHolder holder, int position) {
        String animal = mData[position];
        holder.myTextView.setText(animal);
    }

    // Total number of cells
    @Override
    public int getItemCount() {
        return mData.length;
    }

    // Stores and recycles views as they are scrolled off screen
    public class ViewHolder extends RecyclerView.ViewHolder implements View.OnClickListener {
        public TextView myTextView;

        public ViewHolder(View itemView) {
            super(itemView);
            myTextView = (TextView) itemView.findViewById(R.id.info_text);
            itemView.setOnClickListener(this);
        }

        @Override
        public void onClick(View view) {
            onItemClick(view, getAdapterPosition());
        }
    }

    // Convenience method for getting data at click position
    public String getItem(int id) {
        return mData[id];
    }

    // Method that executes your code for the action received
    public void onItemClick(View view, int position) {
        Log.i("TAG", "You clicked number " + getItem(position).toString() + ", which is at cell position " + position);
    }
}

Обратите внимание, что onItemClickметод, который теперь определен в MyRecyclerViewAdapterэтом месте, - это место, где вы хотели бы закодировать свои задачи для полученного события / действия.

Для того чтобы завершить это преобразование, нужно сделать лишь небольшое изменение: Activity больше не нужно реализовывать MyRecyclerViewAdapter.ItemClickListener, потому что теперь это полностью выполняет Adapter . Это будет окончательная модификация:

MainActivity.java

public class MainActivity extends AppCompatActivity {

    MyRecyclerViewAdapter adapter;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // data to populate the RecyclerView with
        String[] data = {"1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "34", "35", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47", "48"};

        // set up the RecyclerView
        RecyclerView recyclerView = (RecyclerView) findViewById(R.id.rvNumbers);
        int numberOfColumns = 6;
        recyclerView.setLayoutManager(new GridLayoutManager(this, numberOfColumns));
        adapter = new MyRecyclerViewAdapter(this, data);
        adapter.setClickListener(this);
        recyclerView.setAdapter(adapter);
    }
}
jonypera
источник
3
Что делать, если активность должна прослушивать события щелчка? например, передача данных докладчику, логика, основанная на щелчке элемента, отслеживании и т. д.
Ахмад Фадли,
Я согласен, что Адаптер должен обрабатывать события щелчка, так как в нем есть элементы с данными. @AhmadFadli, если вам нужно выполнить какую-то работу на хосте адаптера (фрагмент или действие), вы должны создать интерфейс обратного вызова с необходимыми вам методами. Ваш хост реализует этот интерфейс. А затем вы передаете экземпляр вашего хоста в конструктор адаптера. Имея экземпляр хоста, вы можете вызывать его методы, когда вам нужно, из вашего адаптера. А вашему хозяину мы получаем обратные вызовы. Это часто используется, когда вам нужно работать с ActionMode. Когда вы долго нажимаете, чтобы выбрать элементы и использовать кнопки ActionBar.
Кирилл Кармазин
Я не согласен и считаю, что события кликов должны обрабатываться на хостинге Activity. Потому что только это кликни слушатель может узнать о Activityвзглядах и других Fragments, Activitiesи т.д. Адаптер может отправлять событие нажатия на верхний уровень. Он должен иметь интерфейс ItemClickListener с таким количеством событий, которое может генерировать множество представлений адаптера событий. Это решение было написано еще раньше: stackoverflow.com/a/40563598/2914140 .
CoolMind
4

Вам нужно перевести менеджер макета RecyclelerView в режим Gridlayout, для этого просто измените свой код, когда хотите. Установите RecyclerView LayoutManager:

Примечание: замените желаемое количество столбцов на ### HELP ###

   recyclerView.setLayoutManager(new GridLayoutManager(getActivity(),###HELP###));
MR Coder
источник