Android ViewPagerの使い方を徹底解説！TabLayoutと連携したFragment切り替えの実装手順

Android ViewPagerとは？

実装例に入る前に、まずViewPagerの基本をおさえておきましょう。ViewPagerはAndroidのサポートライブラリに含まれるウィジェットの一つで、画面を左右にスワイプするだけでFragment（フラグメント）を切り替えられる便利なコンポーネントです。

チュートリアル画面や画像ギャラリー、タブ式のコンテンツ切り替えなど、さまざまなアプリで活用されている定番UIです。本記事では、ViewPagerとTabLayoutを組み合わせた実装方法を、具体的なコード例とともにステップ形式で解説します。

ステップ1：新規プロジェクトを作成する

Android Studioを起動し、メニューから「File」→「New Project」を選択します。必要な項目を入力して、新しいプロジェクトを作成しましょう。

ステップ2：build.gradleに依存関係を追加する

モジュールレベルのbuild.gradleに以下のコードを追加します。サポートライブラリ（appcompat-v7・design・constraint-layout）をdependenciesブロックに記述するのがポイントです。

apply plugin: 'com.android.application'
android {
   compileSdkVersion 28
   defaultConfig {
      applicationId "com.example.andy.myapplication"
      minSdkVersion 19
      targetSdkVersion 28
      versionCode 1
      versionName "1.0"
      testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
   }
   buildTypes {
      release {
         minifyEnabled false
         proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
      }
   }
}
dependencies {
   implementation fileTree(dir: 'libs', include: ['*.jar'])
   implementation 'com.android.support:appcompat-v7:28.0.0'
   implementation 'com.android.support:design:28.0.0'
   implementation 'com.android.support.constraint:constraint-layout:1.1.3'
   testImplementation 'junit:junit:4.12'
   androidTestImplementation 'com.android.support.test:runner:1.0.2'
   androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}

ステップ3：activity_main.xmlを編集する

res/layout/activity_main.xmlに以下のコードを追加します。全体をCoordinatorLayoutで構成し、AppBarLayout内にToolbarとTabLayoutを配置、その下にViewPagerを置いています。

<?xml version = "1.0" encoding = "utf-8"?>
<android.support.design.widget.CoordinatorLayout
   xmlns:android = "https://schemas.android.com/apk/res/android"
   xmlns:app = "https://schemas.android.com/apk/res-auto"
   android:layout_width = "match_parent"
   android:layout_height = "match_parent">
   <android.support.design.widget.AppBarLayout
      android:layout_width = "match_parent"
      android:layout_height = "wrap_content"
      android:theme = "@style/ThemeOverlay.AppCompat.Dark.ActionBar">
      <android.support.v7.widget.Toolbar
         android:id = "@+id/toolbar"
         android:layout_width = "match_parent"
         android:layout_height = "?attr/actionBarSize"
         android:background = "?attr/colorPrimary"
         app:layout_scrollFlags = "scroll|enterAlways"
         app:popupTheme = "@style/ThemeOverlay.AppCompat.Light" />
      <android.support.design.widget.TabLayout
         android:id = "@+id/tabs"
         android:layout_width = "match_parent"
         android:layout_height = "wrap_content"
         app:tabMode = "fixed"
         app:tabGravity = "fill"/>
   </android.support.design.widget.AppBarLayout>
   <android.support.v4.view.ViewPager
      android:id = "@+id/viewpager"
      android:layout_width = "match_parent"
      android:layout_height = "match_parent"
      app:layout_behavior = "@string/appbar_scrolling_view_behavior" />
</android.support.design.widget.CoordinatorLayout>

ステップ4：MainActivity.javaを実装する

src/MainActivity.javaに以下のコードを追加します。内部クラスとしてViewPagerAdapter（FragmentPagerAdapterを継承）を定義し、Fragmentとタブタイトルをリストで管理できるようにしています。addFragment()でページを追加し、setAdapter()でViewPagerにセット、最後にsetupWithViewPager()を呼び出すことでTabLayoutと連携します。

