Androidでボトムシート（Bottom Sheet）ウィジェットを実装する方法【コード例付き】

このチュートリアルでは、Androidアプリにボトムシート（Bottom Sheet）ウィジェットを実装する方法を、実際のコード例とともにステップごとに解説します。ボトムシートは、画面下部からスライド表示されるUIコンポーネントで、注文内容の確認やオプション選択など、さまざまな場面で活用できます。

Step 1：新しいプロジェクトを作成する

まず、Android Studioを起動し、File → New Project を選択して新しいプロジェクトを作成します。必要な項目をすべて入力してプロジェクトのセットアップを完了させてください。

Step 2：activity_main.xml にコードを追加する

次に、res/layout/activity_main.xml に以下のコードを追加します。ここでは CoordinatorLayout をルートレイアウトとして使用し、メインコンテンツの後にボトムシートを読み込む構成になっています。

<?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"
   xmlns:tools="https://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   tools:context="MainActivity">
   <android.support.design.widget.AppBarLayout
      android:layout_width="match_parent"
      android:layout_height="wrap_content">
      <android.support.v7.widget.Toolbar
         android:id="@+id/toolbar"
         android:layout_width="match_parent"
         android:layout_height="?attr/actionBarSize"
         android:background="?attr/colorPrimary"
         app:popupTheme="@style/Widget.Support.CoordinatorLayout" />
   </android.support.design.widget.AppBarLayout>
   <include layout="@layout/content" />
<!-- Adding bottom sheet after main content -->   <include layout="@layout/bottomsheet" />
</android.support.design.widget.CoordinatorLayout>

Step 3：build.gradle に依存関係を追加する

build.gradle（Module: app） を開き、以下の依存関係を追加します。Design Support Libraryに加え、ビューのバインディングを簡単に行うためのButter Knifeも導入しています。

implementation 'com.android.support:design:28.0.0'
implementation 'com.jakewharton:butterknife:8.8.1'
annotationProcessor 'com.jakewharton:butterknifecompiler:8.8.1'

Step 4：bottomsheet.xml を作成する

ボトムシート用のレイアウトファイル bottomsheet.xml を新規作成し、以下のコードを記述します。ポイントは app:layout_behavior に BottomSheetBehavior を指定することです。これにより、このレイアウトがボトムシートとして動作するようになります。

• behavior_hideable：下にスワイプして非表示にできるかどうか
• behavior_peekHeight：折りたたみ状態で見える高さ

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
   xmlns:android="https://schemas.android.com/apk/res/android"
   xmlns:app="https://schemas.android.com/apk/res-auto"
   android:id="@+id/bottomSheet"
   android:layout_width="match_parent"
   android:layout_height="wrap_content"
   android:orientation="vertical"
   android:padding="4dp"
   app:behavior_hideable="true"
   app:behavior_peekHeight="10dp"
   app:layout_behavior="android.support.design.widget.BottomSheetBehavior">
   <LinearLayout
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:orientation="horizontal"
      android:layout_gravity="center_vertical"
      android:weightSum="3">
      <TextView
         android:layout_width="0dp"
         android:layout_height="wrap_content"
         android:layout_weight="2"
         android:text="Order Details"
         android:textColor="#444"
         android:textSize="18dp"
         android:textStyle="bold" />
      <TextView
         android:layout_width="0dp"
         android:gravity="right"
         android:layout_height="wrap_content"
         android:layout_weight="1"
         android:textStyle="bold"
         android:textSize="15dp"
         android:text="₹435.00"></TextView>
   </LinearLayout>
   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Chicken BBQ" />
   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Chicken Biriyani" />
   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Delivery Address"
      android:textColor="#444"
      android:textStyle="bold" />
   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Flat No 404, India, Chennai" />
   <Button
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:layout_marginTop="30dp"
      android:background="#000"
      android:text="PROCEED PAYMENT"
      android:textColor="#fff" />
</LinearLayout>

この例では、注文詳細・商品名・配送先住所・支払いボタンを含む、フードデリバリーアプリ風のボトムシートを作成しています。

Step 5：content.xml を作成する

メイン画面のコンテンツ用レイアウト content.xml を作成し、以下のコードを追加します。中央に配置されたボタンをタップすると、ボトムシートの開閉を切り替えられる仕組みです。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
   xmlns:android="https://schemas.android.com/apk/res/android"
   xmlns:tools="https://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   android:orientation="vertical"
   tools:context="MainActivity"
   tools:showIn="@layout/activity_main">
   <Button
      android:id="@+id/btnBottomSheet"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Show Bottom Sheet"
      android:layout_centerInParent="true"/>
