Compose for Wear OS-এ Material 2.5 থেকে Material 3-তে মাইগ্রেট করা

Material 3 Expressive হল Material Design-এর পরবর্তী বিবর্তন। এতে আপডেট করা থিমিং, কম্পোনেন্ট এবং ডায়নামিক কালারের মতো পছন্দমতো সাজিয়ে নেওয়ার ফিচার অন্তর্ভুক্ত।

এই গাইডে, অ্যাপের জন্য Wear Compose Material 2.5 (androidx.wear.compose) Jetpack লাইব্রেরি থেকে Wear Compose Material 3 (androidx.wear.compose.material3) Jetpack লাইব্রেরিতে মাইগ্রেট করার ব্যাপারে ফোকাস করা হয়েছে।

অ্যাপ্রোচ

M2.5 থেকে M3-তে আপনার অ্যাপ কোড মাইগ্রেট করার জন্য, Compose Material মাইগ্রেশন ফোন সংক্রান্ত নির্দেশিকা-তে বর্ণিত একই পদ্ধতি অনুসরণ করুন, বিশেষ করে:

ডিপেন্ডেন্সি

M3-এর প্যাকেজ ও ভার্সন M2.5-এর থেকে আলাদা:

M2.5

implementation("androidx.wear.compose:compose-material:1.4.0")

M3

implementation("androidx.wear.compose:compose-material3:1.7.1")

Wear Compose রিলিজ পৃষ্ঠায় লেটেস্ট M3 ভার্সন দেখুন।

Wear Compose Foundation লাইব্রেরি ভার্সন 1.7.1-এ কিছু নতুন কম্পোনেন্ট পরিচয় করানো হয়েছে যা Material 3 কম্পোনেন্টের সাথে কাজ করার জন্য ডিজাইন করা হয়েছে। একইভাবে, Wear OS 6 (API লেভেল 36) বা তার পরবর্তী ভার্সনে চালানোর সময় Wear Compose Navigation লাইব্রেরি থেকে SwipeDismissableNavHost-এর আপডেট করা অ্যানিমেশন আছে। Wear Compose Material 3 ভার্সনে আপডেট করার সময়, আমরা Wear Compose Foundation এবং Navigation লাইব্রেরিও আপডেট করার সাজেশন দিই:

implementation("androidx.wear.compose:compose-foundation:1.7.1")
implementation("androidx.wear.compose:compose-navigation:1.7.1")

থিম

M2.5 এবং M3, দুটিতেই থিম কম্পোজেবলের নাম হল MaterialTheme, কিন্তু ইমপোর্ট প্যাকেজ এবং প্যারামিটার আলাদা। M3-তে, Colors প্যারামিটারের নাম পরিবর্তন করে ColorScheme করা হয়েছে এবং ট্রানজিশন প্রয়োগ করার জন্য MotionScheme পরিচয় করানো হয়েছে।

M2.5

import androidx.wear.compose.material.MaterialTheme

MaterialTheme(
    colors = AppColors,
    typography = AppTypography,
    shapes = AppShapes,
    content = content
)

M3

import androidx.wear.compose.material3.MaterialTheme
// ...
    MaterialTheme(
        colorScheme = ColorScheme(),
        typography = Typography(),
        shapes = Shapes(),
        motionScheme = MotionScheme.standard(),
        content = { /*content here*/ }
    )

রঙ

M3-এর কালার সিস্টেম M2.5-এর থেকে অনেকটাই আলাদা। রঙের প্যারামিটারের সংখ্যা বেড়েছে, সেগুলির নাম আলাদা এবং M3 কম্পোনেন্টের সাথে সেগুলির ম্যাপিং আলাদাভাবে করা হয়েছে। Compose-এ, এটি M2.5 Colors ক্লাস, M3 ColorScheme ক্লাস এবং সম্পর্কিত ফাংশনের ক্ষেত্রে প্রযোজ্য:

M2.5

import androidx.wear.compose.material.Colors

val appColorScheme: Colors = Colors(
   // M2.5 Color parameters
)

M3

import androidx.wear.compose.material3.ColorScheme
// ...
    val appColorScheme: ColorScheme = ColorScheme(
        // M3 ColorScheme parameters
    )

M2.5 ও M3-এর মধ্যে মূল পার্থক্যগুলি নিম্নলিখিত সারণীতে বর্ণনা করা হয়েছে:

