আইকন বোতাম

আইকন বোতাম ব্যবহারকারীরা যেসব অ্যাকশন নিতে পারেন তা দেখায়। আইকন বোতামে অবশ্যই এমন আইকন ব্যবহার করতে হবে যার অর্থ স্পষ্ট এবং সাধারণত সাধারণ বা ঘন ঘন ব্যবহৃত অ্যাকশনকে উপস্থাপন করে।

আইকন বোতাম দুই ধরনের হয়:

  • ডিফল্ট: এই বোতামগুলি মেনু বা সার্চের মতো অন্যান্য এলিমেন্ট খুলতে পারে।
  • টগল: এই বোতামগুলি বাইনারি অ্যাকশনকে উপস্থাপন করতে পারে যা চালু বা বন্ধ করার জন্য টগল করা যেতে পারে, যেমন "পছন্দসই" বা "বুকমার্ক"।
সেটিংস ও আরও অনেক কিছুর মতো বিভিন্ন আইকন সহ পাঁচটি আইকন বোতাম। কিছু আইটেম ফিল করা থাকে, যা থেকে বোঝা যায় যে সেগুলি বেছে নেওয়া হয়েছে এবং কিছু আইটেম আউটলাইন করা থাকে।
ছবি ১. আইকন বোতাম; কিছু বোতাম ফিল করা (বেছে নেওয়া হয়েছে তা বোঝাতে) এবং বাকিগুলি আউটলাইন করা।

API সারফেস

স্ট্যান্ডার্ড আইকন বোতাম প্রয়োগ করতে IconButton কম্পোজেবল ব্যবহার করুন এবং বেছে নেওয়া ও বেছে না নেওয়া অবস্থার মধ্যে টগল করে এমন বোতামের জন্য IconToggleButton ব্যবহার করুন। ফিল করা, ফিল করা টোনাল বা আউটলাইন করা, এই ধরনের বিভিন্ন ভিজ্যুয়াল স্টাইল তৈরি করতে, FilledIconButton, FilledTonalIconButton এবং OutlinedIconButton অথবা তাদের টগল করা যায় এমন কাউন্টারপার্ট FilledIconToggleButton, FilledTonalIconToggleButton এবং OutlinedIconToggleButton ব্যবহার করুন।

IconButton-এর জন্য মূল প্যারামিটারগুলির মধ্যে রয়েছে:

  • onClick: ব্যবহারকারী আইকন বোতামে ট্যাপ করলে একটি ল্যাম্বডা ফাংশন কার্যকর হয়।
  • enabled: একটি বুলিয়ান যা বোতামের চালু করা স্ট্যাটাস নিয়ন্ত্রণ করে। false হলে, বোতামটি ব্যবহারকারীর ইনপুটে সাড়া দেয় না।
  • content: বোতামের মধ্যে কম্পোজেবল কন্টেন্ট, সাধারণত একটি Icon।

IconToggleButton-এর জন্য মূল প্যারামিটারগুলির মধ্যে রয়েছে:

  • checked: একটি বুলিয়ান যা বোতামের বেছে নেওয়া স্ট্যাটাস কন্ট্রোল করে।
  • onCheckedChange: একটি ল্যাম্বডা ফাংশন যা ব্যবহারকারী বোতামে ট্যাপ করলে কার্যকর হয়, নতুন চেক করা অবস্থা প্রদান করে।
  • enabled: একটি বুলিয়ান যা বোতামের চালু করা স্ট্যাটাস নিয়ন্ত্রণ করে। false হলে, বোতামটি ব্যবহারকারীর ইনপুটে সাড়া দেয় না।

প্রাথমিক উদাহরণ: টগল আইকন বোতাম

টগল আইকন বোতামের সাহায্যে কোনও একটি বিকল্প বেছে নেওয়া বা বাদ দেওয়া যায়, যেমন পছন্দের তালিকা থেকে কিছু যোগ করা বা সরানো। IconToggleButton এবং এর ভেরিয়েন্ট এই উদ্দেশ্যে ডিজাইন করা হয়েছে।

নিচের উদাহরণে দেখানো হয়েছে যে কীভাবে টগল আইকন বোতাম প্রয়োগ করতে হয়, যেটি IconButton-এর মাধ্যমে স্টেট ম্যানেজ করে, এটি বেছে নেওয়া হয়েছে নাকি হয়নি তার উপর ভিত্তি করে এর চেহারা পরিবর্তন করে:

@Preview
@Composable
fun ToggleIconButtonExample() {
    // isToggled initial value should be read from a view model or persistent storage.
    var isToggled by rememberSaveable { mutableStateOf(false) }

    IconButton(
        onClick = { isToggled = !isToggled }
    ) {
        Icon(
            painter = if (isToggled) painterResource(R.drawable.favorite_filled) else painterResource(R.drawable.favorite),
            contentDescription = if (isToggled) "Selected icon button" else "Unselected icon button."
        )
    }
}

