滑動檢視畫面可讓您透過橫向移動的手勢 (也就是左右「滑動」),在同層畫面 (如分頁) 之間導覽。這種導覽模式又稱為「橫向分頁」。本文件將說明如何建立包含滑動檢視畫面的分頁版面配置,以便在分頁之間切換,以及如何顯示標題列而非分頁。
實作滑動檢視畫面
您可以使用 AndroidX 的 ViewPager 小工具建立滑動檢視畫面。如要使用 ViewPager 和分頁,您需要在專案中新增 ViewPager 和 Material Design 元件的依附元件。
如要透過 ViewPager 設定版面配置,請將 <ViewPager> 元素新增到您的 XML 版面配置中。例如,如果滑動檢視畫面中的每個頁面都要使用整個版面配置,則版面配置將如下所示:
<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" />
如要插入代表各個頁面的子檢視畫面,請將這個版面配置掛接到 PagerAdapter。有兩種內建轉接器可選擇:
FragmentPagerAdapter:適用於在固定數量的小型同層畫面間切換。FragmentStatePagerAdapter:適用於對數量不明的頁面進行分頁。FragmentStatePagerAdapter會在使用者離開畫面時刪除片段,藉此最佳化記憶體用量。
以下範例說明可如何使用 FragmentStatePagerAdapter 來滑動一系列的 Fragment 物件:
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)));
}
}
下列各節說明如何新增分頁,協助使用者瀏覽頁面。
使用 TabLayout 新增分頁
TabLayout 可讓您以橫向排列的方式顯示分頁。與 ViewPager 搭配使用時,TabLayout 可提供熟悉的介面,以便在滑動檢視畫面中瀏覽頁面。

TabLayout。如要在 ViewPager 中加入 TabLayout,請在 <ViewPager> 元素內加入 <TabLayout> 元素,如下所示:
<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>
接下來,請使用 setupWithViewPager 將 TabLayout 連結至 ViewPager。TabLayout 中的個別分頁會自動填入 PagerAdapter 的網頁標題:
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);
}
...
}
如需分頁版面配置的其他設計指南,請參閱適用於分頁的 Material Design 說明文件。