M2.5 M3
Colors নাম পরিবর্তন করে ColorScheme রাখা হয়েছে
১৩টি রঙ ২৯টি রঙ
N/A নতুন ডায়নামিক কালার থিমিং
N/A আরও বেশি এক্সপ্রেশনের জন্য নতুন টারশিয়ারি রঙ

ডায়নামিক কালার থিমিং

M3-এর একটি নতুন ফিচার হল ডায়নামিক কালার থিমিং। ব্যবহারকারী ওয়াচফেসের রঙ পরিবর্তন করলে, UI-এর রঙও সেই অনুযায়ী পরিবর্তন হয়ে যায়।

ডায়নামিক রঙের স্কিম প্রয়োগ করতে dynamicColorScheme ফাংশন ব্যবহার করুন এবং ডায়নামিক রঙের স্কিম উপলভ্য না থাকলে ফলব্যাক হিসেবে defaultColorScheme প্রদান করুন।

@Composable
fun myApp() {
    val dynamicColorScheme = dynamicColorScheme(LocalContext.current)
    MaterialTheme(colorScheme = dynamicColorScheme ?: myBrandColors) {}
}

internal val myBrandColors: ColorScheme = ColorScheme( /* Specify colors here */)

টাইপোগ্রাফি

M3-তে টাইপোগ্রাফি সিস্টেম M2.5-এর থেকে আলাদা এবং এতে নিম্নলিখিত ফিচার অন্তর্ভুক্ত:

  • নয়টি নতুন টেক্সট স্টাইল
  • ফ্লেক্স ফন্ট, যা বিভিন্ন ওজন, প্রস্থ এবং গোলাকারতার জন্য টাইপ স্কেল কাস্টমাইজ করার অনুমতি দেয়
  • AnimatedText, যা ফ্লেক্স ফন্ট ব্যবহার করে

M2.5

import androidx.wear.compose.material.Typography

val Typography = Typography(
   // M2.5 TextStyle parameters
)

M3

import androidx.wear.compose.material3.Typography

val Typography = Typography(
    // M3 TextStyle parameters
)

ফ্লেক্স ফন্ট

ফ্লেক্স ফন্ট ডিজাইনারদের নির্দিষ্ট আকারের জন্য টাইপের প্রস্থ এবং ওজন নির্দিষ্ট করার অনুমতি দেয়।

টেক্সটের স্টাইল

M3-তে নিম্নলিখিত TextStyles উপলভ্য। এগুলি বিভিন্ন M3 কম্পোনেন্ট ডিফল্ট হিসেবে ব্যবহার করে।

টাইপোগ্রাফি TextStyle
ডিসপ্লে displayLarge, displayMedium, displaySmall
শীর্ষক titleLarge, titleMedium, titleSmall
লেবেল labelLarge, labelMedium, labelSmall
শরীর bodyLarge, bodyMedium, bodySmall, bodyExtraSmall
সংখ্যা numeralExtraLarge, numeralLarge, numeralMedium, numeralSmall, numeralExtraSmall
আর্ক arcLarge, arcMedium, arcSmall

আকার

M3-তে শেপ সিস্টেম M2.5-এর থেকে আলাদা। শেপ প্যারামিটারের সংখ্যা বেড়েছে, সেগুলির নাম আলাদা এবং M3 কম্পোনেন্টে সেগুলি আলাদাভাবে ম্যাপ করা হয়। নিম্নলিখিত আকারের সাইজ উপলভ্য:

  • খুব ছোট
  • ছোট
  • মাঝারি
  • বড়
  • অত্যন্ত বড়

Compose-এ, এটি M2.5 Shapes ক্লাস এবং M3 Shapes ক্লাসের ক্ষেত্রে প্রযোজ্য:

M2.5

import androidx.wear.compose.material.Shapes

val Shapes = Shapes(
   // M2.5 Shapes parameters
)

M3

import androidx.wear.compose.material3.Shapes

val Shapes = Shapes(
    // M3 Shapes parameters
)

শুরু করার জন্য Compose-এ Material 2 থেকে Material 3-তে মাইগ্রেট করুন থেকে Shapes প্যারামিটার ম্যাপিং ব্যবহার করুন।

শেপ মর্ফিং

M3-তে শেপ মর্ফিং ফিচার চালু করা হয়েছে: ইন্টার‍্যাকশনের ভিত্তিতে এখন শেপ মর্ফ করা হয়।

