Mit Wischansichten kannst du mit einer horizontalen Fingergeste (Wischen) zwischen gleichgeordneten Bildschirmen wie Tabs wechseln. Dieses Navigationsmuster wird auch als horizontales Paging bezeichnet. In diesem Dokument wird beschrieben, wie Sie ein Tab-Layout mit Wischansichten zum Wechseln zwischen Tabs erstellen und wie Sie anstelle von Tabs einen Titelstreifen anzeigen.
Wischansichten implementieren
Sie können Wischansichten mit dem ViewPager-Widget von AndroidX erstellen. Wenn Sie ViewPager und Tabs verwenden möchten, fügen Sie Ihrem Projekt Abhängigkeiten von ViewPager und Material Components hinzu.
Wenn du dein Layout mit ViewPager einrichten möchtest, füge das <ViewPager>-Element zu deinem XML-Layout hinzu. Wenn beispielsweise jede Seite in der Wischansicht das gesamte Layout einnehmen soll, sieht das 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 für jede Seite einfügen möchten, verknüpfen Sie dieses Layout mit einem PagerAdapter. 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.FragmentStatePagerAdapter: Verwenden Sie diese Option, wenn Sie eine unbekannte Anzahl von Seiten durchblättern.FragmentStatePagerAdapteroptimiert die Speichernutzung, indem Fragmente gelöscht werden, wenn der Nutzer die Seite verlässt.
Hier ein Beispiel dafür, wie Sie mit FragmentStatePagerAdapter durch eine Sammlung von Fragment-Objekten wischen können:
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 your
// 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.
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 your
// 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)));
}
}
Im folgenden Abschnitt wird beschrieben, wie Sie Tabs hinzufügen, um die Navigation zwischen Seiten zu erleichtern.
Tabs mit einem TabLayout hinzufügen
Mit einem TabLayout können Tabs horizontal angezeigt werden. In Kombination mit einem ViewPager bietet ein TabLayout eine vertraute Oberfläche für die Navigation zwischen Seiten in einer Wischansicht.
TabLayout mit vier Tabs.Wenn Sie ein TabLayout in ein ViewPager einfügen möchten, fügen Sie ein <TabLayout>-Element in das <ViewPager>-Element ein, wie im folgenden Beispiel gezeigt:
<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 setupWithViewPager, um die TabLayout mit der ViewPager zu verknüpfen, wie im folgenden Beispiel gezeigt. Die einzelnen Tabs in der TabLayout werden automatisch mit den Seitentiteln aus der PagerAdapter ausgefü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 Designhinweise für Tab-Layouts finden Sie in der Material Design-Dokumentation für Tabs.