</RelativeLayout>

Step 6：MainActivity.java にコードを追加する

最後に、src/MainActivity.java に以下のコードを記述します。BottomSheetBehavior.from() でボトムシートのインスタンスを取得し、setBottomSheetCallback() で状態変化を監視しています。

ボトムシートには「展開（STATE_EXPANDED）」「折りたたみ（STATE_COLLAPSED）」「非表示（STATE_HIDDEN）」などの状態があり、状態に応じてボタンのラベルを切り替えることで、直感的な操作性を実現しています。

import android.os.Bundle;
import android.support.annotation.NonNull;
import android.support.design.widget.BottomSheetBehavior;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.Toolbar;
import android.view.View;
import android.widget.Button;
import android.widget.LinearLayout;
import butterknife.BindView;
import butterknife.ButterKnife;
import butterknife.OnClick;
public class MainActivity extends AppCompatActivity {
   @BindView(R.id.btnBottomSheet)
   Button btnBottomSheet;
   @BindView(R.id.bottomSheet)
   LinearLayout layoutBottomSheet;
   BottomSheetBehavior sheetBehavior;
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      ButterKnife.bind(this);
      Toolbar toolbar = findViewById(R.id.toolbar);
      //setSupportActionBar(toolbar);
      sheetBehavior = BottomSheetBehavior.from(layoutBottomSheet);
      sheetBehavior.setBottomSheetCallback(new BottomSheetBehavior.BottomSheetCallback() {
         @Override
         public void onStateChanged(@NonNull View bottomSheet, int newState) {
            switch (newState) {
               case BottomSheetBehavior.STATE_HIDDEN:
               break;
               case BottomSheetBehavior.STATE_EXPANDED: {
                  btnBottomSheet.setText("Close Sheet");
               }
               break;
               case BottomSheetBehavior.STATE_COLLAPSED: {
                  btnBottomSheet.setText("Expand Sheet");
               }
               break;
               case BottomSheetBehavior.STATE_DRAGGING:
               break;
               case BottomSheetBehavior.STATE_SETTLING:
               break;
            }
         }
         @Override
         public void onSlide(@NonNull View bottomSheet, float slideOffset) { }
      });
   }
   @OnClick(R.id.btnBottomSheet)
   public void toggleBottomSheet() {
      if (sheetBehavior.getState() !=
         BottomSheetBehavior.STATE_EXPANDED) {
            sheetBehavior.setState(BottomSheetBehavior.STATE_EXPANDED);
            btnBottomSheet.setText("Close sheet");
         } else {
         sheetBehavior.setState(BottomSheetBehavior.STATE_COLLAPSED);
         btnBottomSheet.setText("Expand sheet");
      }
   }
}

Step 7：AndroidManifest.xml を確認する

androidManifest.xml に以下のコードを追加します。通常の新規プロジェクトであれば、ほぼ自動生成されている内容ですが、ランチャーアクティビティの設定が正しいか確認しておきましょう。

<?xml version="1.0" encoding="utf-8"?>
<manifest
   xmlns:android="https://schemas.android.com/apk/res/android"
   package="app.com.sample">
   <application
      android:allowBackup="true"
      android:icon="@mipmap/ic_launcher"
      android:label="@string/app_name"
      android:roundIcon="@mipmap/ic_launcher_round"
      android:supportsRtl="true"
      android:theme="@style/AppTheme">
      <activity android:name=".MainActivity">
         <intent-filter>
            <action
               android:name="android.intent.action.MAIN" />
            <category
               android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
      </activity>
   </application>
</manifest>

アプリを実行して動作を確認する

それでは、アプリを実行してみましょう。実機のAndroidスマートフォンをPCに接続していることを前提に説明します。Android Studioからアプリを起動するには、プロジェクト内のアクティビティファイルを開き、ツールバーの実行（Run）アイコンをクリックします。接続したモバイルデバイスを選択すると、端末に初期画面が表示されます。

ボタンをタップすると、画面下部からボトムシートがスライド表示され、注文内容や配送先情報、支払いボタンが確認できます。もう一度タップすると、ボトムシートが折りたたまれます。

まとめ

本記事では、CoordinatorLayout と BottomSheetBehavior を組み合わせることで、Androidアプリにボトムシートウィジェットを簡単に実装できることを紹介しました。レイアウトXMLへのbehavior属性の指定と、Javaコードでの状態管理さえ押さえれば、Material Designらしい洗練されたUIを短期間で構築できます。ぜひ自分のプロジェクトにも応用してみてください。