텍스트 입력란의 스타일러스 입력

Jetpack androidx.compose.material3 라이브러리를 사용하면 사용자가 스타일러스를 사용하여 모든 앱의 TextField 구성요소에 쓸 수 있습니다.

기본적으로 스타일러스 입력을 사용 설정하려면 앱의 build.gradle 파일에 라이브러리 종속 항목을 추가합니다.

dependencies {
    implementation("androidx.compose.foundation:foundation:1.7.0")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

dependencies {
    implementation 'androidx.compose.foundation:foundation:1.7.0'
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

TextField

스타일러스 필기 입력은 Android 14 이상과 androidx.compose.foundation:foundation:1.7.0 종속 항목의 모든 TextField 구성요소에 기본적으로 사용 설정됩니다. 구성요소의 필기 입력 경계 내에서 스타일러스 모션 이벤트가 감지되면 TextField의 필기 입력 모드가 시작됩니다.

필기 입력 경계에는 입력란 주변의 세로 패딩 40dp 및 가로 패딩 10dp가 포함됩니다.

입력 방식 편집기가 KeyboardType.Password로 요청되면 TextField 필드에 스타일러스 필기 입력이 지원되지 않습니다.

입력 위임

앱은 자리표시자 UI 요소를 텍스트 입력란처럼 보이지만 실제로는 텍스트 입력 기능이 없는 정적 UI 요소인 자리표시자 UI 요소를 표시할 수 있습니다. 검색 필드가 일반적인 예입니다. 정적 UI 요소를 탭하면 입력에 중점을 둔 기능 텍스트 입력란이 포함된 새로운 UI로 전환됩니다.

스타일러스 입력 위임

필기 입력 위임 API를 사용하여 자리표시자 입력란에 스타일러스 필기 입력 입력을 지원합니다 (handwritingDetector 및 handwritingHandler 참고). 자리표시자 UI 요소는 기능 입력 필드에 필기 입력을 위임하도록 구성됩니다. 구현 예는 HandwritingDetectorSample.kt를 참고하세요.

스타일러스 필기 입력 모드는 기능 입력란이 포커스를 얻고 InputConnection를 만들 때 시작됩니다.

테스트

스타일러스 필기 입력은 호환되는 스타일러스 입력 기기와 Android 14 스타일러스 필기 입력 API를 지원하는 입력 방식 편집기 (IME)가 있는 Android 14 이상 기기에서 지원됩니다.

스타일러스 입력 기기가 없다면 다음 Android 디버그 브리지 (adb) 명령어를 사용하여 루트 액세스 권한이 있는 기기(에뮬레이터 포함)에서 스타일러스 입력을 시뮬레이션합니다.

// Android 14
adb shell setprop persist.debug.input.simulate_stylus_with_touch true && adb shell stop && adb shell start

// Android 15 and higher
// Property takes effect after screen reconfiguration such as orientation change.
adb shell setprop debug.input.simulate_stylus_with_touch true

스타일러스를 지원하지 않는 기기를 사용하는 경우 테스트용으로 Gboard 베타를 사용합니다.

추가 리소스

• Material Design — 텍스트 필드
• 사용자 입력 처리