শেপ মর্ফিং আচরণটি বেশ কয়েকটি গোল বোতামের বৈচিত্র্য হিসাবে উপলভ্য, শেপ মর্ফিং কাজ করে এমন বোতামের নিম্নলিখিত তালিকাটি দেখুন:

বোতাম শেপ মর্ফিং ফাংশন
IconButton IconButtonDefaults.animatedShapes প্রেস করলে আইকন বোতাম অ্যানিমেট করে
IconToggleButton IconToggleButtonDefaults.animatedShapes প্রেস করার সময় আইকন টগল বোতাম অ্যানিমেট করে এবং
IconToggleButtonDefaults.variantAnimatedShapes প্রেস করার সময় এবং টিকচিহ্ন দেওয়া/টিকচিহ্ন সরানোর সময় আইকন টগল বোতাম অ্যানিমেট করে
TextButton TextButtonDefaults.animatedShapes প্রেস করলে টেক্সট বোতাম অ্যানিমেট করে
TextToggleButton TextToggleButtonDefaults.animatedShapes প্রেস করার সময় টেক্সট টগল অ্যানিমেট করে এবং TextToggleButtonDefaults.variantAnimatedShapes প্রেস করার সময় এবং টিকচিহ্ন দেওয়া/টিকচিহ্ন সরানোর সময় টেক্সট টগল অ্যানিমেট করে

কম্পোনেন্ট ও লেআউট

M2.5-এর বেশিরভাগ কম্পোনেন্ট ও লেআউট M3-তে উপলভ্য। তবে, কিছু M3 কম্পোনেন্ট এবং লেআউট M2.5-এ ছিল না। এছাড়াও, কিছু M3 কম্পোনেন্টে M2.5-এর সমতুল্য কম্পোনেন্টের চেয়ে বেশি ভ্যারিয়েশন রয়েছে।

কিছু কম্পোনেন্টের জন্য বিশেষ বিবেচনার প্রয়োজন হলেও, নিম্নলিখিত ফাংশন ম্যাপিংগুলি শুরু করার পয়েন্ট হিসেবে সাজেস্ট করা হয়:

Material 2.5 Material 3
androidx.wear.compose.material.dialog.Alert androidx.wear.compose.material3.AlertDialog
androidx.wear.compose.material.Button androidx.wear.compose.material3.IconButton অথবা androidx.wear.compose.material3.TextButton
androidx.wear.compose.material.Card androidx.wear.compose.material3.Card
androidx.wear.compose.material.TitleCard androidx.wear.compose.material3.TitleCard
androidx.wear.compose.material.AppCard androidx.wear.compose.material3.AppCard
androidx.wear.compose.material.Checkbox M3-এর সমতুল্য কিছু নেই, androidx.wear.compose.material3.CheckboxButton বা androidx.wear.compose.material3.SplitCheckboxButton-এ মাইগ্রেট করুন
androidx.wear.compose.material.Chip androidx.wear.compose.material3.Button অথবা
androidx.wear.compose.material3.OutlinedButton অথবা
androidx.wear.compose.material3.FilledTonalButton অথবা
androidx.wear.compose.material3.ChildButton
androidx.wear.compose.material.CompactChip androidx.wear.compose.material3.CompactButton
androidx.wear.compose.material.InlineSlider androidx.wear.compose.material3.Slider
androidx.wear.compose.material.LocalContentAlpha() Material 3-তে Text বা Icon ব্যবহার না করার কারণে সরিয়ে দেওয়া হয়েছে
androidx.wear.compose.material.PositionIndicator androidx.wear.compose.material3.ScrollIndicator
androidx.wear.compose.material.RadioButton M3-এর সমতুল্য কিছু নেই, androidx.wear.compose.material3.RadioButton বা androidx.wear.compose.material3.SplitRadioButton-এ মাইগ্রেট করুন
androidx.wear.compose.material.SwipeToRevealCard androidx.wear.compose.material3.SwipeToReveal
androidx.wear.compose.material.SwipeToRevealChip androidx.wear.compose.material3.SwipeToReveal
androidx.wear.compose.material.Scaffold androidx.wear.compose.material3.AppScaffold এবং androidx.wear.compose.material3.ScreenScaffold
androidx.wear.compose.material.SplitToggleChip M3-এর সমতুল্য কিছু নেই, androidx.wear.compose.material3.SplitCheckboxButton, androidx.wear.compose.material3.SplitSwitchButton অথবা androidx.wear.compose.material3.SplitRadioButton-এ মাইগ্রেট করুন
androidx.wear.compose.material.Switch M3-এর সমতুল্য কিছু নেই, androidx.wear.compose.material3.SwitchButton বা androidx.wear.compose.material3.SplitSwitchButton-এ মাইগ্রেট করুন
androidx.wear.compose.material.ToggleButton androidx.wear.compose.material3.IconToggleButton অথবা androidx.wear.compose.material3.TextToggleButton
androidx.wear.compose.material.ToggleChip androidx.wear.compose.material3.CheckboxButton অথবা
androidx.wear.compose.material3.RadioButton অথবা
androidx.wear.compose.material3.SwitchButton
androidx.wear.compose.material.Vignette Wear OS-এর জন্য Material 3 Expressive ডিজাইনে অন্তর্ভুক্ত না থাকার কারণে সরানো হয়েছে

