AndroidのListViewでスクロールアップ・スクロールダウンを検出する方法

この記事では、Androidアプリ開発においてListViewのスクロール方向（上方向・下方向）を検出する方法を解説します。ListViewにOnScrollListenerを実装し、先頭に表示されているアイテムの位置変化を比較することで、ユーザーがどちらの方向にスクロールしたかを判定できます。

実装の仕組み

スクロール方向の検出には、AbsListView.OnScrollListenerのonScroll()コールバックを利用します。このメソッドは「先頭に表示されているアイテムの位置（firstVisibleItem）」を受け取るため、前回の値と比較することで方向を判別できます。

• 下方向へのスクロール： 前回のfirstVisibleItemより今回の値が大きい場合
• 上方向へのスクロール： 前回のfirstVisibleItemより今回の値が小さい場合

実装手順

ステップ1：プロジェクトの作成

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

ステップ2：レイアウトファイルの編集

res/layout/activity_main.xml に以下のコードを追加します。画面中央にListViewを配置するシンプルな構成です。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout 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"
    android:gravity="center"
    android:padding="8dp"
    tools:context=".MainActivity">

<ListView
    android:id="@+id/listView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

</LinearLayout>

ステップ3：MainActivity.javaの編集

src/MainActivity.java に以下のコードを記述します。ポイントはsetOnScrollListener()でリスナーを登録し、onScroll()内でlastFirstVisibleItemとの比較を行っている部分です。

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.AbsListView;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {

    ListView listView;
    String[] numbers = {"1","2","3","4", "5","6","7","8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25"};

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        ArrayAdapter adapter = new ArrayAdapter<>(this,
                R.layout.support_simple_spinner_dropdown_item, numbers);
        listView = findViewById(R.id.listView);
        listView.setAdapter(adapter);

        listView.setOnScrollListener(new AbsListView.OnScrollListener() {
            private int lastFirstVisibleItem;

            @Override
            public void onScrollStateChanged(AbsListView view, int scrollState) {
            }

            @Override
            public void onScroll(AbsListView view, int firstVisibleItem,
                                 int visibleItemCount, int totalItemCount) {
                if (lastFirstVisibleItem < firstVisibleItem) {
                    Toast.makeText(getApplicationContext(),
                            "ListViewを下にスクロール中",
                            Toast.LENGTH_SHORT).show();
                }
                if (lastFirstVisibleItem > firstVisibleItem) {
                    Toast.makeText(getApplicationContext(),
                            "ListViewを上にスクロール中",
                            Toast.LENGTH_SHORT).show();
                }
                lastFirstVisibleItem = firstVisibleItem;
            }
        });
    }
}

ステップ4：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」アイコンをクリックし、接続済みのデバイスを選択してアプリを起動してください。

アプリが起動したら、ListViewを上下にスクロールしてみてください。下にスクロールすると「ListViewを下にスクロール中」、上にスクロールすると「ListViewを上にスクロール中」というトーストメッセージが表示され、スクロール方向が正しく検出できていることが確認できます。

まとめ

ListViewのスクロール方向検出は、OnScrollListenerのonScroll()で先頭表示アイテムの位置を追跡するだけで簡単に実装できます。この手法は、スクロールに応じてツールバーを隠す・表示するといったUI制御や、無限スクロール（ページング）の実装など、さまざまな場面で応用できる便利なテクニックです。