مؤشرات التحميل تعرض مستوى التقدّم في وقت انتظار قصير، عادةً للعمليات التي تكتمل في أقل من خمس ثوانٍ. هناك نوعان من مؤشرات التحميل:
- تلقائي: أشكال متحوّلة غير محصورة
- مضمَّنة: أشكال متحوّلة داخل حاوية دائرية
يتغيّر شكل المؤشر باستمرار بين أشكاله المضلّعة، إما إلى أجل غير مسمى أو استجابةً لقيمة تقدّم.
استخدام مؤشرات التحميل
- يُنصح باستخدامه كبديل لمعظم مؤشرات التقدم الدائرية غير المحددة.
- يجب أن تعكس دائمًا عملية جارية وألا تكون مجرد عناصر تزيينية.
- استخدمها عندما لا يكون التقدم قابلاً للقياس، أو عندما لا يكون من الضروري الإشارة إلى المدة التي يستغرقها النشاط.
- يمكن استخدامها لتفاعلات السحب للأسفل لإعادة التحميل.
- اجذب الانتباه من خلال حركة تحويل الأشكال.
أمثلة
تنفيذ مؤشر التحميل
تستخدم مؤشرات التحميل الصور المتحركة لجذب الانتباه وتقليل وقت الاستجابة الملحوظ
والإشارة إلى أنّ هناك نشاطًا قيد التقدّم. يعرض المقتطف التالي
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), ) } }