Screen:swipe()

Melakukan geser satu jari pada layar. Jalur geser didefinisikan oleh daftar nilai SwipePoint yang dilalui jari secara berurutan.

Tanda Tangan

Screen:swipe(swipePoints: List<SwipePoint>, params?: SwipeParams): void

Mengembalikan

void

Parameter

Parameter	Tipe	Deskripsi
swipePoints	List<SwipePoint>	Daftar titik yang dilalui jari. Minimal 2 titik.
params	SwipeParams	Opsional. Mengatur perilaku geser seperti mode berkelanjutan dan delay.

Perilaku SwipePoint

Setiap titik dalam daftar adalah SwipePoint(x, y, holdDuration, swipeDuration). Maknanya tergantung pada posisi titik:

Titik pertama (posisi awal):

• swipeDuration — Delay awal dalam milidetik sebelum jari menyentuh
• holdDuration — Berapa lama menahan di posisi awal sebelum bergerak ke titik berikutnya

Titik berikutnya (target pergerakan):

• swipeDuration — Durasi dalam milidetik untuk bergerak dari titik sebelumnya ke titik ini
• holdDuration — Berapa lama menahan di titik ini setelah tiba (jeda sebelum gerakan berikutnya)

Titik terakhir:

• holdDuration — Penahanan akhir di posisi terakhir sebelum jari diangkat

Contoh

Geser sederhana

Screen:swipe({
  SwipePoint(500, 1200, 50, 0),
  SwipePoint(500, 400, 50, 1000),
})

Jari menyentuh di (500, 1200) seketika, menahan 50ms, lalu geser ke atas ke (500, 400) selama 1 detik.

Geser dengan delay awal

Screen:swipe({
  SwipePoint(300, 800, 50, 2000),
  SwipePoint(700, 800, 50, 1500),
})

Menunggu 2 detik, lalu menyentuh di (300, 800), menahan 50ms, dan geser ke kanan ke (700, 800) selama 1,5 detik.

Geser multi-titik dengan tahanan

Screen:swipe({
  SwipePoint(100, 500, 50, 0),
  SwipePoint(400, 500, 3000, 1000),
  SwipePoint(400, 900, 50, 1000),
})

Linimasa:

Waktu	Aksi
0ms	Tekan di (100, 500)
50ms	Mulai bergerak ke (400, 500)
1050ms	Tiba di (400, 500), tahan selama 3000ms
4050ms	Mulai bergerak ke (400, 900)
5050ms	Tiba di (400, 900), tahan 50ms
5100ms	Jari diangkat

Jari geser ke kanan, jeda selama 3 detik, lalu geser ke bawah.

Geser berkelanjutan dengan SwipeParams

Screen:swipe({
  SwipePoint(200, 600, 50, 0),
  SwipePoint(500, 300, 50, 2000),
}, SwipeParams():setContinue(true))

Ketika setContinue(true) diatur, jari tidak diangkat di antara titik geser. Ini memungkinkan gestur berkelanjutan yang mulus pada Android 8.1+ dengan Layanan Aksesibilitas. Pada Layanan Native, geser selalu berkelanjutan terlepas dari pengaturan ini.

Seret lambat

Screen:swipe({
  SwipePoint(540, 1800, 100, 0),
  SwipePoint(540, 600, 50, 5000),
})

Menyentuh di (540, 1800), menahan 100ms, lalu perlahan menyeret ke atas ke (540, 600) selama 5 detik.