גישה לסטטוס ההתקדמות באופן ידני

הפונקציה הניתנת להרכבה PredictiveBackHandler ב-Jetpack Compose מאפשרת לכם ליירט את תנועת החזרה ולגשת להתקדמות שלה. אתם יכולים להגיב לתנועת החלקה של המשתמש בזמן אמת, וליצור אנימציות או התנהגויות מותאמות אישית על סמך המרחק שהמשתמש החליק.

כדי להשתמש ב-PredictiveBackHandler, צריך לוודא שאתם משתמשים בגרסה androidx.activity:activity:1.6.0 ואילך.

‫PredictiveBackHandler מספקת Flow<BackEventCompat> שפולטת אירועים שמייצגים את ההתקדמות של תנועת החזרה. כל אירוע מכיל מידע כמו:

• ‫progress: ערך מספרי ממשי (float) בין 0 ל-1 שמציין את ההתקדמות של תנועת החזרה (0 = התנועה התחילה, 1 = התנועה הסתיימה).
• ‫touchX ו-touchY: הקואורדינטות X ו-Y של אירוע המגע.

בקטע הקוד הבא אפשר לראות שימוש בסיסי ב-PredictiveBackHandler:

PredictiveBackHandler(true) { progress: Flow<BackEventCompat> ->
    // code for gesture back started
    try {
        progress.collect { backEvent ->
            // code for progress
            boxScale = 1F - (1F * backEvent.progress)
        }
        // code for completion
        boxScale = 0F
    } catch (e: CancellationException) {
        // code for cancellation
        boxScale = 1F
        throw e
    }
}
PredictiveBackSnippets.kt

דוגמה: שילוב עם חלונית הזזה לניווט

בדוגמה הזו אפשר לראות איך מטמיעים אנימציה מותאמת אישית באפליקציה באמצעות PredictiveBackHandler כדי ליצור אינטראקציה חלקה עם מגירת ניווט בתגובה לתנועות החלקה אחורה ב-JetLagged:

בדוגמה הזו, נעשה שימוש ב-PredictiveBackHandler כדי:

• מעקב אחרי ההתקדמות של התנועה לחזרה אחורה.
• מעדכנים את translationX של מגירת האפליקציה על סמך התקדמות המחווה.
• משתמשים ב-velocityTracker כדי לפתוח או לסגור את המגירה בצורה חלקה על סמך מהירות התנועה כשמבצעים את התנועה או מבטלים אותה.