package com.example.andy.myapplication;
import android.annotation.TargetApi;
import android.os.Build;
import android.os.Bundle;
import android.support.design.widget.TabLayout;
import android.support.v4.app.Fragment;
import android.support.v4.app.FragmentManager;
import android.support.v4.app.FragmentPagerAdapter;
import android.support.v4.view.ViewPager;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.Toolbar;
import java.util.ArrayList;
import java.util.List;
public class MainActivity extends AppCompatActivity {
   private ViewPager viewPager;
   private Toolbar toolbar;
   private TabLayout tabLayout;
   @TargetApi(Build.VERSION_CODES.O)
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      toolbar = (Toolbar) findViewById(R.id.toolbar);
      setSupportActionBar(toolbar);
      getSupportActionBar().setDisplayHomeAsUpEnabled(true);
      tabLayout = findViewById(R.id.tabs);
      viewPager = findViewById(R.id.viewpager);
      ViewPagerAdapter adapter = new ViewPagerAdapter(getSupportFragmentManager());
      adapter.addFragment(new OneFragment(), "ONE");
      adapter.addFragment(new TwoFragment(), "TWO");
      viewPager.setAdapter(adapter);
      tabLayout.setupWithViewPager(viewPager);
   }
   class ViewPagerAdapter extends FragmentPagerAdapter {
      private final List<Fragment> mList = new ArrayList<>();
      private final List<String> mTitleList = new ArrayList<>();
      public ViewPagerAdapter(FragmentManager supportFragmentManager) {
         super(supportFragmentManager);
      }
      @Override
      public Fragment getItem(int i) {
         return mList.get(i);
      }
      @Override
      public int getCount() {
         return mList.size();
      }
      public void addFragment(Fragment fragment, String title) {
         mList.add(fragment);
         mTitleList.add(title);
      }
      @Override
      public CharSequence getPageTitle(int position) {
         return mTitleList.get(position);
      }
   }
}

ステップ5：OneFragment.javaを作成する

src/OneFragment.javaに以下のコードを追加します。1つ目のタブに表示されるFragmentです。

package com.example.andy.myapplication;
import android.os.Bundle;
import android.support.v4.app.Fragment;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;
public class OneFragment extends Fragment {
   @Override
   public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState){
      View v= inflater.inflate(R.layout.fragment_one, container, false);
      TextView textView=v.findViewById(R.id.text);
      textView.setText("First Fragment");
      return v;
   }
}

ステップ6：TwoFragment.javaを作成する

src/TwoFragment.javaに以下のコードを追加します。2つ目のタブ用のFragmentです。なお、このサンプルではレイアウトファイルを共通化しているため、どちらのFragmentもfragment_one.xmlを使用しています。

package com.example.andy.myapplication;
import android.os.Bundle;
import android.support.v4.app.Fragment;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;
public class TwoFragment extends Fragment {
   @Override
   public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState){
      View v= inflater.inflate(R.layout.fragment_one, container, false);
      TextView textView=v.findViewById(R.id.text);
      textView.setText("Second Fragment");
      return v;
   }
}

ステップ7：fragment_one.xmlを作成する

res/layout/fragment_one.xmlに以下のコードを追加します。画面中央にテキストを表示するだけのシンプルなレイアウトです。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
xmlns:android="https://schemas.android.com/apk/res/android" android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
   android:id="@+id/text"
   android:layout_width="match_parent"
   android:layout_height="wrap_content"
   android:gravity="center"
   android:textSize="20sp"
/>
</LinearLayout>

ステップ8：styles.xmlを編集する

styles.xmlに以下のコードを追加します。独自のToolbarを使用するため、windowNoTitleとwindowActionBarをfalseに設定している点に注意してください。

<resources>
   <!-- Base application theme. -->
   <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
      <!-- Customize your theme here. -->
      <item name = "windowNoTitle">true</item>
      <item name = "windowActionBar">false</item>
      <item name="colorPrimary">@color/colorPrimary</item>
      <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
      <item name="colorAccent">@color/colorAccent</item>
   </style>
</resources>

アプリを実行して動作を確認しよう

それでは、作成したアプリを実際に実行してみましょう。ここでは、実機のAndroidスマートフォンがPCに接続されているものとして進めます。Android Studioでプロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックしてください。実行デバイスとして自分のスマートフォンを選択すると、端末に以下のような画面が表示されます。

補足：最新の開発ではViewPager2が推奨

なお、本記事で使用しているandroid.supportライブラリはすでに非推奨となっており、現在のAndroid開発ではJetpack（AndroidX）への移行が進められています。新規プロジェクトでは、後継であるViewPager2（androidx.viewpager2.widget.ViewPager2）とTabLayoutMediatorを組み合わせる実装が推奨されます。ただし、基本的な仕組みや考え方は本記事の内容と共通しているため、まずViewPagerの動きを理解したうえで、必要に応じてViewPager2へ移行すると良いでしょう。