কোড সম্পর্কে গুরুত্বপূর্ণ পয়েন্ট

  • ToggleIconButtonExample কম্পোজ করার উপযুক্ত আইটেমটি একটি টগল করা যায় এমন IconButton-কে সংজ্ঞায়িত করে।
    • mutableStateOf(false) একটি MutableState অবজেক্ট তৈরি করে যা একটি বুলিয়ান মান ধারণ করে, প্রাথমিকভাবে false। এটি isToggled-কে একটি স্টেট হোল্ডার করে তোলে, যার অর্থ হল, এর ভ্যালু পরিবর্তন হলেই Compose টুলকিট UI রিকম্পোজ করে।
    • rememberSaveable নিশ্চিত করে যে isToggled স্টেট স্ক্রিন রোটেশনের মতো কনফিগারেশন পরিবর্তন জুড়ে অপরিবর্তিত থাকে।
  • IconButton-এর onClick ল্যাম্বডা ক্লিক করার সময় বোতামের আচরণকে সংজ্ঞায়িত করে, true এবং false-এর মধ্যে স্ট্যাটাস টগল করে।
  • Icon কম্পোজেবলের painter প্যারামিটার শর্তসাপেক্ষে isToggled অবস্থার উপর ভিত্তি করে একটি ভিন্ন painterResource লোড করে। এটি আইকনের ভিজ্যুয়াল রূপ পরিবর্তন করে।
    • isToggled যদি true হয়, তাহলে এটি ভর্তি হার্ট ড্রয়েবল লোড করে।
    • isToggled যদি false হয়, তাহলে এটি আউটলাইন করা হার্ট ড্রয়েবল লোড করে।
  • Icon-এর contentDescription-ও isToggled স্টেটের উপর ভিত্তি করে আপডেট হয় যাতে উপযুক্ত অ্যাক্সেসিবিলিটি সংক্রান্ত তথ্য প্রদান করা যায়।

ফলাফল

নিচের ছবিতে আগের স্নিপেট থেকে টগল আইকন বোতামটি তার বেছে নেওয়া অবস্থায় দেখানো হয়েছে:

ছবি ২. বেছে নেওয়া অবস্থায় "পছন্দের" টগল আইকন বোতাম।

উন্নত উদাহরণ: প্রেস করার পরে বারবার অ্যাকশন

এই বিভাগে দেখানো হয়েছে যে কীভাবে এমন আইকন বোতাম তৈরি করা যায় যা ব্যবহারকারী প্রেস করে ধরে রাখলে ক্রমাগত কোনও অ্যাকশন ট্রিগার করে, প্রতি ক্লিকে একবার ট্রিগার করার পরিবর্তে।

@Composable
fun MomentaryIconButton(
    unselectedImage: Int,
    selectedImage: Int,
    contentDescription: String,
    modifier: Modifier = Modifier,
    stepDelay: Long = 100L, // Minimum value is 1L milliseconds.
    onClick: () -> Unit
) {
    val interactionSource = remember { MutableInteractionSource() }
    val isPressed by interactionSource.collectIsPressedAsState()
    val pressedListener by rememberUpdatedState(onClick)

    LaunchedEffect(isPressed) {
        while (isPressed) {
            delay(stepDelay.coerceIn(1L, Long.MAX_VALUE))
            pressedListener()
        }
    }

    IconButton(
        modifier = modifier,
        onClick = onClick,
        interactionSource = interactionSource
    ) {
        Icon(
            painter = if (isPressed) painterResource(id = selectedImage) else painterResource(id = unselectedImage),
            contentDescription = contentDescription,
        )
    }
}

