প্রোগ্রেস ইন্ডিকেটর

প্রোগ্রেস ইন্ডিকেটর কোনও অপারেশনের স্ট্যাটাস ভিজ্যুয়ালি দেখায়। প্রসেসটি সম্পূর্ণ হতে কত বাকি আছে, যেমন ডেটা লোড বা প্রসেস করা, তা ব্যবহারকারীর নজরে আনার জন্য এগুলি মোশন ব্যবহার করে। এছাড়াও, এটি বোঝাতে পারে যে প্রসেসিং চলছে, তবে এটি সম্পূর্ণ হতে কত সময় লাগবে তা উল্লেখ করে না।

এই তিনটি ব্যবহারের ক্ষেত্র বিবেচনা করুন যেখানে আপনি একটি প্রগ্রেস ইন্ডিকেটর ব্যবহার করতে পারেন:

  • কন্টেন্ট লোড করা: নেটওয়ার্ক থেকে কন্টেন্ট ফেচ করার সময়, যেমন ব্যবহারকারীর প্রোফাইলের জন্য ছবি বা ডেটা লোড করা।
  • ফাইল আপলোড: আপলোড হতে কত সময় লাগতে পারে সেই বিষয়ে ব্যবহারকারীকে মতামত দিন।
  • প্রসেস করতে অনেক সময় লাগা: কোনও অ্যাপ অনেক বেশি পরিমাণ ডেটা প্রসেস করার সময়, মোটের মধ্যে কতটা সম্পূর্ণ হয়েছে তা ব্যবহারকারীকে জানান।

মেটেরিয়াল ডিজাইনে, দুই ধরনের প্রোগ্রেস ইন্ডিকেটর আছে:

  • নির্ধারিত: ঠিক কতটা অগ্রগতি হয়েছে তা দেখায়।
  • অনির্দিষ্ট: প্রোগ্রেস নির্বিশেষে ক্রমাগত অ্যানিমেট করে।

একইভাবে, প্রগ্রেস ইন্ডিকেটর নিম্নলিখিত দুটি ফর্মের মধ্যে একটি নিতে পারে:

  • লিনিয়ার: একটি অনুভূমিক বার যা বাঁদিক থেকে ডানদিকে পূরণ হয়।
  • বৃত্তাকার: একটি বৃত্ত যার স্ট্রোকের দৈর্ঘ্য বৃত্তের সম্পূর্ণ পরিধিকে ঘিরে না ফেলা পর্যন্ত বৃদ্ধি পায়।
সার্কুলার প্রগ্রেস ইন্ডিকেটরের পাশাপাশি লিনিয়ার প্রগ্রেস ইন্ডিকেটর।
ছবি ১. দুই ধরনের প্রগ্রেস ইন্ডিকেটর।

API সারফেস

মেটেরিয়াল ডিজাইনের সাথে সামঞ্জস্যপূর্ণ প্রগ্রেস ইন্ডিকেটর তৈরি করার জন্য আপনি একাধিক কম্পোজেবল ব্যবহার করতে পারলেও, তাদের প্যারামিটারগুলি খুব বেশি আলাদা নয়। আপনাকে যেসব গুরুত্বপূর্ণ প্যারামিটার মনে রাখতে হবে সেগুলি হল:

  • progress: ইন্ডিকেটর বর্তমানে যে প্রোগ্রেস দেখাচ্ছে। 0.0 এবং 1.0-এর মধ্যে Float পাস করুন।
  • color: আসল ইন্ডিকেটরের রঙ। অর্থাৎ, কম্পোনেন্টের যে অংশ প্রগ্রেস দেখায় এবং প্রগ্রেস সম্পূর্ণ হলে কম্পোনেন্টকে সম্পূর্ণভাবে ঘিরে ফেলে।
  • trackColor: ট্র্যাকের রঙ যার উপরে ইন্ডিকেটর আঁকা হয়েছে।

M3 Expressive আপডেট

Material 3 Expressive-এ স্ট্যান্ডার্ড ফ্ল্যাট LinearProgressIndicator এবং CircularProgressIndicator-এর পাশাপাশি অতিরিক্ত বিকল্প হিসেবে LinearWavyProgressIndicator এবং CircularWavyProgressIndicator-এর সুবিধা রয়েছে। এইসব ইন্ডিকেটরে রাউন্ডেড স্টাইল এবং ট্র্যাকের উচ্চতা ও তরঙ্গের আকারের জন্য কনফিগারেশন থাকে। আপনার প্রোডাক্টের জন্য সবচেয়ে মানানসই ভিজ্যুয়াল স্টাইল বেছে নিন।

