कॉन्टेंट 3 को कंपोज़ करें
नया अपडेट | स्टेबल रिलीज़ | रिलीज़ कैंडिडेट | बीटा रिलीज़ | ऐल्फ़ा रिलीज़ |
---|---|---|---|---|
21 अगस्त, 2024 | 1.2.1 | 1.3.0-rc01 | - | - |
संरचना
androidx
में, सात Maven ग्रुप आईडी को मिलाकर कंपोज़ किया जाता है. हर ग्रुप
इसमें फ़ंक्शन का एक सबसेट शामिल होता है, जिसमें हर एक की रिलीज़ का एक सेट होता है
नोट.
इस टेबल में, रिलीज़ नोट के हर सेट के ग्रुप और लिंक के बारे में बताया गया है.
ग्रुप | ब्यौरा |
---|---|
compos.animation | उपयोगकर्ता अनुभव को बेहतर बनाने के लिए, उनके Jetpack Compose ऐप्लिकेशन में ऐनिमेशन बनाएं. |
compos.compiler क्या है | @Composable फ़ंक्शन को ट्रांसफ़ॉर्म करें और Kotlin कंपाइलर प्लगिन की मदद से ऑप्टिमाइज़ेशन चालू करें. |
compos.foundation | बिल्डिंग ब्लॉक इस्तेमाल करने के लिए तैयार Jetpack Compose ऐप्लिकेशन लिखें. साथ ही, अपने खुद के डिज़ाइन सिस्टम के हिस्से बनाने के लिए आधार बढ़ाएं. |
compos.material | मटीरियल डिज़ाइन कॉम्पोनेंट इस्तेमाल करने के लिए तैयार Jetpack Compose के यूज़र इंटरफ़ेस (यूआई) बनाएं. यह Compose का उच्च लेवल का एंट्री पॉइंट है. इसे ऐसे कॉम्पोनेंट उपलब्ध कराने के लिए डिज़ाइन किया गया है जो www.material.io पर बताए गए कॉम्पोनेंट से मेल खाते हैं. |
compos.material3 | मटीरियल डिज़ाइन 3 कॉम्पोनेंट के साथ Jetpack Compose का यूज़र इंटरफ़ेस बनाएं. यह मटीरियल डिज़ाइन का अगला वर्शन है. मटीरियल 3 में अपडेट की गई थीम और कॉम्पोनेंट शामिल हैं. साथ ही, इसमें Material You के मनमुताबिक बनाई गई डाइनैमिक कलर जैसी सुविधाएं शामिल हैं. इसे Android 12 के विज़ुअल स्टाइल और सिस्टम के यूज़र इंटरफ़ेस (यूआई) के हिसाब से डिज़ाइन किया गया है. |
compos.runtime | Compose के प्रोग्रामिंग मॉडल और स्टेट मैनेजमेंट के बुनियादी बिल्डिंग ब्लॉक और टारगेट करने के लिए Compose कंपाइलर प्लगिन के कोर रनटाइम. |
compos.ui | डिवाइस से इंटरैक्ट करने के लिए कंपोज़ यूज़र इंटरफ़ेस (यूआई) के बुनियादी कॉम्पोनेंट की ज़रूरत होती है. इसमें लेआउट, ड्रॉइंग, और इनपुट शामिल हैं. |
डिपेंडेंसी तय करना
Compose पर डिपेंडेंसी जोड़ने के लिए, आपको Google Maven रिपॉज़िटरी को अपने प्रोजेक्ट. Google की Maven रिपॉज़िटरी पढ़ें हमारा वीडियो देखें.
उन आर्टफ़ैक्ट की डिपेंडेंसी जोड़ें जिनकी आपको build.gradle
फ़ाइल में ज़रूरत है
आपका ऐप्लिकेशन या मॉड्यूल:
ग्रूवी
dependencies { implementation "androidx.compose.material3:material3:1.2.1" implementation "androidx.compose.material3:material3-window-size-class:1.2.1" implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.3.0-rc01" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material3:material3:1.2.1") implementation("androidx.compose.material3:material3-window-size-class:1.2.1") implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.3.0-rc01") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
डिपेंडेंसी के बारे में ज़्यादा जानकारी के लिए, बिल्ड डिपेंडेंसी जोड़ना लेख पढ़ें.
सुझाव
आपके सुझाव, शिकायत या राय से Jetpack को बेहतर बनाने में मदद मिलती है. अगर आपको नई समस्याओं का पता चलता है या आपको इस लाइब्रेरी को बेहतर बनाने के लिए आइडिया मिल सकते हैं. कृपया, इस मौजूदा समस्याएं इस लाइब्रेरी में जोड़ें. किसी मौजूदा समस्या के लिए अपना वोट दें. इसके लिए ये तरीके अपनाएं: स्टार बटन पर क्लिक करके ऐसा किया जा सकता है.
समस्या को ट्रैक करने वाले टूल से जुड़ा दस्तावेज़ देखें हमारा वीडियो देखें.
Material3 का कॉमन वर्शन 1.0 कंपोज़ करें
वर्शन 1.0.0-alpha01
17 अप्रैल, 2024
androidx.compose.material3:material3-common:1.0.0-alpha01
, androidx.compose.material3:material3-common-android:1.0.0-alpha01
, और androidx.compose.material3:material3-common-desktop:1.0.0-alpha01
रिलीज़ हुए हैं. वर्शन 1.0.0-alpha01 में ये कमिट मौजूद हैं.
नई सुविधाएं
मटीरियल डिज़ाइन कॉम्पोनेंट बनाने में बिना थीम वाले कॉम्पोनेंट का इस्तेमाल किया जा सकता है:
- टोनल पैलेट
- आइकॉन
- टच टारगेट का साइज़
Material3 के अडैप्टिव नेविगेशन सुइट वर्शन 1.0 में लिखें
वर्शन 1.0.0-alpha07
1 मई, 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07
, और androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07
रिलीज़ हुए हैं. वर्शन 1.0.0-alpha07 में ये कमिट मौजूद हैं.
एपीआई में किए गए बदलाव
- नेविगेशन सुइट एपीआई को प्रयोग के तौर पर उपलब्ध न कराएं (If62af)
गड़बड़ियां ठीक की गईं
- डिफ़ॉल्ट रूप से, कॉन्टेंट के लिए इनसेट का इस्तेमाल करें (50266df)
वर्शन 1.0.0-alpha06
17 अप्रैल, 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06
, और androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06
रिलीज़ हुए हैं. वर्शन 1.0.0-alpha06 में ये कमिट मौजूद हैं.
एपीआई में किए गए बदलाव
NavigationSuiteScaffoldDefaults
मेंcontainerColor
औरcontentColor
जोड़ें. (I64e3a, b/331993720)itemColors
फ़ंक्शन कोNavigationSuiteDefaults
में जोड़ा जा रहा है. (Idf719, b/328480012)NavigationSuiteScope
को सील किया गया करें. (Iefa57)
वर्शन 1.0.0-alpha05
6 मार्च, 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05
, और androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05
रिलीज़ हुए हैं. वर्शन 1.0.0-alpha05 में ये कमिट मौजूद हैं.
एपीआई में किए गए बदलाव
NavigationSuiteItemColors
कंस्ट्रक्टर को सार्वजनिक करें. (Ica83a, b/324886877)
वर्शन 1.0.0-alpha04
21 फ़रवरी, 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04
, और androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04
रिलीज़ हुए हैं. वर्शन 1.0.0-alpha04 में ये कमियां हैं.
डिपेंडेंसी से जुड़े अपडेट
- Material3 के अडैप्टिव डिपेंडेंसी को नए मॉड्यूल पाथ पर अपडेट करें. (Ibc421)
- विंडो साइज़ की क्लास के विंडो मैनेजर वर्शन का इस्तेमाल करने के लिए, माइग्रेट करें. (I3794d)
वर्शन 1.0.0-alpha03
7 फ़रवरी, 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03
, और androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03
रिलीज़ हुए हैं. वर्शन 1.0.0-alpha03 में ये कमियां हैं.
एपीआई में किए गए बदलाव
- नेविगेशन-सुइट (I7eff7) से नेविगेशन सुइट में पैकेज के नाम को अपडेट करें
- अपने एपीआई में
MutableInteractionSource
दिखाने वाले Material3 कॉम्पोनेंट को अपडेट कर दिया गया है, ताकि अब शून्य करने लायकMutableInteractionSource
दिखे. यह डिफ़ॉल्ट तौर पर शून्य होता है. यहां सिमैंटिक में कोई बदलाव नहीं किया गया है: शून्य पास करने का मतलब है कि आपMutableInteractionSource
को हासिल नहीं करना चाहते हैं. साथ ही, ज़रूरत पड़ने पर इसे कॉम्पोनेंट के अंदर बनाया जाएगा. शून्य में बदलने से कुछ कॉम्पोनेंट को कभी भीMutableInteractionSource
असाइन नहीं किया जा सकता. साथ ही, दूसरे कॉम्पोनेंट को ज़रूरत पड़ने पर ही लेज़ी तरीके से इंस्टेंस बनाने की अनुमति मिलती है. इससे इन कॉम्पोनेंट की परफ़ॉर्मेंस बेहतर होती है. अगर इन कॉम्पोनेंट को पास किए जाने वालेMutableInteractionSource
का इस्तेमाल नहीं किया जा रहा है, तो हमारा सुझाव है कि इसके बजाय शून्य को पास करें. हमारा सुझाव है कि आप अपने कॉम्पोनेंट में भी ऐसे ही बदलाव करें. (I41abb, b/298048146)
वर्शन 1.0.0-alpha02
13 दिसंबर, 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02
, और androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02
रिलीज़ हुए हैं. वर्शन 1.0.0-alpha02 में ये कमियां हैं.
नई सुविधाएं
- 'कोई नहीं' जोड़ें
NavigationSuiteType
(If8cb1, b/313688598)
गड़बड़ियां ठीक की गईं
- रूट सरफ़ेस में
modifier.fillMaxSize
होने पर, पूरी स्क्रीन को भरने वाले नेविगेशन कॉम्पोनेंट को ठीक करें. (c9cf250, b/312664933)
वर्शन 1.0.0-alpha01
15 नवंबर, 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01
रिलीज़ हो गया है. वर्शन 1.0.0-alpha01 में ये कमिट शामिल हैं.
नई सुविधाएं
Material3 के अडैप्टिव वर्शन 1.0 को कंपोज़ करें
वर्शन 1.0.0-alpha06
7 फ़रवरी, 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha06
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06
, और androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06
रिलीज़ हुए हैं. वर्शन 1.0.0-alpha06 में ये कमियां हैं.
नई सुविधाएं
ThreePaneScaffoldNavigator
पर वापस जाने के लिए नेविगेशन के लिए, व्यवहार से जुड़े अतिरिक्त विकल्प जोड़े गए. (I858aa)- नेविगेशन इतिहास में वैकल्पिक डेस्टिनेशन कॉन्टेंट जोड़ा गया. (Ibd7e6)
वर्शन 1.0.0-alpha05
24 जनवरी, 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha05
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05
, और androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05
रिलीज़ हुए हैं. वर्शन 1.0.0-alpha05 में ये कमियां हैं.
नई सुविधाएं
- स्कैफ़ोल्ड नेविगेशन और वैल्यू कैलकुलेशन में इतिहास की जानकारी पाने में मदद करें (I71d46)
वर्शन 1.0.0-alpha04
10 जनवरी, 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha04
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04
, और androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04
रिलीज़ हुए हैं. वर्शन 1.0.0-alpha04 में ये कमियां हैं.
नई सुविधाएं
- पैनल स्कैफ़ोल्ड में एज-टू-एज सपोर्ट जोड़ा गया (I1b462)
एपीआई में किए गए बदलाव
- मूव किया गया हिंज, पॉस्चर में मौजूद प्रॉपर्टी को हिंज की जानकारी की सूची में जोड़ता है (I24f90)
गड़बड़ियां ठीक की गईं
- समस्या ठीक करने के बाद,
AnimatedPane
को फिर से नहीं बनाया गया (c3f573d)
वर्शन 1.0.0-alpha03
13 दिसंबर, 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha03
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03
, और androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03
रिलीज़ हुए हैं. वर्शन 1.0.0-alpha03 में ये कमियां हैं.
एपीआई में किए गए बदलाव
- मचान भूमिकाओं को
ThreePaneScaffoldRole
के उपनामों में बदलें. (I65bd1) - स्कैफ़ोल्ड रोल के लिए, बेस क्लास बनाएं (I4784d)
AnimatedPane
के कॉन्टेंट से गै़र-ज़रूरी पैरामीटर हटाएं (Ibc73b)collectWindowSizeAsState
का नाम बदलता है और इसके बजाय रॉ वैल्यू दिखाता है (I480f4)
वर्शन 1.0.0-alpha02
29 नवंबर, 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02
, और androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02
रिलीज़ हुए हैं. वर्शन 1.0.0-alpha02 में ये कमियां हैं.
एपीआई में किए गए बदलाव
- अडैप्टिव स्कैफ़ोल्ड एपीआई की मदद से, स्प्लिट नेविगेशन एपीआई. (Ic4045)
GutterSize
क्लास हटाएं. (I785b3)
गड़बड़ियां ठीक की गईं
AnimatedPane
का इस्तेमाल न होने पर, ठीक करने वाले पैनल स्विच नहीं होते (d88f181)
वर्शन 1.0.0-alpha01
15 नवंबर, 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha01
रिलीज़ हो गया है. वर्शन 1.0.0-alpha01 में ये कमिट शामिल हैं.
नई सुविधाएं
Material3 के अडैप्टिव कंडिशन से जुड़े एपीआई:
Material3 के अडैप्टिव पैनल स्कैफ़ोल्ड डायरेक्टिव एपीआई:
Material3 के अडैप्टिव पैनल स्कैफ़ोल्ड एपीआई:
- पैनल स्कैफ़ोल्ड के बेसिक एपीआई
Material3 वर्शन 1.3 कंपोज़ करें
वर्शन 1.3.0-rc01
21 अगस्त, 2024
androidx.compose.material3:material3-*:1.3.0-rc01
रिलीज़ हो गया है. वर्शन 1.3.0-rc01 में ये कमिट शामिल हैं.
गड़बड़ियां ठीक की गईं
- अब
ModalBottomSheet
सिमैंटिक ट्रैवर्सल क्रम में पहले है और उसके बाद स्क्रिम. (I436f9, b/358594665)
वर्शन 1.3.0-beta05
24 जुलाई, 2024
androidx.compose.material3:material3-*:1.3.0-beta05
रिलीज़ हो गया है. वर्शन 1.3.0-beta05 में ये प्रतिबद्धताएं शामिल हैं.
- Android N और O (a10a2d) पर
BottomSheet
का कॉन्टेंट मौजूद न होने या कट जाने की समस्या को ठीक कर दिया गया है - स्लाइडर के सिमेंटिक्स बाउंड को बढ़ाया गया है, ताकि
TalkBack
अंगूठों के आस-पास फ़ोकस इंडिकेटर को सही तरीके से दिखा सके. (0b5a1d)
वर्शन 1.3.0-beta04
26 जून, 2024
androidx.compose.material3:material3-*:1.3.0-beta04
रिलीज़ हो गया है. वर्शन 1.3.0-beta04 में ये प्रतिबद्धताएं होती हैं.
वर्शन 1.3.0-beta03
12 जून, 2024
androidx.compose.material3:material3-*:1.3.0-beta03
रिलीज़ हो गया है. वर्शन 1.3.0-beta03 में ये प्रतिबद्धताएं शामिल हैं.
बाहरी योगदान
androidx.compose.material3.DropdownMenu
को सामान्य सोर्स सेट से उपलब्ध कराएं. (If62c0)
वर्शन 1.3.0-beta02
29 मई, 2024
androidx.compose.material3:material3-*:1.3.0-beta02
रिलीज़ हो गया है. वर्शन 1.3.0-beta02 में ये प्रतिबद्धताएं शामिल हैं.
एपीआई में किए गए बदलाव
Modifier.pullToRefreshIndicator
, एलिवेशन की सुविधा देता है. 'पूरी जानकारी को रीफ़्रेश करने के लिए पुल करें' एपीआई को अपडेट करें, ताकि इसे लैम्डा के बजाय बूलियन बनाया जा सके.PullToRefreshBox
(I75679) में सहायता से जुड़ा कॉन्टेंट अलाइनमेंटTooltipScope
को सील किया गया इंटरफ़ेस बनाना औरTooltipBox
और लेबल में इस्तेमाल करने के लिए, अंदरूनी तौर पर लागू करना. (I3833e)- किसी भी कैरसेल आइटम (Id67a1) में आकार और बॉर्डर आसानी से जोड़ने के लिए,
CarouselItemScope
-maskClip
औरmaskBorder
में दो नए मॉडिफ़ायर जोड़े गए TimePickerState
अब एक इंटरफ़ेस है और समय सेट करने की अनुमति देता है (I88546)- लिंक को स्टाइल देने के लिए, एपीआई को अपडेट किया गया:
TextLinkStyles
कोTextStyle
में ले जाया गया औरTextDefaults
को कॉन्टेंट से हटा दिया गया. (I5477b)
गड़बड़ियां ठीक की गईं
ModalBottomSheet
स्थिति और नेविगेशन बार आइकॉन अब गहरे रंग वाली थीम की स्थिति के हिसाब से काम करते हैं. (Ie1fe7, b/338342149)ModalBottomSheet
स्क्रिम में क्लोज़ शीट सिमैंटिक जोड़ा. (0e61cb,b/328801864)
बाहरी योगदान
androidx.compose.material3.AlertDialog
को सामान्य सोर्स सेट (Ia33f5) से उपलब्ध कराएंModalBottomSheet
को सामान्य सोर्स सेट (Id7cc7) से उपलब्ध कराएं
वर्शन 1.3.0-beta01
14 मई, 2024
androidx.compose.material3:material3-*:1.3.0-beta01
रिलीज़ हो गया है. वर्शन 1.3.0-beta01 में ये प्रतिबद्धताएं शामिल हैं.
एपीआई में किए गए बदलाव
CaretProperties
के बजाय,DpSize
का इस्तेमाल किया जा रहा है.CaretProperties
को हटाया जा रहा है.CaretScope
का नाम बदलकरTooltipScope
करें. (Id9a76)- टेक्स्ट में मटीरियल थीम वाले लिंक पाने के लिए, एपीआई को अपडेट किया गया. खास तौर पर,
LinkAnnotations
थीम को बनाने के लिएTextDefaults
से तरीके हटाए गए हैं और थीम वाले लिंक के साथ एचटीएमएल को पार्स करने का तरीका बताया गया है. इसके बजाय, एकTextLinkStyles
क्लास जोड़ी गई है, जो टेक्स्ट कंपोज़ेबल में पैरामीटर के तौर पर लिंक को स्टाइल करने की अनुमति देती है. (I31b93)
वर्शन 1.3.0-alpha06
1 मई, 2024
androidx.compose.material3:material3-*:1.3.0-alpha06
रिलीज़ हो गया है. वर्शन 1.3.0-alpha06 में ये कमिट मौजूद हैं.
नुकसान पहुंचाने वाले बदलाव
नए पुल-टू-रीफ़्रेश API:
- Dp इकाइयों के बजाय भिन्नात्मक मानों का इस्तेमाल करने के लिए आसान
PullToRefreshState
. isRefreshing
की स्थिति कोPullToRefreshState
के बजाय, उपयोगकर्ता कंट्रोल करता है.- नेस्ट किए गए स्क्रोल कनेक्शन को
PullToRefreshState
से अलग किया गया. इसे नएPullToRefreshBox
याModifier.pullToRefresh
मैनेज करता है. - यह अपडेट, एक्सपेरिमेंटल एपीआई के पिछले वर्शन में हुआ नुकसान पहुंचा सकता है. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)
- Dp इकाइयों के बजाय भिन्नात्मक मानों का इस्तेमाल करने के लिए आसान
एपीआई में किए गए बदलाव
RippleConfiguration#isEnabled
को हटा दिया गया है औरLocalRippleConfiguration
को शून्य कर दिया गया है. किसी रिपल को बंद करने के लिए,isEnabled = false
के साथRippleConfiguration
देने के बजाय,LocalRippleConfiguration
कोnull
दें. (I22725)- एज टू एज चालू होने पर
ModalBottomSheet
, स्टेटस बार पर ज़्यादा सटीक तरीके से स्क्रिम ड्रॉ करता है. मोडल बॉटम शीट का कॉन्टेंट, अब विंडो इनसेट का इस्तेमाल कर सकता है. इससे कॉन्टेंट को नेविगेशन बार के ऊपर दिखाया जा सकता है. इनसेट को कहां लागू किया जाएगा, यह बताने के लिएModalBottomSheet
पैरामीटरwindowInsets
का नाम बदलकरcontentWindowInsets
किया गया. ये पैरामीटर अब विंडो लॉजिक से नहीं जुड़े हैं.contentWindowInsets
टाइप को ऐसे फ़ंक्शन में बदल दिया गया है जोWindowInsets
रिटर्न करता है, ताकि इसका समाधान नई विंडो में ही किया जा सके. (I39630, b/274872542, b/300280229, b/290893168) PrimaryScrollableTabRow
औरSecondaryScrollableTabRow
अब सब-कंपोज़िशन के बजाय कस्टम लेआउट का इस्तेमाल कर रहे हैं. इससे परफ़ॉर्मेंस बेहतर होनी चाहिए. (I991e0)- टेक्स्ट लिंक को सामान्य स्टाइलिंग के अलावा, दबाया जा सकने वाला स्टाइल चुनने का विकल्प भी मिलता है. इस स्टाइलिंग के दौरान कर्सर को घुमाने पर फ़ोकस किया जाता है और फ़ोकस किया जाता है.
TextDefaults
तरीकों में से हर एक को इसके समर्थन के लिएpressedStyle
तर्क मिला. (Ic473f, b/139312671)
गड़बड़ियां ठीक की गईं
- नेविगेशन पैनल में खींचने वाले ऐंकर अब
drawerContent
की चौड़ाई से मेल खाएंगे. (Ibc72f, b/245355396) - लेबल के लिए अब
OutlinedTextField
टॉप पैडिंग, सिस्टम के फ़ॉन्ट साइज़ के हिसाब से तय है. (Idc781) CalendarLocale
की पैकेज जगह तय की गई. (Ifa235)- [प्रेडिक्टिव बैक] (0.1, 0.1, 0, 1) (I2591a) के इंटरपोलेशन कर्व का इस्तेमाल करने के लिए, अनुमानित बैक ऐनिमेशन को अपडेट करें
वर्शन 1.3.0-alpha05
17 अप्रैल, 2024
androidx.compose.material3:material3-*:1.3.0-alpha05
रिलीज़ हो गया है. वर्शन 1.3.0-alpha05 में ये कमिट मौजूद हैं.
नई सुविधाएं
SearchBar
औरDockedSearchBar
में नए ओवरलोड हैं, जो एक टेक्स्ट फ़ील्ड पैरामीटर लेते हैं. इससे टेक्स्ट फ़ील्ड की स्टाइल को बाकी खोज बार से अलग रखा जा सकता है. साथ ही, कस्टम टेक्स्ट फ़ील्ड पास की जा सकती हैं. मौजूदा लागू करने के टेक्स्ट फ़ील्ड कोSearchBarDefaults.InputField
के तौर पर उपलब्ध करा दिया गया है. (I50c73, b/275074248, b/278773336, b/326627700)- Lambda
drawTick
को सार्वजनिक एपीआई में जोड़ दिया गया है, ताकि ज़रूरत पड़ने पर टिक को अपनी पसंद के मुताबिक बनाया जा सके (I0c048)
एपीआई में किए गए बदलाव
- टेक्स्ट लिंक को सामान्य स्टाइलिंग के अलावा, दबाया जा सकने वाला स्टाइलिंग विकल्प भी मिल गया
CarouselItemInfo
को अपडेट किया गया, ताकि यह पता चल सके कि आइटम से क्लिप बनाई जा रही हैं (I785d8)BasicTooltipState
को Material 3 के पब्लिक एपीआई से हटाया गया. जब तक फ़ाउंडेशनBasicTooltip
को स्टेबलाइज़ नहीं कर लिया जाता, तब तक यह फ़ंक्शनTooltipState
के साथ काम करता रहेगा. (Icda29)- एक
TextDefaults
ऑब्जेक्ट जोड़ा गया, जिसमेंLinkAnnotation
बनाने और एचटीएमएल से टैग की गई स्ट्रिंग को पार्स करने के तरीके शामिल हैं. ये तरीकेMaterialTheme
को लिंक (I98532, b/139312671) पर लागू करते हैं ExposedDropdownMenuBoxScope
में अब सब-क्लास की अनुमति नहीं है. सार्वजनिक किए गए ड्रॉपडाउन मेन्यू में अब एकMenuAnchorType
है. इसेmenuAnchor
को पास किया जाना चाहिए, ताकि इससे बेहतर तरीके से काम किया जा सके. इसका इस्तेमाल,focusable
कोExposedDropdownMenu
पर पास करने के बजाय किया जाना चाहिए. हालांकि, अब यह सुविधा काम नहीं करती.enabled
स्थिति को कंट्रोल करने के लिए,menuAnchor
में एक नया पैरामीटर है. (I55ee6, b/257209915, b/308840226)- बंद होने पर
OutlinedButton
का बॉर्डर रंग ठीक किया गया.ButtonDefaults.outlinedButtonBorder("enabled")
ओवरलोड जोड़ा गया, जो चालू होने की स्थिति लेता है. (Ie650b, b/318461363) - आइटम के साइज़ के बारे में जानकारी पाने में क्लाइंट की मदद करने के लिए, नई
CarouselItemInfo
क्लास जोड़ी गई. (I9070c) - बिना सरफ़ेस कंटेनर वाला
ColorScheme
कंस्ट्रक्टर अब काम नहीं करता. कृपया ऐसे कंस्ट्रक्टर पर माइग्रेट करें जिसमें सर्फ़ेस कंटेनर शामिल हैं. (I35c11) - [Outlined]
TextFieldDefaults
ContainerBox
का नाम बदलकरContainer
किया गया. (Ie8d3b)
गड़बड़ियां ठीक की गईं
- अगर
sheetSwipeEnabled
गलत है, तोBottomSheetScaffold
अब नेस्ट किए गए स्क्रोल से स्क्रोल नहीं करेगा. (I5e1c1, b/306464779) IconButtonSamples.kt
से कुछExperimentalMaterial3Api
ऑप्ट-इन एनोटेशन हटाए गए. (I111d1)
वर्शन 1.3.0-alpha04
3 अप्रैल, 2024
androidx.compose.material3:material3-*:1.3.0-alpha04
रिलीज़ हो गया है. वर्शन 1.3.0-alpha04 में ये कमिट मौजूद हैं.
नई सुविधाएं
- Material3 कैरसेल के प्रयोग के तौर पर दो वर्शन जोड़े गए हैं -
HorizontalMultiBrowseCarousel
औरHorizontalUncontainedCarousel
(I88d64) - ऑप्ट-इन के तौर पर, U+ पर अनुमानित वापस जाने की सुविधा के लिए, Compose M3 नेविगेशन पैनल (
ModalDrawerSheet
औरDismissibleDrawerSheet
) को अपडेट किया गया (Ie5b0b) - आइकॉन में नया एपीआई जोड़ा गया, ताकि कलर टिंट को लैम्डा के रूप में पास किया जा सके, ताकि उसे दोबारा न लिखा जा सके. (I5b5a2)
- टॉप ऐप्लिकेशन बार एपीआई अब तय और छोटे किए जा सकने वाले, दोनों सेक्शन के लिए पसंद के मुताबिक ऊंचाई का इस्तेमाल करते हैं. (Ib8b0c, b/323403446)
एपीआई में किए गए बदलाव
- टॉप ऐप्लिकेशन बार एपीआई अब तय और छोटे किए जा सकने वाले, दोनों सेक्शन के लिए पसंद के मुताबिक ऊंचाई का इस्तेमाल करते हैं. उस समस्या को ठीक किया गया है जिसकी वजह से कॉन्टेंट स्क्रोल करने पर, सबसे ऊपर मौजूद एक लाइन वाले ऐप्लिकेशन बार को कई बार इस्तेमाल करना पड़ता था. उस समस्या को ठीक किया गया जिसकी वजह से
MediumTopAppBar
ने बड़ी फ़ॉन्ट/डिसप्ले सेटिंग वाले डिवाइसों पर टाइटल में काट-छांट की. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676) SegmentedButton
और उससे जुड़े एपीआई अब ठीक से काम कर रहे हैं (I8a158)SwipeToDismissBox
,SwipeToDismissBoxDefaults
,SwipeToDismissBoxState
, औरSwipeToDismissBoxValue
को अब स्थिर के तौर पर मार्क किया गया है. (I5f000)- हटाए गए
DismissDirection
औरDismissValue
ईनम और एपीआई हटाए गए. (I89ccd) - कैरसेल के
CarouselState
कंपैनियन ऑब्जेक्ट में, प्रयोग के तौर पर जोड़ा गया टैग जोड़ा गया है. (I94154) LocalMinimumInteractiveComponentEnforcement
का बहिष्कार करें और उसे बदलने के लिएLocalMinimumInteractiveComponentSize
को प्रस्तुत किया. (I7a7ac)SearchBarColors
कंस्ट्रक्टर अब सार्वजनिक है. (I769ca)SwipeToDismissBox
मेंgesturesEnabled
पैरामीटर जोड़ा गया. (Idc59f, b/324170119)- ऐसे टेक्स्ट फ़ील्ड एपीआई हटाए गए जिन्हें 'अब काम नहीं करता' और 'एक्सपेरिमेंट के तौर पर शुरू किया गया' के तौर पर मार्क किया गया था. (I1305f)
वर्शन 1.3.0-alpha03
20 मार्च, 2024
androidx.compose.material3:material3-*:1.3.0-alpha03
रिलीज़ हो गया है. वर्शन 1.3.0-alpha03 में ये कमिट मौजूद हैं.
विज़ुअल रूप से नुकसान पहुंचाने वाले बदलाव
- सही मात्रा में कलर कंट्रास्ट पक्का करने के लिए, फ़ोकस स्टेट ओवरले को 0.1f पर अपडेट करें. (I7ea77)
lightColorScheme
औरdarkColorScheme
में, सरफ़ेस और बैकग्राउंड के रंग में डिफ़ॉल्ट रूप से छोटे बदलाव किए गए हैं. (I9db52)
नई सुविधाएं
ExposedDropdownMenu
को पसंद के मुताबिक बनाने के लिए पैरामीटर जोड़े गए. खास तौर पर, अब मेन्यू में एकfocusable
पैरामीटर (डिफ़ॉल्टtrue
) है, जिसे बदलाव किए जा सकने वाले टेक्स्ट फ़ील्ड के साथ काम करते समय,false
पर सेट किया जाना चाहिए. (I4184c, b/323694447, b/278609042)
एपीआई में किए गए बदलाव
ScaffoldSubcomposeInMeasureFix
फ़्लैग हटा दिया गया है. (Ie2a4b)NavigationRailItemColors
को अब@Immutable
के तौर पर मार्क कर दिया गया है. (If6112, b/327660613)NavigationBarItemColors
को अब@Immutable
के तौर पर मार्क कर दिया गया है. (I42a30, b/298064514)- स्लाइडर ट्रैक कंपोज़ेबल में पैरामीटर का क्रम बदलें. (I9f315)
ExposedDropdownMenu
को अबPopup
का इस्तेमाल करके लागू किया गया है. इसके अलावा, कीबोर्ड पर टाइप करते समय, फ़ोकस किए जा सकने वाले मेन्यू के अलावा, ऐसे टेक्स्ट फ़ील्ड भी खारिज हो सकते हैं जिनमें बदलाव किया जा सकता है.
गड़बड़ियां ठीक की गईं
- सरफ़ेस और सर्फ़ेस कंटेनर के बेसलाइन रोल में थोड़ा बदलाव किया गया है, ताकि हल्के और गहरे रंग वाली थीम के रंगों को ज़्यादा बेहतर बनाया जा सके. (I677a5)
- नॉन-टेक्स्ट कंट्रास्ट की नई विशेषताओं को फ़ॉलो करने के लिए, स्लाइडर और
ProgressIndicator
के रंगों को अपडेट किया गया. (I26807) - सही मात्रा में कलर कंट्रास्ट पक्का करने के लिए, फ़ोकस स्टेट ओवरले को 0.1f पर अपडेट करें. (I7ea77)
lightColorScheme
औरdarkColorScheme
में, सरफ़ेस और बैकग्राउंड के रंग में डिफ़ॉल्ट रूप से छोटे बदलाव किए गए हैं. (I9db52)
वर्शन 1.3.0-alpha02
6 मार्च, 2024
androidx.compose.material3:material3-*:1.3.0-alpha02
रिलीज़ हो गया है. वर्शन 1.3.0-alpha02 में ये कमिट मौजूद हैं.
एपीआई में किए गए बदलाव
- स्लाइडर को फिर से स्थिर स्थिति में लाने के लिए.
State.onValueChangeFinished
को फिर से वैल्यू मिल रही है.onValueChangeFinished
कोrememberUpdatedState
में रैप करना. (I82ab2, b/322269951) - नेविगेशन कॉम्पोनेंट अब
SurfaceContainer
की नई भूमिकाओं का इस्तेमाल करते हैं.DrawerDefaults
में अब अलग-अलगstandardContainerColor
औरmodalContainerColor
एट्रिब्यूट मिलते हैं.DrawerDefaults.ModalDrawerElevation
अब0.dp
है. (I7fbac) - हम
state.onValueChangeFinished
कोvar
में बदल रहे हैं, इसलिए@Stable
कोSlider
की स्थितियों से हटाया जा रहा है. (Ied34a, b/322269951) ModalBottomSheet
औरStandardBottomSheet
ऐनिमेशन की खास जानकारी अबTweenSpec
है, जिसे स्प्रिंग ऐनिमेशन से अपडेट किया गया है. इससे ओवरशूट से जुड़ी समस्या ठीक हो जाती है. बिना डेंसिटी वालेSheetState
कंस्ट्रक्टर को हटा दिया गया है. (I7babc, b/285847707)
गड़बड़ियां ठीक की गईं
- अब कॉम्पोनेंट,
SurfaceContainer
वैरिएंट का इस्तेमाल करते हैं. कलर, सरफ़ेस औरTonalElevation
की मदद से औपचारिक रूप से कैलकुलेट किए गए कलर में, अब डिफ़ॉल्ट रूप सेSurfaceContainer
रोल का इस्तेमाल किया जाता है. हालांकि, इन पर टोनल एलिवेशन का कोई असर नहीं होता. (b/304584161) - उस गड़बड़ी को ठीक कर दिया गया है जिसकी वजह से
ElevatedFilterChip
के चुने हुए का निशान, बंद किए गए कंटेनर का रंग काला हो गया था. (I400e6, b/322407043) - प्रोग्रेस 0 (Id6582) होने पर, तय नहीं किए गए प्रोग्रेस इंडिकेटर को ठीक करें
- आरटीएल लेआउट पर
Slider
औरRangeSlider
से जुड़ी गड़बड़ी ठीक की गई (Iab0e1) - फ़्लोट राउंडिंग की वजह से स्लाइडर रेंज कैलकुलेशन के लिए
SliderRangeTolerance
जोड़ना गलत हो सकता है. (Ic918a, b/324934900) - पक्का करें कि
DateRangePicker
को नेस्ट करते समय या बड़े फ़ॉन्ट वाली छोटी स्क्रीन पर, किसी भी तरह का डेट पिकर दिखाते समय,DatePickerDialog
इसके बटन दिखाता हो. (Ie4758, b/325107799, b/277768544) Menu
, अब कंटेनर के रंग के लिएSurfaceContainer
भूमिका का इस्तेमाल करता है.MenuDefaults.TonalElevation
अब0.dp
है. (I135b7)TextField
, अब कंटेनर के रंग के लिएSurfaceContainerHighest
भूमिका का इस्तेमाल करता है. (I4d)- बेहतर बनाए गए चिप, अब
SurfaceContainerLow
भूमिका (I7cd2f) का इस्तेमाल करते हैं DatePicker
कंटेनर का रंग अबSurfaceContainerHigh
है.DatePickerDefaults.TonalElevation
अब0.dp
है. (Ida753)- बॉटम शीट के कंटेनर का रंग और ड्रैग हैंडल का रंग अपडेट करता है. (I72a0a)
RichTooltip
कंटेनर का रंग अबSurfaceContainer
है. (Ia8b45)SearchBar
कंटेनर का रंग अबSurfaceContainerHighest
है.SearchBarDefaults.TonalElevation
अब0.dp
है. (I88604)SurfaceContainerHighest
रंग वाली भूमिका का फ़ायदा पाने के लिए, अपडेट वाले स्विच को बंद कर दिया गया है. साथ ही, चुने गए ट्रैक/आइकॉन से चुने हुए का निशान हटाया गया है. (I7687a)AlertDialog
कंटेनर का रंग अबSurfaceContainerHigh
है. (Ie0433)BottomAppBar
कंटेनर का रंग अबSurfaceContainer
है.TopAppBar
onScroll
रंग अबSurfaceContainer
है. (I41630)ElevatedCard
कंटेनर का रंग अबSurfaceContainerLow
है.FilledCard
के कंटेनर का रंगSurfaceContainerHighest
है. (I35141)ElevatedButton
कंटेनर का रंग अबSurfaceContainerLow
है.FilledIconButton
के चुने हुए का निशान हटाने पर, कंटेनर का रंगSurfaceContainerHighest
हो जाएगा. (I792c9)TimePicker
कंटेनर के रंग और घड़ी के डायल के रंग को बदलकरSurfaceContainerHighest
कर दिया गया है. (I43b93)
वर्शन 1.3.0-alpha01
21 फ़रवरी, 2024
androidx.compose.material3:material3-*:1.3.0-alpha01
रिलीज़ हो गया है. वर्शन 1.3.0-alpha01 में ये कमियां हैं.
नई सुविधाएं
- U+ (Iccf32, b/281967264, b/304850357) पर, सुझाव के तौर पर वापस जाने की सुविधा के लिए, Compose M3
ModalBottomSheet
को अपडेट करें - U+ (I657f8) पर प्रेडिक्टिव बैक की सुविधा के लिए, Compose M3
SearchBar
को अपडेट किया गया - गैप और स्टॉप इंडिकेटर जोड़कर सुलभता बेहतर बनाने के लिए, स्लाइडर को अपडेट किया गया. (I3058e)
- 'गैप और स्टॉप' इंंडिकेटर जोड़कर सुलभता सुविधाओं को बेहतर बनाने के लिए,
ProgressIndicator
को अपडेट किया गया. (I21451) - रिच टूलटिप के लिए डिफ़ॉल्ट कैरेट जोड़ने से, अब नया रिच टूलटिप एपीआई, ऐंकर
LayoutCoordinates
के हिसाब से कस्टम कैरेट बनाने की सुविधा देता है. (Ifd42c)
व्यवहार में बदलाव
- नए Repple API का इस्तेमाल करने के लिए, मटीरियल कॉम्पोनेंट माइग्रेट कर दिए गए हैं. अब ये
RippleTheme
से जुड़ी क्वेरी नहीं करेंगे.
एपीआई में किए गए बदलाव
drawStopIndicator
मज़ेदार वीडियो अब सार्वजनिक हो गया है. (I3f59f)DatePicker
केformatWithSkeleton
फ़ंक्शन को इंटरनल के तौर पर मार्क करें (Ic65dc)DropdownMenu
अब पसंद के मुताबिक रंग, आकार, ऊंचाई, और बॉर्डर के साथ काम करता है. (I8e981, b/289554448, b/301887035, b/283654243)- अपने एपीआई में
MutableInteractionSource
दिखाने वाले Material3 कॉम्पोनेंट को अपडेट कर दिया गया है. इससे अब शून्य करने लायकMutableInteractionSource
दिखेगा, जो डिफ़ॉल्ट रूप सेnull
पर सेट होता है. यहां सिमैंटिक में कोई बदलाव नहीं किया गया है: शून्य पास करने का मतलब है कि आपMutableInteractionSource
को हासिल नहीं करना चाहते हैं. साथ ही, ज़रूरत पड़ने पर इसे कॉम्पोनेंट के अंदर बनाया जाएगा. शून्य में बदलने से कुछ कॉम्पोनेंट को कभी भीMutableInteractionSource
असाइन नहीं किया जा सकता. साथ ही, दूसरे कॉम्पोनेंट को ज़रूरत पड़ने पर ही लेज़ी तरीके से इंस्टेंस बनाने की अनुमति मिलती है. इससे इन कॉम्पोनेंट की परफ़ॉर्मेंस बेहतर होती है. अगर इन कॉम्पोनेंट को पास किए जाने वालेMutableInteractionSource
का इस्तेमाल नहीं किया जा रहा है, तो हमारा सुझाव है कि इसके बजाय शून्य को पास करें. हमारा सुझाव है कि आप अपने कॉम्पोनेंट में भी ऐसे ही बदलाव करें. (I41abb, b/298048146) - तय वैल्यू का इस्तेमाल करके, हर कॉम्पोनेंट / सब-ट्री को पसंद के मुताबिक बनाने के लिए,
RippleConfiguration
औरLocalRippleConfiguration
को जोड़ा जाता है. उदाहरण के लिए, किसी ऐसे कॉम्पोनेंट का रंग बदलने के लिए जिस पर आपका कंट्रोल नहीं है या किसी कॉम्पोनेंट के लिए रिपल बंद करना. ज़्यादातर मामलों में डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाना चाहिए: अलग-अलग कॉम्पोनेंट / सीमित सब-ट्री को पसंद के मुताबिक बनाने के लिए, इन एपीआई की मदद ली जा सकती है. बड़े बदलावों और कस्टम डिज़ाइन सिस्टम के लिए, आपकोcreateRippleModifierNode
का इस्तेमाल करके अपना खुद का रिपल बनाना चाहिए. (I7b5d6, b/298048146) - content3 में नया Repple API जोड़ा गया, जो अब काम नहीं करने वाले
rememberRipple
की जगह ले लेता है. इसके अलावा, काम न करने वालेrememberRipple
/RippleTheme
एपीआई का इस्तेमाल करने के लिए, content3 कॉम्पोनेंट को वापस लाने के लिए एक अस्थायीCompositionLocal
,LocalUseFallbackRippleImplementation
भी जोड़ता है. इसे अगले ठीक से काम करने वाले वर्शन में हटा दिया जाएगा. इसका मकसद सिर्फ़ उन मामलों में माइग्रेशन में मदद करना है जहां आपने अपनी पसंद के मुताबिकRippleTheme
उपलब्ध कराए हैं. (I34cbc, b/298048146)
गड़बड़ियां ठीक की गईं
- परफ़ॉर्मेंस को बेहतर बनाने के लिए,
ModalBottomSheet
का सब-कंपोज़िशन हटाया गया. उस समस्या को ठीक किया गया है जिसकी वजह सेLookaheadScope
के साथ, कुछ खास स्थितियों मेंModalBottomSheet
क्रैश हो सकता है. (I2a198) - परफ़ॉर्मेंस को बेहतर बनाने के लिए,
BottomSheetScaffold
का सब-कंपोज़िशन हटाया गया. उस समस्या को ठीक किया गया है जिसकी वजह सेLookaheadScope
के साथ-साथ, कुछ खास स्थितियों मेंBottomSheetScaffold
क्रैश हो जाता था. (Ie6401) - सबसे ऊपर दाएं कोने के हिसाब से, बैज अलाइनमेंट को ऐंकर कॉन्टेंट के बीच के करीब लाने के लिए अडजस्ट किया गया है. (I18a28)
DateRangePicker
की समस्या को ठीक करें, जहां महीने-साल के टेक्स्ट के टाइटल को स्क्रीन रीडर, बटन से ऐक्सेस करने की सुविधा, और वॉइस ऐक्सेस का इस्तेमाल करने वाले लोगों को कार्रवाई करने लायक बताया गया था. (I2ac55)mediumTopAppBarColors
पैरामीटर के ऑर्डर से जुड़ी गड़बड़ी ठीक की गई. (Ibe64a)
वर्शन 1.2
वर्शन 1.2.1
6 मार्च, 2024
androidx.compose.material3:material3-*:1.2.1
रिलीज़ हो गया है. वर्शन 1.2.1 में ये शर्तें शामिल हैं.
गड़बड़ियां ठीक की गईं
- स्लाइडर की स्थितियों को फिर से स्थिर बनाएं.
State.onValueChangeFinished
को फिर से वैल्यू मिल रही है.onValueChangeFinished
कोrememberUpdatedState
में रैप करना. (Ie8fd0, b/322269951) - हम
state.onValueChangeFinished
कोvar
में बदल रहे हैं, इसलिए@Stable
कोSlider
की स्थितियों से हटाया जा रहा है. (I82ba1, b/322269951) - डिफ़ॉल्ट से कॉपी करने के लिए,
NavigationBar
कस्टम रंग से जुड़ी समस्या को ठीक करें. (80a779, b/326894020) - फ़ोकस करने लायक बनाने के लिए,
ExposedDropdownMenu
में रिग्रेशन की समस्या ठीक करें (3fcec1, b/323694447) - बटन के रंग को कैश मेमोरी में सेव करने से जुड़ी समस्या ठीक करना (3e5bbcb/327371655)
वर्शन 1.2.0
7 फ़रवरी, 2024
androidx.compose.material3:material3-*:1.2.0
रिलीज़ हो गया है. वर्शन 1.2.0 में ये कमियां शामिल हैं.
आम समस्या
- परफ़ॉर्मेंस में सुधार के लिए
PrimaryTabRow
में View-Compose इंटरऑप रेंडरिंग गड़बड़ी की शुरुआत की गई थी. इसका समाधान है किTabRow
कोTabRowDefaults.PrimaryIndicator
के साथ इस्तेमाल किया जाए
1.1.0 के बाद से हुए अहम बदलाव
नए मटीरियल डिज़ाइन वाले तीन कॉम्पोनेंट
- रीफ़्रेश करने के लिए, स्क्रीन पर ऊपर की ओर स्वाइप करें
- सेगमेंट किया गया बटन
मौजूदा मटीरियल डिज़ाइन 3 कॉम्पोनेंट को बेहतर बनाया गया है.
- स्क्रीन पर सबसे नीचे मौजूद ऐप्लिकेशन बार (आरटीएल अलाइनमेंट, स्क्रोल करने पर अपने-आप छिपाएं)
- टैब का विज़ुअल अपडेट
- बैज (अलाइनमेंट अपडेट)
एक्सपेरिमेंट वाले एपीआई को स्थिर में प्रमोट किया गया!
परफ़ॉर्मेंस में सुधार
- ज़्यादा जानकारी के लिए, कृपया यह ब्लॉग पोस्ट देखें!
वर्शन 1.2.0-rc01
24 जनवरी, 2024
androidx.compose.material3:material3-*:1.2.0-rc01
रिलीज़ हो गया है. वर्शन 1.2.0-rc01 में ये कमिट शामिल हैं.
गड़बड़ियां ठीक की गईं
mediumTopAppBarColors
पैरामीटर के ऑर्डर से जुड़ी गड़बड़ी ठीक की गई. (Ibe64a)CardDefaults.cardColors
में1.2.0-beta02
में आई उस गड़बड़ी को ठीक किया गया जोcontainerColor
पैरामीटर वैल्यू के आधार पर,contentColor
को अपडेट नहीं की गई थी. (Iee041, b/319671246)1.2.0-beta02
में पेश की गईdisabledContentColor
की गड़बड़ी को ठीक किया गया और छोटा ऑप्टिमाइज़ेशन जोड़ा गया. (I6dda1, b/318428829)
वर्शन 1.2.0-beta02
10 जनवरी, 2024
androidx.compose.material3:material3-*:1.2.0-beta02
रिलीज़ हो गया है. वर्शन 1.2.0-beta02 में ये तय किए गए हिस्से शामिल हैं.
आम तौर पर होने वाली गड़बड़ी
IconButtonColors
में मौजूद एक गड़बड़ी, डिफ़ॉल्ट रूप से उपयोगकर्ता के बताए गएcontentColor
के बजाय,LocalContentColor
के ऐल्फ़ा (0.38f) कोdisabledContentColor
असाइन करेगी. वैकल्पिक हलdisabledContentColor
को साफ़ तौर पर सेट करना है. इसे अगली रिलीज़ में ठीक कर दिया जाएगा.
एपीआई में किए गए बदलाव
- प्लेन
Tooltip
एपीआई के लिए, टूलटिप कैरेट चालू करने की सुविधा. (Ibf767) SwipeToDismissState
,rememberSwipeToDismiss
, औरSwipeToDismissValue
का नाम बदलकर,_SwipeToDismissBox_
कर दिया गया है. (I68d6d)
गड़बड़ियां ठीक की गईं
- निर्देशों के हिसाब से अलाइन करने के लिए,
ListItem
एंड पैडिंग की वैल्यू ठीक की गई. (Ibd68b, b/305342674) - आउटलाइन किए गए कार्ड के लिए आउटलाइन का रंग अब
OutlineVariant
के साथ सही तरीके से मैप किया गया है. (I75480, b/310979715) - डाइनैमिक कलर, अब सिस्टम के तय किए गए कलर रोल से लिया जाता है. इससे ऐक्सेस किए जा सकने वाले कॉन्टेंट के लिए कंट्रास्ट बेहतर होता है और डाइनैमिक कलर को मटीरियल की खास बातों के हिसाब से सेट किया जाता है. (I1de96)
- Android T/13 के बाद के वर्शन पर,
android:enableOnBackInvokedCallback="true"
सेModalBottomSheet
की बैक हैंडलिंग ठीक की गई. (I728dc, b/306196110)
वर्शन 1.2.0-beta01
13 दिसंबर, 2023
androidx.compose.material3:material3-*:1.2.0-beta01
रिलीज़ हो गया है. वर्शन 1.2.0-beta01 में ये कमिट मौजूद हैं.
एपीआई में किए गए बदलाव
TabIndicatorScope
को प्रयोग के तौर पर मार्क करें. (I45c88)- टूलटिप के लिए, काम न करने वाले एक्सपेरिमेंटल एपीआई हटाए जा रहे हैं. (I438cb)
- सब-कंपोज़िशन का इस्तेमाल न करने के लिए, नए
TabRow
ओवरलोड को बदलें. इस नतीजे के तौर पर, दिए गए कस्टम मॉडिफ़ायर के साथTabRow
इंंडिकेटर बनाने का अलग तरीका मिलता है. (Ife741) DismissDirection
औरDismissValue
एपीआई का इस्तेमाल बंद करें. इन्हेंSwipeToDismissValue
में मर्ज कर दिया गया है, जिनकी वैल्यूSwipeToDismissBox
की पोज़िशन और दिशा, दोनों दिखाती हैं.DismissState.progress
को अबFloatRange
के तौर पर,0.0
से1.0
के बीच मार्क कर दिया गया है.DismissState
बंद किए गए सेवर और कंस्ट्रक्टर को अब हटा दिया गया है.SwipeToDismiss
कॉम्पोनेंट, स्थिति, और डिफ़ॉल्ट ऑब्जेक्ट को एक्सपेरिमेंट के तौर पर मार्क किया गया है. (Ib54f2)
गड़बड़ियां ठीक की गईं
PullToRefresh
के लिए डिफ़ॉल्ट इंडिकेटर एक ठोस त्रिभुज के बजाय एक खुला ऐरोहेड है. (I67be3)
वर्शन 1.2.0-alpha12
29 नवंबर, 2023
androidx.compose.material3:material3-*:1.2.0-alpha12
रिलीज़ हो गया है. वर्शन 1.2.0-alpha12 में ये कमियां हैं.
एपीआई में किए गए बदलाव
RangeSlider
अब Kotlin रेंज लेता है (उदाहरण के लिए,0f..1f
) का इस्तेमाल करें.FloatRange
SnapFlingBehavior.kt
अब Kotlin रेंज का भी इस्तेमाल करता है. (I025cb)- मॉडिफ़ायर फ़ैक्ट्री फ़ंक्शन को
@Stable
के तौर पर मार्क करें. (Ib109f)
वर्शन 1.2.0-alpha11
15 नवंबर, 2023
androidx.compose.material3:material3-*:1.2.0-alpha11
रिलीज़ हो गया है. वर्शन 1.2.0-alpha11 में ये कमियां हैं.
नई सुविधाएं
PullToRefreshContainer
औरPullToRefreshState
को लागू करता है, जो एक साथ Material3 में रीफ़्रेश करके लागू करने की सुविधा देते हैं. (I16456, b/261760718)
एपीआई में किए गए बदलाव
SwipeToDismissBox
DismissDirection
औरDismissValue
को एक्सपेरिमेंट के तौर पर मार्क करें. (I517b0)SwipeToDismiss
का नाम बदलकरSwipeToDismissBox
करें.background
का नाम बदलकरbackgroundContent
करें. साथ ही,dismissContent
का नाम बदलकरcontent
Lambda करें. (I7f4d3)ChipElevation
औरSelectableChipElevation
के लिए कंस्ट्रक्टर को सार्वजनिक करें. (Ie0c48, b/308432421)ModalBottomSheetProperties
को जोड़ा जा रहा है.securePolicy
कोModalBottomSheetProperties
में ले जाया जा रहा है.isFocusable
औरshouldDismissOnBackPress
कोModalBottomSheetProperties
में जोड़ा जा रहा है. इन नए बूलियन्स से यह तय करने में मदद मिलती है कि मॉडल बॉटम शीट को IME इवेंट को कैसे हैंडल करना चाहिए. (Iea56f, b/278216859)initialOnValueChange
, शुरुआती प्रीफ़िक्स, और सही kdocs को हटाने के लिए,RangeSlider
औरSlider
स्टेटस को अपडेट किया गया. (I57d30)ChipBorder
क्लास और उससे जुड़े फ़ंक्शन कॉल को रोकें. इसके बजाय, सीधेBorderStroke
का इस्तेमाल करने का सुझाव दें. (I89cc2)- फ़ाउंडेशन टूलटिप एपीआई की वैल्यू अब
@ExperimentalFoundationApi
है. (I30b0b) TabRow
औरScrollableTabRow
अब काम नहीं करते. प्राइमरी और सेकंडरी वैरिएंट को एक्सपेरिमेंट के तौर पर मार्क किया गया है. (I0def6)- फ़िल्टर और इनपुट चिप अब सीधे तौर पर
BorderStroke
का इस्तेमाल करते हैं. (I07a8d) SegmentedButton
अब सीधेBorderStroke
का इस्तेमाल करता है. (I89b9b)- जेनरिक
AlertDialog
फ़ंक्शन का नाम बदलकरBasicAlertDialog
कर दिया गया है. साथ ही, पिछले फ़ंक्शन को रोक दिया गया है. (Idbe52) SwipeToDismiss
एपीआई का नाम बदलकरSwipeDismiss
करें. साथ ही,SwipeDismiss
एपीआई के नए वर्शन को स्थिर बनाएं. (I14cbe)- टूलटिप एपीआई में
tonalElevation
औरshadowElevation
को जोड़ा जा रहा है. इसके अलावा,TooltipBox
,PlainTooltip
, औरRichTooltip
एपीआई को वापस एक्सपेरिमेंटल स्टेज में ले जाया जा रहा है, क्योंकि ये गलती से स्थिर के तौर पर रिलीज़ हो गए थे. (If0f66, b/293939035) - एक्सपेरिमेंटल चिप एपीआई को बेहतर तरीके से काम करने के लिए बढ़ावा दें. (Iea2c3)
- Material3 के क्लिक किए जा सकने वाले कार्ड से,
@ExperimentalMaterial3Api
एनोटेशन को हटाया गया. (I88dbf)
गड़बड़ियां ठीक की गईं
- नेस्ट किए गए Lookahead और लेज़ी लेआउट के साथ, कुछ खास स्थितियों में
SwipeToDismiss
के क्रैश होने की समस्या को ठीक किया गया है. (Ica8d1, b/297226562)
वर्शन 1.2.0-alpha10
18 अक्टूबर, 2023
androidx.compose.material3:material3-*:1.2.0-alpha10
रिलीज़ हो गया है. वर्शन 1.2.0-alpha10 में ये कमियां हैं.
एपीआई में किए गए बदलाव
Badge
औरBadgedBox
को स्थिर में पदोन्नत किया जा रहा है. (I67f16, b/261565132)securePolicy
कोModalBottomSheet
में पैरामीटर के तौर पर जोड़ा जा रहा है, ताकि उपयोगकर्ताWindowManager.LayoutParams.FLAG_SECURE
के लिए बिहेवियर तय कर सकें. (Icdac8, b/296250262)LinearProgressIndicator
औरCircularProgressIndicator
के नए ओवरलोड जोड़े गए, जोprogress
को लैम्डा के रूप में लेते हैं. इन वर्शन की परफ़ॉर्मेंस, पिछले वर्शन से ज़्यादा होनी चाहिए. (I824e6, b/295616656)StandardSizeClasses
का नाम बदलकरAllSizeClasses
कर देता है. (I8cb07)- विंडो साइज़ की क्लास के कैलकुलेशन फ़ंक्शन जोड़ें. (Iad935)
गड़बड़ियां ठीक की गईं
DatePicker
क्रैश की समस्या को ठीक करने के लिए, नेविगेशन ऐरो बटन पर तुरंत क्लिक करें. ऐसा तब करें, जब दिखाया गया महीना सालों की तय सीमा के आखिर में हो. (I46f36, b/290954897, b/297002119)- [नेविगेशन रेल/बार] इंडिकेटर के लिए पारदर्शी रंग का इस्तेमाल किया जा सकता है. (Ie0a9b, b/267289987)
वर्शन 1.2.0-alpha09
4 अक्टूबर, 2023
androidx.compose.material3:material3-*:1.2.0-alpha09
रिलीज़ हो गया है. वर्शन 1.2.0-alpha09 में ये कमियां हैं.
एपीआई में किए गए बदलाव
- नए
AnchoredDraggable
एपीआई इस्तेमाल करने के लिए,ModalNavigationDrawer
औरDismissibleNavigationDrawer
को माइग्रेट किया गया.DrawerState
केanimateTo
को ओपन और क्लोज़ के तरीकों से बदल दिया गया है. साथ ही, ऑफ़सेट को अब स्टेट ऑब्जेक्ट के बजाय फ़्लोट के तौर पर दिखाया जाता है.currentOffset
से ऑफ़सेट को सीधे ऐक्सेस किया जा सकता है. (I0a72c) - सीधे
DatePickerState
औरDateRangePickerState
बनाने के लिए, कंपोज़ेबल फ़ंक्शन जोड़ दिए गए हैं. ज़रूरत पड़ने पर, इन फ़ंक्शन का इस्तेमाल, ComposablerememberDatePickerState
औरrememberDateRangePickerState
फ़ंक्शन के विकल्प के तौर पर किया जा सकता है. (I70326, b/291524052) - ठीक किए गए और स्क्रोल किए जा सकने वाले
TabRows
के अब प्राइमरी और सेकंडरी वैरिएंट उपलब्ध हैं. ये Material3 में बताए गए रंग और इंंडिकेटर के व्यवहार से सही ढंग से मैप करते हैं. PrimaryScrollableTabRow
औरSecondaryScrollableTabRow
में अब स्क्रोल की स्थिति दिख रही है. (Iec8f5, b/260572337)- एक नया
sheetMaxWidth
पैरामीटर जोड़ना, जिसे डेवलपर शीट की ज़्यादा से ज़्यादा चौड़ाई के बारे में बताने के लिए सेट कर सकते हैं. अगर आपको स्क्रीन की पूरी चौड़ाई वाली शीट को सेट करना है, तो पैरामीटर में Dp.Unspecified पैरामीटर को पास किया जा सकता है. (Ifb7c9, b/266697696) PlainTooltipBox
औरRichTooltipBox
एपीआई को अब काम नहीं करने वाले तरीकों के तौर पर फिर से जोड़ा जा रहा है. (I246FA)
गड़बड़ियां ठीक की गईं
- क्रैश को ठीक तब किया जाता है, जब
DatePicker
को ऐसेDatePickerFormatter
से शुरू किया जाता है जिसमें कुछ तारीख के ढांचों होते हैं, जो तारीख के पैटर्न (जैसे कि YY) में बदलने पर भी एक जैसे रहते हैं. (I01f29)
वर्शन 1.2.0-alpha08
20 सितंबर, 2023
androidx.compose.material3:material3-*:1.2.0-alpha08
रिलीज़ हो गया है. वर्शन 1.2.0-alpha08 में ये कमियां हैं.
व्यवहार में बड़ा बदलाव
ColorScheme
को अब बदला नहीं जा सकता. इसकी वजह से, अलग-अलग रंगों के अपडेट कम कारगर हैं, लेकिन रंगों का ज़्यादा इस्तेमाल किया जा रहा है. इस बदलाव की वजह यह है कि ज़्यादातर ऐप्लिकेशन में, अलग-अलग रंगों को अपडेट नहीं किया जाएगा. ऐसा अब भी किया जा सकता है. हालांकि, इस प्रोसेस को पहले की तुलना में ज़्यादा बार फिर से लागू किया जाएगा. ऐसे में, हम सभी मटीरियल कोड का इस्तेमाल करके, राज्य की सदस्यताओं की संख्या में काफ़ी कमी कर देंगे. इसका असर, सामान्य इस्तेमाल के ज़्यादा उदाहरणों के ज़रिए शुरू करने और रनटाइम की लागत पर पड़ेगा. (Ic447d, b/297212873)- टोनल एलिवेशन, निर्देशों से मेल खाने के लिए अलग-अलग इंटरैक्शन स्थितियों में ऐनिमेट नहीं होता. (Icdd12)
एपीआई में किए गए बदलाव
- एक नया
BottomAppBar
जोड़ा गया है, जोBottomAppBarScrollBehavior
पैरामीटर के तौर पर काम करता है, ताकि जब कॉन्टेंट स्क्रोल किया जाए, तब यह अपने-आप छिप जाए. साथ ही,FabPosition.EndOverlay
को जोड़ा गया, जिससे एफ़एबी को स्कैफ़ोल्ड में सबसे नीचे वाले ऐप्लिकेशन बार के ऊपर लगाने के बजाय, ओवरले करने की अनुमति मिली. (Iecb47) - एक सामान्य 'लेबल' कॉम्पोनेंट जोड़ा गया है, जो
BasicTooltipBox
के ऊपर बनता है. यह लेबल के बाहर टैप करने पर खारिज नहीं होता है. (I821f9)
गड़बड़ियां ठीक की गईं
- टूलटिप के लिए,
rememberSaveable
का इस्तेमाल हटाया गया. (Icc131, b/299500338) - यह कंट्रोल करने के लिए एक अस्थायी फ़्लैग उपलब्ध कराया गया कि स्कैफ़ोल्ड को तापमान मापने के दौरान अपने बच्चों को मापना चाहिए या प्लेसमेंट के दौरान. डिफ़ॉल्ट रूप से, इसे मेज़रमेंट में मेज़र किया जाएगा. अगर आपको नई सेटिंग में समस्याएं आ रही हैं, तो कृपया समस्या की शिकायत करें. (I0b354)
BottomSheet
में डिवाइस की स्क्रीन की चौड़ाई के लिए, सही माप का इस्तेमाल करके हॉरिज़ॉन्टल एज से एज पर सेट किया गया. (I1df0c, b/299058752)- शीट पर नीचे की ओर स्वाइप करके,
ModalBottomSheet
नेonDismissedRequest
को कॉल न करने की गड़बड़ी ठीक की है. (Idfdd8)
वर्शन 1.2.0-alpha07
6 सितंबर, 2023
androidx.compose.material3:material3-*:1.2.0-alpha07
रिलीज़ हो गया है. वर्शन 1.2.0-alpha07 में ये कमिट हैं.
नई सुविधाएं
compose material 1.6.0-alpha05
में, ऑटो-मिरर आइकॉन की सुविधा जोड़ दी गई है. ऑटो-मिरर आइकॉन के बारे में जानने के लिए, कृपया रिलीज़ की जानकारी देखें.
एपीआई में किए गए बदलाव
SliderState
,DraggableState
(I9b116) को लागू करता है- आकार को ज़रूरी पैरामीटर बनाने के लिए बदलें. आकार हेल्पर फ़ंक्शन में,
position
का नाम बदलकरindex
करें. (I34941) - परफ़ॉर्मेंस को बेहतर बनाने के लिए कैश मेमोरी के तौर पर इस्तेमाल किए जाने वाले मैप को शामिल करने के लिए,
DatePicker
formatWithSkeleton
को अपडेट करता है. (I3195f) BasicTooltipBox
कोcompose.foundation
में जोड़ा गया. साथ ही,PlainTooltipBox
औरRichTooltipBox
को अपडेट किया गया, ताकिTooltipBox
नएPlainTooltip
औरRichTooltip
कंपोज़ेबल के साथ इस्तेमाल किया जा सके. (I79e1d)
गड़बड़ियां ठीक की गईं
dynamicLightColorScheme
औरdynamicDarkColorScheme
, अब सरफ़ेस औरsurfaceContainer
भूमिकाओं के लिए क्रोमा के ज़्यादा रंग दिखाते हैं. (I5e901)- उस समस्या को ठीक किया गया है जहां
LookaheadScope
के अंदर, स्कैफ़ोल्ड के अंदर सबकंपोज़िशन (जैसे किBottomSheetScaffold
) का इस्तेमाल करने वाले कुछ कॉम्पोनेंट, साइज़ को बहुत जल्दी पढ़ने की कोशिश कर रहे थे. (I297b4, I871f1, b/295536718)
वर्शन 1.2.0-alpha06
23 अगस्त, 2023
androidx.compose.material3:material3-*:1.2.0-alpha06
रिलीज़ हो गया है. वर्शन 1.2.0-alpha06 में ये कमियां हैं.
गड़बड़ियां ठीक की गईं
DropdownMenu
केoffset
का कैलकुलेशन करने पर, x ऑफ़सेट पूरी तरह से आपके डिवाइस के लेआउट की दिशा के हिसाब से तय होते हैं. स्क्रीन के निचले हिस्से के पास मेन्यू होने पर, y ऑफ़सेट को उलटा नहीं किया जाएगा. (IFCC74, b/294103942)DropdownMenu
केoffset
का कैलकुलेशन करने पर, x ऑफ़सेट पूरी तरह से आपके डिवाइस के लेआउट की दिशा के हिसाब से तय होते हैं. स्क्रीन के निचले हिस्से के पास मेन्यू होने पर, y ऑफ़सेट को उलटा नहीं किया जाएगा. (Ib87a2, b/294103942)
वर्शन 1.2.0-alpha05
9 अगस्त, 2023
androidx.compose.material3:material3-*:1.2.0-alpha05
रिलीज़ हो गया है. वर्शन 1.2.0-alpha05 में ये कमियां हैं.
एपीआई में किए गए बदलाव
- चेकबॉक्स और
TriStateCheckbox
रंगों के लिए अपडेट.CheckboxDefaults.colors()
disabledUncheckedColor
अब सिर्फ़ चेकबॉक्स के बॉर्डर पर असर डालता है. खास मामलों में, बंद किए जाने और सही का निशान हटाने पर, आपको बॉक्स के अंदर बॉक्स का रंग सेट करना पड़ता है. ऐसे मामलों में, अपने हिसाब से रंग की वैल्यू वालेCheckboxColors
के कस्टम इंस्टेंस की ज़रूरत होती है. (I77d17, b/291943198)
वर्शन 1.2.0-alpha04
26 जुलाई, 2023
androidx.compose.material3:material3-*:1.2.0-alpha04
रिलीज़ हो गया है. वर्शन 1.2.0-alpha04 में ये कमियां हैं.
नई सुविधाएं
- एक्सपेरिमेंटल सेगमेंट किया गया बटन एपीआई (Ifc8fb)
- वर्टिकल डिवाइडर के साथ काम करने के लिए, स्क्रीन की दिशा को कंट्रोल करने के लिए अब डिवाइडर का पैरामीटर उपलब्ध है. (I4c899, b/288438593)
एपीआई में किए गए बदलाव
- हम डेंसिटी डिपेंडेंसी को कॉम्पोनेंट लेवल पर ले जा रहे हैं. यह इन कॉम्पोनेंट पर लागू होता है:
SwipeToDismiss
और शीट पर आधारित कॉम्पोनेंट. जहां सघनता एक पैरामीटर है, कृपया दिए गए नए ओवरलोड का इस्तेमाल करें. (I1846e) - कंपोज़ेबल में अनुमति वाले इनपुट के बारे में बताने के लिए अतिरिक्त एनोटेशन (Ief234)
- सेगमेंट किए गए बटन में आइकॉन पैरामीटर और सिमैंटिक को अलग-अलग करें, ताकि सेगमेंट किए गए बटन को एक बार में चुनने के विकल्प को लागू किया जा सके और
SelectableSegmentedButtonRow
औरToggelableSegmentedButtonRow
के साथ, एक से ज़्यादा विकल्प लागू करने के लिए टॉगल किया जा सके. (I38740) - डिवाइडर का नाम बदलकर
HorizontalDivider
कर दिया गया है.VerticalDivider
फ़ंक्शन जोड़ा गया. (I5975c) - ऑटोबॉक्सिंग को कम करने के लिए, प्रयोग के तौर पर इस्तेमाल होने वाले Material3 एपीआई में कम वज़न
FloatRange
के लिए,ClosedFloatingPointRange
का इस्तेमाल बदलें. (I4aab5) FabPosition
(Ib7aea, b/170592777) के लिए, नया स्टार्ट अलाइनमेंट जोड़ा गया
गड़बड़ियां ठीक की गईं
ModalBottomSheet
, लोकल लेआउट की दिशा का ध्यान रखता है. (Ib4f44, b/285628622)
वर्शन 1.2.0-alpha03
21 जून, 2023
androidx.compose.material3:material3-*:1.2.0-alpha03
रिलीज़ हो गया है. वर्शन 1.2.0-alpha03 में ये कमियां हैं.
व्यवहार में बदलाव
- मटीरियल 3 की टाइपोग्राफ़ी में,
includeFontPadding
का नाम अब डिफ़ॉल्ट रूप सेfalse
हो गया है. लाइन की ऊंचाई की डिफ़ॉल्ट स्टाइल को भीTrim.None
औरAlignment.Center
में बदल दिया गया है. साथ ही,Typography
केTextStyle
में साफ़ तौर परlineHeight
(एसपी में) जोड़ दिया गया है. अगर आपको इन वैल्यू को अपनी पसंद के मुताबिक बनाना है, तो एपीआई के दस्तावेज़ देखें. साथ ही, इन बदलावों के बारे में ज़्यादा जानने के लिए, ब्लॉग पोस्ट देखें. (I6266f, Icabc3)
नई सुविधाएं
RangeSlider
के लिए ओवरलोड जोड़ा गया, जो कॉम्पोनेंट का स्टेटफ़ुल वर्शन है.RangeSliderState
बनाया गया, जिसमें मौजूदा चालू ट्रैक की सारी जानकारी,RangeSlider
के कॉम्पोनेंट के माप, और ड्रैग और जेस्चर लॉजिक की पूरी जानकारी मौजूद होती है. (I8c270)- खोज बार में, जोड़े गए नए
shadowElevation
पैरामीटर की मदद से अब शैडो का इस्तेमाल किया जा सकता है. (Ia5369, b/271040353) ColorScheme
में अब नईSurfaceContainer
भूमिकाएं काम करती हैं.- सरफ़ेस टोनल एलिवेशन ओवरले को अब
LocalTonalElevationEnabled
कंपोज़िशन लोकल से बंद किया जा सकता है. (Ic203c, b/277774590)
एपीआई में किए गए बदलाव
- कॉम्पोनेंट के कलर कंस्ट्रक्टर खोलें. (I8c4a6)
- फ़ोकस करने लायक पैरामीटर को दोनों टूलटिप एपीआई में जोड़ना, ताकि डेवलपर टूलटिप को टच इवेंट का इस्तेमाल करने या न करने का विकल्प दे सकें. सावधान रहें कि इससे सुलभता फ़ोकस के ऑटोमैटिक ट्रैवर्सल पर असर पड़ सकता है. (Ie32d8)
- परफ़ॉर्मेंस और मेमोरी के बंटवारे के लिए, बेहतर सुलभता सुविधाएं. (Iede48)
DefaultSizeClasses
का उपयोग करें औरWindowSizeClasses
(I91838) के लिएStandardSizeClasses
बनाएंWindowWidth/HeightSizeClass
को फ़्लोट वैल्यू क्लास (Ie686e) में बदलें
गड़बड़ियां ठीक की गईं
- अब स्कैफ़ोल्ड का
contentWindowInsets
पैरामीटर, इस्तेमाल किए गए विंडो इनसेट के हिसाब से काम करता है. ध्यान दें किtopBar
औरbottomBar
पर आधारित कॉन्टेंट पैडिंग (जगह) पर होने वाले असर में, इन पैरामीटर का इस्तेमाल करने से कोई बदलाव नहीं होगा. (I08b73, b/264601542) - ऐप्लिकेशन के बीच में सबसे ऊपर मौजूद बार का अलाइनमेंट ठीक करें, ताकि यह पक्का किया जा सके कि ऐक्शन आइकॉन या नेविगेशन आइकॉन पर लंबा टाइटल न दिखे. (I4369f, b/236994621)
- टैब की पोज़िशन के हिसाब से, अब कॉन्टेंट की चौड़ाई कम से कम 24.dp होती है. इससे टैब इंडिकेटर के लिए ऐक्सेस किया जा सकने वाला टच टारगेट मिलता है. (आईडी8861)
dynamicLightColorScheme
औरdynamicDarkColorScheme
के डाइनैमिक रंग पटल अब नई सरफ़ेस भूमिकाओं के साथ काम करते हैं. (I1252e)- दादा-दादी से टकराते समय बैज की सूचना के अलाइनमेंट को क्लिप की जगह इस्तेमाल न करने के लिए सेट करें. (Idf75a)
वर्शन 1.2.0-alpha02
24 मई, 2023
androidx.compose.material3:material3-*:1.2.0-alpha02
रिलीज़ हो गया है. वर्शन 1.2.0-alpha02 में ये कमियां हैं.
एपीआई में किए गए बदलाव
ModalBottomSheet
में विंडो इनसेट पैरामीटर जोड़ें.ModalBottomSheet
के लिए स्क्रिम को अब स्टेटस बार के पीछे खींचा जा सकता है. साथ ही,windowInsets
को शून्य पर सेट किया जा सकता है- नेविगेशन और सिस्टम बार से बाहर रहने के लिए,
ModalBottomSheet
की डिफ़ॉल्ट सुविधा अपडेट की गई - स्टेटस बार इनसेट हैंडलिंग, एक से दूसरे किनारे वाले मोड में खींचने वाले हैंडल से दी जाती है.
BottomSheetDefaults
मेंBottomSheetWindow
के लिए विंडो इनसेट शामिल हैं. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/161483, b/161483)
Indicator
को बंद करें और M3 की विशेषताओं के हिसाब सेPrimary
/SecondaryIndicator
जोड़ें.PrimaryIndicator
, टैब के कॉन्टेंट की चौड़ाई से मेल खाता है, जबकिSecondaryIndicator
की चौड़ाई पूरी स्क्रीन में दिखती है.SecondaryIndicator
, अब काम नहीं करने वालेIndicator
के बराबर है. इसे सीधे तौर पर बदला जा सकता है. (I27604)DropdownMenu
याExposedDropdownMenu
बनाते समय, मेन्यू में दिखाए गए आइटम की वर्टिकल स्क्रोल स्थिति को कंट्रोल करने के लिए,ScrollState
में पास करने का विकल्प जोड़ा गया. (Ia0734, b/185304441)Slider
के लिए ओवरलोड जोड़ा गया, जो कॉम्पोनेंट का स्टेटफ़ुल वर्शन है.SliderState
बनाया गया, जिसमें मौजूदा चालू ट्रैक की सारी जानकारी,Slider
के कॉम्पोनेंट के माप, और खींचें और हाथ के जेस्चर का लॉजिक शामिल है. (I124a5)- सिमैंटिक प्रॉपर्टी का नाम
isContainer
सेisTraversalGroup
किया जा रहा है (I121f6) - पूरे पैरामीटर सूची के साथ ऑप्टिमाइज़ की गई
TextStyle.merge(...)
को जोड़ा गया. (Iad234, b/246961787) TooltipState
,RichTooltipState
, औरPlainTooltipState
को सार्वजनिक इंटरफ़ेस बनाया गया. डिफ़ॉल्ट स्थितियों के लिए,RichTooltipStateImpl
औरPlainTooltipStateImpl
को जोड़ा गया. लागू किए गए इन स्टेटस को पाने के लिए,remember*State
फ़ंक्शन जोड़े गए.TooltipDefault.GlobalMutatorMutex
के पक्ष मेंTooltipSync
को हटाया गया. (I7813d)- तारीख चुनने वाले टूल के डिवाइडर, नेविगेशन, और टेक्स्ट इनपुट फ़ील्ड के कलर के लिए, पसंद के मुताबिक अतिरिक्त विकल्प शामिल करने के लिए,
DatePickerColors
को अपडेट किया गया. (I1a685, b/274626815) DatePickerState
औरDateRangePickerState
अब सार्वजनिक इंटरफ़ेस हैं. इन्हें डिफ़ॉल्ट तौर पर लागू किया जाता है. इन्हेंrememberDatePickerState
औरrememberDateRangePickerState
से वापस लाया जा सकता है. (I71c52)dateValidator
कोDatePicker
औरDateRangePicker
से हटा दिया गया है. साथ ही,SelectableDates
इंटरफ़ेस जोड़ा गया है. इस इंटरफ़ेस की स्थिति को कंट्रोल किया जा सकता है. इससे यह कंट्रोल किया जा सकता है कि यूज़र इंटरफ़ेस (यूआई) में कौनसी तारीख या साल चुने जा सकते हैं. (Ic2fc6)TimePicker
को स्टेबल एपीआई से हटा दिया गया है. एपीआई स्टेटस (I3f39a) में और बदलाव हो सकते हैंModalBottomSheet
को सिर्फ़ Android पर ले जाया गया.ModalBottomSheet
को डेस्कटॉप पर इस्तेमाल करने का सुझाव नहीं दिया जाता. साथ ही, इस सुविधा को सक्रिय रूप से मैनेज नहीं किया जाता है. (Ib3778)
गड़बड़ियां ठीक की गईं
- 'पुष्टि करें' कार्रवाई के नीचे दिखने वाली,
AlertDialog
खारिज करने की कार्रवाई को ठीक किया गया है, ताकि डायलॉग की चौड़ाई में फ़िट होने के लिए, ऐक्शन को एक-दूसरे के ऊपर रखा जा सके. यह सुधार, लागू करने की प्रक्रिया को मटीरियल डिज़ाइन की खास बातों के साथ अलाइन करता है. (I029de, b/235454277) - तीन लाइन वाले आइटम के लिए गलत पैडिंग (जगह) का इस्तेमाल करके,
ListItem
की गड़बड़ी को ठीक किया गया. (I6e235) ModalBottomSheet
अब IME कीबोर्ड (Idc508, b/262140644, b/268380384, b/272483584) दिखा सकता है
वर्शन 1.2.0-alpha01
10 मई, 2023
androidx.compose.material3:material3:1.2.0-alpha01
और androidx.compose.material3:material3-window-size-class:1.2.0-alpha01
रिलीज़ हुई हैं. वर्शन 1.2.0-alpha01 में ये कमियां हैं.
वर्शन 1.1
वर्शन 1.1.2
20 सितंबर, 2023
androidx.compose.material3:material3:1.1.2
और androidx.compose.material3:material3-window-size-class:1.1.2
रिलीज़ हुई हैं. वर्शन 1.1.2 में ये कमियां शामिल हैं.
गड़बड़ियां ठीक की गईं
- ठीक किए गए मॉडिफ़ायर को गलती से दो कंपोज़ेबल में पास किया जा रहा है. (b/282761472)
- ठीक किया गया
TimePickerState
, 23 घंटों से शुरू होने पर गलत घंटे दिखाता है. (b/278242122) - दोपहर और मिनट की पुष्टि के लिए, शुरुआती टॉगल की स्थिति को ठीक किया गया. (b/269768197, b/282790635)
- 11pm के लिए गलत मान लौटाने वाला
state.hour
ठीक किया गया. (b/282761472, b/278242122)
वर्शन 1.1.1
21 जून, 2023
androidx.compose.material3:material3:1.1.1
और androidx.compose.material3:material3-window-size-class:1.1.1
रिलीज़ हुई हैं. वर्शन 1.1.1 में ये कमियां शामिल हैं.
गड़बड़ियां ठीक की गईं
- बाइनरी साथ काम करने के लिए,
windowInset
पैरामीटर के बिनाModalBottomSheet
के लिए कॉल जोड़ता है. (Ib7959) ModalBottomSheet
में विंडो इनसेट पैरामीटर जोड़ें.ModalBottomSheet
के लिए स्क्रिम को अब स्टेटस बार के पीछे खींचा जा सकता है. साथ ही,windowInsets
को शून्य पर सेट किया जा सकता है- नेविगेशन और सिस्टम बार से बाहर रहने के लिए,
ModalBottomSheet
की डिफ़ॉल्ट सुविधा अपडेट की गई - स्टेटस बार इनसेट हैंडलिंग, एक से दूसरे किनारे वाले मोड में खींचने वाले हैंडल से दी जाती है.
BottomSheetDefaults
मेंBottomSheetWindow
के लिए विंडो इनसेट शामिल हैं. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/161483, b/161483)
वर्शन 1.1.0
10 मई, 2023
androidx.compose.material3:material3:1.1.0
और androidx.compose.material3:material3-window-size-class:1.1.0
रिलीज़ हुई हैं. वर्शन 1.1.0 में ये कमियां शामिल हैं.
1.1.0 की मुख्य सुविधाएं
नए मटीरियल डिज़ाइन के तीन कॉम्पोनेंट
मौजूदा मटीरियल डिज़ाइन 3 कॉम्पोनेंट को बेहतर बनाया गया है.
एक्सपेरिमेंट वाले एपीआई को स्थिर में प्रमोट किया गया!
ज़्यादा जानकारी के लिए, कृपया यह ब्लॉग पोस्ट देखें!
वर्शन 1.1.0-rc01
19 अप्रैल, 2023
androidx.compose.material3:material3:1.1.0-rc01
और androidx.compose.material3:material3-window-size-class:1.1.0-rc01
रिलीज़ हुई हैं. वर्शन 1.1.0-rc01 में ये कमिट शामिल हैं.
एपीआई में किए गए बदलाव
TimePicker
को स्टेबल एपीआई से हटा दिया गया है. एपीआई स्टेटस (I3f39a) में और बदलाव हो सकते हैंModalBottomSheet
को सिर्फ़ Android पर ले जाया गया.ModalBottomSheet
को डेस्कटॉप पर इस्तेमाल करने का सुझाव नहीं दिया जाता. साथ ही, इस सुविधा को सक्रिय रूप से मैनेज नहीं किया जाता है. (Ib3778)
वर्शन 1.1.0-beta02
5 अप्रैल, 2023
androidx.compose.material3:material3:1.1.0-beta02
और androidx.compose.material3:material3-window-size-class:1.1.0-beta02
रिलीज़ हुई हैं. वर्शन 1.1.0-beta02 में ये तय किए गए हिस्से शामिल हैं.
एपीआई में किए गए बदलाव
SheetState
में अबskipHiddenState
पैरामीटर का इस्तेमाल करना ज़रूरी नहीं हैrememberStandardBottomSheetState
में अबskipHiddenState
पैरामीटर का इस्तेमाल करना ज़रूरी नहीं हैBottomSheetScaffold
में अब पहले से तय 'छिपा हुआ ऐंकर' मौजूद है. हालांकि, यह डिफ़ॉल्ट रूप से बंद रहता हैSheetState.requireOffset
दस्तावेज़ अपडेट कर दिया गया हैBottomSheetDefaults.MinimizedShape
का नाम बदलकरBottomSheetDefaults.HiddenShape
कर दिया गया है (I839f4, b/273870234)
गड़बड़ियां ठीक की गईं
- टच एक्सप्लोरेशन चालू होने पर, डायल फ़ेस को घंटे से मिनट में स्विच न करें. (I717d0)
ModalBottomSheet
औरBottomSheetScaffold
ड्रैग हैंडल सिमैंटिक को अब मर्ज कर दिया गया है. (I05afb)BottomSheetScaffold
मॉडिफ़ायर,containerColor
, औरcontentColor
पैरामीटर अब सिर्फ़ कॉन्टेंट पर असर डालते हैं. (I992cb)- शीट कॉन्टेंट के लिए
BottomSheetScaffold nestedScroll
अब फ़्लिंग लागू करता है. (I992cb)
वर्शन 1.1.0-beta01
22 मार्च, 2023
androidx.compose.material3:material3:1.1.0-beta01
और androidx.compose.material3:material3-window-size-class:1.1.0-beta01
रिलीज़ हुई हैं. वर्शन 1.1.0-beta01 में ये तय किए गए हिस्से शामिल हैं.
एपीआई में किए गए बदलाव
TimePicker
कंपोज़ेबल में लेआउट टाइप पैरामीटर जोड़ें. यह स्क्रीन कॉन्फ़िगरेशन (Ia0e16) के आधार पर अलग-अलग लेआउट का इस्तेमाल करने की अनुमति देता हैSearchBarDefaults
को प्रयोग के तौर पर मार्क किया गया है. (I65561)BottomSheetScaffold
में शैडो एलिवेशन जोड़ा गया (I94e0f)- हेडर वाले हिस्से के बिना, तारीख चुनने वाले टूल दिखाने की सुविधा जोड़ी गई. तारीख चुनने वाला टूल बनाते समय, शून्य हेडलाइन पास करने की अनुमति देने के लिए, एपीआई में बदलाव किए जाते हैं. अब बिना हेडलाइन, टाइटल, और
showToggleMode = false
को पास करके, बिना ग्राफ़िक यूज़र इंटरफ़ेस वाला पिकर दिखाया जा सकता है. (Id3f3a, b/266132421, b/267194809)
गड़बड़ियां ठीक की गईं
- जब डिवाइस को इस्तेमाल नहीं किया जाता है, तब खोज बार से फ़ोकस अपने-आप हट जाता है. (I22a7c, b/261444487)
DateRangePicker
को अपडेट किया गया, ताकि शुरू और खत्म होने की एक ही तारीख वाली रेंज को चुना जा सके. (I16529, b/272882497)- फ़ॉन्ट का साइज़ उम्मीद से छोटा होने पर, टेक्स्ट फ़ील्ड अब अपने टेक्स्ट एलिमेंट को सही जगह पर रख सकते हैं. इससे फ़ॉन्ट सेटिंग और स्क्रिप्ट के आधार पर, आपके ऐप्लिकेशन में कुछ पिक्सल में बदलाव हो सकता है. (I8b8d0)
- बॉटम शीट सिमैंटिक कार्रवाइयों में अब लेबल हैं. (I277b0)
वर्शन 1.1.0-alpha08
8 मार्च, 2023
androidx.compose.material3:material3:1.1.0-alpha08
और androidx.compose.material3:material3-window-size-class:1.1.0-alpha08
रिलीज़ हुई हैं. वर्शन 1.1.0-alpha08 में ये कमियां हैं.
नई सुविधाएं
BottomSheetScaffold
औरBottomSheetScaffoldState
के लिए सहायता जोड़ी गई. (I063d4)
एपीआई में किए गए बदलाव
- शुरुआती स्थिति बनाने के बाद तारीखों को सेट करने की अनुमति देने के लिए,
DatePickerState
औरDateRangePickerState
में एक सुविधा जोड़ी गई. साथ ही, शून्य टाइमस्टैंप सेट करके चुनी गई सेटिंग को रीसेट किया जा सकता है. तारीखों को मैन्युअल तरीके से सेट करते समय सावधानी बरतें. अगर दी गई तारीख पहले से तय नहीं हो पाती है, तो नयाsetSelection
फ़ंक्शन अपवाद दिखाएगा (दस्तावेज़ देखें). (Ifa645, b/268609314, b/270427389) - इस स्थिति में व्यवहार को ज़्यादा सटीक और सुविधाजनक ढंग से दिखाने के लिए,
SheetValue
का नाम बदलकरPartiallyExpanded
किया गया. (Ia1491) ListItem
पैरामीटर के नामों को _text के बजाय, _content में अपडेट किया गया. जहां ज़रूरी हो वहां डिफ़ॉल्ट गैटर अबReadOnlyComposables
हो गए हैं. (I69a25)- एक्सपेरिमेंट के तौर पर इस्तेमाल किए जा रहे प्लैटफ़ॉर्म के एपीआई इस्तेमाल करें. (I90d59, b/261561812)
गड़बड़ियां ठीक की गईं
- उस समस्या को ठीक कर दिया गया है जिसकी वजह से
ModalBottomSheet
केHalfExpanded
की स्थिति का हिसाब गलत तरीके से लगाया गया था और शीट फ़्लोटिंग लग रही थी. (I45e84, b/268411386) ModalBottomSheet
के लिए टैप को स्क्रिम करने के लिएconfirmValueChange
चेक जोड़ें. (I2311a, b/270425759)- हैंडल को खींचने के लिए, सिमैंटिक
BottomSheet
कार्रवाइयों को ले जाएं. (I158ba) ModalBottomSheet
अब लॉन्च पर फ़ोकस करता है और 'वापस जाएं' बटन को हैंडल करता है. (I4d2ab)ModalBottomSheet onDismissRequest
को अब नेस्ट किए गए स्क्रोल फ़्लिंग के दौरान भी हैंडल किया जाता है. (I655c5, b/268433166)
वर्शन 1.1.0-alpha07
22 फ़रवरी, 2023
androidx.compose.material3:material3:1.1.0-alpha07
और androidx.compose.material3:material3-window-size-class:1.1.0-alpha07
रिलीज़ हुई हैं. वर्शन 1.1.0-alpha07 में ये कमिट हैं.
नई सुविधाएं
- ऐसा टाइम इनपुट कंपोज़ेबल जोड़ें जो
rememberTimePickerState()
के साथ काम करता हो. यह टाइम इनपुट (Ia4fab) के लिए, M3 की खास जानकारी का पालन करता है - तारीखों की सीमा चुनने के लिए, Material 3
DateRangePicker
API जोड़ा गया. (I7a6c3, b/267194809) DateRangePicker
API के ज़रिए तारीख की सीमाएं चुनने के लिए, Material 3 इनपुट मोड की सुविधा जोड़ी गई. (Ifdbc4)- टेक्स्ट फ़ील्ड के रंग अब पसंद के मुताबिक बनाने की अनुमति देते हैं:
- फ़ोकस और गड़बड़ी की स्थिति के आधार पर, इनपुट फ़ील्ड और प्लेसहोल्डर टेक्स्ट के रंग.
textColor
पैरामीटर का नाम बदलकर,unfocusedTextColor
औरplaceholderColor
का नाम बदलकरunfocusedPlaceholderColor
किया गया है. - नए
errorContainerColor
पैरामीटर के साथ गड़बड़ी की स्थिति के आधार पर, भरे हुए टेक्स्ट फ़ील्ड के लिए कंटेनर का रंग.
- फ़ोकस और गड़बड़ी की स्थिति के आधार पर, इनपुट फ़ील्ड और प्लेसहोल्डर टेक्स्ट के रंग.
- नए प्रीफ़िक्स और सफ़िक्स एपीआई के साथ काम करने के लिए, एक्सपोज़ किए गए ड्रॉपडाउन मेन्यू के टेक्स्ट फ़ील्ड के कलर को पैरामीटर के साथ अपडेट कर दिया गया है. (I9c8b4, b/254284181, b/264766350)
एपीआई में किए गए बदलाव
- स्लाइडर एपीआई के कुछ वर्शन को पहले जैसा करें. साथ ही, ऐसे स्लाइडर ओवरलोड हटाएं जिन्हें एक्सपेरिमेंट के तौर पर शुरू किया गया है. साथ ही, पसंद के मुताबिक थंब और ट्रैक सेट करने की सुविधा का इस्तेमाल किया जा रहा है.
RangeSlider
को स्थिर बनाया जा रहा है. (Ie8fbd) - चिप के एलिवेशन फ़ंक्शन में,
defaultElevation
का नाम बदलकरelevation
किया गया. (I0f872) - नीचे दिए गए Material 3 टेक्स्ट फ़ील्ड एपीआई, अब एक्सपेरिमेंट के तौर पर उपलब्ध नहीं हैं:
TextField
,OutlinedTextField
,textFieldWithLabelPadding
,textFieldWithoutLabelPadding
,outlinedTextFieldPadding
. (Ieb5c0, b/261561819) TimePickers
is24Hour
, सिस्टम सेटिंग (I18856) का इस्तेमाल करता है- स्कैफ़ोल्ड एपीआई से, प्रयोग के तौर पर इस्तेमाल की गई जानकारी हटाई गई. (Ibb51e, b/261565765, b/261436953)
गड़बड़ियां ठीक की गईं
ModalBottomSheet
का डिफ़ॉल्ट आकार अब हमेशाSheetDefaults.ExpandedShape
पर सेट होता है. (I0dfca)- Material 3
DatePicker
औरDateRangePicker
के लिए सुलभता सुधार. (I5087e) - वह बग ठीक किया गया है जहां अधिकतम ऊंचाई कंस्ट्रेंट लागू किया जाता है और क्रैश हो सकता है. (I30d8c)
- क्लिक किए जा सकने वाले और चुने जा सकने वाले प्लैटफ़ॉर्म से सिमैंटिक भूमिकाएं हटा दी गई हैं. साथ ही, अपडेट किए गए कॉम्पोनेंट को भी हटाया गया है. ये कॉम्पोनेंट, मॉडिफ़ायर.सिमेंटिक्स (I793d9) का इस्तेमाल करके भूमिकाएं सेट करने के लिए इस्तेमाल किए गए थे.
वर्शन 1.1.0-alpha06
8 फ़रवरी, 2023
androidx.compose.material3:material3:1.1.0-alpha06
और androidx.compose.material3:material3-window-size-class:1.1.0-alpha06
रिलीज़ हुई हैं. वर्शन 1.1.0-alpha06 में ये कमिट हैं.
नई सुविधाएं
- टेक्स्ट फ़ील्ड अब प्रीफ़िक्स और सफ़िक्स टेक्स्ट (Ia8578, b/179884561) के साथ काम करते हैं
- मटीरियल 3 की खास जानकारी के हिसाब से, टाइम पिकर दिखाने के लिए
TimePicker
फ़ंक्शन जोड़ा गया. इसका इस्तेमालTimePickerState
और सुविधा के तरीकेrememberTimePickerState
(I71910) के साथ किया गया है DatePicker
में तारीख का इनपुट अब डिसप्ले मोड है. तारीख चुनने वाले टूल और तारीख इनपुट मोड के बीच स्विच करने की सुविधा जोड़ी गई. (Ieeff7)RichTextTooltips
के लिए एपीआई जोड़ा गया. (I58ef3)ModalBottomSheet
औरModalBottomSheetDefaults
सहित Material 3 के लिए, मोडल बॉटम शीट लागू करना.SheetState
औरrememberSheetState
के बारे में भी बताया जाता है, जिनका इस्तेमाल आगे के शीट कॉम्पोनेंट के लिए किया जा सकता है. (I0853a, b/244189383)
एपीआई में किए गए बदलाव
- एपीआई को स्टेबलाइज़ करें
showSnackbar
(I195c2, b/261424370) - असिस्ट चिप और सुझाव चिप के लिए एपीआई को स्टेबलाइज़ करें (Ibb67b, b/261424370)
ListItem
,ListItemDefaults
, औरListItemColors
एपीआई को बिना एक्सपेरिमेंट वाले (I7e7fa, b/261438882) में प्रमोट करता हैSliderPositions
,SliderDefaults.Thumb
, औरSliderDefaults.Track
को स्थिर में पदोन्नत किया जा रहा है और कस्टम थंब्स और ट्रैक वाले गैर-प्रयोगात्मकSlider
औरRangeSlider
API जोड़े जा रहे हैं. साथ ही, पिछलेSlider
औरRangeSlider
एपीआई भी बंद किए जा रहे हैं. (Ie5ea6, b/261566890)Modifier.tooltipAnchor()
को सार्वजनिक के तौर पर सेट किया गया है, ताकि डेवलपर इसे ऐंकर पर भेज सकें. इससे पता चलता है कि देर तक दबाए रखने पर टूलटिप दिखनी चाहिए.PlainTooltipBox
एपीआई को अपडेट किया गया, ताकिTooltipState
को शून्य न होने लायक न बनाया जा सके. साथ ही, अब इसे डिफ़ॉल्ट के तौर पर सेट कर दिया गया है. (Ie2fb7)ProgressIndicatorDefaults.circularTrackColor
को लगातार@Composable
के तौर पर मार्क किया गया है. (आईडी29सीसी)- वापस लाया गया प्रॉपर्टी गैटर
LocalMinimuTouchTargetEnforcement
. इसे 'अब काम नहीं करता' के तौर पर मार्क करके,LocalMinimumInteractiveComponentEnforcement
पर रीडायरेक्ट करें. (I60dd5)
वर्शन 1.1.0-alpha05
26 जनवरी, 2023
androidx.compose.material3:material3:1.1.0-alpha05
और androidx.compose.material3:material3-window-size-class:1.1.0-alpha05
रिलीज़ हुई हैं. वर्शन 1.1.0-alpha05 में ये कमियां हैं.
नई सुविधाएं
DatePickerDialog
और सुलभता सहायताRangeSlider
में कस्टम थंब और ट्रैक जोड़ा गया.
डिपेंडेंसी से जुड़े अपडेट
- अब
Compose UI
औरCompose Material
, लाइफ़साइकल 2.6.0 पर निर्भर करते हैं.
वर्शन 1.1.0-alpha04
11 जनवरी, 2023
androidx.compose.material3:material3:1.1.0-alpha04
और androidx.compose.material3:material3-window-size-class:1.1.0-alpha04
रिलीज़ हुई हैं. वर्शन 1.1.0-alpha04 में ये कमियां हैं.
नई सुविधाएं
- कैलेंडर यूज़र इंटरफ़ेस (यूआई) के ज़रिए एक तारीख चुनने के लिए, शुरुआती
DatePicker
एपीआई. इस एपीआई में अब भी बदलाव हो रहे हैं. (I722b9) PlainTooltipBox
के ज़रिए सादे टूलटिप के लिए सहायता जोड़ी गई. (I0cdfb)- खोज बार (Iad128)
SwipeToDismiss
(I458a8, b/242889540)
एपीआई में किए गए बदलाव
- Surfaces पर
IsContainer
सिमैंटिक प्रॉपर्टी में जोड़ा गया. इस प्रॉपर्टी का इस्तेमाल बाद के किसी बदलाव में किया जाएगा. यह बदलाव, सरफ़ेस जैसे एलिमेंट के मतलब के आधार पर ट्रैवर्सल ऑर्डर को तय करता है. (I63379) - नेविगेशन पैनल से जुड़े एपीआई को स्थिर के तौर पर मार्क करें. (Iab01e, b/261439597)
- सर्कुलर प्रोग्रेस इंडिकेटर के लिए एक ट्रैक कलर पैरामीटर जोड़ा गया. साथ ही, सर्कुलर और लीनियर, दोनों तरह की प्रोग्रेस इंडिकेटर के लिए, स्ट्रोक कैप पैरामीटर जोड़ा गया. (Ie668c, b/216325962, b/222964817)
- काम न करने वाले छिपे हुए फ़ंक्शन की ज़्यादा रिटर्न टाइप शून्यता (Ibf7b0)
Modifier.minimumInteractiveComponentSize
जोड़ें. अगर एलिमेंट का साइज़ छोटा होगा, तो टच इंटरैक्शन को अलग करने के लिए इसका इस्तेमाल कम से कम 48.dp का साइज़ रिज़र्व करने के लिए किया जा सकता है. (I33f58, b/258495559)AlertDialog
कंपोज़ेबल के लिए एक्सपेरिमेंट के तौर पर उपलब्ध एपीआई जोड़ा गया, जिसमें कॉन्टेंट स्लॉट है. (Iec4a2)
गड़बड़ियां ठीक की गईं
- प्रोग्रेस इंडिकेटर की प्रोग्रेस को अब अपनी उम्मीद के मुताबिक रेंज के तौर पर सेट किया गया है. (I8a7eb, b/262262727)
आम समस्या
androidx.compose.foundation:1.4.0-alpha03
सेandroidx.compose.foundation:1.4.0-alpha04
में अपडेट करने पर, आपकोjava.lang.NoSuchFieldError
गड़बड़ी दिख सकती है. यहां वह जगह है जहां पर समस्या की मूल रूप से रिपोर्ट की गई थी. समस्या का हल सबमिट कर दिया गया है और यह विकल्प Compose के अगले अपडेट में उपलब्ध होगा. काम करने के लिए, अपनीandroidx.compose.material
औरandroidx.compose.material3
लाइब्रेरी को नए वर्शन(1.1.0-alpha04) में अपडेट करें या अपनेandroidx.compose.foundation
को 1.4.0-alpha03 पर डाउनग्रेड करें.
वर्शन 1.1.0-alpha03
7 दिसंबर, 2022
androidx.compose.material3:material3:1.1.0-alpha03
और androidx.compose.material3:material3-window-size-class:1.1.0-alpha03
रिलीज़ हुई हैं. वर्शन 1.1.0-alpha03 में ये कमियां हैं.
एपीआई में किए गए बदलाव
consumedWindowInsets()
का नाम बदलकरconsumeWindowInsets()
औरwithConsumedWindowInsets()
का नाम बदलकरonConsumedWindowInsetsChanged()
किया. साथ ही, मॉडिफ़ायर को सार्वजनिक किया. (Ie44e1)- इस्तेमाल किए जाने वाले आइकॉन के साथ टेक्स्ट बटन के लिए नई डिफ़ॉल्ट कॉन्टेंट पैडिंग जोड़ें. (I8f662)
- नेविगेशन बार और रेल के लिए बंद किए गए रंग जोड़े गए. (Ia7892, b/258867034)
- क्वेरी ऐन्सेस्टर की स्क्रोल जानकारी में मॉडिफ़ायर एपीआई जोड़ा गया. (I2ba9d, b/203141462)
Clickable
में इस्तेमाल किया जाता है, ताकि प्रेस इंटरैक्शन में देरी हो सके. ऐसा तब होता है, जब जेस्चर, स्क्रोल इवेंट बन सकते हैं.Scrollable ViewGroup
में इस्तेमाल किए जाने पर,Clickables
को ठीक किया गया है, जिससे रिपल में देरी नहीं हो रही है.- अगर जेस्चर, स्क्रोल इवेंट बन सकते हैं, तो ड्रॉर और शीट को अपडेट किया गया है, ताकि दबाए जाने पर सही तरीके से कार्रवाई को रोका जा सके.
डिपेंडेंसी से जुड़े अपडेट
Compose UI
औरCompose Material
अब लाइफ़साइकल 2.5.1 पर निर्भर करते हैं. (I05ab0, b/258038814)
वर्शन 1.1.0-alpha02
9 नवंबर, 2022
androidx.compose.material3:material3:1.1.0-alpha02
और androidx.compose.material3:material3-window-size-class:1.1.0-alpha02
रिलीज़ हुई हैं. वर्शन 1.1.0-alpha02 में ये कमियां हैं.
एपीआई में किए गए बदलाव
awaitFirstDown
औरwaitForUpOrCancellation
अब ज़्यादा सुविधा के लिएPointerEventPass
को स्वीकार करते हैं (स्क्रोल करने के दौरान मेन्यू दिखाने वालेExposedDropdownMenuBox
को भी ठीक कर दिया गया है).(I7579a, b/212091796)- सामग्री और content3 Text,
TextField
, औरOutlinedTextField
मेंminLines
पैरामीटर को जोड़ा गया. इसकी मदद से लाइनों की संख्या (I4af1d) के हिसाब से कॉम्पोनेंट की कम से कम ऊंचाई सेट की जा सकती है TopAppBarDefaults smallTopAppBarColors
फ़ंक्शन को बंद करें, ताकि नएtopAppBarColors
फ़ंक्शन का इस्तेमाल किया जा सके. इसका इस्तेमालTopAppBar
बनाते समय किया जाना चाहिए. (Ie6cb9)BasicText
औरBasicTextField
मेंminLines
पैरामीटर जोड़ा गया. इससे कंपोज़ेबल की कम से कम ऊंचाई सेट की जा सकती है लाइनों की संख्या (I24294, b/122476634)
गड़बड़ियां ठीक की गईं
- Material3
IconButton
औरIconToggleBotton
के कॉन्टेंट को कॉम्पोनेंट की स्टेट-लेयर आकार (जैसे कि गोल आकार) में क्लिप करें. (I9da8f) - Material3 के मीडियम और बड़े टॉप ऐप्लिकेशन बार को अपडेट करता है, ताकि पूरे सरफ़ेस पर बैकग्राउंड के लिए एक जैसा कलर लागू किया जा सके. साथ ही, डिफ़ॉल्ट कलर को पारदर्शी कलर वैल्यू से बदलने की अनुमति मिल सके. (I67659, b/249688556, b/250838918)
वर्शन 1.1.0-alpha01
24 अक्टूबर, 2022
androidx.compose.material3:material3:1.1.0-alpha01
और androidx.compose.material3:material3-window-size-class:1.1.0-alpha01
रिलीज़ हुई हैं. वर्शन 1.1.0-alpha01 में ये कमियां हैं.
गड़बड़ियां ठीक की गईं
- TextStyle और ब्रश की मदद से टाइटल लागू किए जाने पर, ऐप्लिकेशन बार के ऊपर वाले हिस्से में सुधार किया जाता है. (If667e)
संस्करण 1.0
वर्शन 1.0.1
9 नवंबर, 2022
androidx.compose.material3:material3:1.0.1
और androidx.compose.material3:material3-window-size-class:1.0.1
रिलीज़ हुई हैं. वर्शन 1.0.1 में ये कमियां शामिल हैं.
गड़बड़ियां ठीक की गईं
- Material3 के मीडियम और बड़े टॉप ऐप्लिकेशन बार को अपडेट करता है, ताकि पूरे सरफ़ेस पर बैकग्राउंड के लिए एक जैसा कलर लागू किया जा सके. साथ ही, डिफ़ॉल्ट कलर को पारदर्शी कलर वैल्यू से बदलने की अनुमति मिल सके. (I67659, b/249688556, b/250838918)
वर्शन 1.0.0
24 अक्टूबर, 2022
androidx.compose.material3:material3:1.0.0
और androidx.compose.material3:material3-window-size-class:1.0.0
रिलीज़ हुई हैं. वर्शन 1.0.0 में ये कमियां शामिल हैं.
1.0.0 की मुख्य सुविधाएं
यह Compose Material 3 की पहली ऐसी रिलीज़ है जिसमें बदलाव नहीं किया जा सकता!
मटीरियल डिज़ाइन 3 थीमिंग और मटीरियल यू डाइनैमिक कलर
मटीरियल डिज़ाइन 3 कॉम्पोनेंट
- बैज
- सबसे नीचे मौजूद ऐप्लिकेशन बार
- बटन
- एफ़एबी और एक्सटेंडेड एफ़एबी
- कार्ड (अलग-अलग डेटा का जानकारी कार्ड)
- चेकबॉक्स
- चिप
- डायलॉग
- डिवाइडर
- ड्रॉपडाउन मेन्यू
- सूची
- नेविगेशन बार
- नेविगेशन पैनल
- नेविगेशन रेल
- प्रोग्रेस इंडिकेटर
- रेडियो बटन
- स्लाइडर
- स्विच करें
- टैब
- टेक्स्ट फ़ील्ड
- सबसे ऊपर मौजूद ऐप्लिकेशन बार
- आइकॉन
- मैसेज भेजें
- प्लैटफ़ॉर्म
- लेआउट
- सामग्री रंग
विंडो साइज़ क्लास
material3-window-size-class
एक नई लाइब्रेरी है, जो विंडो के साइज़ की क्लास के लिए सहायता उपलब्ध कराती है: यह आपके लिए राय वाले व्यूपोर्ट ब्रेकपॉइंट का एक सेट है, ताकि आप ऐप्लिकेशन के लेआउट को डिज़ाइन कर सकें, बना सकें, और उनकी जांच कर सकें. विंडो साइज़ क्लास इंस्टेंस वापस पाने के लिए,calculateWindowSizeClass
का इस्तेमाल किया जा सकता है. इसका इस्तेमाल यह तय करने के लिए किया जा सकता है कि आपका यूज़र इंटरफ़ेस (यूआई) कैसा दिखना चाहिए. जैसे, बड़े साइज़ की विंडो के लिए बॉटम नेविगेशन के बजाय नेविगेशन रेल दिखाना. ज़्यादा जानकारी और उपयोग के नमूने के लिएWindowSizeClass
के लिए API संदर्भ दस्तावेज़ देखें.ज़्यादा जानकारी के लिए, कृपया यह ब्लॉग पोस्ट देखें!
वर्शन 1.0.0-rc01
5 अक्टूबर, 2022
androidx.compose.material3:material3:1.0.0-rc01
और androidx.compose.material3:material3-window-size-class:1.0.0-rc01
रिलीज़ हुई हैं. वर्शन 1.0.0-rc01 में ये कमिट शामिल हैं.
एपीआई में किए गए बदलाव
- टेक्स्ट फ़ील्ड एपीआई में टेक्स्ट के साथ काम करने के लिए स्लॉट पैरामीटर जोड़ा गया (Iaac0d, b/227146125)
वर्शन 1.0.0-beta03
21 सितंबर, 2022
androidx.compose.material3:material3:1.0.0-beta03
और androidx.compose.material3:material3-window-size-class:1.0.0-beta03
रिलीज़ हुई हैं. वर्शन 1.0.0-beta03 में ये कमिट हैं.
एपीआई में किए गए बदलाव
ExposedDropdownMenuDefaults
, अब मेन्यू आइटम के लिए पैडिंग वैल्यू दिखाता है. (I34ee1)ExposedDropdownMenuBoxScope
में अब एकModifier.menuAnchor()
मॉडिफ़ायर है, जिसे सही a11y व्यवहार के लिए टेक्स्ट फ़ील्ड में पास किया जाना चाहिए. (I27fa3)- मौजूदा स्लाइडर एपीआई के लिए ओवरलोडेड दो तरीके जोड़े जा रहे हैं, ताकि लोग स्लाइडर को पॉप्युलेट करने के लिए थंब या ट्रैक से आगे बढ़ सकें. (I21c00)
गड़बड़ियां ठीक की गईं
- ऑन एरर कंटेनर के लिए, गहरे रंग वाली थीम के कलर मैपिंग को टोन 90 (Ic5612) पर अपडेट किया गया
- छोटे मटीरियल 3 शीर्ष ऐप्लिकेशन बार के लिए पारदर्शी बैकग्राउंड सेट करने की अनुमति देने के लिए ठीक करें. (I645e2, b/245575782)
वर्शन 1.0.0-beta02
7 सितंबर, 2022
androidx.compose.material3:material3:1.0.0-beta02
और androidx.compose.material3:material3-window-size-class:1.0.0-beta02
रिलीज़ हुई हैं. वर्शन 1.0.0-beta02 में ये तय किए गए अपडेट शामिल हैं.
एपीआई में किए गए बदलाव
- बीटा01 वर्शन में m3 कॉम्पोनेंट में पेश किए गए डिफ़ॉल्ट कॉम्पोनेंट इनसेट, अब IME इनसेट के लिए नहीं हैं.
- Material3 के स्कैफ़ोल्ड कॉम्पोनेंट में अब एक
contentWindowInsets
पैरामीटर है. इससे यह तय किया जा सकता है कि कॉन्टेंट स्लॉट को कितनी संख्या में इनसेट को मैनेज करना है. (Icf11a, b/243713323) - प्रयोग के तौर पर इस्तेमाल किए जा रहे Material 3
SmallTopAppBar
फ़ंक्शन को बंद करता है और इससे मिलता-जुलताTopAppBar
फ़ंक्शन उपलब्ध कराता है. कृपया अपने नए डेटा का इस्तेमाल करें. (I74404, b/226918634) - टॉप ऐप्लिकेशन बार फ़्लिंग और स्नैप व्यवहार पर नियंत्रण जोड़ता है. (I15c81)
- डिवाइडर से startइंडेंट हटाता है, रंग को आखिरी पैरामीटर पर ले जाता है. (If7be2)
गड़बड़ियां ठीक की गईं
- उपयोगकर्ताओं को डायलॉग बॉक्स दिखाए जाने पर, डायलॉग बॉक्स की मदद से उनकी पहचान 'डायलॉग' शब्द की मदद से की जा सकती है, ताकि वे TalkBack इस्तेमाल कर सकें. (I857ef)
वर्शन 1.0.0-beta01
24 अगस्त, 2022
androidx.compose.material3:material3:1.0.0-beta01
और androidx.compose.material3:material3-window-size-class:1.0.0-beta01
रिलीज़ हुई हैं. वर्शन 1.0.0-beta01 में ये कमिट मौजूद हैं.
एपीआई का संदर्भ
सबसे नई थीमिंग, कॉम्पोनेंट, और अन्य कंपोज़ेबल के बारे में जानने के लिए, Compose Material 3 API के रेफ़रंस के तौर पर दी गई खास जानकारी देखें.
एपीआई में किए गए बदलाव
- मटीरियल 3 को टॉप ऐप्लिकेशन बार में अपडेट किया गया है, ताकि उसे पूरी तरह से छोटा करके पूरी तरह से बड़ा कर दिया गया हो. साथ ही,
TopAppBarDefaults
के व्यवहार से जुड़े फ़ंक्शन को कंपोज़ेबल के तौर पर अपडेट किया है. साथ ही, ऐप्लिकेशन बार की मुख्य स्थिति और ऐनिमेशन की खास बातों के लिए डिफ़ॉल्ट वैल्यू भी दी हैं. (I642b3) - सरफ़ेस एपीआई (I3afaa) से मेल खाने के लिए, एफ़एबी कॉम्पोनेंट के हस्ताक्षर अपडेट किए गए
- टॉप ऐप्लिकेशन बार, पैनल, नेविगेशन बार, और रेल के लिए इनसेट बिल्ड-इन सपोर्ट को जोड़ा गया. अलग से या स्कैफ़ोल्ड के साथ इस्तेमाल किए जाने पर, ये कॉम्पोनेंट अपने-आप डेवलपर के लिए इनसेट को हैंडल कर देंगे. ध्यान दें: इस बदलाव के बाद, स्टेटस बार आइकॉन का अपने-आप हैंडल होने की सुविधा नहीं मिलेगी. साथ ही, स्टेटस और नेविगेशन बार की पारदर्शिता भी नहीं बढ़ेगी. कृपया, इसे मैन्युअल तौर पर जारी रखें, ताकि उपयोगकर्ताओं को बेहतरीन अनुभव मिल सके. (I7e4e6, b/183161866)
- एपीआई प्लैटफ़ॉर्म को कम करने के लिए, कॉम्पोनेंट की डिफ़ॉल्ट सेटिंग को अपडेट किया गया है. इससे आने वाले समय में ज़रूरत के हिसाब से काम किया जा सकता है और परफ़ॉर्मेंस को बेहतर बनाया जा सकता है. (I31820)
- एपीआई (I45d0b) में एक जैसा बनाए रखने के लिए, फिर से क्रम में लगाए गए चिप और नेविगेशन पैनल के शीट पैरामीटर
startIndent
को डिवाइडर से हटाया गया और रंग को आखिरी पैरामीटर के तौर पर ले जाया गया.(If7be2)
वर्शन 1.0.0-alpha16
10 अगस्त, 2022
androidx.compose.material3:material3:1.0.0-alpha16
और androidx.compose.material3:material3-window-size-class:1.0.0-alpha16
रिलीज़ हुई हैं. वर्शन 1.0.0-alpha16 में ये कमियां हैं.
नई सुविधाएं
- नेविगेशन पैनल पर पसंद के मुताबिक चौड़ाई तय करने की सुविधा. (Ia7f10)
एपीआई में किए गए बदलाव
- एपीआई (Ie2637) को एक जैसा बनाए रखने के लिए, Tab और लीड आइकॉन टैब के पैरामीटर को फिर से क्रम में लगाएं
BadgeDefaults
को प्रयोग के तौर पर मार्क किया गया. (I98ef3)- रोके गए नेविगेशन पैनल के फ़ंक्शन को हटाएं. (I4f2db)
- एपीआई (I0aee7) में एक जैसा बनाए रखने के लिए, Material 3 में स्लाइडर पैरामीटर को फिर से क्रम में लगाएं
- एपीआई (I51cda) में एक जैसा बनाए रखने के लिए,
NavigationBar
औरNavigationRail
पैरामीटर को फिर से क्रम में लगाएं - एपीआई में एक जैसा बनाए रखने के लिए, Material 3 में पैरामीटर फिर से क्रम में लगाएं. (If4ae1)
- एपीआई (I62673) में एक जैसा बनाए रखने के लिए, Material 3 में स्लाइडर पैरामीटर को फिर से क्रम में लगाएं
- सबसे ऊपर मौजूद ऐप्लिकेशन बार (Id75be) से मेल खाने के लिए, आइकॉन पैरामीटर का नाम बदलकर कार्रवाइयों किया गया
Badge
औरBadgedBox
को एक्सपेरिमेंट के तौर पर मार्क करें, क्योंकि ऐंकर अलाइनमेंट अब भी फ़्लोट कर रहा है. (I1712e, b/236524516)- आइकॉन बटन के वैरिएंट पर,
@ExperimentalMaterial3Api
एनोटेशन को@OptIn
(I070b5) में बदलें - नेविगेशन पैनल के कॉन्टेंट को उसके कंपोज़ेबल में अलग किया गया, ताकि उस पर कस्टम चौड़ाई तय की जा सके. (Ia7f10)
Divider
कोMenuDefaults
औरTabDefaults
(I4e33c) से हटाता है
वर्शन 1.0.0-alpha15
27 जुलाई, 2022
androidx.compose.material3:material3:1.0.0-alpha15
और androidx.compose.material3:material3-window-size-class:1.0.0-alpha15
रिलीज़ हुई हैं. वर्शन 1.0.0-alpha15 में ये कमियां हैं.
नई सुविधाएं
- सबसे ऊपर मौजूद ऐप्लिकेशन बार को बार से खींचकर छोड़ने की अनुमति दें. (I65c00, b/205873416)
एपीआई में किए गए बदलाव
selectedIcon
स्लॉट को हटाने और किसी चुनी गई स्थिति को दिखाने के लिए,leadingIcon
के दोबारा इस्तेमाल को बढ़ावा देने के लिए,FilterChip
औरElevatedFilterChip
एपीआई में अपडेट. (Ie5dc2)- कलर रोल के लिए स्क्रिम और आउटलाइन वैरिएंट जोड़ें. (Id6d54)
- कंपोज़ेबल डिफ़ॉल्ट के लिए नाम रखने के तरीके ठीक करें. (I62b27)
ListItemDefaults
औरListItemColors
को प्रयोग के तौर पर मार्क करें. (I1f3ec)- सबसे ऊपर मौजूद ऐप्लिकेशन बार एपीआई में बदलाव किए गए हैं, ताकि इसकी स्टेट प्रॉपर्टी का मतलब बेहतर तरीके से समझा जा सके. साथ ही, सबसे ऊपर मौजूद ऐप्लिकेशन बार एपीआई को एक्सपेरिमेंट के तौर पर मार्क करें. (Ic0ad8)
- टेक्स्ट चुनने के लिए रंग अब
TextFieldColors
में जोड़ दिए गए हैं, ताकि उन्हें आसानी से खोजा जा सके. (Iba1b8) - आइकॉन वाले बटन के साथ इस्तेमाल करने के लिए
ButtonDefault.ButtonWithIconContentPadding
को जोड़ा जा रहा है. (I2bf9c) - टेक्स्ट फ़ील्ड को प्रयोग के तौर पर मार्क किया गया है, ताकि आने वाले समय में एपीआई में बदलाव करने में ज़्यादा आसानी हो. (I127b5)
Checkbox
फ़ंक्शन से@ExperimentalMaterial3Api
एनोटेशन हटाया गया. (I5eefc)RadioButton
फ़ंक्शन से@ExperimentalMaterial3Api
एनोटेशन हटाया गया. (I17e2a)- नॉन-इंटरैक्टिव कार्ड से
@ExperimentalMaterial3Api
एनोटेशन को हटाया गया. (I9bd49) - रंग, आकार वगैरह शामिल करने के लिए, अलग-अलग कॉम्पोनेंट के डिफ़ॉल्ट ऑब्जेक्ट अपडेट करता है. (I96e11)
गड़बड़ियां ठीक की गईं
- कैटलॉग ऐप्लिकेशन में उपयोगकर्ता को कोई भ्रम होने से बचाने के लिए, इनपुट चिप के सैंपल से पीछे के उन आइकॉन को हटाया गया जो काम नहीं करते. (I9846a)
वर्शन 1.0.0-alpha14
29 जून, 2022
androidx.compose.material3:material3:1.0.0-alpha14
और androidx.compose.material3:material3-window-size-class:1.0.0-alpha14
रिलीज़ हुई हैं. वर्शन 1.0.0-alpha14 में ये कमियां हैं.
नई सुविधाएं
- जोड़ी गई M3 सूची को लागू करने का तरीका, सैंपल के इस्तेमाल से जुड़े दस्तावेज़ देखें (Id7a20)
एपीआई में किए गए बदलाव
RangeSlider
में पैरामीटर के नाम को वैल्यू से बदलकर (I3b79a) करें- मटीरियल डिज़ाइन स्पेसिफ़िकेशन के हिसाब से, चुनी जा सकने वाली स्थिति की सुविधा देने के लिए, एपीआई को
InputChip
लागू करने के तरीके में बदलाव किया जाता है. बंद की गई चुनी गई स्थिति के लिए,FilterChip
रंगों के लिए ज़्यादा सहायता. (I55244, b/235792432) BottomAppBar
डिफ़ॉल्ट एफ़एबी (Ida4c8) जोड़ेंColorScheme.surfaceColorAtElevation
जोड़ा गया (Id41af)- कंपोज़ लाइब्रेरी में इंटरफ़ेस अब jdk8 का इस्तेमाल करके बनाए जाते हैं डिफ़ॉल्ट इंटरफ़ेस के तरीके (I5bcf1)
WindowWidthSizeClass
औरWindowHeightSizeClass
में अब तुलना की जा सकने वाली सुविधा लागू की गई है, ताकि ऑपरेटर (<, <=, >=, >) और दूसरे एपीआई का इस्तेमाल करके उनकी तुलना की जा सके. (I747d0)
गड़बड़ियां ठीक की गईं
- कॉन्टेंट की बेहतर जानकारी देने के लिए, बैज का सैंपल अपडेट करें. (I10b9d)
- इससे Material 3 कैटलॉग के थीम पिकर में सिस्टम फ़ॉन्ट साइज़ इस्तेमाल करने का विकल्प जोड़ा जाता है. (I10605)
- यह बैज के लिए सैंपल कोड जोड़ता है और प्रोग्रेस इंडिकेटर को तय नहीं करता. (I8fbe0)
वर्शन 1.0.0-alpha13
1 जून, 2022
androidx.compose.material3:material3:1.0.0-alpha13
और androidx.compose.material3:material3-window-size-class:1.0.0-alpha13
रिलीज़ हुई हैं. वर्शन 1.0.0-alpha13 में ये कमियां हैं.
एपीआई में किए गए बदलाव
- कॉन्फ़िगरेशन में बदलाव होने पर, ऐप्लिकेशन बार की पोज़िशन को सबसे ऊपर बनाए रखा जा सकता है. (I10459, b/216160958)
वर्शन 1.0.0-alpha12
18 मई, 2022
androidx.compose.material3:material3:1.0.0-alpha12
और androidx.compose.material3:material3-window-size-class:1.0.0-alpha12
रिलीज़ हुई हैं. वर्शन 1.0.0-alpha12 में ये कमियां हैं.
गड़बड़ियां ठीक की गईं
- स्लाइडर पैरंट की चौड़ाई अब 0 सेट की जा सकती है. (b/231707291)
वर्शन 1.0.0-alpha11
11 मई, 2022
androidx.compose.material3:material3:1.0.0-alpha11
और androidx.compose.material3:material3-window-size-class:1.0.0-alpha11
रिलीज़ हुई हैं. वर्शन 1.0.0-alpha11 में ये कमियां हैं.
नई सुविधाएं
RangeSlider
को Material 3 में जोड़ा गया (I18e38)- Material3 के
AssistChip
औरInputChip
के साथ काम करता है (I0d25a) - Material3 के
FilterChip
औरSuggestionChip
के साथ काम करता है (I9fdf3)
एपीआई में किए गए बदलाव
TextFieldDefaults.BorderStroke
कंपोज़ेबल का नाम बदला गया, जोOutlinedTextField
सेTextFieldDefaults.BorderBox
में बॉर्डर स्ट्रोक बनाता है. (I5f295)- m3 विज़ुअल में बदलाव करें (Iab30e)
- स्टैंडर्ड आइकॉन बटन पर कलर पास करने की अनुमति दें. (Ia2445)
गड़बड़ियां ठीक की गईं
- मटीरियल 3/स्कैफ़ोल्ड में लिंट चेक जोड़ें, ताकि यह पक्का किया जा सके कि इनर पैडिंग का इस्तेमाल किया गया है (I72293, b/226951418)
वर्शन 1.0.0-alpha10
20 अप्रैल, 2022
androidx.compose.material3:material3:1.0.0-alpha10
और androidx.compose.material3:material3-window-size-class:1.0.0-alpha10
रिलीज़ हुई हैं. वर्शन 1.0.0-alpha10 में ये कमियां हैं.
नई सुविधाएं
material3-window-size-class
एक नई लाइब्रेरी है, जो विंडो के साइज़ की क्लास के लिए सहायता उपलब्ध कराती है: यह आपके लिए राय वाले व्यूपोर्ट ब्रेकपॉइंट का एक सेट है, ताकि आप ऐप्लिकेशन के लेआउट को डिज़ाइन कर सकें, बना सकें, और उनकी जांच कर सकें. विंडो साइज़ क्लास इंस्टेंस वापस पाने के लिए,calculateWindowSizeClass
का इस्तेमाल किया जा सकता है. इसका इस्तेमाल यह तय करने के लिए किया जा सकता है कि आपका यूज़र इंटरफ़ेस (यूआई) कैसा दिखना चाहिए. जैसे, बड़े साइज़ की विंडो के लिए बॉटम नेविगेशन के बजाय नेविगेशन रेल दिखाना. ज़्यादा जानकारी और सैंपल के इस्तेमाल के लिए,WindowSizeClass
के लिए एपीआई के रेफ़रंस दस्तावेज़ देखें. विंडो के साइज़ की क्लास से जुड़ी परिभाषाओं के बारे में ज़्यादा जानने के लिए, अलग-अलग स्क्रीन साइज़ के साथ काम करने के बारे में सार्वजनिक दिशा-निर्देश देखें.
एपीआई में किए गए बदलाव
BottomAppBar
के लिए डिफ़ॉल्ट एफ़एबी एलिवेशन जोड़ता है, एफ़एबी के साथBottomAppBar
से पीछे लगने वाला लैम्डा हटा देता है. (I92c47)- Material3
FilledIconButton
,FilledTonalIconButton
, औरOutlinedIconButton
को जोड़ता है. (Ib2bda) - Material 3 Snackbar API को अपडेट करता है, ताकि वैकल्पिक कार्रवाई और खारिज की जाने वाली कार्रवाई के लिए, कलर की वैल्यू स्वीकार की जा सकें. (Ibe4b4)
PointerInputChange
में कुछ हद तक इस्तेमाल (डाउन या पोज़िशन) पर रोक लगा दी गई है. इस बदलाव का पूरा इस्तेमाल करने के लिए,consume()
का इस्तेमाल किया जा सकता है.isConsumed
का इस्तेमाल करके, यह पता लगाया जा सकता है कि पहले किसी दूसरे व्यक्ति ने इस बदलाव का इस्तेमाल किया है या नहीं.PointerInputChange::copy()
अब हमेशा कम जानकारी वाली कॉपी बनाता है. इसका मतलब है कि अगर किसी वीडियो की कॉपी मिटा दी जाती है, तो उस वीडियो कीPointerInputChange
कॉपी मिटा दी जाएंगी. अगर आपको अनबाउंडPointerInputChange
बनाना है, तो इसके बजाय कंस्ट्रक्टर का इस्तेमाल करें. (Ie6be4, b/225669674)CardColors
इंटरफ़ेस के ज़रिए कंटेनर और कॉन्टेंट के कलर पाने के लिए, Card API में किए गए बदलाव क्लिक किए जा सकने वाले कार्ड. (I927df)- अन्य कॉम्पोनेंट को एक जैसा बनाए रखने के लिए, मटीरियल 3 टेक्स्ट फ़ील्ड में पैरामीटर
backgroundColor
का नाम बदलकरcontainerColor
कर दिया गया है. (I6fbd9)
गड़बड़ियां ठीक की गईं
- इसे Material3 की खास बातों के साथ अलाइन करने के लिए, स्टैंडर्ड
IconButton
में अपडेट किए जाएंगे. (I09eab) - सामग्री को पास की गई पैडिंग में मटीरियल3 स्कैफ़ोल्ड की ऊपरी बार की ऊंचाई को ले जाएं, ताकि कॉन्टेंट को ऐप्लिकेशन के सबसे ऊपर मौजूद बार के नीचे रेंडर किया जा सके. अगर
PaddingValues
को अनदेखा किया जाता है, तो हो सकता है कि सबसे ऊपर मौजूद बार की वजह से, कॉन्टेंट छिप जाए. (I83cbc, b/217776202)
वर्शन 1.0.0-alpha09
6 अप्रैल, 2022
androidx.compose.material3:material3:1.0.0-alpha09
रिलीज़ हो गया है. वर्शन 1.0.0-alpha09 में ये कमियां हैं.
नई सुविधाएं
- Material 3 Switch API (I2c3ad) जोड़ा गया
एपीआई में किए गए बदलाव
- टेक्स्ट फ़ील्ड (यानी 'एक्सपोज़्ड ड्रॉपडाउन मेन्यू' या 'कॉम्बो बॉक्स') वाले ड्रॉपडाउन मेन्यू इस्तेमाल करने की सुविधा जोड़ी गई. (I1b832)
- Material थीम और आकार के सब सिस्टम में आकार पैरामीटर जोड़ा गया. (I37426)
- हर स्थिति के बीच ऐनिमेशन का इस्तेमाल करके,
ExtendedFloatingActionButton
में बड़ा किया गया पैरामीटर जोड़ा गया. इससे यह कंट्रोल किया जा सकता है कि एफ़एबी को बड़ा या छोटा किया जाए या नहीं. आइकॉन के बिना ExtendedFAB के लिए बाद में टेक्स्ट देने वाले एक्सटेंडेड एफ़एबी के लिए एक्सटेंडेड एफ़एबी ओवरलोड जोड़ा गया. (Iba7f1)
वर्शन 1.0.0-alpha08
23 मार्च, 2022
androidx.compose.material3:material3:1.0.0-alpha08
रिलीज़ हो गया है. वर्शन 1.0.0-alpha08 में ये कमियां हैं.
नई सुविधाएं
- Material 3 टेक्स्ट फ़ील्ड के लिए सहायता जोड़ी गई. (I795cc, b/199377790)
एपीआई में किए गए बदलाव
- मेन्यू के लिए डिफ़ॉल्ट डिवाइडर जोड़ें (I01374)
ColorScheme
क्लास मेंsurfaceTint
रंग पैरामीटर जोड़ा गया. (I2f558)
गड़बड़ियां ठीक की गईं
- डिफ़ॉल्ट टेक्स्ट स्टाइल वैल्यू को पढ़ने के लिए, Material3 बटन पर जाकर ठीक करें मटीरियल थीम से ऐक्सेस किया जा सकता है. (Ie62fc)
वर्शन 1.0.0-alpha07
9 मार्च, 2022
androidx.compose.material3:material3:1.0.0-alpha07
रिलीज़ हो गया है. वर्शन 1.0.0-alpha07 में ये कमिट हैं.
एपीआई में किए गए बदलाव
- Material 3 Surface API में अपडेट, जो वेबसाइट की क्लिक किए जा सकने वाले प्लैटफ़ॉर्म के लिए ओवरलोड किए गए फ़ंक्शन के साथ-साथ एक फ़ंक्शन का इस्तेमाल किया जा सकता है. (I4bf18)
LazyVerticalGrid
औरLazyHorizontalGrid
की स्थिति में अब कोई बदलाव नहीं हुआ है. (I307c0)LazyVerticalGrid/LazyHorizontalGrid
और इससे जुड़े सभी एपीआई को .grid सबपैकेज में ले जाया गया. कृपया अपने इंपोर्ट को androidx.compos.foundation.lazy से androidx.compos.foundation.lazy.grid में अपडेट करें. (I2d446)- पिछली बार कन्वर्ज़न वैल्यू के तौर पर व्यू के आधार पर किए गए बदलाव को वापस लाया गया
WindowInsetsControllerCompat
को इस्तेमाल किया है और फिर से एक ऐसी विंडो की ज़रूरत है जो कुछ विंडो फ़्लैग को प्रबंधित करने के लिए ज़रूरी है.ViewCompat.getWindowInsetsController
को इसके पक्ष में बहिष्कृत किया गयाWindowCompat.getInsetsController
का इस्तेमाल करके पक्का करें कि सही विंडो इस्तेमाल किया गया हो (जैसे कि व्यू किसी डायलॉग में हो). (I660ae, b/219572936) - क्रॉस-ऐक्सिस के साइज़ तय करने के लिए, नया
LazyVerticalGrid
एपीआई जोड़ा गया (I17723)
गड़बड़ियां ठीक की गईं
- कार्ड एपीआई में अपडेट, ताकि प्लैटफ़ॉर्म पर होने वाले बदलावों को फ़ॉलो किया जा सके एपीआई (I3c8b9)
वर्शन 1.0.0-alpha06
23 फ़रवरी, 2022
androidx.compose.material3:material3:1.0.0-alpha06
रिलीज़ हो गया है. वर्शन 1.0.0-alpha06 में ये कमियां हैं.
एपीआई में किए गए बदलाव
NavigationDrawerItem
जोड़ा गया है जो ड्रॉर के अंदर एक ही डेस्टिनेशन दिखाता है (Ic396f, b/218286829)PermanentNavigationDrawer
औरDismissibleNavigationDrawer
को एक्सपेरिमेंटल एपीआई के तौर पर जोड़ा गया है. वे बड़े स्क्रीन वाले डिवाइसों के लिए सही पैनल हैं. (I5f8ab, b/218286829)- मटीरियल 3 के नीचे वाले ऐप्लिकेशन बार की सुविधा जोड़ता है (Ic432a)
NavigationDrawer
का नाम बदलकरModalNavigationDrawer
कर दिया गया है (I1807d, b/218286829)- मटीरियल 3 स्लाइडर क्लास और टोकन जोड़ा गया (I1ccee)
- लागू करने के लिए टैब जोड़ा गया, सैंपल के इस्तेमाल से जुड़े दस्तावेज़ देखें (Ie0146)
गड़बड़ियां ठीक की गईं
- उस समस्या को ठीक किया गया है जिसकी वजह से
TalkBack
स्क्रीन रीडर लीनियर नेविगेशन ने, सबसे ऊपर मौजूद ऐप्लिकेशन बार के खाली टाइटल को चुना था. (आईडी4690) IconSize
कोFloatingActionButtonDefaults
में जोड़ा गया. (Ia71cf)LazyColumn
की मदद से बड़ा टेक्स्ट जोड़ने पर, छिपे हुएAlertDialog
बटन से जुड़ी गड़बड़ी ठीक की गई. (Ib2cc9, b/216663029)
वर्शन 1.0.0-alpha05
9 फ़रवरी, 2022
androidx.compose.material3:material3:1.0.0-alpha05
रिलीज़ हो गया है. वर्शन 1.0.0-alpha05 में ये कमियां हैं.
नई सुविधाएं
मटीरियल डिज़ाइन 3 कॉम्पोनेंट जोड़े गए
- ड्रॉपडाउन मेन्यू
- कार्ड (अलग-अलग डेटा का जानकारी कार्ड)
एपीआई में किए गए बदलाव
- ऑनक्लिक लेने वाला
Surface
फ़ंक्शन अब काम नहीं करता कॉलबैक. क्लिक किए जा सकने वाले प्लैटफ़ॉर्म,InteractionSource
का इस्तेमाल करके बनाए जाने चाहिए और एकModifier.clickable()
. (I211c6) - एफ़एबी के लिए दबाया गया और फ़ोकस की गई ऊंचाई की सुविधा जोड़ी गई. (Ibb584)
Surface
API को बदला गया, ताकि ऐसा इंटरैक्शनSource किया जा सके जो इसकी अनुमति देता है और इस तरह के कॉन्टेंट को अलग-अलग स्थितियों में कंट्रोल करने के लिए किया जा सकता है. (Iafbc8)
गड़बड़ियां ठीक की गईं
- डाइनैमिक कलर स्कीम में, वह तीसरा रंग जोड़ा गया जो पहले मौजूद नहीं था (I456c4, b/214588434)
वर्शन 1.0.0-alpha04
26 जनवरी, 2022
androidx.compose.material3:material3:1.0.0-alpha04
रिलीज़ हो गया है. वर्शन 1.0.0-alpha04 में ये कमियां हैं.
एपीआई में किए गए बदलाव
- ओवरलोड वाले तरीकों में
NonRestartableComposable
को जोड़ा गया इस्तेमाल कर सकते हैं. यह कंपाइलर को कम करता है उन सभी पैरामीटर के लिए जनरेट की गई मेमोाइज़ेशन जांच (इसके बराबर है) को अंदरूनी फ़ंक्शन में दोहराया जाता है. (I90490) - मटीरियल 3 डिवाइडर जोड़ा गया. (Ica5fc)
- एक्सपेरिमेंट के तौर पर उपलब्ध एपीआई की मदद से चेकबॉक्स और RadioButton को मार्क करें एनोटेशन. (Ie44bb)
- Material 3 के प्रोग्रेस इंंडिकेटर के लिए सहायता जोड़ी गई है. (Iff232, b/205023841)
गड़बड़ियां ठीक की गईं
- बंद किए गए
TextButton's
कंटेनर के रंग को पारदर्शी बनाने के लिए, उसे अपडेट करें (I6b248, b/213339737)
वर्शन 1.0.0-alpha03
12 जनवरी, 2022
androidx.compose.material3:material3:1.0.0-alpha03
रिलीज़ हो गया है. वर्शन 1.0.0-alpha03 में ये कमियां हैं.
गड़बड़ियां ठीक की गईं
- Material 3 के
MaterialTheme
मेंLocalIndication
जोड़ें. (I7ce4e) - चेकबॉक्स (I38b03, b/175198975, b/202309440) के लिए लागू किए गए कोने के रेडियस को ठीक करें
डिपेंडेंसी से जुड़े अपडेट
- अब Kotlin
1.6.10
पर निर्भर करता है.
वर्शन 1.0.0-alpha02
1 दिसंबर, 2021
androidx.compose.material3:material3:1.0.0-alpha02
रिलीज़ हो गया है. वर्शन 1.0.0-alpha02 में ये कमियां हैं.
नई सुविधाएं
- चेकबॉक्स और रेडियोबटन के लिए समर्थन जोड़ें.
- Kotlin
1.6.0
के साथ काम करने के लिए अपडेट किया गया
एपीआई में किए गए बदलाव
- Material 3 के स्कैफ़ोल्ड से दराज़ हटाएं. (I04f51)
- Material 3
Checkbox
के लिए सहायता उपलब्ध कराता है. (आईडी5542) - Material 3
RadioButton
के लिए सहायता उपलब्ध कराता है. (I20334)
गड़बड़ियां ठीक की गईं
IconButton
के रिपल रेडियस को 40dp से कम करके 20dp करें. (I68bbe, b/206674345)Text
के लिए पोर्ट स्ट्रिंग फ़ास्ट पाथcompose.material
से बदलता है (I30b03)- समस्या को ठीक कर दिया गया है, लेकिन हार्डकोड किया गया बटन हमेशा चालू रहेगा. (Iea832, b/205335456)
वर्शन 1.0.0-alpha01
27 अक्टूबर, 2021
androidx.compose.material3:material3:1.0.0-alpha01
रिलीज़ हो गया है. वर्शन 1.0.0-alpha01 में ये कमिट शामिल हैं.
नई सुविधाएं
मटीरियल डिज़ाइन 3 थीमिंग और मटीरियल यू डाइनैमिक कलर
मटीरियल डिज़ाइन 3 कॉम्पोनेंट
- बटन
- एफ़एबी और एक्सटेंडेड एफ़एबी
- डायलॉग
- नेविगेशन बार
- नेविगेशन पैनल
- नेविगेशन रेल
- सबसे ऊपर मौजूद ऐप्लिकेशन बार
- बैज
- आइकॉन
- मैसेज भेजें
- प्लैटफ़ॉर्म
- लेआउट
- सामग्री रंग
ज़्यादा जानकारी के लिए, Compose में मटीरियल थीमिंग गाइड में मटीरियल डिज़ाइन 3 और मटीरियल यू सेक्शन देखें.