मटीरियल डिज़ाइन 3 मटीरियल डिज़ाइन का अगला डेवलपमेंट है. इसमें अपडेट की गई थीम, कॉम्पोनेंट, और Material You की मनमुताबिक बनाने की सुविधाएं शामिल हैं. जैसे, डाइनैमिक कलर. यह मटीरियल डिज़ाइन 2 का अपडेट है और Android 12 और उसके बाद वाले वर्शन के लिए, नए विज़ुअल स्टाइल और सिस्टम यूज़र इंटरफ़ेस (यूआई) के साथ मेल खाता है.
इस गाइड में, Compose Material (androidx.compos.material) Jetpack लाइब्रेरी से Compose Material 3 (androidx.compos.material3) Jetpack लाइब्रेरी में माइग्रेट करने पर फ़ोकस किया गया है.
तरीके
आम तौर पर, आपको किसी एक ऐप्लिकेशन में लंबे समय तक M2 और M3, दोनों का इस्तेमाल नहीं करना चाहिए. ऐसा इसलिए है, क्योंकि दोनों डिज़ाइन सिस्टम और उनसे जुड़ी लाइब्रेरी, उनके UX/यूज़र इंटरफ़ेस (यूआई) के डिज़ाइन और Compose को लागू करने की प्रोसेस के हिसाब से काफ़ी अलग-अलग हैं.
आपका ऐप्लिकेशन किसी डिज़ाइन सिस्टम का इस्तेमाल कर सकता है. जैसे, Figma का इस्तेमाल करके बनाया गया सिस्टम. ऐसे मामलों में, हमारा सुझाव है कि आप या आपका डिज़ाइन टीम, Compose माइग्रेशन शुरू करने से पहले, इसे M2 से M3 पर माइग्रेट कर लें. अगर किसी ऐप्लिकेशन का UX/यूज़र इंटरफ़ेस (यूआई) डिज़ाइन M2 पर आधारित है, तो उस ऐप्लिकेशन को M3 पर माइग्रेट करने का कोई मतलब नहीं.
इसके अलावा, आपके ऐप्लिकेशन के साइज़, जटिलता, और यूएक्स/यूआई डिज़ाइन के आधार पर, माइग्रेशन का तरीका अलग-अलग होना चाहिए. ऐसा करने से, कोडबेस पर पड़ने वाले असर को कम करने में मदद मिलती है. माइग्रेशन के लिए, आपको अलग-अलग चरणों को पूरा करना चाहिए.
कब माइग्रेट करें
आपको जल्द से जल्द माइग्रेशन शुरू करना चाहिए. हालांकि, यह ध्यान रखना ज़रूरी है कि आपका ऐप्लिकेशन, M2 से M3 पर पूरी तरह माइग्रेट करने की स्थिति में है या नहीं. शुरू करने से पहले, ब्लॉक करने से जुड़ी कुछ स्थितियों की जांच करना ज़रूरी है:
स्थिति | सुझाया गया तरीका |
---|---|
कोई ब्लॉकर नहीं | चरणों में माइग्रेशन शुरू करना |
M2 का कोई कॉम्पोनेंट, M3 में अभी उपलब्ध नहीं है. नीचे कॉम्पोनेंट और लेआउट सेक्शन देखें. | चरणों में माइग्रेशन शुरू करना |
आपने या आपके डिज़ाइन टीम ने ऐप्लिकेशन के डिज़ाइन सिस्टम को M2 से M3 पर माइग्रेट नहीं किया है | डिज़ाइन सिस्टम को M2 से M3 पर माइग्रेट करें. इसके बाद, चरणों में माइग्रेशन शुरू करें |
भले ही, आप पर ऊपर बताई गई स्थितियों का असर पड़ा हो, लेकिन ऐप्लिकेशन के अपडेट को रिलीज़ करने से पहले, आपको माइग्रेशन के लिए धीरे-धीरे आगे बढ़ना चाहिए. ऐसे मामलों में, आपको M2 और M3 का एक साथ इस्तेमाल करना होगा. साथ ही, M3 पर माइग्रेट करते समय, M2 को धीरे-धीरे बंद करना होगा.
चरणबद्ध तरीका
धीरे-धीरे माइग्रेट करने का सामान्य तरीका यहां बताया गया है:
- M2 डिपेंडेंसी के साथ-साथ M3 डिपेंडेंसी जोड़ें.
- अपने ऐप्लिकेशन की थीम के M2 वर्शन के साथ-साथ, M3 वर्शन भी जोड़ें.
- अपने ऐप्लिकेशन के साइज़ और जटिलता के आधार पर, अलग-अलग मॉड्यूल, स्क्रीन या कॉम्पोज़ेबल को M3 पर माइग्रेट करें. ज़्यादा जानकारी के लिए, नीचे दिए गए सेक्शन देखें.
- पूरी तरह से माइग्रेट होने के बाद, अपने ऐप्लिकेशन की थीम के M2 वर्शन हटा दें.
- M2 डिपेंडेंसी हटाएं.
डिपेंडेंसी
M3 का M2 से अलग पैकेज और वर्शन भी है:
M2
implementation "androidx.compose.material:material:$m2-version"
M3
implementation "androidx.compose.material3:material3:$m3-version"
Compose Material 3 रिलीज़ पेज पर, M3 के नए वर्शन देखें.
मुख्य M2 और M3 लाइब्रेरी के बाहर मौजूद अन्य मटीरियल डिपेंडेंसी में कोई बदलाव नहीं हुआ है. वे M2 और M3 पैकेज और वर्शन का इस्तेमाल करते हैं. हालांकि, इससे माइग्रेशन पर कोई असर नहीं पड़ता. इन्हें M3 के साथ ऐसे ही इस्तेमाल किया जा सकता है:
लाइब्रेरी | पैकेज और वर्शन |
---|---|
मटीरियल आइकॉन लिखना | androidx.compose.material:material-icons-*:$m2-version |
मटीरियल रिपल कंपोज़ करें | androidx.compose.material:material-ripple:$m2-version |
प्रयोग के लिए एपीआई
M3 के कुछ एपीआई को एक्सपेरिमेंट के तौर पर माना जाता है. ऐसे मामलों में, आपको ExperimentalMaterial3Api
ऐनोटेशन का इस्तेमाल करके, फ़ंक्शन या फ़ाइल लेवल पर ऑप्ट इन करना होगा:
import androidx.compose.material3.ExperimentalMaterial3Api
@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun AppComposable() {
// M3 composables
}
थीम बनाई जा रही है
M2 और M3, दोनों में थीम कंपोजबल का नाम MaterialTheme
है, लेकिन इंपोर्ट किए गए पैकेज और पैरामीटर अलग-अलग हैं:
M2
import androidx.compose.material.MaterialTheme
MaterialTheme(
colors = AppColors,
typography = AppTypography,
shapes = AppShapes
) {
// M2 content
}
M3
import androidx.compose.material3.MaterialTheme
MaterialTheme(
colorScheme = AppColorScheme,
typography = AppTypography,
shapes = AppShapes
) {
// M3 content
}
रंग
M3 का कलर सिस्टम, M2 से काफ़ी अलग है. कलर पैरामीटर की संख्या बढ़ गई है. साथ ही, उनके नाम अलग-अलग हैं और वे M3 कॉम्पोनेंट के साथ अलग तरीके से मैप होते हैं. Compose में, यह M2
Colors
क्लास, M3 ColorScheme
क्लास, और उनसे जुड़े फ़ंक्शन पर लागू होता है:
M2
import androidx.compose.material.lightColors
import androidx.compose.material.darkColors
val AppLightColors = lightColors(
// M2 light Color parameters
)
val AppDarkColors = darkColors(
// M2 dark Color parameters
)
val AppColors = if (darkTheme) {
AppDarkColors
} else {
AppLightColors
}
M3
import androidx.compose.material3.lightColorScheme
import androidx.compose.material3.darkColorScheme
val AppLightColorScheme = lightColorScheme(
// M3 light Color parameters
)
val AppDarkColorScheme = darkColorScheme(
// M3 dark Color parameters
)
val AppColorScheme = if (darkTheme) {
AppDarkColorScheme
} else {
AppLightColorScheme
}
M2 और M3 कलर सिस्टम के बीच काफ़ी अंतर है. इसलिए, Color
पैरामीटर के लिए कोई सही मैपिंग नहीं है. इसके बजाय, M3 कलर स्कीम जनरेट करने के लिए, Material थीम बिल्डर टूल का इस्तेमाल करें. टूल में M2 रंगों को कोर सोर्स रंगों के तौर पर इस्तेमाल करें. टूल, इन रंगों को टोनल पैलेट में बड़ा करता है, जिनका इस्तेमाल M3 कलर स्कीम में किया जाता है. शुरुआत के लिए, यहां दी गई मैपिंग का सुझाव दिया जाता है:
M2 | मटीरियल थीम बिल्डर |
---|---|
primary |
मुख्य |
primaryVariant |
Secondary |
secondary |
Tertiary |
surface या background |
ठीक-ठाक |
हल्के और गहरे रंग वाली थीम के लिए, टूल से रंग की हेक्स कोड की वैल्यू कॉपी की जा सकती हैं. साथ ही, M3 ColorScheme इंस्टेंस को लागू करने के लिए भी इनका इस्तेमाल किया जा सकता है. इसके अलावा, मटीरियल थीम बिल्डर, कंपोज़ कोड को भी एक्सपोर्ट कर सकता है.
isLight
M2 Colors
क्लास के उलट, M3 ColorScheme
क्लास में isLight
पैरामीटर शामिल नहीं होता. आम तौर पर, आपको थीम लेवल पर इस जानकारी की ज़रूरत होती है. उदाहरण के लिए:
M2
import androidx.compose.material.lightColors
import androidx.compose.material.darkColors
import androidx.compose.material.MaterialTheme
@Composable
private fun AppTheme(
darkTheme: Boolean = isSystemInDarkTheme(),
content: @Composable () -> Unit
) {
val colors = if (darkTheme) darkColors(…) else lightColors(…)
MaterialTheme(
colors = colors,
content = content
)
}
@Composable
fun AppComposable() {
AppTheme {
val cardElevation = if (MaterialTheme.colors.isLight) 0.dp else 4.dp
…
}
}
M3
import androidx.compose.material3.lightColorScheme
import androidx.compose.material3.darkColorScheme
import androidx.compose.material3.MaterialTheme
val LocalCardElevation = staticCompositionLocalOf { Dp.Unspecified }
@Composable
private fun AppTheme(
darkTheme: Boolean = isSystemInDarkTheme(),
content: @Composable () -> Unit
) {
val cardElevation = if (darkTheme) 4.dp else 0.dp
CompositionLocalProvider(LocalCardElevation provides cardElevation) {
val colorScheme = if (darkTheme) darkColorScheme(…) else lightColorScheme(…)
MaterialTheme(
colorScheme = colorScheme,
content = content
)
}
}
@Composable
fun AppComposable() {
AppTheme {
val cardElevation = LocalCardElevation.current
…
}
}
ज़्यादा जानकारी के लिए, Compose में कस्टम डिज़ाइन सिस्टम बनाने के बारे में गाइड देखें.
डाइनैमिक कलर
M3 में एक नई सुविधा डाइनैमिक कलर है. M3 ColorScheme
में पसंद के मुताबिक रंगों का इस्तेमाल करने के बजाय, Android 12 और इसके बाद के वर्शन वाले डिवाइसों पर, डिवाइस के वॉलपेपर के कलर का इस्तेमाल किया जा सकता है. इसके लिए, ये फ़ंक्शन इस्तेमाल किए जा सकते हैं:
मुद्रण कला
M3 में टाइपोग्राफ़ी सिस्टम, M2 से अलग है. टाइपोग्राफ़ी पैरामीटर की संख्या लगभग एक जैसी है, लेकिन उनके नाम अलग-अलग हैं और वे M3 कॉम्पोनेंट के साथ अलग तरह से मैप होते हैं. Compose में, यह M2
Typography
क्लास और M3 Typography
क्लास पर लागू होता है:
M2
import androidx.compose.material.Typography
val AppTypography = Typography(
// M2 TextStyle parameters
)
M3
import androidx.compose.material3.Typography
val AppTypography = Typography(
// M3 TextStyle parameters
)
शुरुआत के लिए, इन TextStyle
पैरामीटर मैपिंग का सुझाव दिया जाता है:
M2 | M3 |
---|---|
h1 |
displayLarge |
h2 |
displayMedium |
h3 |
displaySmall |
लागू नहीं | headlineLarge |
h4 |
headlineMedium |
h5 |
headlineSmall |
h6 |
titleLarge |
subtitle1 |
titleMedium |
subtitle2 |
titleSmall |
body1 |
bodyLarge |
body2 |
bodyMedium |
caption |
bodySmall |
button |
labelLarge |
लागू नहीं | labelMedium |
overline |
labelSmall |
आकार
M3 में आकार का सिस्टम, M2 से अलग है. शेप पैरामीटर की संख्या बढ़ गई है. साथ ही, इनका नाम अलग है और ये M3 कॉम्पोनेंट के साथ अलग तरीके से मैप होते हैं. Compose में, यह M2 Shapes
क्लास और M3 Shapes
क्लास पर लागू होता है:
M2
import androidx.compose.material.Shapes
val AppShapes = Shapes(
// M2 Shape parameters
)
M3
import androidx.compose.material3.Shapes
val AppShapes = Shapes(
// M3 Shape parameters
)
शुरुआती पॉइंट के तौर पर, यहां दी गई Shape
पैरामीटर मैपिंग का सुझाव दिया जाता है:
M2 | M3 |
---|---|
लागू नहीं | extraSmall |
small |
small |
medium |
medium |
large |
large |
लागू नहीं | extraLarge |
कॉम्पोनेंट और लेआउट
M2 के ज़्यादातर कॉम्पोनेंट और लेआउट, M3 में उपलब्ध हैं. हालांकि, कुछ कुछ नए प्रॉडक्ट भी मौजूद नहीं हैं, जो M2 में मौजूद नहीं थे. इसके अलावा, M3 के कुछ कॉम्पोनेंट में, M2 के उन कॉम्पोनेंट के मुकाबले ज़्यादा वैरिएंट होते हैं. आम तौर पर, M3 एपीआई के प्लैटफ़ॉर्म, M2 में मौजूद मिलते-जुलते प्लैटफ़ॉर्म से ज़्यादा से ज़्यादा मिलते-जुलते होते हैं.
अपडेट किए गए कलर, टाइपोग्राफ़ी, और शेप सिस्टम के हिसाब से, M3 कॉम्पोनेंट, थीम की नई वैल्यू के साथ अलग तरह से मैप होते हैं. इन मैपिंग के सटीक होने की पुष्टि करने के लिए, Compose Material 3 के सोर्स कोड में टोकन डायरेक्ट्री देखना अच्छा होता है.
कुछ कॉम्पोनेंट के लिए खास बातों का ध्यान रखना ज़रूरी होता है. हालांकि, शुरुआत करने के लिए, यहां दी गई फ़ंक्शन मैपिंग का सुझाव दिया जाता है:
एपीआई मौजूद नहीं हैं:
M2 | M3 |
---|---|
androidx.compose.material.swipeable |
फ़िलहाल उपलब्ध नहीं है |
बदले गए एपीआई:
M2 | M3 |
---|---|
androidx.compose.material.BackdropScaffold |
M3 के बराबर कोई वैल्यू नहीं है. इसके बजाय, Scaffold या BottomSheetScaffold पर माइग्रेट करें |
androidx.compose.material.BottomDrawer |
M3 के बराबर कोई वैल्यू नहीं है. इसके बजाय, ModalBottomSheet पर माइग्रेट करें |
नाम बदले गए एपीआई:
अन्य सभी एपीआई:
Compose Material 3 API के रेफ़रंस की खास जानकारी में जाकर, M3 के नए कॉम्पोनेंट और लेआउट देखें. साथ ही, नए और अपडेट किए गए एपीआई के लिए, रिलीज़ पेज पर नज़र रखें.
स्कैफ़ोल्ड, स्नैकबार, और नेविगेशन पैनल
M3 में स्कैफ़ोल्ड, M2 से अलग है. M2 और M3 दोनों में, मुख्य लेआउट कंपोज़ेबल का नाम Scaffold
होता है, लेकिन इंपोर्ट पैकेज और पैरामीटर अलग-अलग होते हैं:
M2
import androidx.compose.material.Scaffold
Scaffold(
// M2 scaffold parameters
)
M3
import androidx.compose.material3.Scaffold
Scaffold(
// M3 scaffold parameters
)
M2 Scaffold
में मौजूद backgroundColor
पैरामीटर का नाम अब M3 Scaffold
में containerColor
हो गया है:
M2
import androidx.compose.material.Scaffold
Scaffold(
backgroundColor = …,
content = { … }
)
M3
import androidx.compose.material3.Scaffold
Scaffold(
containerColor = …,
content = { … }
)
M2 ScaffoldState
क्लास अब M3 में मौजूद नहीं है, क्योंकि इसमें एक ऐसा drawerState
पैरामीटर है जिसकी अब ज़रूरत नहीं है. M3 Scaffold
के साथ स्नैकबार दिखाने के लिए, इसके बजाय SnackbarHostState
का इस्तेमाल करें:
M2
import androidx.compose.material.Scaffold
import androidx.compose.material.rememberScaffoldState
val scaffoldState = rememberScaffoldState()
val scope = rememberCoroutineScope()
Scaffold(
scaffoldState = scaffoldState,
content = {
…
scope.launch {
scaffoldState.snackbarHostState.showSnackbar(…)
}
}
)
M3
import androidx.compose.material3.Scaffold
import androidx.compose.material3.SnackbarHost
import androidx.compose.material3.SnackbarHostState
val snackbarHostState = remember { SnackbarHostState() }
val scope = rememberCoroutineScope()
Scaffold(
snackbarHost = { SnackbarHost(snackbarHostState) },
content = {
…
scope.launch {
snackbarHostState.showSnackbar(…)
}
}
)
M2 Scaffold
के सभी drawer*
पैरामीटर, M3 Scaffold
से हटा दिए गए हैं. इनमें drawerShape
और
drawerContent
जैसे पैरामीटर शामिल हैं. अगर आपको M3 Scaffold
वाला एक पैनल दिखाना है, तो नेविगेशन पैनल के कंपोज़ेबल का इस्तेमाल करें, जैसे कि ModalNavigationDrawer
. इसके लिए, यह तरीका अपनाएं:
M2
import androidx.compose.material.DrawerValue
import
import androidx.compose.material.Scaffold
import androidx.compose.material.rememberDrawerState
import androidx.compose.material.rememberScaffoldState
val scaffoldState = rememberScaffoldState(
drawerState = rememberDrawerState(DrawerValue.Closed)
)
val scope = rememberCoroutineScope()
Scaffold(
scaffoldState = scaffoldState,
drawerContent = { … },
drawerGesturesEnabled = …,
drawerShape = …,
drawerElevation = …,
drawerBackgroundColor = …,
drawerContentColor = …,
drawerScrimColor = …,
content = {
…
scope.launch {
scaffoldState.drawerState.open()
}
}
)
M3
import androidx.compose.material3.DrawerValue
import androidx.compose.material3.ModalDrawerSheet
import androidx.compose.material3.ModalNavigationDrawer
import androidx.compose.material3.Scaffold
import androidx.compose.material3.rememberDrawerState
val drawerState = rememberDrawerState(DrawerValue.Closed)
val scope = rememberCoroutineScope()
ModalNavigationDrawer(
drawerState = drawerState,
drawerContent = {
ModalDrawerSheet(
drawerShape = …,
drawerTonalElevation = …,
drawerContainerColor = …,
drawerContentColor = …,
content = { … }
)
},
gesturesEnabled = …,
scrimColor = …,
content = {
Scaffold(
content = {
…
scope.launch {
drawerState.open()
}
}
)
}
)
टॉप ऐप्लिकेशन बार
M3 में टॉप ऐप्लिकेशन बार, M2 में मौजूद टॉप ऐप्लिकेशन बार से अलग होते हैं. M2 और M3, दोनों में सबसे ऊपर मौजूद ऐप्लिकेशन बार के मुख्य कॉम्पोज़ेबल का नाम TopAppBar
है. हालांकि, इंपोर्ट किए गए पैकेज और पैरामीटर अलग-अलग हैं:
M2
import androidx.compose.material.TopAppBar
TopAppBar(…)
M3
import androidx.compose.material3.TopAppBar
TopAppBar(…)
अगर पहले M2 TopAppBar
में कॉन्टेंट को बीच में रखा जाता था, तो अब M3 CenterAlignedTopAppBar
का इस्तेमाल करें. MediumTopAppBar
और LargeTopAppBar
के बारे में भी जानना अच्छा होता है.
सबसे ऊपर मौजूद M3 ऐप्लिकेशन बार में एक नया scrollBehavior
पैरामीटर शामिल होता है. यह TopAppBarScrollBehavior
क्लास में स्क्रोल करने पर अलग-अलग फ़ंक्शन उपलब्ध कराता है, जैसे कि ऊंचाई में बदलाव करना. यह सुविधा, Modifer.nestedScroll
की मदद से स्क्रोल किए जा रहे कॉन्टेंट के साथ काम करती है. elevation
पैरामीटर को मैन्युअल तरीके से बदलने पर, M2 TopAppBar
में ऐसा किया जा सकता था:
M2
import androidx.compose.material.AppBarDefaults
import androidx.compose.material.Scaffold
import androidx.compose.material.TopAppBar
val state = rememberLazyListState()
val isAtTop by remember {
derivedStateOf {
state.firstVisibleItemIndex == 0 && state.firstVisibleItemScrollOffset == 0
}
}
Scaffold(
topBar = {
TopAppBar(
elevation = if (isAtTop) {
0.dp
} else {
AppBarDefaults.TopAppBarElevation
},
…
)
},
content = {
LazyColumn(state = state) { … }
}
)
M3
import androidx.compose.material3.Scaffold
import androidx.compose.material3.TopAppBar
import androidx.compose.material3.TopAppBarDefaults
val scrollBehavior = TopAppBarDefaults.pinnedScrollBehavior()
Scaffold(
modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),
topBar = {
TopAppBar(
scrollBehavior = scrollBehavior,
…
)
},
content = {
LazyColumn { … }
}
)
बॉटम नेविगेशन / नेविगेशन बार
M2 में बॉटम नेविगेशन को M3 में नेविगेशन बार नाम दिया गया है. M2 में BottomNavigation
और
BottomNavigationItem
कॉम्पोज़ेबल हैं, जबकि M3 में
NavigationBar
और NavigationBarItem
कॉम्पोज़ेबल हैं:
M2
import androidx.compose.material.BottomNavigation
import androidx.compose.material.BottomNavigationItem
BottomNavigation {
BottomNavigationItem(…)
BottomNavigationItem(…)
BottomNavigationItem(…)
}
M3
import androidx.compose.material3.NavigationBar
import androidx.compose.material3.NavigationBarItem
NavigationBar {
NavigationBarItem(…)
NavigationBarItem(…)
NavigationBarItem(…)
}
बटन, आइकॉन बटन, और फ़्लाइंग ऐक्शन बटन
M3 में मौजूद बटन, आइकॉन बटन, और फ़्लोटिंग ऐक्शन बटन (एफ़एबी), M2 वाले वर्शन से अलग हैं. M3 में M2 बटन के सभी कंपोज़ेबल शामिल हैं:
M2
import androidx.compose.material.Button
import androidx.compose.material.ExtendedFloatingActionButton
import androidx.compose.material.FloatingActionButton
import androidx.compose.material.IconButton
import androidx.compose.material.IconToggleButton
import androidx.compose.material.OutlinedButton
import androidx.compose.material.TextButton
// M2 buttons
Button(…)
OutlinedButton(…)
TextButton(…)
// M2 icon buttons
IconButton(…)
IconToggleButton(…)
// M2 FABs
FloatingActionButton(…)
ExtendedFloatingActionButton(…)
M3
import androidx.compose.material3.Button
import androidx.compose.material3.ExtendedFloatingActionButton
import androidx.compose.material3.FloatingActionButton
import androidx.compose.material3.IconButton
import androidx.compose.material3.IconToggleButton
import androidx.compose.material3.OutlinedButton
import androidx.compose.material3.TextButton
// M3 buttons
Button(…)
OutlinedButton(…)
TextButton(…)
// M3 icon buttons
IconButton(…)
IconToggleButton(…)
// M3 FABs
FloatingActionButton(…)
ExtendedFloatingActionButton(…)
M3 में नए बटन वैरिएंट भी शामिल हैं. Compose Material 3 API के रेफ़रंस की खास जानकारी पर जाकर, इनके बारे में जानें.
स्विच करें
M3 में स्विच, M2 से अलग है. M2 और M3, दोनों में स्विच
कंपोज़ेबल का नाम Switch
है, लेकिन इंपोर्ट पैकेज अलग-अलग हैं:
M2
import androidx.compose.material.Switch
Switch(…)
M3
import androidx.compose.material3.Switch
Switch(…)
सतह और ऊंचाई
M3 में, सतह और ऊंचाई के सिस्टम, M2 से अलग हैं. M3 में दो तरह की चढ़ाई है:
- शैडो एलिवेशन (M2 की तरह ही परछाई डालता है)
- टोनल एलिवेशन (एक रंग को ओवरले करता है, M3 से नया)
'लिखें' विकल्प में, यह M2 Surface
फ़ंक्शन और M3
Surface
फ़ंक्शन पर लागू होता है:
M2
import androidx.compose.material.Surface
Surface(
elevation = …
) { … }
M3
import androidx.compose.material3.Surface
Surface(
shadowElevation = …,
tonalElevation = …
) { … }
UX/यूज़र इंटरफ़ेस (यूआई) डिज़ाइन की प्राथमिकता के आधार पर, M3 में shadowElevation
और/या tonalElevation
, दोनों के लिए M2 में elevation
Dp
वैल्यू का इस्तेमाल किया जा सकता है.
Surface
, ज़्यादातर कॉम्पोनेंट के पीछे मौजूद बैकिंग कॉम्पोज़ेबल है. इसलिए, कॉम्पोनेंट कॉम्पोज़ेबल भी एलिवेशन पैरामीटर दिखा सकते हैं. आपको इन्हें उसी तरह माइग्रेट करना होगा.
M3 में टोनल एलिवेशन, M2 की डार्क थीम में एलिवेशन ओवरले के कॉन्सेप्ट की जगह लेता है . इस वजह से, ElevationOverlay
और LocalElevationOverlay
, M3 में मौजूद नहीं हैं. साथ ही, M2 में मौजूद LocalAbsoluteElevation
को M3 में बदलकर LocalAbsoluteTonalElevation
कर दिया गया है.
हाइलाइट और कॉन्टेंट ऐल्फ़ा
M3 में, M2 से काफ़ी अलग फ़ोकस है. M2 में, टेक्स्ट और आइकॉन जैसे कॉन्टेंट में अंतर करने के लिए, कुछ अल्फा वैल्यू के साथ चालू रंगों का इस्तेमाल किया गया है. M3 में, अब कुछ अलग तरीके हैं:
- बड़े किए गए M3 कलर सिस्टम के वैरिएंट ऑन कलर के साथ-साथ ऑन कलर का इस्तेमाल करना.
- टेक्स्ट के लिए अलग-अलग फ़ॉन्ट वेट का इस्तेमाल करना.
इस वजह से, ContentAlpha
और LocalContentAlpha
M3 में नहीं हैं और इन्हें बदलना होगा.
शुरुआत के लिए, इन मैपिंग का सुझाव दिया जाता है:
M2 | M3 |
---|---|
ContentAlpha.high वाला onSurface |
onSurface आम तौर पर, टेक्स्ट के लिए FontWeight.Medium - FontWeight.Black |
ContentAlpha.medium वाला onSurface |
onSurfaceVariant आम तौर पर, टेक्स्ट के लिए FontWeight.Thin - FontWeight.Normal |
ContentAlpha.disabled वाला onSurface |
onSurface.copy(alpha = 0.38f) |
यहां M2 बनाम M3 में आइकॉन पर ज़ोर देने का उदाहरण दिया गया है:
M2
import androidx.compose.material.ContentAlpha
import androidx.compose.material.LocalContentAlpha
// High emphasis
CompositionLocalProvider(LocalContentAlpha provides ContentAlpha.high) {
Icon(…)
}
// Medium emphasis
CompositionLocalProvider(LocalContentAlpha provides ContentAlpha.medium) {
Icon(…)
}
// Disabled emphasis
CompositionLocalProvider(LocalContentAlpha provides ContentAlpha.disabled) {
Icon(…)
}
M3
import androidx.compose.material3.LocalContentColor
// High emphasis
CompositionLocalProvider(LocalContentColor provides MaterialTheme.colorScheme.onSurface) {
Icon(…)
}
// Medium emphasis
CompositionLocalProvider(LocalContentColor provides MaterialTheme.colorScheme.onSurfaceVariant) {
Icon(…)
}
// Disabled emphasis
CompositionLocalProvider(LocalContentColor provides MaterialTheme.colorScheme.onSurface.copy(alpha = 0.38f)) {
Icon(…)
}
यहां M2 और M3 में टेक्स्ट पर ज़ोर देने के उदाहरण दिए गए हैं:
M2
import androidx.compose.material.ContentAlpha
import androidx.compose.material.LocalContentAlpha
// High emphasis
CompositionLocalProvider(LocalContentAlpha provides ContentAlpha.high) {
Text(…)
}
// Medium emphasis
CompositionLocalProvider(LocalContentAlpha provides ContentAlpha.medium) {
Text(…)
}
// Disabled emphasis
CompositionLocalProvider(LocalContentAlpha provides ContentAlpha.disabled) {
Text(…)
}
M3
import androidx.compose.material3.LocalContentColor
// High emphasis
Text(
…,
fontWeight = FontWeight.Bold
)
// Medium emphasis
Text(
…,
fontWeight = FontWeight.Normal
)
// Disabled emphasis
CompositionLocalProvider(LocalContentColor provides MaterialTheme.colorScheme.onSurface.copy(alpha = 0.38f)) {
Text(
…,
fontWeight = FontWeight.Normal
)
}
बैकग्राउंड और कंटेनर
M2 में बैकग्राउंड को M3 में कंटेनर कहा जाता है. आम तौर पर, एक ही वैल्यू का इस्तेमाल करके, M2 में मौजूद background*
पैरामीटर को M3 में मौजूद container*
पैरामीटर से बदला जा सकता है.
उदाहरण के लिए:
M2
Badge(
backgroundColor = MaterialTheme.colors.primary
) { … }
M3
Badge(
containerColor = MaterialTheme.colorScheme.primary
) { … }
काम के लिंक
Compose में M2 से M3 पर माइग्रेट करने के बारे में ज़्यादा जानने के लिए, यहां दिए गए अन्य रिसॉर्स देखें.
Docs
सैंपल ऐप्लिकेशन
- Reply M3 का सैंपल ऐप्लिकेशन
- Jetchat के सैंपल ऐप्लिकेशन को M2 से M3 पर माइग्रेट करना
- Jetnews के सैंपल ऐप्लिकेशन को M2 से M3 पर माइग्रेट करना
- अब Android M3 के हीरो ऐप्लिकेशन में उपलब्ध है :core-designsystem मॉड्यूल
वीडियो
एपीआई का रेफ़रंस और सोर्स कोड
आपके लिए सुझाव
- ध्यान दें: JavaScript बंद होने पर लिंक टेक्स्ट दिखता है
- Compose में Material Design 2
- Compose में Material Design 3
- Compose में कस्टम डिज़ाइन सिस्टम