এখানে সাধারণ Material 3 কম্পোনেন্ট এবং সেগুলির সমতুল্য Material 2.5-এর তালিকা দেওয়া হল:

Material 3 Material 2.5-এর সমতুল্য কম্পোনেন্ট (M3-তে নতুন না হলে)
androidx.wear.compose.material3.AlertDialog androidx.wear.compose.material.dialog.Alert
androidx.wear.compose.material3.AnimatedPage নতুন
androidx.wear.compose.material3.AnimatedText নতুন
androidx.wear.compose.material3.AppScaffold androidx.wear.compose.material.Scaffold ( androidx.wear.compose.material3.ScreenScaffold সহ)
androidx.wear.compose.material3.Button androidx.wear.compose.material.Chip
androidx.wear.compose.material3.ButtonGroup নতুন
androidx.wear.compose.material3.Card androidx.wear.compose.material.Card
androidx.wear.compose.material3.CheckboxButton চেকবক্স টগল কন্ট্রোল সহ androidx.wear.compose.material.ToggleChip
androidx.wear.compose.material3.ChildButton androidx.wear.compose.material.Chip (শুধুমাত্র যখন কোনও ব্যাকগ্রাউন্ডের প্রয়োজন হয় না)
androidx.wear.compose.material3.CircularProgressIndicator androidx.wear.compose.material.CircularProgressIndicator
androidx.wear.compose.material3.CompactButton androidx.wear.compose.material.CompactChip
androidx.wear.compose.material3.ConfirmationDialog androidx.wear.compose.material.dialog.Confirmation
androidx.wear.compose.material3.curvedText androidx.wear.compose.material.curvedText
androidx.wear.compose.material3.DatePicker নতুন
androidx.wear.compose.material3.Dialog androidx.wear.compose.material.dialog.Dialog
androidx.wear.compose.material3.EdgeButton নতুন
androidx.wear.compose.material3.FadingExpandingLabel নতুন
androidx.wear.compose.material3.FilledTonalButton টোনাল বোতামের ব্যাকগ্রাউন্ডের প্রয়োজন হলে androidx.wear.compose.material.Chip
androidx.wear.compose.material3.HorizontalPageIndicator androidx.wear.compose.material.HorizontalPageIndicator
androidx.wear.compose.material3.HorizontalPagerScaffold নতুন
androidx.wear.compose.material3.Icon androidx.wear.compose.material.Icon
androidx.wear.compose.material3.IconButton androidx.wear.compose.material.Button
androidx.wear.compose.material3.IconToggleButton androidx.wear.compose.material.ToggleButton
androidx.wear.compose.material3.LevelIndicator নতুন
androidx.wear.compose.material3.LinearProgressIndicator নতুন
androidx.wear.compose.material3.ListHeader androidx.wear.compose.material.ListHeader
androidx.wear.compose.material3.ListSubHeader নতুন
androidx.wear.compose.material3.MaterialTheme androidx.wear.compose.material.MaterialTheme
androidx.wear.compose.material3.OpenOnPhoneDialog নতুন
androidx.wear.compose.material3.Picker androidx.wear.compose.material.Picker
androidx.wear.compose.material3.PickerGroup androidx.wear.compose.material.PickerGroup
androidx.wear.compose.material3.RadioButton রেডিও বোতাম টগল কন্ট্রোল সহ androidx.wear.compose.material.ToggleChip
androidx.wear.compose.material3.ScreenScaffold androidx.wear.compose.material.Scaffold (androidx.wear.compose.material3.AppScaffold-এর সাথে)
androidx.wear.compose.material3.ScrollIndicator androidx.wear.compose.material.PositionIndicator
androidx.wear.compose.material3.scrollAway androidx.wear.compose.material.scrollAway
androidx.wear.compose.material3.SegmentedCircularProgressIndicator নতুন
androidx.wear.compose.material3.Slider androidx.wear.compose.material.InlineSlider
androidx.wear.compose.material3.SplitRadioButton androidx.wear.compose.material.SplitToggleChip
androidx.wear.compose.material3.SplitCheckboxButton androidx.wear.compose.material.SplitToggleChip
androidx.wear.compose.material3.SplitSwitchButton androidx.wear.compose.material.SplitToggleChip
androidx.wear.compose.material3.Stepper androidx.wear.compose.material.Stepper
androidx.wear.compose.material3.SwipeToDismissBox androidx.wear.compose.material.SwipeToDismissBox
androidx.wear.compose.material3.SwipeToReveal androidx.wear.compose.material.SwipeToRevealCard এবং androidx.wear.compose.material.SwipeToRevealChip
androidx.wear.compose.material3.SwitchButton সুইচ টগল কন্ট্রোল সহ androidx.wear.compose.material.ToggleChip
androidx.wear.compose.material3.Text androidx.wear.compose.material.Text
androidx.wear.compose.material3.TextButton androidx.wear.compose.material.Button
androidx.wear.compose.material3.TextToggleButton androidx.wear.compose.material.ToggleButton
androidx.wear.compose.material3.TimeText androidx.wear.compose.material.TimeText
androidx.wear.compose.material3.VerticalPagerScaffold নতুন

