درحال بار کردن نشانگرها

نشانگرهای بارگیری پیشرفت را برای زمان انتظار کوتاه نشان می‌دهند—معمولاً عملیاتی که در کمتر از پنج ثانیه تکمیل می‌شود. دو پیکربندی برای نشانگرهای بار کردن وجود دارد:

  1. پیش‌فرض: شکل‌های دگرگون‌شونده نامحدود.
  2. دربرگیرنده: شکل‌های دگرگون‌شونده در محفظه دایره‌ای.
پیکربندی‌های پیش‌فرض و محصور نشانگرهای بار کردن
شکل ۱. نشانگرهای بار کردن پیش‌فرض و محصور.

نشانگر به‌طور مداوم بین شکل‌های چندضلعی خود تغییر شکل می‌دهد، چه به‌طور نامحدود یا در پاسخ به مقدار پیشرفت.

استفاده از نشانگرهای بار کردن

  • به‌عنوان جایگزینی برای اکثر نشانگرهای پیشرفت دایره‌ای نامشخص توصیه می‌شود.
  • همیشه فرایندی درحال انجام را نشان می‌دهند و هرگز صرفاً تزئینی نیستند.
  • وقتی پیشرفت قابل‌اندازه‌گیری نیست یا وقتی لازم نیست نشان داده شود که فعالیت چقدر طول می‌کشد، از آن‌ها استفاده کنید.
  • می‌تواند برای تعاملات کشیدن برای بازآوری استفاده شود.
  • با حرکت تغییر شکل، توجه را جلب کنید.

مثال‌ها

پیاده‌سازی نشانگر بار کردن

نشانگرهای بار کردن از پویانمایی برای جلب توجه، کاهش تأخیر درک‌شده، و نشان دادن اینکه فعالیتی درحال انجام است استفاده می‌کنند. قطعه کد زیر یک LoadingIndicator نامعین پیش‌فرض را ارائه می‌دهد:

@Composable
fun LoadingIndicatorSample() {
    Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator() }
}

پیاده‌سازی نشانگر بار کردن محصور

از ContainedLoadingIndicator برای رندر کردن شکل‌های دگردیسی در داخل محفظه دایره‌ای استفاده کنید که کنتراست بیشتری نسبت به محتوای اصلی ارائه می‌دهد. قطعه کد زیر نشانگر بار کردن محصور را پیاده‌سازی می‌کند:

@Composable
fun ContainedLoadingIndicatorSample() {
    Column(horizontalAlignment = Alignment.CenterHorizontally) { ContainedLoadingIndicator() }
}

نشانگر بار کردن معین را پیاده‌سازی کنید

Pass a progress lambda returning a Float from 0.0 to 1.0 to morph LoadingIndicator determinately as an operation progresses. قطعه کد زیر پیشرفت نشانگر بار کردن را با 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),
        )
    }
}