Diese Seite wurde von der Cloud Translation API übersetzt.

Wischansichten mit Tabs mit ViewPager erstellen

Mit Wischansichten können Sie mit einer horizontalen Fingergeste oder Wischen zwischen gleichgeordneten Bildschirmen wie Tabs wechseln. Dieses Navigationsmuster wird auch als horizontales Paging bezeichnet. In diesem Artikel erfahren Sie, wie Sie ein Tablayout mit Wischansichten zum Wechseln zwischen Tabs erstellen und wie Sie einen Titelstreifen anstelle von Tabs anzeigen.

Wischansichten implementieren

Sie können Wischansichten mit dem ViewPager-Widget von AndroidX erstellen. Wenn Sie eine ViewPager und Tabs verwenden möchten, müssen Sie Ihrem Projekt Abhängigkeiten für ViewPager und Material Components hinzufügen.

Wenn Sie Ihr Layout mit ViewPager einrichten möchten, fügen Sie Ihrem XML-Layout das <ViewPager>-Element hinzu. Wenn z. B. jede Seite in der Wischansicht das gesamte Layout verwendet, sieht Ihr Layout so aus:

<androidx.viewpager.widget.ViewPager
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/pager"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

Wenn Sie untergeordnete Ansichten einfügen möchten, die jede Seite darstellen, müssen Sie dieses Layout mit einem PagerAdapter verknüpfen. Sie können zwischen zwei Arten von integrierten Adaptern wählen:

FragmentPagerAdapter: Verwenden Sie diese Option, wenn Sie zwischen einer kleinen, festen Anzahl von gleichgeordneten Bildschirmen wechseln möchten.
FragmentStatePagerAdapter: Verwenden Sie diese Option, wenn Sie durch eine unbekannte Anzahl von Seiten wechseln. FragmentStatePagerAdapter optimiert die Arbeitsspeichernutzung, indem Fragmente gelöscht werden, während der Nutzer die Seite verlässt.

Hier sehen Sie ein Beispiel, wie Sie FragmentStatePagerAdapter verwenden können, um über eine Sammlung von Fragment-Objekten zu wischen:

Kotlin

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

    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?) {
        demoCollectionPagerAdapter = DemoCollectionPagerAdapter(childFragmentManager)
        viewPager = view.findViewById(R.id.pager)
        viewPager.adapter = demoCollectionPagerAdapter
    }
}

// Since this is an object collection, use a FragmentStatePagerAdapter,
// NOT a FragmentPagerAdapter.
class DemoCollectionPagerAdapter(fm: FragmentManager) : FragmentStatePagerAdapter(fm) {

    override fun getCount(): Int  = 100

    override fun getItem(i: Int): Fragment {
        val fragment = DemoObjectFragment()
        fragment.arguments = Bundle().apply {
            // Our object is just an integer :-P
            putInt(ARG_OBJECT, i + 1)
        }
        return fragment
    }

    override fun getPageTitle(position: Int): CharSequence {
        return "OBJECT ${(position + 1)}"
    }
}

private const val ARG_OBJECT = "object"

// Instances of this class are fragments representing a single
// object in the 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()
        }
    }
}

Java

public class CollectionDemoFragment extends Fragment {
    // When requested, this adapter returns a DemoObjectFragment
    // representing an object in the collection.
    DemoCollectionPagerAdapter demoCollectionPagerAdapter;
    ViewPager 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) {
        demoCollectionPagerAdapter = new DemoCollectionPagerAdapter(getChildFragmentManager());
        viewPager = view.findViewById(R.id.pager);
        viewPager.setAdapter(demoCollectionPagerAdapter);
   }
}

// Since this is an object collection, use a FragmentStatePagerAdapter,
// NOT a FragmentPagerAdapter.
public class DemoCollectionPagerAdapter extends FragmentStatePagerAdapter {
    public DemoCollectionPagerAdapter(FragmentManager fm) {
        super(fm);
    }

    @Override
    public Fragment getItem(int i) {
        Fragment fragment = new DemoObjectFragment();
        Bundle args = new Bundle();
        // Our object is just an integer :-P
        args.putInt(DemoObjectFragment.ARG_OBJECT, i + 1);
        fragment.setArguments(args);
        return fragment;
    }

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

    @Override
    public CharSequence getPageTitle(int position) {
        return "OBJECT " + (position + 1);
    }
}

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

    @Override
    public View onCreateView(LayoutInflater inflater,
            ViewGroup container, 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)));
    }
}

In den folgenden Abschnitten wird gezeigt, wie Sie Tabs hinzufügen, um die Navigation zwischen Seiten zu erleichtern.

Tabs mithilfe eines TabLayout hinzufügen

Mit TabLayout können Sie Tabs horizontal anzeigen. In Kombination mit einem ViewPager bietet ein TabLayout eine vertraute Oberfläche zum Wechseln zwischen Seiten in einer Wischansicht.

Abbildung 1: Ein TabLayout mit vier Tabs.

Wenn Sie ein TabLayout in eine ViewPager einfügen möchten, fügen Sie wie unten gezeigt ein <TabLayout>-Element innerhalb des <ViewPager>-Elements ein:

<androidx.viewpager.widget.ViewPager
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/pager"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

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

</androidx.viewpager.widget.ViewPager>

Verwenden Sie dann setupWithViewPager(), um TabLayout mit dem ViewPager zu verknüpfen. Die einzelnen Tabs im TabLayout werden automatisch mit den Seitentiteln von PagerAdapter gefüllt:

Kotlin

class CollectionDemoFragment : Fragment() {
    ...
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        val tabLayout = view.findViewById(R.id.tab_layout)
        tabLayout.setupWithViewPager(viewPager)
    }
    ...
}

class DemoCollectionPagerAdapter(fm: FragmentManager) : FragmentStatePagerAdapter(fm) {

    override fun getCount(): Int  = 4

    override fun getPageTitle(position: Int): CharSequence {
        return "OBJECT ${(position + 1)}"
    }
    ...
}

Java

public class CollectionDemoFragment extends Fragment {
    ...
    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        TabLayout tabLayout = view.findViewById(R.id.tab_layout);
        tabLayout.setupWithViewPager(viewPager);
    }
    ...
}

public class DemoCollectionPagerAdapter extends FragmentStatePagerAdapter {
    ...
    @Override
    public int getCount() {
        return 4;
    }

    @Override
    public CharSequence getPageTitle(int position) {
        return "OBJECT " + (position + 1);
    }

    ...
}

Weitere Informationen zum Design von Tab-Layouts findest du in der Material Design-Dokumentation für Tabs.