এবং অবশেষে Wear Compose Foundation লাইব্রেরি থেকে কিছু প্রাসঙ্গিক কম্পোনেন্টের তালিকা:

Wear Compose Foundation 1.7.1
androidx.wear.compose.foundation.hierarchicalFocusGroup অ্যাপ্লিকেশনে কম্পোজ করার উপযুক্ত আইটেম অ্যানোটেট করতে, কম্পোজিশনের অ্যাক্টিভ অংশের ট্র্যাক রাখতে এবং ফোকাস সমন্বয় করতে ব্যবহার করা হয়।
androidx.wear.compose.foundation.pager.HorizontalPager একটি অনুভূমিকভাবে স্ক্রোলিং পেজার, যা Wear-নির্দিষ্ট উন্নতির সাথে Compose Foundation কম্পোনেন্টের উপর তৈরি করা হয়েছে যাতে পারফর্ম্যান্স উন্নত করা যায় এবং Wear OS নির্দেশিকা মেনে চলা যায়।
androidx.wear.compose.foundation.pager.VerticalPager একটি উল্লম্বভাবে স্ক্রোলিং পেজার, যা Wear-নির্দিষ্ট উন্নতির সাথে Compose Foundation কম্পোনেন্টের উপর তৈরি করা হয়েছে যাতে পারফর্ম্যান্স উন্নত করা যায় এবং Wear OS নির্দেশিকা মেনে চলা যায়।
androidx.wear.compose.foundation.lazy.TransformingLazyColumn প্রতিটি আইটেমে স্ক্রল ট্রান্সফর্ম এফেক্ট যোগ করতে ScalingLazyColumn-এর পরিবর্তে ব্যবহার করা যেতে পারে।

বোতাম

M3-এর বোতাম M2.5-এর থেকে আলাদা। M2.5 চিপের পরিবর্তে বোতাম ব্যবহার করা হয়েছে। Button ইমপ্লিমেন্টেশন Text maxLines এবং textAlign-এর জন্য ডিফল্ট ভ্যালু প্রদান করে। Text এলিমেন্টে সেইসব ডিফল্ট ভ্যালু ওভাররাইড করা যেতে পারে।

M2.5

import androidx.wear.compose.material.Chip

//M2.5 Buttons
Chip(...)
CompactChip(...)
Button(...)

M3

//M3 Buttons
Button(onClick = { }){}
CompactButton(onClick = { }){}
IconButton(onClick = { }){}
TextButton(onClick = { }){}

M3-তে নতুন বোতামের ভেরিয়েশনও অন্তর্ভুক্ত আছে। Compose Material 3 API রেফারেন্স ওভারভিউ থেকে সেগুলি চেক করে দেখুন।

