안드로이드 ListView에서 프로그래밍 방식으로 특정 위치까지 스크롤하는 방법

이 예제는 안드로이드에서 ListView를 프로그래밍 방식으로 특정 위치까지 스크롤하는 방법을 단계별로 소개합니다. 핵심은 smoothScrollToPosition() 메서드로, 이를 호출하면 지정한 인덱스의 항목으로 부드러운 애니메이션 효과와 함께 화면이 이동합니다.

1단계 — 새 프로젝트 생성

Android Studio에서 File → New Project를 선택하고, 프로젝트 생성에 필요한 정보를 모두 입력해 새 프로젝트를 만듭니다.

2단계 — 레이아웃 작성 (res/layout/activity_main.xml)

화면 상단에는 스크롤을 실행할 버튼을 배치하고, 그 아래에 ListView가 오도록 RelativeLayout으로 구성합니다.

<?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:id="@+id/rl"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="10dp"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/btn"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="ListView Scroll To Position 22" />

    <ListView
        android:id="@+id/listView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_below="@id/btn" />
</RelativeLayout>

3단계 — 메인 액티비티 구현 (src/MainActivity.java)

축구 선수 이름 배열을 만들어 리스트로 변환한 뒤 ArrayAdapter에 연결합니다. 그리고 버튼 클릭 리스너 안에서 listView.smoothScrollToPosition(22)를 호출해 22번 인덱스 항목으로 스크롤되도록 구현합니다.

import android.os.Bundle;
import android.app.Activity;
import android.view.View;
import android.widget.ArrayAdapter;
import android.widget.Button;
import android.widget.ListView;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

public class MainActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        final ListView listView = findViewById(R.id.listView);
        Button btn = findViewById(R.id.btn);

        String[] playerNames = new String[] {
                "Cristiano Ronaldo",
                "Lionel Messi",
                "Neymar Jnr",
                "Eden Hazard",
                "Isco",
                "Gareth Bale",
                "Sergio Buesquets",
                "Zlatan Ibrahimovic",
                "GG Buffon",
                "Iker Casillas",
                "Rafael Varane",
                "Zinedine Zidane",
                "Menphis Depay",
                "Gerard Pique",
                "Victor Valdes",
                "David De Gea",
                "Mo Salah",
                "Ronaldinio",
                "Marco Rues",
                "Asencio",
                "Luis Figo",
                "Sergio Ramos",
                "Maldini",
                "Marcelo",
                "Karim Benzema",
                "Sir Alex Firguson"
        };

        final List<String> footballPlayers = new ArrayList<>(Arrays.asList(playerNames));
        final ArrayAdapter<String> arrayAdapter =
                new ArrayAdapter<>(this, android.R.layout.simple_list_item_1, footballPlayers);
        listView.setAdapter(arrayAdapter);

        btn.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                // 22번 위치로 부드럽게 스크롤
                listView.smoothScrollToPosition(22);
            }
        });
    }
}

참고: 즉시 이동 vs 부드러운 스크롤

• setSelection(position): 애니메이션 없이 해당 위치로 즉시 이동합니다.
• smoothScrollToPosition(position): 스크롤 애니메이션과 함께 자연스럽게 이동합니다.

4단계 — 매니페스트 설정 (androidManifest.xml)

이 예제는 특별한 권한이 필요하지 않으며, 기본 매니페스트에 MainActivity만 등록되어 있으면 됩니다.

<?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 Studio 툴바의 Run 아이콘을 클릭합니다. 실행 기기 목록에서 연결된 모바일 기기를 선택하면 앱이 설치된 후 실행됩니다.

앱이 시작되면 축구 선수 목록이 화면에 표시됩니다. 이때 상단의 버튼을 누르면 목록이 22번째 항목(Maldini)으로 부드럽게 스크롤되는 것을 확인할 수 있습니다.