Screen:swipe()

Thực hiện vuốt bằng một ngón tay trên màn hình. Đường vuốt được xác định bởi một danh sách các giá trị SwipePoint mà ngón tay di chuyển lần lượt qua.

Khai báo

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

Trả về

void

Tham số

Tham số	Kiểu	Mô tả
swipePoints	List<SwipePoint>	Danh sách các điểm mà ngón tay di chuyển qua. Tối thiểu 2 điểm.
params	SwipeParams	Tùy chọn. Kiểm soát hành vi vuốt như chế độ liên tục và độ trễ.

Hành vi SwipePoint

Mỗi điểm trong danh sách là một SwipePoint(x, y, holdDuration, swipeDuration). Ý nghĩa phụ thuộc vào vị trí của điểm:

Điểm đầu tiên (vị trí bắt đầu):

• swipeDuration — Độ trễ ban đầu tính bằng mili giây trước khi ngón tay chạm xuống
• holdDuration — Khoảng thời gian giữ tại vị trí bắt đầu trước khi di chuyển đến điểm tiếp theo

Các điểm tiếp theo (đích di chuyển):

• swipeDuration — Khoảng thời gian tính bằng mili giây để di chuyển từ điểm trước đó đến điểm này
• holdDuration — Khoảng thời gian giữ tại điểm này sau khi đến (tạm dừng trước lần di chuyển tiếp theo)

Điểm cuối cùng:

• holdDuration — Giữ ở vị trí cuối cùng trước khi ngón tay nhấc lên

Ví dụ

Vuốt đơn giản

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

Ngón tay chạm xuống tại (500, 1200) ngay lập tức, giữ 50ms, sau đó vuốt lên đến (500, 400) trong 1 giây.

Vuốt với độ trễ ban đầu

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

Chờ 2 giây, sau đó chạm xuống tại (300, 800), giữ 50ms và vuốt sang phải đến (700, 800) trong 1,5 giây.

Vuốt nhiều điểm với khoảng giữ

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

Dòng thời gian:

Thời gian	Hành động
0ms	Chạm xuống tại (100, 500)
50ms	Bắt đầu di chuyển đến (400, 500)
1050ms	Đến (400, 500), giữ trong 3000ms
4050ms	Bắt đầu di chuyển đến (400, 900)
5050ms	Đến (400, 900), giữ 50ms
5100ms	Ngón tay nhấc lên

Ngón tay vuốt sang phải, tạm dừng 3 giây, sau đó vuốt xuống.

Vuốt liên tục với SwipeParams

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

Khi setContinue(true) được đặt, ngón tay không nhấc lên giữa các điểm vuốt. Điều này cho phép các cử chỉ liên tục mượt mà trên Android 8.1+ với Dịch vụ Hỗ trợ tiếp cận. Trên Dịch vụ Native, vuốt luôn luôn liên tục bất kể cài đặt này.

Kéo chậm

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

Chạm xuống tại (540, 1800), giữ 100ms, sau đó từ từ kéo lên đến (540, 600) trong 5 giây.