প্রোগ্রেস ইন্ডিকেটরের জন্য M3 Expressive আপডেট সম্পর্কে আরও জানতে, Material Design 3 প্রোগ্রেস ইন্ডিকেটর সংক্রান্ত নির্দেশিকা দেখুন।

ছবি ২. Material 3 Expressive প্রোগ্রেস ইন্ডিকেটরের ওয়েভি শেপ ও ভেরিয়েবল ট্র্যাক হাইট।

প্রোগ্রেস ইন্ডিকেটরে গোলাকার, রঙিন স্টাইল এবং বেছে নেওয়ার জন্য অতিরিক্ত কনফিগারেশন রয়েছে, যার মধ্যে রয়েছে ঢেউ খেলানো আকৃতি এবং পরিবর্তনশীল ট্র্যাকের উচ্চতা। অ্যাক্টিভ ইন্ডিকেটরের দুটি শেপের বিকল্প আছে: ওয়েভি এবং ফ্ল্যাট।

ওয়েভি

ওয়েভি প্রগ্রেস ইন্ডিকেটর নির্দিষ্ট ও অনির্দিষ্ট, দুই ধরনের ভ্যারিয়েন্টই অফার করে এবং আরও বেশি অভিব্যক্তিপূর্ণ ভিজ্যুয়ালের জন্য ওয়েভ প্যারামিটার ব্যবহার করে আপনাকে সেগুলির চেহারা কাস্টমাইজ করতে দেয়।

ছবি ৩. এক্সপ্রেসিভ ওয়েভ প্যারামিটার সহ ওয়েভি প্রোগ্রেস ইন্ডিকেটর।

ওয়েভি লিনিয়ার ইন্ডিকেটর সামগ্রিক কন্টেনারের উচ্চতা বাড়ায়।

ওয়েভি প্রোগ্রেস ইন্ডিকেটরের দুটি ভ্যারিয়েন্ট আছে: লিনিয়ার এবং সার্কুলার।

ডিটারমিনেট লিনিয়ার ওয়েভি প্রগ্রেস ইন্ডিকেটর

ডিফল্ট হিসেবে, ওয়েভি প্রোগ্রেস ইন্ডিকেটর ব্যবহার করার সময়, ওয়েভ স্পিড প্রয়োগ করা হয় যাতে কনস্ট্যান্ট ওয়েভ মোশন তৈরি করা যায়, এমনকি ডিটারমিনেট মোডেও। 0.dp থেকে waveSpeed-এ পাস করে আপনি এই ওয়েভ মোশন বন্ধ করতে পারবেন।

নিম্নলিখিত স্নিপেট থেকে বোঝা যাবে যে কীভাবে Slider দ্বারা নিয়ন্ত্রিত LinearWavyProgressIndicator প্রয়োগ করা যায়:

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun LinearWavyProgressIndicatorSample() {
    val sliderState = rememberSliderState(0.1f)
    val animatedProgress by animateFloatAsState(
            targetValue = sliderState.value,
            animationSpec = ProgressIndicatorDefaults.ProgressAnimationSpec,
        )

    Column(horizontalAlignment = Alignment.CenterHorizontally) {
        LinearWavyProgressIndicator(progress = { animatedProgress })
        Spacer(Modifier.requiredHeight(30.dp))
        Text("Set progress:")
        Slider(
            state = sliderState,
            onValueChange = { sliderState.value = it },
            modifier = Modifier.width(300.dp),
        )
    }
}

অনির্দিষ্ট লিনিয়ার ওয়েভি প্রোগ্রেস ইন্ডিকেটর

অপেক্ষার সময় জানা না থাকলে, কোনও প্রসেস চলছে তা দেখানোর জন্য অনির্দিষ্ট সূচক ব্যবহার করুন। নিম্নলিখিত স্নিপেট থেকে বোঝা যাবে যে কীভাবে অনির্দিষ্ট LinearWavyProgressIndicator প্রয়োগ করতে হয়:

@Composable
fun IndeterminateLinearWavyProgressIndicatorSample() {
    Column(horizontalAlignment = Alignment.CenterHorizontally) { LinearWavyProgressIndicator() }
}

ডিটারমিনেট সার্কুলার ওয়েভি প্রোগ্রেস ইন্ডিকেটর

