אינדיקטורים לטעינה מציגים את ההתקדמות של פעולות שזמן ההמתנה להן קצר, בדרך כלל פחות מ-5 שניות. יש שתי הגדרות של אינדיקטורים לטעינה:
- ברירת מחדל: צורות משתנות ללא גבולות.
- בתוך מסגרת: צורות שמשתנות בתוך מסגרת עגולה.
האינדיקטור משנה את צורת המצולע שלו כל הזמן, ללא הגבלת זמן או בתגובה לערך ההתקדמות.
שימוש באינדיקטורים לטעינה
- מומלץ להשתמש בו כתחליף לרוב האינדיקטורים המעגליים הלא מוגדרים של התקדמות.
- הם תמיד משקפים תהליך מתמשך, ולעולם לא משמשים רק לקישוט.
- השתמשו בהם כשאי אפשר למדוד את ההתקדמות, או כשלא צריך לציין כמה זמן הפעילות נמשכת.
- אפשר להשתמש בו לאינטראקציות של משיכה למטה לרענון.
- מושכים את תשומת הלב באמצעות תנועה שמשנה צורה.
דוגמאות
הטמעת אינדיקטור לטעינה
אינדיקטורים לטעינה משתמשים באנימציה כדי למשוך תשומת לב, להפחית את זמן האחזור הנתפס ולציין שפעילות מתבצעת. קטע הקוד הבא מציג רכיב LoadingIndicator לא מוגדר כברירת מחדל:
@Composable fun LoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator() } }
הטמעת אינדיקטור טעינה מוגבל
אפשר להשתמש ב-ContainedLoadingIndicator כדי להציג צורות שמשתנות בתוך מאגר עגול, שיוצר ניגודיות נוספת מעל תוכן הגוף. קטע הקוד הבא מטמיע אינדיקטור טעינה מוכל:
@Composable fun ContainedLoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { ContainedLoadingIndicator() } }
הטמעת אינדיקטור טעינה מוגדר
מעבירים פונקציית lambda מסוג progress שמחזירה Float מ-0.0 ל-1.0 כדי לשנות את LoadingIndicator באופן דטרמיניסטי ככל שהפעולה מתקדמת. קטע הקוד הבא מפעיל את ההתקדמות של אינדיקטור הטעינה באמצעות Slider ו-rememberSliderState:
@Composable fun DeterminateLoadingIndicatorSample() { val sliderState = rememberSliderState() val animatedProgress by animateFloatAsState( targetValue = sliderState.value, animationSpec = spring( dampingRatio = Spring.DampingRatioNoBouncy, stiffness = Spring.StiffnessVeryLow, visibilityThreshold = 1 / 1000f, ), ) Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator(progress = { animatedProgress }) Spacer(Modifier.requiredHeight(30.dp)) Text("Set loading progress:") Slider( state = sliderState, onValueChange = { sliderState.value = it }, modifier = Modifier.width(300.dp), ) } }