लोड होने की जानकारी देने वाले इंडिकेटर

लोड होने की जानकारी देने वाले इंडिकेटर, कम समय के लिए इंतज़ार करने की प्रोग्रेस दिखाते हैं. आम तौर पर, ये ऐसे ऑपरेशन होते हैं जो पांच सेकंड से कम समय में पूरे हो जाते हैं. लोडिंग इंडिकेटर के दो कॉन्फ़िगरेशन होते हैं:

  1. डिफ़ॉल्ट: इसमें आकार बदलने वाली ऐसी आकृतियां होती हैं जो किसी कंटेनर में नहीं होतीं.
  2. कंटेन किया गया: इसमें गोल कंटेनर के अंदर, आकार बदलते रहते हैं.
लोडिंग इंडिकेटर के डिफ़ॉल्ट और कंटेन किए गए कॉन्फ़िगरेशन
पहली इमेज. डिफ़ॉल्ट और कंटेन किए गए लोडिंग इंडिकेटर.

इंडिकेटर, अपने पॉलीगॉन शेप के बीच लगातार बदलता रहता है. यह बदलाव, अनिश्चित समय तक या प्रोग्रेस वैल्यू के हिसाब से होता है.

लोडिंग इंडिकेटर का इस्तेमाल करना

  • हमारा सुझाव है कि आप इसे, प्रोग्रेस दिखाने वाले ज़्यादातर इंडिकेटर की जगह इस्तेमाल करें.
  • इनसे हमेशा किसी प्रोसेस के जारी होने का पता चलता है. ये कभी भी सिर्फ़ सजावट के लिए नहीं होते.
  • इनका इस्तेमाल तब करें, जब प्रोग्रेस को मेज़र न किया जा सकता हो या यह बताना ज़रूरी न हो कि किसी गतिविधि में कितना समय लगेगा.
  • इसका इस्तेमाल, नीचे स्वाइप करके रीफ़्रेश करने वाले इंटरैक्शन के लिए किया जा सकता है.
  • शेप-मॉर्फ़िंग मोशन का इस्तेमाल करके, लोगों का ध्यान खींचें.

उदाहरण

लोड होने की जानकारी देने वाला इंडिकेटर लागू करना

लोड होने की जानकारी देने वाले इंडिकेटर, लोगों का ध्यान खींचने, इंतज़ार के समय को कम करने, और यह बताने के लिए ऐनिमेशन का इस्तेमाल करते हैं कि कोई गतिविधि जारी है. नीचे दिया गया स्निपेट, डिफ़ॉल्ट इंडिटरमिनेट LoadingIndicator रेंडर करता है:

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

लोड होने की जानकारी देने वाला इंडिकेटर लागू करना

ContainedLoadingIndicator का इस्तेमाल करके, गोल कंटेनर में बदलते हुए आकार रेंडर करें. इससे मुख्य कॉन्टेंट को ज़्यादा कंट्रास्ट मिलता है. यहां दिए गए स्निपेट में, लोडिंग इंडिकेटर को लागू करने का तरीका बताया गया है:

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

लोड होने की स्थिति बताने वाला इंडिकेटर लागू करना

0.0 से 1.0 तक Float दिखाने वाला progress लैम्ब्डा पास करें, ताकि ऑपरेशन के आगे बढ़ने पर 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),
        )
    }
}