কোড সম্পর্কে গুরুত্বপূর্ণ পয়েন্ট

  • MomentaryIconButton-এ unselectedImage: Int, বোতাম প্রেস না করা হলে আইকনের জন্য ড্রয়েবল রিসোর্স আইডি এবং selectedImage: Int, বোতাম প্রেস করা হলে আইকনের জন্য ড্রয়েবল রিসোর্স আইডি থাকে।
  • এটি ব্যবহারকারীর "প্রেস" ইন্টার‍্যাকশন বিশেষভাবে ট্র্যাক করতে interactionSource ব্যবহার করে।
  • বোতামটি অ্যাক্টিভভাবে প্রেস করা হলে isPressed ট্রু হিসেবে বিবেচিত হয় এবং অন্যথায় ফলস হিসেবে বিবেচিত হয়। isPressed, true হলে, LaunchedEffect লুপে প্রবেশ করে।
    • এই লুপের মধ্যে, এটি ট্রিগার অ্যাকশনের মধ্যে পজ তৈরি করতে delay (stepDelay সহ) ব্যবহার করে। coerceIn নিশ্চিত করে যে ইনফিনিট লুপ প্রতিরোধ করতে দেরি অন্তত ১ মিলি সেকেন্ড হয়।
    • লুপের মধ্যে প্রতিটি বিলম্বের পরে pressedListener চালু করা হয়। এটি অ্যাকশনটি রিপিট করে।
  • pressedListener rememberUpdatedState ব্যবহার করে যাতে onClick ল্যাম্বডা (যে অ্যাকশনটি করতে হবে) সবসময় লেটেস্ট কম্পোজিশন থেকে সবচেয়ে আপ-টু-ডেট থাকে।
  • বোতামটি বর্তমানে প্রেস করা আছে কিনা তার উপর ভিত্তি করে Icon তার ডিসপ্লে করা ছবি পরিবর্তন করে।
    • isPressed সঠিক হলে, selectedImage দেখানো হয়।
    • অন্যথায়, unselectedImage দেখানো হয়।

এরপর, একটি উদাহরণে এই MomentaryIconButton ব্যবহার করুন। নিম্নলিখিত স্নিপেট একটি কাউন্টার নিয়ন্ত্রণকারী দুটি আইকন বোতাম প্রদর্শন করে:

@Preview()
@Composable
fun MomentaryIconButtonExample() {
    var pressedCount by remember { mutableIntStateOf(0) }

    Row(
        modifier = Modifier.fillMaxWidth(),
        verticalAlignment = Alignment.CenterVertically
    ) {
        MomentaryIconButton(
            unselectedImage = R.drawable.fast_rewind,
            selectedImage = R.drawable.fast_rewind_filled,
            stepDelay = 100L,
            onClick = { pressedCount -= 1 },
            contentDescription = "Decrease count button"
        )
        Spacer(modifier = Modifier)
        Text("advanced by $pressedCount frames")
        Spacer(modifier = Modifier)
        MomentaryIconButton(
            unselectedImage = R.drawable.fast_forward,
            selectedImage = R.drawable.fast_forward_filled,
            contentDescription = "Increase count button",
            stepDelay = 100L,
            onClick = { pressedCount += 1 }
        )
    }
}

কোড সম্পর্কে গুরুত্বপূর্ণ পয়েন্ট

  • MomentaryIconButtonExample কম্পোজেবল একটি Row দেখায় যাতে দুটি MomentaryIconButton ইনস্ট্যান্স এবং একটি Text কম্পোজেবল থাকে যা একটি কাউন্টার বাড়ানো এবং কমানোর জন্য একটি UI তৈরি করে।
  • এটি remember ও mutableIntStateOf ব্যবহার করে pressedCount মিউটেবল স্টেট ভেরিয়েবল বজায় রাখে, যা ০ দিয়ে শুরু হয়। pressedCount পরিবর্তন হলে, এটি পর্যবেক্ষণ করা যেকোনও কম্পোজেবল (যেমন Text কম্পোজেবল) নতুন ভ্যালু দেখানোর জন্য আবার কম্পোজ করে।
  • ক্লিক করলে বা হোল্ড করলে প্রথম MomentaryIconButton pressedCount কমে যায়।
  • ক্লিক করলে বা হোল্ড করলে দ্বিতীয় MomentaryIconButton pressedCount বাড়ে।
  • দুটি বোতামই ১০০ মিলিসেকেন্ডের stepDelay ব্যবহার করে, যার অর্থ হল বোতামটি ধরে রাখার সময় প্রতি ১০০ মিলিসেকেন্ডে onClick অ্যাকশনটি পুনরাবৃত্তি হয়।

ফলাফল

নিচের ভিডিওতে আইকন বোতাম ও কাউন্টার সহ UI দেখানো হয়েছে:

ছবি ৩। দুটি আইকন বোতাম (প্লাস ও মাইনাস) সহ একটি কাউন্টার UI যা কাউন্টার বাড়ায় ও কমায়।

M3 Expressive আপডেট

M3 এক্সপ্রেসিভ আপডেটের মাধ্যমে, আইকন বোতাম অতিরিক্ত সাইজ, কোণ এবং প্রস্থের বিকল্প সমর্থন করে এবং প্রেস বা বেছে নেওয়া হলে আকার পরিবর্তন করতে পারে। স্ট্যান্ডার্ড বোতাম গ্রুপে রাখা হলে, আইকন বোতাম প্রেস করা হলে তা আশেপাশের বোতামের সাথেও ইন্টার‍্যাক্ট করে।

অ্যানিমেটেড আকার

