Создавайте пролистываемые представления с вкладками с помощью ViewPager2.

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

Реализация просмотра с перелистыванием

Вы можете создавать пролистываемые представления с помощью виджета AndroidX ViewPager2 . Чтобы использовать ViewPager2 и вкладки, вам необходимо добавить в проект зависимость от ViewPager2 и компонентов материала .

Чтобы настроить макет с помощью ViewPager2 , добавьте элемент <ViewPager2> в макет XML. Например, если каждая страница в режиме пролистывания должна занимать весь макет, ваш макет должен выглядеть следующим образом:

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

Чтобы вставить дочерние представления, представляющие каждую страницу, вам необходимо подключить этот макет к FragmentStateAdapter . Вот как вы можете использовать его для перемещения по коллекции объектов Fragment :

class CollectionDemoFragment : Fragment() {
   
// When requested, this adapter returns a DemoObjectFragment,
   
// representing an object in the collection.
   
private lateinit var demoCollectionAdapter: DemoCollectionAdapter
   
private lateinit var viewPager: ViewPager2

   
override fun onCreateView(
        inflater
: LayoutInflater,
        container
: ViewGroup?,
        savedInstanceState
: Bundle?
   
): View? {
       
return inflater.inflate(R.layout.collection_demo, container, false)
   
}

   
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        demoCollectionAdapter
= DemoCollectionAdapter(this)
        viewPager
= view.findViewById(R.id.pager)
        viewPager
.adapter = demoCollectionAdapter
   
}
}

class DemoCollectionAdapter(fragment: Fragment) : FragmentStateAdapter(fragment) {

   
override fun getItemCount(): Int = 100

   
override fun createFragment(position: Int): Fragment {
       
// Return a NEW fragment instance in createFragment(int)
       
val fragment = DemoObjectFragment()
        fragment
.arguments = Bundle().apply {
           
// Our object is just an integer :-P
            putInt
(ARG_OBJECT, position + 1)
       
}
       
return fragment
   
}
}

private const val ARG_OBJECT = "object"

// Instances of this class are fragments representing a single
// object in our collection.
class DemoObjectFragment : Fragment() {

   
override fun onCreateView(
        inflater
: LayoutInflater,
        container
: ViewGroup?,
        savedInstanceState
: Bundle?
   
): View {
       
return inflater.inflate(R.layout.fragment_collection_object, container, false)
   
}

   
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        arguments
?.takeIf { it.containsKey(ARG_OBJECT) }?.apply {
           
val textView: TextView = view.findViewById(android.R.id.text1)
            textView
.text = getInt(ARG_OBJECT).toString()
       
}
   
}
}
public class CollectionDemoFragment extends Fragment {
   
// When requested, this adapter returns a DemoObjectFragment,
   
// representing an object in the collection.
   
DemoCollectionAdapter demoCollectionAdapter;
   
ViewPager2 viewPager;

   
@Nullable
   
@Override
   
public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container,
           
@Nullable Bundle savedInstanceState) {
       
return inflater.inflate(R.layout.collection_demo, container, false);
   
}

   
@Override
   
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        demoCollectionAdapter
= new DemoCollectionAdapter(this);
        viewPager
= view.findViewById(R.id.pager);
        viewPager
.setAdapter(demoCollectionAdapter);
   
}
}

public class DemoCollectionAdapter extends FragmentStateAdapter {
   
public DemoCollectionAdapter(Fragment fragment) {
       
super(fragment);
   
}

   
@NonNull
   
@Override
   
public Fragment createFragment(int position) {
       
// Return a NEW fragment instance in createFragment(int)
       
Fragment fragment = new DemoObjectFragment();
       
Bundle args = new Bundle();
       
// Our object is just an integer :-P
        args
.putInt(DemoObjectFragment.ARG_OBJECT, position + 1);
        fragment
.setArguments(args);
       
return fragment;
   
}

   
@Override
   
public int getItemCount() {
       
return 100;
   
}
}

// Instances of this class are fragments representing a single
// object in our collection.
public class DemoObjectFragment extends Fragment {
   
public static final String ARG_OBJECT = "object";

   
@Nullable
   
@Override
   
public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container,
           
@Nullable Bundle savedInstanceState) {
       
return inflater.inflate(R.layout.fragment_collection_object, container, false);
   
}

   
@Override
   
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
       
Bundle args = getArguments();
       
((TextView) view.findViewById(android.R.id.text1))
               
.setText(Integer.toString(args.getInt(ARG_OBJECT)));
   
}
}

В следующих разделах показано, как можно добавлять вкладки для облегчения навигации между страницами.

Добавление вкладок с помощью TabLayout

TabLayout позволяет отображать вкладки горизонтально. При использовании вместе с ViewPager2 TabLayout может предоставить знакомый интерфейс для навигации между страницами в режиме пролистывания.

Рис. 1. TabLayout с четырьмя вкладками.

Чтобы включить TabLayout в ViewPager2 , добавьте элемент <TabLayout> над элементом <ViewPager2> , как показано ниже:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
   
android:layout_width="match_parent"
   
android:layout_height="match_parent"
   
android:orientation="vertical">

   
<com.google.android.material.tabs.TabLayout
       
android:id="@+id/tab_layout"
       
android:layout_width="match_parent"
       
android:layout_height="wrap_content" />

   
<androidx.viewpager2.widget.ViewPager2
       
android:id="@+id/pager"
       
android:layout_width="match_parent"
       
android:layout_height="0dp"
       
android:layout_weight="1" />

</LinearLayout>

Затем создайте TabLayoutMediator , чтобы связать TabLayout с ViewPager2 , и прикрепите его следующим образом:

class CollectionDemoFragment : Fragment() {
   
...
   
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
       
val tabLayout = view.findViewById(R.id.tab_layout)
       
TabLayoutMediator(tabLayout, viewPager) { tab, position ->
            tab
.text = "OBJECT ${(position + 1)}"
       
}.attach()
   
}
   
...
}
public class CollectionDemoFragment extends Fragment {
   
...
   
@Override
   
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
       
TabLayout tabLayout = view.findViewById(R.id.tab_layout);
       
new TabLayoutMediator(tabLayout, viewPager,
               
(tab, position) -> tab.setText("OBJECT " + (position + 1))
       
).attach();
   
}
   
...
}

Дополнительные рекомендации по проектированию макетов вкладок см. в документации Material Design для вкладок .

Дополнительные ресурсы

Дополнительные сведения о ViewPager2 см. в следующих дополнительных ресурсах.

Образцы

Видео