Library Jetpack
androidx.compose.material3
memungkinkan pengguna menulis ke komponen TextField
apa pun di
aplikasi apa pun menggunakan stilus.
Untuk mengaktifkan input stilus secara default, tambahkan dependensi library ke file
build.gradle
aplikasi Anda:
Kotlin
dependencies { implementation("androidx.compose.foundation:foundation:LATEST_COMPOSE_VERSION") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "LATEST_EXTENSION_VERSION" } kotlinOptions { jvmTarget = "LATEST_JVM_VERSION" } }
Groovy
dependencies { implementation 'androidx.compose.foundation:foundation:LATEST_COMPOSE_VERSION' } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = 'LATEST_EXTENSION_VERSION' } kotlinOptions { jvmTarget = 'LATEST_JVM_VERSION' } }
TextField
Tulis tangan stilus diaktifkan untuk semua komponen TextField
secara default di
Android 14 dan yang lebih baru, serta
dependensi
androidx.compose.foundation:foundation:1.7.0
. Mode tulisan tangan dimulai untuk TextField
saat peristiwa gerakan stilus
terdeteksi dalam batas tulisan tangan komponen.
Batas tulisan tangan mencakup padding vertikal 40 dp dan padding horizontal 10 dp di sekitar kolom input.
![Kolom input dengan persegi panjang di sekitarnya yang menunjukkan batas untuk mendeteksi peristiwa gerakan stilus.](https://developer.android.com/static/images/develop/ui/compose/touch-input/stylus-input/shared/edittext_handwriting_bounds.png?authuser=8&hl=id)
TextField
.
Tulis tangan stilus tidak didukung untuk kolom TextField
jika editor
metode input diminta dengan KeyboardType.Password
.
Delegasi input
Aplikasi dapat menampilkan elemen UI placeholder yang tampak seperti kolom input teks, tetapi sebenarnya hanyalah elemen UI statis tanpa kemampuan input teks. Kolom penelusuran adalah contoh umumnya. Mengetuk elemen UI statis akan memicu transisi ke UI baru yang berisi kolom input teks fungsional yang difokuskan untuk input.
Delegasi input stilus
Gunakan API delegasi tulis tangan guna mendukung input tulisan tangan stilus untuk
kolom input placeholder (lihat handwritingDetector
dan
handwritingHandler
). Elemen UI placeholder
dikonfigurasi untuk mendelegasikan tulisan tangan ke kolom input fungsional. Untuk contoh
implementasi, lihat
HandwritingDetectorSample.kt
.
Mode tulis tangan stilus dimulai saat kolom input fungsional mendapatkan fokus dan
membuat
InputConnection
.
Pengujian
Tulis tangan stilus didukung di perangkat Android 14 dan yang lebih baru dengan perangkat input stilus yang kompatibel dan editor metode input (IME) yang mendukung API tulisan tangan stilus Android 14.
Jika Anda tidak memiliki perangkat input stilus, simulasikan input stilus pada perangkat apa pun yang memiliki akses root (termasuk emulator) menggunakan perintah Android Debug Bridge (adb) berikut:
// 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
Gunakan Gboard beta untuk pengujian jika Anda menggunakan perangkat yang tidak mendukung stilus.
Referensi tambahan
- Desain Material — Kolom teks
- Menangani input pengguna