Нередко можно встретить приложения, которые реализуют систему перелистывания, а само приложение предстает в виде набора страниц, которые можно пролистывать влево и вправо. В приложении Android для создания подобного эффекта можно использовать элемент ViewPager2 из комплекта JetPack. Для создания эффекта страниц ViewPager2 использует фрагменты.
Итак, создадим новый проект. Добавим в папку res/layout файл разметки для фрагмента, который будет представлять страницу. Назовем его fragment_page.xml и определим в нем следующий код:
<?xml version="1.0" encoding="utf-8"?> <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" android:layout_width="match_parent" android:layout_height="match_parent"> <TextView android:id="@+id/displayText" android:layout_width="wrap_content" android:layout_height="wrap_content" android:textSize="22sp" app:layout_constraintBottom_toBottomOf="parent" app:layout_constraintLeft_toLeftOf="parent" app:layout_constraintRight_toRightOf="parent" app:layout_constraintTop_toTopOf="parent" /> </androidx.constraintlayout.widget.ConstraintLayout>
Фрагмент будет отображать текстовое поле с номером страницы.
Теперь добавим в проект сам класс фрагмента. Назовем его PageFragment:
package com.example.viewpagerapp; import android.os.Bundle; import android.view.LayoutInflater; import android.view.View; import android.view.ViewGroup; import android.widget.TextView; import androidx.fragment.app.Fragment; public class PageFragment extends Fragment { private int pageNumber; public static PageFragment newInstance(int page) { PageFragment fragment = new PageFragment(); Bundle args=new Bundle(); args.putInt("num", page); fragment.setArguments(args); return fragment; } public PageFragment() { } @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); pageNumber = getArguments() != null ? getArguments().getInt("num") : 1; } @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { View result=inflater.inflate(R.layout.fragment_page, container, false); TextView pageHeader = result.findViewById(R.id.displayText); String header = "Фрагмент " + (pageNumber+1); pageHeader.setText(header); return result; } }
Переменная pageNumber
указывает на номер текущей страницы. Номер страницы будет передаваться извне через фабричный метод
newInstance()
. Передача номера происходит путем добавления значения в аргумент "num"
Затем при создании фрагмента в методе onCreate()
этот номер будет извлекаться из аргумента "num" (если аргументы определены):
pageNumber = getArguments() != null ? getArguments().getInt("num") : 1;
В методе onCreateView()
полученный номер страницы будет отображаться в текстовом поле.
Сам по себе фрагмент еще не создает функциональность постраничной навигации. Для этого нам нужен один из классов PagerAdapter. Android SDK содержит ряд встроенных реализаций PagerAdapter, в частности, класс FragmentStateAdapter. Этот класс являются абстрактным, поэтому напрямую мы его использовать не можем, и нам нужно создать класс-наследник. Для этого добавим в проект новый класс, который назовем MyAdapter:
package com.example.viewpagerapp; import androidx.annotation.NonNull; import androidx.fragment.app.Fragment; import androidx.fragment.app.FragmentActivity; import androidx.viewpager2.adapter.FragmentStateAdapter; public class MyAdapter extends FragmentStateAdapter { public MyAdapter(FragmentActivity fragmentActivity) { super(fragmentActivity); } @NonNull @Override public Fragment createFragment(int position) { return(PageFragment.newInstance(position)); } @Override public int getItemCount() { return 10; } }
Класс FragmentStateAdapter определяет два метода:
int getItemCount()
: возвращает количество страниц, которые будут в ViewPager2 (в нашем случае 10)
Fragment createFragment(int position)
: по номеру страницы, передаваемому в качестве параметра position, возвращает объект фрагмента
Стоит отметить, что в качестве параметра конструктор FragmentStateAdapter принимает контекст выполнения - обычно это объект FragmentActivity, но также это может быть объект Fragment
В завершении установим в файле activity_main.xml элемент ViewPager2:
<androidx.viewpager2.widget.ViewPager2 xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/pager" android:layout_width="match_parent" android:layout_height="match_parent" />
И также изменим код MainActivity:
package com.example.viewpagerapp; import androidx.appcompat.app.AppCompatActivity; import androidx.viewpager2.adapter.FragmentStateAdapter; import androidx.viewpager2.widget.ViewPager2; import android.os.Bundle; public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); ViewPager2 pager = findViewById(R.id.pager); FragmentStateAdapter pageAdapter = new MyAdapter(this); pager.setAdapter(pageAdapter); } }
Класс MainActivity наследуется от AppCompatActivity - класса, который в свою очередь наследуется от FragmentActivity, и поэтому ее текущий объект мы можем передать в качестве параметра в конструктор MyAdapter (а через него - в конструктор FragmentStateAdapter). Чтобы перелистывание заработало, для ViewPager2 устанавливается адаптер MyAdapter.
И запустив проект, мы сможем с помощью перелистывания перемещаться по страницам: