Android 14 (level API 34) dan yang lebih baru memungkinkan pengguna menulis ke kolom input
teks apa pun di aplikasi apa pun menggunakan stilus. Kolom entri teks Android, termasuk
komponen EditText
dan
widget teks WebView
, mendukung
input stilus secara default.
Namun, jika aplikasi Anda memerlukan kolom input teks kustom (lihat Editor teks kustom) atau memiliki tata letak yang kompleks dengan kolom entri teks yang menempatkan platform gambar, Anda perlu menyesuaikan aplikasi.
EditText
Tulisan tangan stilus diaktifkan untuk semua kolom EditText
secara default di Android 14
dan yang lebih baru. Mode tulisan tangan dimulai untuk EditText
saat peristiwa gerakan stilus
terdeteksi dalam batas tulisan tangan tampilan.
Batas tulisan tangan mencakup padding vertikal 40 dp dan padding horizontal 10 dp di sekitar tampilan. Sesuaikan batas tulisan tangan dengan
setHandwritingBoundsOffsets()
.
Nonaktifkan tulis tangan dengan
setAutoHandwritingEnabled(false)
.
![Kolom input dengan persegi panjang di sekitarnya yang menunjukkan batas untuk mendeteksi peristiwa gerakan stilus.](https://developer.android.google.cn/static/images/develop/ui/compose/touch-input/stylus-input/shared/edittext_handwriting_bounds.png?authuser=19&hl=id)
EditText
.
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
setHandwritingDelegatorCallback()
dan
setIsHandwritingDelegate()
).
Elemen UI placeholder dikonfigurasi untuk mendelegasikan tulisan tangan ke kolom
input fungsional, misalnya:
Kotlin
if (Build.VERSION.SDK_INT >= 34) { placeholderInputField.setHandwritingDelegatorCallback { showAndFocusDelegateInputField() } delegateInputField.setIsHandwritingDelegate(true) }
Java
if (Build.VERSION.SDK_INT >= 34) { placeholderInputField.setHandwritingDelegatorCallback(this::showAndFocusInputFieldDelegate); delegateInputField.setIsHandwritingDelegate(true); }
Gerakan stilus di atas tampilan kolom input teks placeholder akan memanggil callback.
Callback memicu transisi UI untuk menampilkan dan memfokuskan kolom input
fungsional. Implementasi callback biasanya sama dengan implementasi
untuk pemroses klik pada elemen placeholder. Saat kolom input fungsional
membuat
InputConnection
,
mode tulis tangan stilus akan dimulai.
Desain Material
Library
com.google.android.material.search
menyediakan
class
SearchBar
dan
SearchView
untuk memfasilitasi implementasi pola UI placeholder.
Placeholder dan tampilan penelusuran fungsional ditautkan dengan
setUpWithSearchBar()
.
Delegasi tulisan tangan dikonfigurasi di library Material tanpa pengembangan tambahan di aplikasi Anda.
Tumpang tindih dengan permukaan gambar
Jika aplikasi Anda memiliki platform gambar dengan kolom teks yang menempatkan permukaan tersebut, Anda
mungkin perlu menonaktifkan tulisan tangan stilus agar pengguna dapat menggambar. Lihat
setAutoHandwritingEnabled()
.
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
- Editor teks kustom