তরঙ্গায়িত আকৃতি দীর্ঘ প্রসেসকে কম স্ট্যাটিক বলে মনে করাতে পারে এবং যখন আরও বেশি অভিব্যক্তিপূর্ণ স্টাইল উপযুক্ত হয় তখন এটি সবচেয়ে ভালোভাবে ব্যবহার করা হয়। নিম্নলিখিত স্নিপেট থেকে বোঝা যাবে যে কীভাবে Slider দ্বারা নিয়ন্ত্রিত CircularWavyProgressIndicator ডিটারমিনেট প্রয়োগ করতে হয়:

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun CircularWavyProgressIndicatorSample() {
    val sliderState = rememberSliderState(0.1f)
    val animatedProgress by animateFloatAsState(
            targetValue = sliderState.value,
            animationSpec = ProgressIndicatorDefaults.ProgressAnimationSpec,
        )

    Column(horizontalAlignment = Alignment.CenterHorizontally) {
        CircularWavyProgressIndicator(progress = { animatedProgress })
        Spacer(Modifier.requiredHeight(30.dp))
        Text("Set progress:")
        Slider(
            state = sliderState,
            onValueChange = { sliderState.value = it },
            modifier = Modifier.width(300.dp),
        )
    }
}

অনির্দিষ্ট সার্কুলার ওয়েভি প্রোগ্রেস ইন্ডিকেটর

সার্কুলার প্রোগ্রেস ইন্ডিকেটর সরাসরি কন্টেনার বা লোড হচ্ছে এমন পৃষ্ঠার কেন্দ্রে থাকা উচিত, যেমন বোতাম বা কার্ড। নিচের স্নিপেট দেখায় কীভাবে অনির্দিষ্ট CircularWavyProgressIndicator প্রয়োগ করতে হয়:

@Composable
fun IndeterminateCircularWavyProgressIndicatorSample() {
    Column(horizontalAlignment = Alignment.CenterHorizontally) { CircularWavyProgressIndicator() }
}

ফ্ল্যাট

নির্ধারিত ইন্ডিকেটর

একটি ডিটারমিনেট ইন্ডিকেটর কোনও অ্যাকশন কতটা সম্পূর্ণ হয়েছে তা সঠিকভাবে দেখায়। LinearProgressIndicator অথবা CircularProgressIndicator কম্পোজেবল ব্যবহার করুন এবং progress প্যারামিটারের জন্য একটি ভ্যালু পাস করুন।

নিম্নলিখিত স্নিপেট থেকে বোঝা যাবে যে কীভাবে Slider দ্বারা নিয়ন্ত্রিত LinearProgressIndicator প্রয়োগ করা যায়:

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun LinearProgressIndicatorSample() {
    val sliderState = rememberSliderState(0.1f)
    val animatedProgress by animateFloatAsState(
            targetValue = sliderState.value,
            animationSpec = ProgressIndicatorDefaults.ProgressAnimationSpec,
        )

    Column(horizontalAlignment = Alignment.CenterHorizontally) {
        LinearProgressIndicator(progress = { animatedProgress })
        Spacer(Modifier.requiredHeight(30.dp))
        Text("Set progress:")
        Slider(
            state = sliderState,
            onValueChange = { sliderState.value = it },
            modifier = Modifier.width(300.dp),
        )
    }
}

নিম্নলিখিত স্নিপেট থেকে বোঝা যাবে যে কীভাবে Slider দ্বারা নিয়ন্ত্রিত CircularProgressIndicator প্রয়োগ করা যায়:

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun CircularProgressIndicatorSample() {
    val sliderState = rememberSliderState(0.1f)
    val animatedProgress by animateFloatAsState(
            targetValue = sliderState.value,
            animationSpec = ProgressIndicatorDefaults.ProgressAnimationSpec,
        )

    Column(horizontalAlignment = Alignment.CenterHorizontally) {
        CircularProgressIndicator(progress = { animatedProgress })
        Spacer(Modifier.requiredHeight(30.dp))
        Text("Set progress:")
        Slider(
            state = sliderState,
            onValueChange = { sliderState.value = it },
            modifier = Modifier.width(300.dp),
        )
    }
}

নিম্নলিখিত স্নিপেট তুলনামূলকভাবে বিস্তারিত উদাহরণ প্রদান করে। ব্যবহারকারী বোতামটি প্রেস করলে, অ্যাপটি এটিকে প্রগ্রেস ইন্ডিকেটর দিয়ে রিপ্লেস করে এবং একটি কোরুটিন লঞ্চ করে যা ধীরে ধীরে progress-এর ভ্যালু বাড়ায়। এর ফলে প্রোগ্রেস ইন্ডিকেটর এক এক করে উপরে উঠতে থাকে।