আইকন বোতাম প্রেস করা হলে, সেটির আকার অ্যানিমেট করতে পারে এবং টগল আইকন বোতাম চেক করা অবস্থার উপর ভিত্তি করে সেটির আকার অ্যানিমেট করতে পারে। শেপ অ্যানিমেশন চালু করতে, IconButtonDefaults.shapes() বা IconButtonDefaults.toggleableShapes()-কে IconButton বা IconToggleButton-এর shapes প্যারামিটারে পাস করুন।

আইকন বোতাম

আইকন বোতামের স্ট্যাটাস
ছবি ৪. গোল ও বর্গাকার শেপে আইকন বোতামের শেপ অ্যানিমেশন।

নিচের স্নিপেট থেকে বোঝা যায় যে কীভাবে এমন একটি আইকন বোতাম প্রয়োগ করা যায় যা প্রেস করলে তার আকার অ্যানিমেট হয়:

@Composable
fun IconButtonWithAnimatedShapeSample() {
    IconButton(
        onClick = { /* doSomething() */ },
        shapes = IconButtonDefaults.shapes(),
    ) {
        Icon(painter = rememberVectorPainter(AppIcons.LockFilled), contentDescription = "Localized description")
    }
}

আইকন বোতাম টগল করুন

টগল আইকন বোতামের স্ট্যাটাস
ছবি ৫. বেছে নেওয়া ও বাদ দেওয়া অবস্থায় আইকন বোতামের আকার অ্যানিমেশন টগল করুন।

নিচের স্নিপেট থেকে বোঝা যাবে যে কীভাবে টগল আইকন বোতাম প্রয়োগ করতে হয় যা চেক করা স্ট্যাটাসের উপর ভিত্তি করে এর আকার অ্যানিমেট করে:

@Composable
fun IconToggleButtonWithAnimatedShapeSample() {
    var checked by remember { mutableStateOf(false) }
    IconToggleButton(
        checked = checked,
        onCheckedChange = { checked = it },
        shapes = IconButtonDefaults.toggleableShapes(),
    ) {
        if (checked) {
            Icon(painter = rememberVectorPainter(AppIcons.LockFilled), contentDescription = "Localized description")
        } else {
            Icon(painter = rememberVectorPainter(AppIcons.Lock), contentDescription = "Localized description")
        }
    }
}

সাইজ, প্রস্থ ও আকারের ভ্যারিয়েন্ট

আইকন বোতাম গোল ও বর্গাকার আকৃতি, পাঁচটি সাইজ ও তিনটি প্রস্থে উপলভ্য।

আইকন বোতামের সাইজ, আকার ও প্রস্থের উদাহরণ।
ছবি ৬. এক্সপ্রেসিভ ফিচারের মধ্যে পাঁচটি সাইজ, দুটি আকার ও তিনটি প্রস্থ অন্তর্ভুক্ত।

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

আইকন বোতামের সাইজের পাঁচটি ভেরিয়েন্ট আছে: অতিরিক্ত ছোট, ছোট, মাঝারি, বড় এবং অতিরিক্ত বড়। প্রতিটি সাইজে প্রস্থের তিনটি বিকল্প থাকে: ইউনিফর্ম (ডিফল্ট), সরু এবং চওড়া।

পাঁচটি সারি ও তিনটি কলামে আইকন বোতাম রয়েছে, যেখানে একটি হার্ট আইকন দেখানো হচ্ছে। প্রতিটি সারির সাইজ বৃদ্ধি পায় এবং তিনটি কলামের প্রস্থ আলাদা হয়: ইউনিফর্ম, সরু ও চওড়া।
ছবি ৭. আইকন বোতামে পাঁচটি সাইজ এবং তিনটি প্রস্থের বিকল্প দেখানো হচ্ছে: ইউনিফর্ম, সরু এবং চওড়া।

আইকন বোতাম গোল বা বর্গাকার কোণ ভেরিয়েন্টে উপলভ্য এবং টগল আইকন বোতাম প্রেস বা বেছে নেওয়া হলে তাদের আকার পরিবর্তন করে।

হার্ট আইকন সহ পাঁচটি আইকন বোতামের দুটি সারি, বাঁদিক থেকে ডানদিকে সাইজ বড় হচ্ছে; উপরের সারিতে গোলাকার কোণ এবং নিচের সারিতে বর্গাকার কোণ রয়েছে।
ছবি ৮. আইকন বোতাম গোল বা চৌকো কোণ ভ্যারিয়েন্টে উপলভ্য।

কর্নার ভেরিয়েন্টের মধ্যে থেকে বেছে নেওয়ার ব্যাপারে নির্দেশিকা পেতে, মেটেরিয়াল ডিজাইন ৩ আইকন বোতাম সংক্রান্ত নির্দেশিকা দেখুন।

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