안드로이드 WebView에서 프로그래밍 방식으로 스크롤 방지하기

이 튜토리얼에서는 안드로이드 앱에서 WebView의 스크롤을 프로그래밍 방식으로 차단하는 방법을 단계별로 알아봅니다. 핵심 원리는 setOnTouchListener()를 사용해 터치 이동(Move) 이벤트를 가로채는 것으로, 이렇게 하면 사용자가 화면을 드래그해도 WebView가 스크롤되지 않습니다.

1단계 — 새 프로젝트 생성

Android Studio에서 File → New Project 메뉴로 이동한 후, 새 프로젝트 생성에 필요한 정보를 모두 입력하여 프로젝트를 만듭니다.

2단계 — activity_main.xml 레이아웃 구성

res/layout/activity_main.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"
    tools:context=".MainActivity">
    <ScrollView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:scrollbars="vertical">
    </ScrollView>
    <WebView
        android:id="@+id/webView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />
</RelativeLayout>

3단계 — MainActivity.java 코드 작성

src/MainActivity.java에 다음 코드를 추가합니다.

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.MotionEvent;
import android.view.View;
import android.webkit.WebSettings;
import android.webkit.WebView;
import android.webkit.WebViewClient;
public class MainActivity extends AppCompatActivity {
    private WebView webView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        webView = findViewById(R.id.webView);
        webView.setWebViewClient(new WebViewClient());
        webView.loadUrl("https://www.youtube.com");
        WebSettings webSettings = webView.getSettings();
        webSettings.setJavaScriptEnabled(true);
        webView.setOnTouchListener(new View.OnTouchListener(){
            @Override
            public boolean onTouch(View v, MotionEvent event){
                return (event.getAction() == MotionEvent.ACTION_MOVE);
            }
        });
    }
    @Override
    public void onBackPressed() {
        if (webView.canGoBack()) {
            webView.goBack();
        } else {
            super.onBackPressed();
        }
    }
}

스크롤 차단의 핵심 원리

위 코드에서 스크롤을 막는 부분은 바로 setOnTouchListener()입니다. MotionEvent.ACTION_MOVE(손가락을 누른 채 움직이는 드래그 동작)가 감지되면 true를 반환하여 해당 터치 이벤트를 소비(consume)합니다. 이벤트가 소비되면 WebView까지 전달되지 않기 때문에 드래그 스크롤이 발생하지 않습니다. 반면 단순 탭(Tap) 같은 다른 이벤트는 정상적으로 처리되므로 링크 클릭 등의 기능은 그대로 유지됩니다.

또한 onBackPressed()를 오버라이드하여, 뒤로 가기 버튼을 누르면 앱이 종료되지 않고 WebView가 이전 페이지로 돌아가도록 처리했습니다.

참고: 위 예제는 구버전 support 라이브러리(android.support.v7)를 기준으로 작성되었습니다. 최신 Android Studio 프로젝트에서는 androidx.appcompat.app.AppCompatActivity를 import하면 동일하게 동작합니다.

4단계 — AndroidManifest.xml 설정

androidManifest.xml에 아래 코드를 추가합니다. 외부 웹페이지를 로드하므로 인터넷 권한(INTERNET) 선언이 반드시 필요합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample">
    <uses-permission android:name="android.permission.INTERNET" />
    <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(실행) 아이콘을 클릭합니다. 옵션 목록에서 본인의 모바일 기기를 선택하면, 앱이 설치·실행되며 아래와 같은 기본 화면이 표시됩니다.

안드로이드 WebView에서 프로그래밍 방식으로 스크롤 방지하기

앱이 실행되면 YouTube 페이지는 정상적으로 열리고 터치·탭 조작은 가능하지만, 손가락으로 드래그해도 화면이 스크롤되지 않는 것을 확인할 수 있습니다.