M3 একটি নতুন বোতাম নিয়ে এসেছে: EdgeButton। EdgeButton ৪টি আলাদা সাইজে উপলভ্য: অতিরিক্ত ছোট, ছোট, মাঝারি এবং বড়। EdgeButton ইমপ্লিমেন্টেশন সাইজের উপর নির্ভর করে maxLines-এর জন্য একটি ডিফল্ট ভ্যালু প্রদান করে যা কাস্টমাইজ করা যেতে পারে।

আপনি TransformingLazyColumn বা ScalingLazyColumn ব্যবহার করলে, EdgeButton-কে ScreenScaffold-এ পাস করুন যাতে এটি স্ক্রল করার সাথে সাথে নিজের আকার পরিবর্তন করে, চূড়ান্ত তালিকা আইটেম হিসেবে EdgeButton যোগ করার পরিবর্তে। ScreenScaffold ও TransformingLazyColumn-এর সাথে EdgeButton কীভাবে ব্যবহার করতে হয় তা চেক করতে নিম্নলিখিত কোড দেখুন।

val state = rememberTransformingLazyColumnState()
ScreenScaffold(
    scrollState = state,
    edgeButton = {
        EdgeButton(
            onClick = { },
            modifier = Modifier.scrollable(
                state,
                orientation = Orientation.Vertical,
                reverseDirection = true,
                // Apply overscroll to the EdgeButton for proper scrolling behavior.
                overscrollEffect = rememberOverscrollEffect(),
            ),
        ) {
            Text(stringResource(R.string.show))
        }
    },
) { contentPadding ->
    TransformingLazyColumn(state = state, contentPadding = contentPadding) {
        // additional code here
        // ...
    }
}

ভারা

M3-তে স্ক্যাফোল্ড M2.5-এর থেকে আলাদা। M3-তে, AppScaffold এবং নতুন ScreenScaffold কম্পোজেবল Scaffold-কে রিপ্লেস করেছে। AppScaffold এবং ScreenScaffold স্ক্রিনের স্ট্রাকচার লে-আউট করে এবং ScrollIndicator ও TimeText কম্পোনেন্টের ট্রানজিশন কোঅর্ডিনেট করে।

AppScaffold, TimeText-এর মতো স্ট্যাটিক স্ক্রিন এলিমেন্টকে সোয়াইপ-টু-ডিসমিসের মতো ইন-অ্যাপ ট্রানজিশনের সময় দৃশ্যমান থাকতে দেয়। এটি মূল অ্যাপ্লিকেশন কন্টেন্টের জন্য একটি স্লট প্রদান করে, যা সাধারণত SwipeDismissableNavHost-এর মতো একটি নেভিগেশন কম্পোনেন্ট দ্বারা সরবরাহ করা হবে

আপনি অ্যাক্টিভিটির জন্য একটি AppScaffold ঘোষণা করেন এবং প্রতিটি স্ক্রিনের জন্য একটি ScreenScaffold ব্যবহার করেন। AppScaffold স্ক্রিনে ডিফল্ট TimeTextকম্পোনেন্ট যোগ করে। আপনি timeText প্যারামিটার ব্যবহার করে কাস্টমাইজ করতে চাইলে, এটি ওভাররাইড করতে পারবেন।

M2.5

import androidx.wear.compose.material.Scaffold

Scaffold {...}

M3

    AppScaffold {
        val navController = rememberSwipeDismissableNavController()
        SwipeDismissableNavHost(
            navController = navController,
            startDestination = "message_list"
        ) {
            composable("message_list") {
                MessageList(onMessageClick = { id ->
                    navController.navigate("message_detail/$id")
                })
            }
            composable("message_detail/{id}") {
                MessageDetail(id = it.arguments?.getString("id")!!)
            }
        }
    }
}