@Composable
fun LinearDeterminateIndicator() {
    var currentProgress by remember { mutableFloatStateOf(0f) }
    var loading by remember { mutableStateOf(false) }
    val scope = rememberCoroutineScope() // Create a coroutine scope
    // Animate between progress updates so the indicator fills smoothly.
    val animatedProgress by animateFloatAsState(
        targetValue = currentProgress,
        animationSpec = ProgressIndicatorDefaults.ProgressAnimationSpec,
    )

    if (loading) {
        LinearProgressIndicator(
            progress = { animatedProgress },
            modifier = Modifier.fillMaxWidth(),
        )
    } else {
        Button(onClick = {
            loading = true
            scope.launch {
                loadProgress { progress ->
                    currentProgress = progress
                }
                loading = false // Reset loading when the coroutine finishes
            }
        }) {
            Text("Start loading")
        }
    }
}

/** Iterate the progress value */
suspend fun loadProgress(updateProgress: (Float) -> Unit) {
    for (i in 1..100) {
        updateProgress(i.toFloat() / 100)
        delay(100)
    }
}

লোডিং আংশিকভাবে সম্পূর্ণ হলে, পূর্ববর্তী উদাহরণের লিনিয়ার ইন্ডিকেটরটি নিম্নলিখিতভাবে দেখানো হয়:

ছবি ৪. একটি লিনিয়ার ডিটারমিনেট প্রোগ্রেস ইন্ডিকেটর।

একইভাবে, বৃত্তাকার ইন্ডিকেটর এইভাবে দেখানো হয়:

ছবি ৫. একটি সার্কুলার ডিটারমিনেট প্রগ্রেস ইন্ডিকেটর।

অনির্দিষ্ট ইন্ডিকেটর

একটি অনির্দিষ্ট সূচক কোনও অপারেশন সম্পূর্ণ হওয়ার কতটা কাছাকাছি তা প্রতিফলিত করে না। বরং, এটি ব্যবহারকারীকে নির্দেশ করার জন্য মোশন ব্যবহার করে যে প্রসেসিং চলছে, যদিও সম্পূর্ণ হওয়ার কোনও ডিগ্রি নির্দিষ্ট না করেই।

অনির্দিষ্ট প্রগ্রেস ইন্ডিকেটর তৈরি করতে, LinearProgressIndicator বা CircularProgressIndicator কম্পোজেবল ব্যবহার করুন, তবে progress-এর জন্য কোনও ভ্যালু পাস করবেন না। নিচের স্নিপেট থেকে বোঝা যাবে যে কীভাবে অনির্দিষ্ট LinearProgressIndicator প্রয়োগ করতে হয়:

@Composable
fun IndeterminateLinearProgressIndicatorSample() {
    Column(horizontalAlignment = Alignment.CenterHorizontally) { LinearProgressIndicator() }
}

নিচের স্নিপেট থেকে বোঝা যাবে যে কীভাবে অনির্দিষ্ট CircularProgressIndicator প্রয়োগ করতে হয়:

@Composable
fun IndeterminateCircularProgressIndicatorSample() {
    Column(horizontalAlignment = Alignment.CenterHorizontally) { CircularProgressIndicator() }
}

নিম্নলিখিত উদাহরণ থেকে আপনি জানতে পারবেন যে কীভাবে বোতাম প্রেস করে অনির্দিষ্ট ইন্ডিকেটর টগল করতে পারবেন। এই উদাহরণে আরও দেখানো হয়েছে যে ইন্ডিকেটরের চেহারা কাস্টমাইজ করার জন্য আপনি কীভাবে color এবং trackColor প্যারামিটারের ভ্যালু পাস করতে পারেন:

@Composable
fun IndeterminateCircularIndicator() {
    var loading by remember { mutableStateOf(false) }

    if (loading) {
        CircularProgressIndicator(
            modifier = Modifier.size(64.dp),
            color = MaterialTheme.colorScheme.secondary,
            trackColor = MaterialTheme.colorScheme.surfaceVariant,
        )
    } else {
        Button(onClick = { loading = true }) {
            Text("Start loading")
        }
    }
}

ইন্ডিকেটর চালু থাকলে এই প্রয়োগের উদাহরণ নিচে দেওয়া হল:

ছবি ৬. একটি বৃত্তাকার অনির্দিষ্ট প্রগ্রেস ইন্ডিকেটর।

নিচে একই ধরনের প্রয়োগের উদাহরণ দেওয়া হল, তবে CircularProgressIndicator-এর পরিবর্তে LinearProgressIndicator ব্যবহার করা হয়েছে:

ছবি ৭. একটি লিনিয়ার ইনডিটারমিনেট প্রোগ্রেস ইন্ডিকেটর।

অতিরিক্ত রিসোর্স