// Implementation of one of the screens in the navigation
@Composable
fun MessageDetail(id: String) {
    // .. Screen level content goes here
    val scrollState = rememberTransformingLazyColumnState()
    val transformationSpec = rememberTransformationSpec()

    ScreenScaffold(
        scrollState = scrollState,
    ) { contentPadding ->
        // Screen content goes here
        // ...

আপনি HorizontalPageIndicator-এর সাথে HorizontalPager ব্যবহার করলে, HorizontalPagerScaffold-এ মাইগ্রেট করতে পারবেন। HorizontalPagerScaffold AppScaffold-এর মধ্যে রাখা হয়েছে। AppScaffold এবং HorizontalPagerScaffold পেজারের স্ট্রাকচার লে-আউট করে এবং HorizontalPageIndicator ও TimeText কম্পোনেন্টের ট্রানজিশন কোঅর্ডিনেট করে।

HorizontalPagerScaffold ডিফল্ট হিসেবে স্ক্রিনের সেন্টার-এন্ডে HorizontalPageIndicator দেখায় এবং Pager-এর পেজ করা হচ্ছে কিনা তার উপর নির্ভর করে TimeText ও HorizontalPageIndicator দেখানো ও লুকানো সমন্বয় করে, এটি PagerState-এর মাধ্যমে নির্ধারণ করা হয়।

এছাড়াও, একটি নতুন AnimatedPage কম্পোনেন্ট আছে, যা পেজারের মধ্যে কোনও পৃষ্ঠাকে অ্যানিমেট করে। এটির পজিশনের উপর ভিত্তি করে স্কেলিং ও স্ক্রিম এফেক্ট সহ এটি করা হয়।

AppScaffold {
    val pagerState = rememberPagerState(pageCount = { 10 })

    HorizontalPagerScaffold(pagerState = pagerState) {
        HorizontalPager(
            state = pagerState,
            flingBehavior =
                PagerScaffoldDefaults.snapWithSpringFlingBehavior(
                    state = pagerState
                ),
        ) { page ->
            AnimatedPage(pageIndex = page, pagerState = pagerState) {
                val columnState = rememberTransformingLazyColumnState()
                val transformationSpec = rememberTransformationSpec()

                ScreenScaffold(
                    scrollState = columnState,
                ) { contentPadding ->
                    TransformingLazyColumn(
                        state = columnState,
                        contentPadding = contentPadding,
                    ) {
                        item {
                            ListHeader(
                                modifier = Modifier
                                    .fillMaxWidth()
                                    .transformedHeight(this, transformationSpec)
                                    .minimumVerticalContentPadding(
                                        ListHeaderDefaults.minimumTopListContentPadding
                                    ),
                                transformation = SurfaceTransformation(transformationSpec),
                            ) {
                                Text(text = "Pager sample")
                            }
                        }
                        item {
                            Card(
                                modifier = Modifier
                                    .fillMaxWidth()
                                    .transformedHeight(this, transformationSpec)
                                    .minimumVerticalContentPadding(
                                        CardDefaults.minimumVerticalListContentPadding
                                    ),
                                transformation = SurfaceTransformation(transformationSpec),
                            ) {
                                if (page == 0) {
                                    Text(text = "Page #$page. Swipe right")
                                } else {
                                    Text(text = "Page #$page. Swipe left and right")
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}

অবশেষে, M3 একটি VerticalPagerScaffold প্রবর্তন করে যা HorizontalPagerScaffold-এর মতো একই প্যাটার্ন অনুসরণ করে:

@Composable
fun VerticalPagerScaffoldSample() {
    AppScaffold {
        val pagerState = rememberPagerState(pageCount = { 10 })

        VerticalPagerScaffold(pagerState = pagerState) {
            VerticalPager(
                state = pagerState,
                flingBehavior =
                    PagerScaffoldDefaults.snapWithSpringFlingBehavior(
                        state = pagerState
                    ),
            ) { page ->
                AnimatedPage(pageIndex = page, pagerState = pagerState) {
                    ScreenScaffold {
                        Column(
                            modifier = Modifier.fillMaxSize(),
                            horizontalAlignment = Alignment.CenterHorizontally,
                            verticalArrangement = Arrangement.Center,
                        ) {
                            Text(text = "Page #$page")
                            Spacer(modifier = Modifier.height(8.dp))
                            Text(text = "Swipe up and down")
                        }
                    }
                }
            }
        }
    }
}

প্লেসহোল্ডার

M2.5 এবং M3-এর মধ্যে কিছু API পরিবর্তন আছে। M3 দুটি প্লেসহোল্ডার মডিফায়ার প্রদান করে:

  • Modifier.placeholder, যা এখনও লোড না হওয়া কন্টেন্টের পরিবর্তে আঁকা হয়
  • একটি প্লেসহোল্ডার শিমার এফেক্ট Modifier.placeholderShimmer যা একটি প্লেসহোল্ডার শিমার এফেক্ট প্রদান করে যা ডেটা লোড হওয়ার জন্য অপেক্ষা করার সময় একটি অ্যানিমেশন লুপে চলে।

Placeholder কম্পোনেন্টে অতিরিক্ত পরিবর্তন সম্পর্কে জানতে নিম্নলিখিত টেবিল দেখুন।

M2.5 M3
PlaceholderState.startPlaceholderAnimation সরিয়ে দেওয়া হয়েছে
PlaceholderState.placeholderProgression সরিয়ে দেওয়া হয়েছে
PlaceholderState.isShowContent PlaceholderState.isVisible (ইনভার্টেড বুলিয়ান) দ্বারা প্রতিস্থাপিত হয়েছে
PlaceholderState.isWipeOff সরিয়ে দেওয়া হয়েছে
PlaceholderDefaults.painterWithPlaceholderOverlayBackgroundBrush সরিয়ে দেওয়া হয়েছে
PlaceholderDefaults.placeholderBackgroundBrush সরিয়ে দেওয়া হয়েছে
PlaceholderDefaults.placeholderChipColors সরিয়ে দেওয়া হয়েছে

SwipeDismissableNavHost

SwipeDismissableNavHost হল wear.compose.navigation-এর অংশ। M3-এর সাথে এই কম্পোনেন্ট ব্যবহার করা হলে, M3 MaterialTheme LocalSwipeToDismissBackgroundScrimColor এবং LocalSwipeToDismissContentScrimColor আপডেট করে।

TransformingLazyColumn

TransformingLazyColumn হল androidx.wear.compose.foundation.lazy-এর অংশ এবং স্ক্রল করার সময় তালিকার আইটেমে স্কেলিং ও মর্ফিং অ্যানিমেশনের জন্য সহায়তা যোগ করে, ব্যবহারকারীর অভিজ্ঞতা উন্নত করে। অ্যাপকে ScalingLazyColumn থেকে TransformingLazyColumn-এ মাইগ্রেট করার জন্য বিশেষভাবে সাজেস্ট করা হচ্ছে।

ScalingLazyColumn-এর মতোই, এটি rememberTransformingLazyColumnState() প্রদান করে যাতে এমন একটি TransformingLazyColumnState তৈরি করা যায় যা কম্পোজিশন জুড়ে মনে রাখা হয়।

স্কেলিং ও মর্ফিং অ্যানিমেশন যোগ করতে, প্রতিটি তালিকা আইটেমে নিম্নলিখিতগুলি যোগ করুন:

  • Modifier.transformedHeight, যা আপনাকে TransformationSpec ব্যবহার করে আইটেমের পরিবর্তিত উচ্চতা গণনা করতে দেয়, আপনি rememberTransformationSpec() ব্যবহার করতে পারেন, যদি না আপনার আরও কাস্টমাইজেশনের প্রয়োজন হয়।
  • SurfaceTransformation

তালিকার উপরে ও নিচে প্যাডিং সঠিক আছে কিনা তা যাচাই করতে, minimumVerticalContentPadding মডিফায়ার ব্যবহার করুন।

val columnState = rememberTransformingLazyColumnState()
val transformationSpec = rememberTransformationSpec()
ScreenScaffold(
    scrollState = columnState
) { contentPadding ->
    TransformingLazyColumn(
        state = columnState,
        contentPadding = contentPadding
    ) {
        item {
            ListHeader(
                modifier = Modifier
                    .fillMaxWidth()
                    .transformedHeight(this, transformationSpec)
                    .minimumVerticalContentPadding(ListHeaderDefaults.minimumTopListContentPadding),
                transformation = SurfaceTransformation(transformationSpec)
            ) {
                Text(text = "Header")
            }
        }
        // ... other items
        item {
            Button(
                modifier = Modifier
                    .fillMaxWidth()
                    .transformedHeight(this, transformationSpec)
                    .minimumVerticalContentPadding(ButtonDefaults.minimumVerticalListContentPadding),
                transformation = SurfaceTransformation(transformationSpec),
                onClick = { /* ... */ },
                icon = {
                    Icon(
                        imageVector = Icons.Default.Build,
                        contentDescription = "build",
                    )
                },
            ) {
                Text(
                    text = "Build",
                    maxLines = 1,
                    overflow = TextOverflow.Ellipsis,
                )
            }
        }
    }
}

Compose-এ M2.5 থেকে M3-তে মাইগ্রেট করার ব্যাপারে আরও জানতে, নিম্নলিখিত অতিরিক্ত রিসোর্স দেখুন।

নমুনা

API রেফারেন্স ও সোর্স কোড

ডিজাইন