نوشتن مواد 3
آخرین به روز رسانی | انتشار پایدار | کاندید را آزاد کنید | نسخه بتا | انتشار آلفا |
---|---|---|---|---|
13 نوامبر 2024 | 1.3.1 | - | - | 1.4.0-alpha04 |
ساختار
Compose ترکیبی از هفت شناسه گروه Maven در androidx
است. هر گروه شامل یک زیرمجموعه هدفمند از عملکرد است که هر کدام مجموعه ای از یادداشت های انتشار خود را دارند.
این جدول گروه ها و پیوندهای هر مجموعه از یادداشت های انتشار را توضیح می دهد.
گروه | توضیحات |
---|---|
آهنگسازی.انیمیشن | انیمیشن هایی را در برنامه های Jetpack Compose خود بسازید تا تجربه کاربر را غنی تر کنید. |
compose.compiler | توابع @Composable را تغییر دهید و بهینه سازی ها را با افزونه کامپایلر Kotlin فعال کنید. |
تألیف.بنیاد | برنامه های Jetpack Compose را با بلوک های ساختمانی آماده بنویسید و پایه را گسترش دهید تا قطعات سیستم طراحی خود را بسازید. |
آهنگسازی.مواد | رابط کاربری Jetpack Compose را با اجزای طراحی مواد آماده برای استفاده بسازید. این نقطه ورود سطح بالاتر Compose است که برای ارائه مؤلفه هایی مطابق با آنچه در www.material.io توضیح داده شده است طراحی شده است. |
نوشتن.مواد3 | ایجاد رابط کاربری Jetpack Compose با 3 مؤلفه طراحی متریال، تکامل بعدی طراحی متریال. Material 3 شامل قالبها و اجزای بهروز شده و ویژگیهای شخصیسازی Material You مانند رنگ پویا است و به گونهای طراحی شده است که با سبک بصری جدید Android 12 و رابط کاربری سیستم هماهنگ باشد. |
نوشتن. زمان اجرا | بلوکهای بنیادی مدل برنامهنویسی Compose و مدیریت حالت، و زمان اجرا اصلی برای هدف قرار دادن افزونه Compose Compiler. |
compose.ui | مؤلفههای اساسی نوشتن رابط کاربر برای تعامل با دستگاه، از جمله طرحبندی، طراحی، و ورودی مورد نیاز است. |
اعلام وابستگی ها
برای افزودن وابستگی به Compose، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.
وابستگیهای مصنوعات مورد نیاز خود را در فایل build.gradle
برای برنامه یا ماژول خود اضافه کنید:
Groovy
dependencies { implementation "androidx.compose.material3:material3:1.3.1" implementation "androidx.compose.material3:material3-window-size-class:1.3.1" implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha05" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material3:material3:1.3.1") implementation("androidx.compose.material3:material3-window-size-class:1.3.1") implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha05") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
برای اطلاعات بیشتر درباره وابستگیها، به افزودن وابستگیهای ساخت نگاه کنید.
بازخورد
بازخورد شما به بهتر شدن Jetpack کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.
برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.
Compose Material3 Common Version 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 حاوی این تعهدات است.
ویژگی های جدید
اجزای بدون مضمون که می توانند برای ساخت اجزای طراحی متریال استفاده شوند:
- پالت تونال
- نماد
- اندازه هدف را لمس کنید
Compose Material3 Adaptive Navigation Suite نسخه 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 حاوی این commit ها است.
تغییرات API
- APIهای مجموعه ناوبری را غیر آزمایشی کنید ( 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 حاوی این تعهدات است.
تغییرات API
-
containerColor
وcontentColor
بهNavigationSuiteScaffoldDefaults
اضافه کنید. ( 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 حاوی این تعهدات است.
تغییرات API
- سازنده
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 حاوی این commit ها است.
به روز رسانی های وابستگی
- وابستگی های تطبیقی Material3 را به مسیرهای ماژول جدید به روز کنید. ( IBC421 )
- برای استفاده از نسخه Window Manager کلاسهای اندازه پنجره مهاجرت کنید. ( 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 حاوی این commit ها است.
تغییرات API
- به روز رسانی نام بسته به navigationsuite از navigation-suite ( I7eff7 )
- مؤلفههای Material3 که یک
MutableInteractionSource
در API خود نشان میدهند، بهروزرسانی شدهاند تا اکنون یکMutableInteractionSource
قابل تهی را که پیشفرض آن null است، در معرض نمایش بگذارد. هیچ تغییر معنایی در اینجا وجود ندارد: عبور از null به این معنی است که شما نمی خواهیدMutableInteractionSource
را بالا ببرید و در صورت نیاز در داخل کامپوننت ایجاد می شود. تغییر به null به برخی از مؤلفهها اجازه میدهد تا هرگز یکMutableInteractionSource
تخصیص ندهند، و به سایر مؤلفهها اجازه میدهد فقط در صورت نیاز، نمونهای را ایجاد کنند، که عملکرد این مؤلفهها را بهبود میبخشد. اگر ازMutableInteractionSource
که به این مؤلفه ها منتقل می کنید استفاده نمی کنید، توصیه می شود به جای آن، null را ارسال کنید. همچنین توصیه می شود که تغییرات مشابهی را در اجزای خود ایجاد کنید. ( 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 حاوی این commit ها است.
ویژگی های جدید
- یک
NavigationSuiteType
"None" اضافه کنید ( 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 حاوی این commit ها است.
ویژگی های جدید
Compose Material3 Adaptive Version 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 حاوی این commit ها است.
ویژگی های جدید
- گزینه های رفتاری اضافی برای ناوبری برگشتی
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 حاوی این commit ها است.
ویژگی های جدید
- پشتیبانی از آگاهی از تاریخ در مسیریابی داربست و محاسبه ارزش ( 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 حاوی این commit ها است.
ویژگی های جدید
- اضافه شدن پشتیبانی لبه به لبه در داربست های شیشه ای ( I1b462 )
تغییرات API
- ویژگیهای حاشیه لولا در وضعیت وضعیت به فهرستی از اطلاعات لولا منتقل شد ( 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 حاوی این commit ها است.
تغییرات API
- نقش های داربست را به نام مستعار
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 حاوی این commit ها است.
تغییرات API
- APIهای ناوبری را از APIهای داربست تطبیقی جدا کنید. ( IC4045 )
- کلاس
GutterSize
را حذف کنید. ( I785b3 )
رفع اشکال
- وقتی از
AnimatedPane
استفاده نمیشود، پنجرههای ثابت تغییر نمیکنند ( d88f181 )
نسخه 1.0.0-alpha01
15 نوامبر 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha01
منتشر شد. نسخه 1.0.0-alpha01 حاوی این commit ها است.
ویژگی های جدید
APIهای شرایط تطبیقی Material3:
APIهای دستورالعمل داربست صفحه تطبیقی Material3:
APIهای داربست صفحه تطبیقی Material3:
- APIهای پایه داربست
Compose Material3 نسخه 1.4
نسخه 1.4.0-alpha04
13 نوامبر 2024
androidx.compose.material3:material3-*:1.4.0-alpha04
منتشر شد. نسخه 1.4.0-alpha04 حاوی این commit ها است.
تغییرات رفتار
- تغییرات رنگ معرفی شده در aosp/3212478 را به
iconButtonColors
،iconToggleButtonColors
،outlinedIconButtonColors
،outlinedIconToggleButtonColors
وoutlinedIconToggleButtonBorder
برگردانید. رفتار بازگردانده شده را به مجموعه جدیدی از توابع به نامiconButtonVibrantColors
و غیره منتقل کرد تا بر رنگهای کنتراست بالا که برگردانده میشوند تأکید کند. ( Iffd8d )
ویژگی های جدید
- مولفه
VerticalDragHandle
معرفی کنید ( I6c770 )
تغییرات API
- تغییر نام
DismissibleModalWideNavigationRailDefaults
بهModalWideNavigationRailDefaults
. ( I8e877 ) -
NavigationBarComponentOverrides
اضافه کنید. ( I8a3f3 ) -
NavigationRailComponentOverride
را اضافه کنید. ( I83e13 ) -
WideNavigationRailState
برای مدیریت فروپاشی/بسط ریل معرفی کنید، اجازه دهیدModalWideNavigationRail
قابل رد شود وDismissibleModalWideNavigationRail
حذف کنید. ( I88568 ) - پیشفرضهای اندازه xSmall، متوسط، بزرگ و xLarge را به پیشفرضهای دکمه جابجایی اضافه کنید. ( Ie95d1 )
- اندازه های پیش فرض xSmall، متوسط، بزرگ و xLarge را به پیش فرض های دکمه اضافه کنید. ( If8b6d )
رفع اشکال
- رنگ نماد دنباله تراشه فیلتر براساس مشخصات از Primary به
OnSurfaceContainer
بهروزرسانی شده است. همه رنگهای طرح کلی تراشه، بر اساس مشخصات، از Outline به Outline Variant بهروزرسانی شدهاند. ( I68bd4 )
نسخه 1.4.0-alpha03
30 اکتبر 2024
androidx.compose.material3:material3-*:1.4.0-alpha03
منتشر شد. نسخه 1.4.0-alpha03 حاوی این commit ها است.
تغییرات API
- سازنده
SheetState
با چگالی به نفع آستانه های موقعیتی و سرعتی منسوخ شده است. ( Ifd16e ) -
rememberTooltipPositionProvider
اضافه شد که حاوی یک منطق موقعیت یابی به روز شده است.rememberPlainTooltipPositionProvider
وrememberRichTooltipPositionProvider
منسوخ شده است. ( Ie66e2 ) -
ModalBottomSheetProperties
اضافی امکان سفارشیسازی وضعیت و رنگهای نوار پیمایش را فراهم میکند. بهطور پیشفرض، این بهروزرسانیها براساس رنگ محتوا بهجای وضعیت تم تیره سیستم است. ( Ib874e , b/362539765 ) - تجربه ورودی برای انتخابگرهای تاریخ بهبود یافته است: در حالت ورودی، قسمت متن تاریخ برای وارد کردن متن فوری متمرکز می شود. این تغییر یک پارامتر
requestFocus
را بهDatePicker
وDateRangePicker
اضافه می کند. شما ممکن است با عبورfalse
از تمرکز جلوگیری کنید. ( I12d09 , b/286399710 , b/340102743 ) - کش کردن شکل به صورت پیش فرض در شی Shape است. ایجاد شکل پیش فرض
@Composable
برای دکمه جابجایی. جمع کردن اشکال در یک شکل پیشفرض زیرا انواع به یک فایل توکن اشاره میکنند. ( Iaa014 )
رفع اشکال
- رفتار Scaffold
contentPadding
را بهینه کنید تا از ترکیب مجدد محتوای بدنه هنگام تغییرcontentPadding
جلوگیری کنید. ( I8c8e2 , b/373904168 ) -
progress
TextFieldLabelScope
بهlabelMinimizedProgress
تغییر نام داد -
Default
TextFieldLabelPosition
بهAttached
تغییر نام داد. اعضای رابط حذف شده اند. ( If75c6 ) - مشکل
DatePicker
در حالت ورودی که خطاهای اعتبارسنجی میتواند باعث تغییر ارتفاع مؤلفه شود، برطرف شد. ( I2e229 , b/280462363 ) - هنگامی که کلیدهای کنترل فشار داده می شوند، لغزنده مواد را تغییر دهید. ( I1c442 )
نسخه 1.4.0-alpha02
16 اکتبر 2024
androidx.compose.material3:material3-*:1.4.0-alpha02
منتشر شد. نسخه 1.4.0-alpha02 حاوی این تعهدات است.
تغییرات API
- بهروزرسانیهای انتخابگر تاریخ برای اطمینان از استفاده مداوم از Locale در سرتاسر
DatePicker
وDateRangePicker
هنگام تنظیم یک Locale مستقیماً از طریقDatePickerState
یاDateRangePickerState
. توجه داشته باشید که وقتی Locales را مستقیماً روی حالت تنظیم میکنید، این شما هستید که باید اطمینان حاصل کنید که متون عنوان و عنوان بر اساس آن بومیسازی میشوند، زیرا متن پیشفرض آنها همچنان بر اساس پلتفرم پیشفرض Locale اعمال میشود. ( I37073 , b/326490763 , b/321657276 ) -
SheetState.isAnimationRunning
اکنون در معرض دید قرار گرفته است. ( I9a3d7 ) - اکنون
DatePickerColors
به درستی بر رنگهای متضاد تعریف شده در سبکهای متن تایپوگرافی موضوع اولویت دارد. همچنین توجه داشته باشید که این بهروزرسانی موقعیت پارامترcolor
را در توابع انتخابگر تاریخ تنظیم میکند و یک پارامترcontentColor
را برای سفارشیسازی رنگهای هدر و متن عنوان معرفی میکند. ( I30d03 , b/347031394 ) - تغییر نام
SplitButton
بهSplitButtonLayout
و حذف APIهای رنگیSplitButton
، انواع با استفاده مجدد از انواع دکمه ارائه شده توسطSplitButtonDefaults
به دست خواهند آمد. ( I44c36 ) -
ModalBottomSheet
اکنون دارای پارامترsheetGestureEnabled
است ( I856cb , b/288211587 ) -
standardMotionScheme
وexpressiveMotionScheme
را به استاندارد و رسا تغییر نام داد. هر دو تابع اکنون از طریق شیء همراهMotionScheme
با فراخوانیMotionScheme.standard()
وMotionScheme.expressive()
قابل دسترسی هستند. ( Iceccf ) - افزودن پارامتر
maxWidth
به راهنمای ابزار ساده و غنی. به طور پیش فرض مشخصات طراحی 200 dp برای راهنمای ابزار ساده و 320 dp برای راهنمای ابزار غنی است. ( I30ce9 )
رفع اشکال
-
DatePicker
وDateRangePicker
اکنون زمانی که از طریقdisplayedMonthMillis
ایالت خود تنظیم می شوند، ماه نمایش داده شده را به درستی به روز می کنند. ( If9e47 , b/333414302 ) - محتوای
ModalBottomSheet
اکنون محتوا را از نوار وضعیت دور می کند. ( I5114c , b/321877275 , b/336962418 , b/342093067 ) - [برگ پایین] اولویت پاسخ به تماس را به
PRIORITY_DEFAULT
تغییر دهید تا اجازه دهید صفحه کلید IME ابتدا رد شود. ( I447fb ) - هنگامی که حداقل سال قابل انتخاب روی سال آینده تنظیم شده باشد، خرابی ها را در
DatePicker
وDateRangePicker
برطرف کنید. ( I78656 , b/319395747 ) - هنگامی که نمونه بهروزرسانیشده
SelectableDates
اعمال میشود، برای بهروزرسانی رابط کاربری، مشکل انتخابگر تاریخ را برطرف کنید. ( Iad59a , b/290135807 , b/339898760 )
نسخه 1.4.0-alpha01
2 اکتبر 2024
androidx.compose.material3:material3-*:1.4.0-alpha01
منتشر شد. نسخه 1.4.0-alpha01 حاوی این تعهدات است.
تغییرات رفتار
- Library دیگر وابستگی به
material-icons-core
اضافه نمی کند، بنابراین اگر پروژه شما به آن متکی است، باید به صراحت آن وابستگی را در فایل هایbuild.gradle[.kts]
خود اضافه کنید. ( I735ff , b/349894318 ) - تغییر رنگ برچسب فعال
NavigationBarItem
وNavigationRailItem
ازonSurface
بهsecondary
به منظور بهبود قابلیت استفاده، کنتراست رنگ و بهبود انسجام در سیستم ( Ibc297 )، برای بازگشت به رفتار قبلی، کپی کردن رنگ های پیش فرض و تغییر TextColorselectedTextColor
بهMaterialTheme.colorScheme.onSurface
. - اجزای Material 3 اکنون از
MotionScheme
جدید برای تعریف حرکت خود استفاده می کنند. ( Ie0f93 ) - تغییرات حرکتی نشانگر پیشرفت دایره ای نامشخص ( I3c07e )
- برای تضاد رنگ بهتر
OutlinedIconButtonColors
وOutlinedIconToggleButtonColors
را بهروزرسانی کنید. ( I2743d ) - ظرف و رنگ محتوا برای
FilledIconToggleButtonColors
وFilledTonalIconToggleButtonColors
بهروزرسانی شد. ( IC5d0f ) - رنگ حاشیه
OutlinedButton
ازoutline
بهoutlineVariant
به روز شد. ( 057f00 )
تغییرات API
- یک پارامتر
reverseLayout
اختیاری به تابعenterAlwaysScrollBehavior
TopAppBar
اضافه کرد تا از محتوایی که باreverseLayout
تنظیم شده بود، بهتر پشتیبانی کند. ( I4e0e5 ) -
SegmentedButton
اکنون از آرگومانcontentPadding
پشتیبانی می کند. ( I5ad91 , b/358414376 ) -
PullToRefreshState
دیگر اجرای پیشفرض برایisAnimating
را ندارد ( I6a593 ) - اضافه بارهای جدیدی از Material
TextField
وOutlinedTextField
اضافه شده است که ازTextFieldState
استفاده می کنند. APIهای جعبه دکوراسیون اضافه شده که باTextFieldDecorator
سازگار هستند. ( If13a1 ) - پارامتر برای کنترل
labelPosition
فیلد متنی اضافه شد. استفاده ازalwaysMinimize
به الگوی رابط کاربری اجازه میدهد تا یک برچسب و مکاننما را در یک فیلد متنی بهطور همزمان نمایش دهد، حتی زمانی که فیلد فوکوس نشده باشد. ( I1ef2c ) - مواد
SecureTextField
وOutlinedSecureTextField
برای فیلدهای ورود رمز عبور اضافه شد. ( I7e22d ) - یک محدوده به برچسبهای فیلد متنی برای جستجوی پیشرفت انیمیشن اضافه شده است. ( If5ec8 )
- پشتیبانی از
MotionEvent.CLASSIFICATION_DEEP_PRESS
را به نکات ابزار اضافه می کند. ( I62e6a ) -
isAfternoon
TimePickerState
اکنون به جای var در رابط، یک Extension Val است که بهisPm
تغییر نام داده است ( I89a97 ) - بهروزرسانی کلاس تایپوگرافی برای پشتیبانی از مقیاسهای نوع تأکید شده. ( Ifa13c )
-
ModalWideNavigationRail
API اضافه شد و APIهایModalExpandedNavigationRail
بهDismissibleModalWideNavigationRail
تغییر نام داد. ( IC9118 ) -
FloatingAppBarScrollBehavior
برای محاسبه خودکارscreenOffset
و عدم نیاز به@Composable
به روز شد. ( IDF349 ) - API
LoadingIndicator
را بهروزرسانی میکند تا نامگذاری را در شیء پیشفرض آن اصلاح کند. یک ثابتLoadingIndicatorElevation
درPullToRefresh
اضافه شد. ( I1d72b ) - API
LoadingIndicator
را بهروزرسانی میکند تا نامگذاری را در شیء پیشفرض آن اصلاح کند. یک ثابتLoadingIndicatorElevation
درPullToRefresh
اضافه شد. ( I1d72b ) - پارامترهای
amplitude
وwaveSpeed
را به تغییرات نامشخصLinearWavyProgressIndicator
وCircularWavyProgressIndicator
اضافه کرد. ( I2a0c5 ) - پشتیبانی از تغییر شکل دکمه جابجایی نماد بر اساس حالت فشار داده شده یا علامت زده آن. ( IBC781 )
- بهروزرسانی کلاس تایپوگرافی برای پشتیبانی از مقیاسهای نوع تأکید شده. ( Ifa13c )
- شکل
SplitButton
بر اساس حالت پیشفرض/فشرده تغییر شکل میدهد. ApiAnimatedTrailingButton
حذف شد زیرا apiTrailingButton
می تواند همان سفارشی سازی ها را ارائه دهد ( I95066 ) - اضافه کردن اصلاح کننده به متحرک نمایش و پنهان FAB، به عنوان مثال زمانی که محتوا اسکرول. ( I8338d )
- اضافه کردن اشکال گروه دکمه های متصل و فاصله به
ButtonGroupDefaults
برای استفاده در یک نمونه. ( I68e30 ) - دکمه تقسیم، بالشتک افقی را برای دکمه دنباله اضافه می کند و مرکز نوری محاسبه شده از تفاوت گوشه های شروع و پایان را فعال می کند ( I122e2 )
- معرفی یک Material
MotionScheme
جدید برای تنظیم یک طرح برای حرکت مولفه. این طرح از طریقMaterialTheme
تنظیم می شود. ( ID50c2 )
رفع اشکال
- شاخص پیمایش فوکوس صحیح را روی
Scaffold
child Composables اعمال کنید. دستورtopBar
،bottomBar
، fab، محتوا، اسنکبار است. ( I5936b ) - مشکلی در
DatePicker
وDateRangePicker
رفع شد که در برخی از مناطق و اسکلتهای قالبی خاص، برخی از عناصر تاریخ (مثلاً نام ماه) با حرف بزرگ شروع نمیشدند. ( I1430f ) - ادغام نشانههای کامپوننت منوی FAB و FAB (بهروزرسانیهای بصری جزئی برای بالشتکها و متن) ( Ib57f3 )
-
ModalBottomSheet
اکنون در ترتیب پیمایش معنایی اول است و سپس scrim قرار دارد. ( I436f9 , b/358594665 ) - رفع نشدن نوار پایین برنامه هنگام پیمایش در زیر قرص پیمایش در حالت لبه به لبه ( I3ee21 )
Compose Material3 نسخه 1.3
نسخه 1.3.1
30 اکتبر 2024
androidx.compose.material3:material3-*:1.3.1
منتشر شد. نسخه 1.3.1 حاوی این commit ها است.
رفع اشکال
-
DatePicker
وDateRangePicker
اکنون زمانی که از طریقdisplayedMonthMillis
ایالت خود تنظیم می شوند، ماه نمایش داده شده را به درستی به روز می کنند. ( If9e47 , b/333414302 ) - هنگامی که حداقل سال قابل انتخاب روی سال آینده تنظیم شده باشد، خرابی ها را در
DatePicker
وDateRangePicker
برطرف کنید. ( I78656 , b/319395747 ) - هنگامی که نمونه بهروزرسانیشده
SelectableDates
اعمال میشود، برای بهروزرسانی رابط کاربری، مشکل انتخابگر تاریخ را برطرف کنید. ( Iad59a , b/290135807 , b/339898760 ) - اولویت برگشت به تماس مورد استفاده برگه های پایین را به
PRIORITY_DEFAULT
تغییر دهید تا صفحه کلید IME ابتدا رد شود. ( I447fb )
نسخه 1.3.0
4 سپتامبر 2024
androidx.compose.material3:material3-*:1.3.0
منتشر شد. نسخه 1.3.0 شامل این commit ها است.
تغییرات مهم از 1.2.0
ویژگی های اصلی 1.3.0
مواد جدید طراحی 3 جزء
- چرخ فلک
- ارتقاء
HorizontalMultiBrowseCarousel
وHorizontalUncontainedCarousel
به اجزای طراحی متریال موجود 3.
- ارتقاء
- [
ModalBottomSheet
] اکنون از Predictive Back در U+ پشتیبانی میکند ( Iccf32 , b/281967264 , b/304850357 ) - [
SearchBar
] اکنون از Predictive Back در U+ ( I657f8 ) پشتیبانی می کند - Nav Drawer (
ModalDrawerSheet
وDismissibleDrawerSheet
) اکنون از Back Predictive Back در U+ به عنوان انتخاب ( Ie5b0b ) پشتیبانی می کند. - اکنون
DropdownMenu
از رنگ، شکل، ارتفاع و حاشیه سفارشی پشتیبانی می کند. ( I8e981 , b/289554448 , b/301887035 , b/283654243 ) - لغزنده به روز شده برای بهبود دسترسی با افزودن نشانگر شکاف و توقف. ( I3058e )
-
ProgressIndicator
برای بهبود دسترسی با افزودن نشانگر شکاف و توقف بهروزرسانی شد. ( I21451 ) - یک کارت پیشفرض برای راهنمایی ابزار غنی اضافه شده است، با توجه به لنگر
LayoutCoordinates
از کارت سفارشی پشتیبانی میکند. ( Ifd42c ) شکستن تغییرات - APIهای کشش برای تازه کردن:
-
PullToRefreshState
برای استفاده از مقادیر کسری به جای واحدهای Dp ساده کرد. - وضعیت
isRefreshing
به جایPullToRefreshState
توسط کاربر کنترل می شود. - اتصال پیمایش تودرتو از
PullToRefreshState
جدا شد. توسطPullToRefreshBox
یاModifier.pullToRefresh
جدید مدیریت می شود. - این بهروزرسانی یک تغییر قطعی نسبت به APIهای آزمایشی قبلی است. ( I0adeb , b/314496282 , b/317177684 , b/323787138 , b/324573502 , b/317177683 ) Visual Breaking Changes
-
- برای اطمینان از کنتراست رنگ کافی، پوشش حالت فوکوس را 0.1f به روز کنید. ( I7ea77 )
- تنظیمات کوچک برای پیشفرض رنگ سطح و پسزمینه در
lightColorScheme
وdarkColorScheme
. ( I9db52 ) - رنگهای Slider و
ProgressIndicator
بهروزرسانی شدند تا از مشخصات جدید Non-Text Contrast پیروی کنند. ( I26807 ) - انواع
SurfaceContainer
اکنون توسط کامپوننت ها استفاده می شود. اجزایی که به طور رسمی رنگ را باSurface
وTonalElevation
محاسبه میکنند، اکنون بهطور پیشفرض از نقشهایSurfaceContainer
استفاده میکنند، که تحت تأثیر ارتفاع صدا قرار نمیگیرند. ( b/304584161 ) - نقشهای خط پایه کانتینر سطحی و سطحی کمی تنظیم شدهاند و رنگ بیشتری را در تمهای روشن و تاریک ایجاد میکنند. ( I677a5 )
- APIهای آزمایشی را به پایداری ارتقا داد!
- بهبود عملکرد
نسخه 1.3.0-rc01
21 آگوست 2024
androidx.compose.material3:material3-*:1.3.0-rc01
منتشر شد. نسخه 1.3.0-rc01 حاوی این commit ها است.
رفع اشکال
-
ModalBottomSheet
اکنون در ترتیب پیمایش معنایی اول است و سپس scrim قرار دارد. ( I436f9 , b/358594665 )
نسخه 1.3.0-beta05
24 جولای 2024
androidx.compose.material3:material3-*:1.3.0-beta05
منتشر شد. نسخه 1.3.0-beta05 حاوی این تعهدات است.
- رفع مشکل عدم وجود یا قطع محتوای
BottomSheet
در Android N و O ( a10a2d ) - مرزهای معنایی لغزنده را افزایش داد تا
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 حاوی این تعهدات است.
تغییرات API
-
Modifier.pullToRefreshIndicator
از elevation پشتیبانی میکند، APIهای Pull To Refresh را بهروزرسانی میکند تا به جای لامبدا، یک Boolean را فعال کرده باشد. پشتیبانی از تراز محتوا درPullToRefreshBox
( I75679 ) - ساخت
TooltipScope
یک رابط مهر و موم شده و ایجاد یک پیاده سازی داخلی برای استفاده درTooltipBox
و Label. ( I3833e ) - دو اصلاحکننده جدید به
CarouselItemScope
اضافه شد -maskClip
وmaskBorder
- برای افزودن آسان شکل و حاشیه به هر مورد چرخ فلکی ( Id67a1 ) -
TimePickerState
اکنون یک رابط است و امکان تنظیم زمان را فراهم می کند ( I88546 ) - API به روز شده برای استایل دادن به پیوندها:
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 حاوی این تعهدات است.
تغییرات API
- استفاده از
DpSize
به جایCaretProperties
. حذفCaretProperties
تغییر نامCaretScope
بهTooltipScope
. ( ID9a76 ) - API را برای دریافت پیوندهای مضمون مواد در متن به روز کرد. به طور خاص، روشها را از
TextDefaults
برای ساختLinkAnnotations
با مضمون حذف کرد و HTML را با پیوندهای مضمون تجزیه کرد. در عوض، یک کلاسTextLinkStyles
اضافه کرد که اجازه می دهد تا به پیوندها به عنوان یک پارامتر به Text composable استایل دهید. ( I31b93 )
نسخه 1.3.0-alpha06
1 مه 2024
androidx.compose.material3:material3-*:1.3.0-alpha06
منتشر شد. نسخه 1.3.0-alpha06 حاوی این commit ها است.
شکستن تغییرات
APIهای کشش برای تازه کردن:
-
PullToRefreshState
برای استفاده از مقادیر کسری به جای واحدهای Dp ساده کرد. - وضعیت
isRefreshing
به جایPullToRefreshState
توسط کاربر کنترل می شود. - اتصال پیمایش تودرتو از
PullToRefreshState
جدا شد. توسطPullToRefreshBox
یاModifier.pullToRefresh
جدید مدیریت می شود. - این بهروزرسانی یک تغییر قطعی نسبت به APIهای آزمایشی قبلی است. ( I0adeb , b/314496282 , b/317177684 , b/323787138 , b/324573502 , b/317177683 )
-
تغییرات API
-
RippleConfiguration#isEnabled
حذف شده است وLocalRippleConfiguration
پوچ شده است. برای غیرفعال کردن ریپل، به جای ارائه یکRippleConfiguration
باisEnabled = false
،null
بهLocalRippleConfiguration
ارائه کنید. ( 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 ) - لامبدا
drawTick
به API عمومی اضافه شده است تا در صورت نیاز تیک ها را سفارشی کنید ( I0c048 )
تغییرات API
- پیوندهای متنی علاوه بر استایل معمولی، گزینه استایل حالت فشرده را نیز دریافت کردند، شناور و فوکوس شدند ( I5f864 ، b/139312671 )
-
CarouselItemInfo
بهروزرسانی شد تا ماسکی را نشان دهد . -
BasicTooltipState
از API عمومی Material 3 حذف شد. عملکرد آن باTooltipState
ترکیب می شود تا زمانی کهBasicTooltip
بنیاد تثبیت شود. ( Icda29 ) - یک شی
TextDefaults
اضافه کرد که حاوی روشهایی برای ساختLinkAnnotation
و تجزیه رشته برچسبگذاری شده HTML است کهMaterialTheme
را روی پیوندها اعمال میکند ( I98532 , b/139312671 ) -
ExposedDropdownMenuBoxScope
دیگر اجازه زیر کلاس ها را نمی دهد. منوهای کشویی در معرض اکنون دارای یکMenuAnchorType
هستند که برای پشتیبانی بهتر a11y باید بهmenuAnchor
منتقل شود. این باید به جای انتقالfocusable
بهExposedDropdownMenu
استفاده شود که اکنون منسوخ شده است.menuAnchor
یک پارامتر جدید برای کنترل وضعیتenabled
دارد. ( I55ee6 , b/257209915 , b/308840226 ) - رنگ حاشیه
OutlinedButton
در صورت غیرفعال بودن ثابت شد. اضافه بارButtonDefaults.outlinedButtonBorder("enabled")
که حالت فعال را می گیرد. ( Ie650b , b/318461363 ) - یک کلاس
CarouselItemInfo
جدید اضافه کرد تا به مشتریان کمک کند اطلاعاتی درباره اندازه اقلام دریافت کنند. ( I9070c ) - سازنده
ColorScheme
بدون ظروف سطحی اکنون منسوخ شده است. لطفاً به سازنده ای که شامل ظروف سطحی است مهاجرت کنید. ( I35c11 ) - [نشان داده شده]
TextFieldDefaults
ContainerBox
بهContainer
تغییر نام داد. ( Ie8d3b )
رفع اشکال
- اگر
sheetSwipeEnabled
نادرست باشد،BottomSheetScaffold
دیگر از پیمایش تو در تو اسکرول نخواهد شد. ( I5e1c1 , b/306464779 ) - برخی از حاشیه نویسی
ExperimentalMaterial3Api
OptIn درIconButtonSamples.kt
حذف شد. ( I111d1 )
نسخه 1.3.0-alpha04
3 آوریل 2024
androidx.compose.material3:material3-*:1.3.0-alpha04
منتشر شد. نسخه 1.3.0-alpha04 حاوی این commit ها است.
ویژگی های جدید
- دو نسخه آزمایشی از Material3 Carousel اضافه شد -
HorizontalMultiBrowseCarousel
وHorizontalUncontainedCarousel
( I88d64 ) - به روز شده Compose M3 Nav Drawer (
ModalDrawerSheet
وDismissibleDrawerSheet
) برای پشتیبانی از Predictive Back در U+ به عنوان انتخاب ( Ie5b0b ) - برای جلوگیری از ترکیب مجدد، یک API جدید در نماد اضافه کرد تا امکان عبور رنگ به صورت لامبدا را فراهم کند. ( I5b5a2 )
- API های نوار برنامه برتر اکنون از ارتفاع های سفارشی برای بخش های ثابت و تاشو پشتیبانی می کنند. ( Ib8b0c , b/323403446 )
تغییرات API
- API های نوار برنامه برتر اکنون از ارتفاع های سفارشی برای بخش های ثابت و تاشو پشتیبانی می کنند. مشکلی را برطرف کرد که باعث شد نوارهای بالای برنامه تک خطی بارها هنگام پیمایش محتوا دوباره ترکیب شوند. مشکلی که در آن
MediumTopAppBar
عناوین را در دستگاههایی با تنظیمات فونت/نمایش بزرگ کوتاه میکرد، حل شد. ( Ib8b0c , b/323403446 , b/300953236 , b/286296147 , b/330410290 , b/308540676 ) -
SegmentedButton
و APIهای مرتبط اکنون پایدار هستند ( I8a158 ) -
SwipeToDismissBox
،SwipeToDismissBoxDefaults
،SwipeToDismissBoxState
وSwipeToDismissBoxValue
اکنون پایدار علامتگذاری شدهاند. ( I5f000 ) - فهرستها و APIهای
DismissDirection
وDismissValue
منسوخ شده حذف شدند. ( I89ccd ) - یک برچسب آزمایشی به شیء همراه
CarouselState
Carousel اضافه شد. ( I94154 ) -
LocalMinimumInteractiveComponentEnforcement
منسوخ کنید وLocalMinimumInteractiveComponentSize
برای جایگزینی آن معرفی کنید. ( I7a7ac ) - سازنده
SearchBarColors
اکنون عمومی است. ( I769ca ) - یک پارامتر
gesturesEnabled
بهSwipeToDismissBox
اضافه شد. ( Idc59f , b/324170119 ) - APIهای فیلد نوشتاری که بهعنوان منسوخ و آزمایشی علامتگذاری شدند حذف شدند. ( 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 )
تغییرات API
- پرچم
ScaffoldSubcomposeInMeasureFix
حذف شده است. ( Ie2a4b ) -
NavigationRailItemColors
اکنون به عنوان@Immutable
علامت گذاری شده است. ( If6112 , b/327660613 ) -
NavigationBarItemColors
اکنون بهعنوان@Immutable
علامتگذاری شده است. ( I42a30 , b/298064514 ) - ترتیببندی مجدد پارامترها در Slider Track قابل تنظیم. ( I9f315 )
-
ExposedDropdownMenu
اکنون با استفاده ازPopup
اجرا می شود. رفتار باید یکسان باشد به جز اینکه منوهای قابل فوکوس با فیلدهای متنی قابل ویرایش ممکن است هنگام تایپ روی صفحه کلید نادیده گرفته شوند.
رفع اشکال
- نقشهای خط پایه کانتینر سطحی و سطحی کمی تنظیم شدهاند و رنگ بیشتری را در تمهای روشن و تاریک ایجاد میکنند. ( I677a5 )
- رنگهای Slider و
ProgressIndicator
بهروزرسانی شدند تا از مشخصات جدید Non-Text Contrast پیروی کنند. ( 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 حاوی این commit ها است.
تغییرات API
- ثابت کردن حالت های لغزنده دوباره. ساخت
State.onValueChangeFinished
دوباره یک val را به پایان رساند. بسته بندی رویonValueChangeFinished
درrememberUpdatedState
. ( I82ab2 , b/322269951 ) - اجزای Navigation اکنون از نقشهای
SurfaceContainer
جدید استفاده میکنند. اکنونDrawerDefaults
ویژگیهایstandardContainerColor
وmodalContainerColor
را ارائه میکند.DrawerDefaults.ModalDrawerElevation
اکنون0.dp
است. ( I7fbac ) - حذف
@Stable
از حالت هایSlider
از آنجایی که ماstate.onValueChangeFinished
را بهvar
تغییر می دهیم. ( Ied34a , b/322269951 ) - مشخصات انیمیشن
ModalBottomSheet
وStandardBottomSheet
اکنون یکTweenSpec
است که از یک انیمیشن بهار به روز شده است. با این کار مشکلی که در آن بیش از حد قابل مشاهده است حل می شود. سازندگانSheetState
منسوخ شده بدون چگالی اکنون حذف شده اند. ( I7babc , b/285847707 )
رفع اشکال
- انواع
SurfaceContainer
اکنون توسط کامپوننت ها استفاده می شود. اجزایی که به طور رسمی رنگ را با Surface وTonalElevation
محاسبه میکنند، اکنون بهطور پیشفرض از نقشهایSurfaceContainer
استفاده میکنند، که تحت تأثیر ارتفاع صدا قرار نمیگیرند. ( b/304584161 ) - اشکال رفع شد که باعث شد رنگ محفظه انتخاب نشده و غیرفعال
ElevatedFilterChip
سیاه شود. ( I400e6 , b/322407043 ) - وقتی پیشرفت 0 است نشانگر پیشرفت نامشخص را برطرف کنید ( Id6582 )
- رفع مشکل
Slider
وRangeSlider
در طرح RTL ( Iab0e1 ) - افزودن
SliderRangeTolerance
برای محاسبه محدوده لغزنده زیرا گرد کردن شناور می تواند نادرست باشد. ( Ic918a , b/324934900 ) - اطمینان حاصل کنید که
DatePickerDialog
دکمه های خود را هنگام قرار دادنDateRangePicker
یا هنگام نمایش هر نوع انتخابگر تاریخ در صفحه های کوچک با فونت های بزرگتر نمایش می دهد. ( Ie4758 , b/325107799 , b/277768544 ) -
Menu
اکنون از نقشSurfaceContainer
برای رنگ ظرف استفاده می کند.MenuDefaults.TonalElevation
اکنون0.dp
است. ( I135b7 ) -
TextField
اکنون از نقشSurfaceContainerHighest
برای رنگ ظرف استفاده می کند. ( I4dced ) - تراشه های ارتقا یافته اکنون از نقش
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 ) - به روزرسانی های Container Container
TimePicker
و نقش شماره شماره گیری ساعت بهSurfaceContainerHighest
. ( i43b93 )
نسخه 1.3.0-alpha01
21 فوریه 2024
androidx.compose.material3:material3-*:1.3.0-alpha01
منتشر شده است. نسخه 1.3.0-alpha01 حاوی این commit ها است.
ویژگی های جدید
- به روزرسانی آهنگ M3
ModalBottomSheet
برای پشتیبانی از پیش بینی برگشت در U+ ( ICCF32 ، B/281967264 ، B/304850357 ) - به روز شده آهنگ M3
SearchBar
برای پشتیبانی از پیش بینی برگشت در U+ ( I657F8 ) - کشویی به روز شده برای بهبود دسترسی با اضافه کردن یک شکاف و نشانگر توقف. ( i3058e )
- با افزودن شکاف و توقف نشانگر ،
ProgressIndicator
پیشرفته را برای بهبود دسترسی به روز کرد. ( I21451 ) - با اضافه کردن یک سرپرست پیش فرض برای Tooltip Rich ، API New Rich Tooltip API اکنون اجازه می دهد تا با توجه به
LayoutCoordinates
های لنگرگاه ، Caret سفارشی ترسیم شود. ( IFD42C )
تغییرات رفتار
- اجزای مواد برای استفاده از API های جدید Ripple مهاجرت کرده اند و دیگر
RippleTheme
پرس و جو نمی شوند.
تغییرات API
- Fun
drawStopIndicator
اکنون عمومی است. ( i3f59f ) - عملکرد
formatWithSkeleton
DatePicker
را به عنوان داخلی ( IC65DC ) علامت گذاری کنید -
DropdownMenu
اکنون از رنگ ، شکل ، ارتفاع و مرز سفارشی پشتیبانی می کند. ( i8e981 ، b/289554448 ، b/301887035 ، b/283654243 ) - مؤلفه های Material3 در معرض یک
MutableInteractionSource
در API خود به روز شده اند تا اکنون یکMutableInteractionSource
قابل تهی را که به طور پیش فرض برایnull
است ، در معرض دید قرار دهند. هیچ تغییر معنایی در اینجا وجود ندارد: عبور از null به این معنی است که شما نمی خواهیدMutableInteractionSource
را بالا ببرید و در صورت نیاز در داخل کامپوننت ایجاد می شود. تغییر به null به برخی از مؤلفهها اجازه میدهد تا هرگز یکMutableInteractionSource
تخصیص ندهند، و به سایر مؤلفهها اجازه میدهد فقط در صورت نیاز، نمونهای را ایجاد کنند، که عملکرد این مؤلفهها را بهبود میبخشد. اگر ازMutableInteractionSource
که به این مؤلفه ها منتقل می کنید استفاده نمی کنید، توصیه می شود به جای آن، null را ارسال کنید. همچنین توصیه می شود که تغییرات مشابهی را در اجزای خود ایجاد کنید. ( i41abb ، b/298048146 ) - اضافه کردن
RippleConfiguration
وLocalRippleConfiguration
را اضافه می کند تا امکان سفارشی سازی هر جزء / زیر درخت از موج ها با استفاده از مقادیر ثابت فراهم شود. به عنوان مثال ، برای تغییر رنگ یک مؤلفه که کنترل نمی کنید ، یا یک موج را برای یک جزء غیرفعال می کنید. در بیشتر موارد از مقادیر پیش فرض باید استفاده شود: این API ها یک دریچه فرار برای شخصی سازی اجزای فردی / زیر درختان محدود هستند. برای تغییرات گسترده تر و سیستم های طراحی سفارشی ، در عوض باید با استفاده ازcreateRippleModifierNode
موج خود را بسازید. ( i7b5d6 ، b/298048146 ) - API جدید Ripple را در Material3 اضافه می کند که جایگزین
rememberRipple
مستهلک شده است. همچنین یکCompositionLocal
موقت ،LocalUseFallbackRippleImplementation
استفاده می کند ، اما در صورت استفاده از API های مستهلک شدهrememberRipple
/RippleTheme
قطعات 3 را برای بازگرداندن اجزای Material3 به Material3 بازگردانید. این مورد در نسخه پایدار بعدی حذف میشود و فقط به عنوان کمکی موقت برای مهاجرت برای مواردی در نظر گرفته شده است که یکRippleTheme
سفارشی ارائه میکنید. ( i34cbc ، b/298048146 )
رفع اشکال
- برای بهبود عملکرد ، زیرمجموعه زیر
ModalBottomSheet
را حذف کرد. مسئله ای را برطرف کرد که در آنModalBottomSheet
می تواند در سناریوهای خاص در ترکیب باLookaheadScope
سقوط کند. ( i2a198 ) - زیرمجموعه ای را در
BottomSheetScaffold
قرار داد تا عملکرد را بهبود بخشد. مسئله ای را برطرف کرد که در آنBottomSheetScaffold
در سناریوهای خاص در ترکیب باLookaheadScope
خراب می شود. ( IE6401 ) - تراز نشان تنظیم شده است تا از نظر گوشه بالا سمت راست به مرکز محتوای لنگر نزدیکتر شود. ( i18a28 )
- یک مسئله A11y را با
DateRangePicker
که در آن عنوان متن ماه به عنوان عملی برای خواننده صفحه نمایش ، دسترسی به سوئیچ و کاربران دسترسی صوتی منتقل شده است ، برطرف کنید. ( I2AC55 ) - رفع اشکال Param Param
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
Slider
var
@Stable
شود. ( i82ba1 ، b/322269951 ) - برای کپی کردن از پیش فرض ، رنگهای سفارشی
NavigationBar
برطرف کنید. ( 80a779 ، b/326894020 ) - رفع رگرسیون در
ExposedDropdownMenu
برای دوباره تمرکز آن ( 3FCEC1 ، B/323694447 ) - مشکل ذخیره سازی رنگ دکمه ( 3E5BBC B/327371655 )
نسخه 1.2.0
7 فوریه 2024
androidx.compose.material3:material3-*:1.2.0
منتشر می شود. نسخه 1.2.0 حاوی این commit ها است.
موضوع شناخته شده
- یک اشکال رندر بین المللی با نمای در
PrimaryTabRow
به عنوان بخشی از تغییر بهبود عملکرد معرفی شد. راه حل استفاده ازTabRow
باTabRowDefaults.PrimaryIndicator
است
تغییرات مهم از 1.1.0
طراحی مواد جدید 3 مؤلفه
- بکشید تا تازه شود
- دکمه تقسیم شده
پیشرفت به طراحی مواد موجود 3 مؤلفه.
- نوار برنامه پایین (تراز RTL ، مخفی خودکار در پیمایش)
- به روزرسانی بصری زبانه
- نشان (به روزرسانی تراز)
API های تجربی را به ثبات!
بهبود عملکرد
- لطفاً برای اطلاعات بیشتر به این پست وبلاگ مراجعه کنید!
نسخه 1.2.0-rc01
24 ژانویه 2024
androidx.compose.material3:material3-*:1.2.0-rc01
منتشر می شود. نسخه 1.2.0-rc01 حاوی این commit ها است.
رفع اشکال
- رفع اشکال Param Param
mediumTopAppBarColors
ثابت. ( ibe64a ) - رفع اشکال معرفی شده در
1.2.0-beta02
درCardDefaults.cardColors
کهcontentColor
بر اساس مقدار paramcontainerColor
به روز نکرد. ( IEE041 ، b/319671246 ) - رفع اشکال در
disabledContentColor
در1.2.0-beta02
معرفی شد و بهینه سازی کمی اضافه کرد. ( i6dda1 ، b/318428829 )
نسخه 1.2.0-beta02
10 ژانویه 2024
androidx.compose.material3:material3-*:1.2.0-beta02
منتشر می شود. نسخه 1.2.0-beta02 حاوی این تعهدات است.
اشکال شناخته شده
- یک اشکال در
IconButtonColors
به طور پیش فرضdisabledContentColor
به جایcontentColor
مشخص شده توسط کاربر ، به یک آلفا (0.38F) ازLocalContentColor
اختصاص می دهد. راه حل این است که صریحاًdisabledContentColor
را تنظیم کنید. این در نسخه بعدی ثابت خواهد شد.
تغییرات API
- افزودن قابلیت فعال کردن CADETS TOOLTIP برای API های
Tooltip
ساده. ( IBF767 ) -
SwipeToDismissState
،rememberSwipeToDismiss
wipetodismiss وSwipeToDismissValue
همه به آنها تغییر نام داده اند تا_SwipeToDismissBox_
داشته باشند. ( i68d6d )
رفع اشکال
- مقدار ثابت
ListItem
PADDING برای تراز کردن با مشخصات. ( IBD68B ، B/305342674 ) - رنگ رئوس مطالب برای کارت مشخص شده اکنون به درستی نقشه برداری شده است تا به
OutlineVariant
. ( I75480 ، B/310979715 ) - رنگ پویا اکنون از نقش های رنگی تعریف شده سیستم بیرون می آید. این تضاد را برای محتوای در دسترس بهبود می بخشد و رنگ پویا را با مشخصات مواد نزدیک تر می کند. ( i1de96 )
- دست زدن به پشتی
ModalBottomSheet
بر روی Android T/13+ هنگامandroid:enableOnBackInvokedCallback="true"
. ( I728DC ، B/306196110 )
نسخه 1.2.0-beta01
13 دسامبر 2023
androidx.compose.material3:material3-*:1.2.0-beta01
منتشر می شود. نسخه 1.2.0-beta01 حاوی این تعهدات است.
تغییرات API
- Mark
TabIndicatorScope
به عنوان تجربی. ( i45c88 ) - از بین بردن API های تجربی مستهلک برای ابزار ابزار. ( i438cb )
- بیش از
TabRow
جدید را تغییر دهید تا از زیر مجموعه استفاده نکنید. این امر به روشی متفاوت برای ساخت شاخص هایTabRow
با اصلاح کننده های سفارشی ارائه شده منجر می شود. ( IFE741 ) - Deprecate
DismissDirection
وDismissValue
API. اینها باSwipeToDismissValue
ادغام شده اند ، که مقادیر آن نشان دهنده موقعیت و جهتSwipeToDismissBox
است.DismissState.progress
اکنون به عنوان یکFloatRange
بین0.0
تا1.0
مشخص شده است. Saver و سازنده مستهلک شدهDismissState
حذف شده است. مؤلفهSwipeToDismiss
، حالت و پیش فرض به عنوان تجربی مورد توجه قرار گرفته است. ( IB54F2 )
رفع اشکال
- نشانگر پیش فرض
PullToRefresh
اکنون به جای یک مثلث جامد ، یک فلش باز است. ( i67be3 )
نسخه 1.2.0-alpha12
29 نوامبر 2023
androidx.compose.material3:material3-*:1.2.0-alpha12
منتشر می شود. نسخه 1.2.0-alpha12 شامل این تعهدات است.
تغییرات API
-
RangeSlider
اکنون به جای یک کلاس با ارزشFloatRange
سفارشی ، یک محدوده Kotlin (به عنوان مثال ،0f..1f
) می گیرد.SnapFlingBehavior.kt
هم اکنون از محدوده کوتلین نیز استفاده می کند. ( i025cb ) - توابع کارخانه اصلاح کننده را به عنوان
@Stable
انجام دهید. ( IB109F )
نسخه 1.2.0-alpha11
15 نوامبر 2023
androidx.compose.material3:material3-*:1.2.0-alpha11
منتشر شده است. نسخه 1.2.0-alpha11 شامل این تعهدات است.
ویژگی های جدید
- پیاده روی
PullToRefreshContainer
وPullToRefreshState
، که در کنار هم می توانند یک حرکت را برای تازه کردن اجرای در مواد 3 فراهم کنند. ( i16456 ، b/261760718 )
تغییرات API
-
SwipeToDismissBox
DismissDirection
علامت گذاری کنید و به عنوان تجربیDismissValue
. ( i517b0 ) - تغییر نام
SwipeToDismiss
بهSwipeToDismissBox
.background
بهbackgroundContent
تغییر نام دهید و به دنبالcontent
لامبداdismissContent
. ( i7f4d3 ) - سازنده را برای
ChipElevation
وSelectableChipElevation
عمومی انتخاب کنید. ( IE0C48 ، B/308432421 ) - افزودن
ModalBottomSheetProperties
. انتقالsecurePolicy
بهModalBottomSheetProperties
. افزودنisFocusable
وshouldDismissOnBackPress
بهModalBottomSheetProperties
. این Booleans جدید به تعیین چگونگی رسیدگی به ورق پایین معین باید با وقایع IME کمک کند. ( IEA56F ، B/278216859 ) - دامنه
RangeSlider
وSlider
به روز شده برای حذفinitialOnValueChange
، پیشوندهای اولیه و KDOC های مناسب. ( I57D30 ) - کلاس
ChipBorder
و تماس های عملکرد مرتبط با آن ، استفاده ازBorderStroke
را مستقیماً به جای آن توصیه کنید. ( i89cc2 ) - API های بنیاد Tooltip اکنون
@ExperimentalFoundationApi
هستند. ( i30b0b ) -
TabRow
وScrollableTabRow
دیگر مستهلک نمی شوند. انواع جدید و ثانویه جدید به عنوان تجربی مشخص شده اند. ( i0def6 ) - تراشه های فیلتر و ورودی اکنون به طور مستقیم
BorderStroke
استفاده می کنند. ( i07a8d ) -
SegmentedButton
اکنون ازBorderStroke
مستقیم استفاده می کند. ( i89b9b ) - تابع
AlertDialog
عمومی را بهBasicAlertDialog
تغییر نام داد و عملکرد قبلی را کاهش داد. ( idbe52 ) - تغییر نام API های
SwipeToDismiss
بهSwipeDismiss
، و ارتقاء API های جدیدSwipeDismiss
را به ثبات. ( i14cbe ) - افزودن
tonalElevation
وshadowElevation
به API های Tooltip. علاوه بر این ، حرکتTooltipBox
،PlainTooltip
وRichTooltip
API به آزمایشی بازگشتند زیرا به طور تصادفی به عنوان پایدار آزاد شدند. ( IF0F66 ، B/293939035 ) - API های تراشه آزمایشی را به ثبات ارتقا دهید. ( IEA2C3 )
- حاشیه نویسی
@ExperimentalMaterial3Api
را از کارتهای قابل کلیک Material3 حذف کرد. ( i88dbf )
رفع اشکال
- مسئله ای را برطرف کرد که
SwipeToDismiss
در سناریوهای خاصی با طرح های تو در تو و چیدمان های تنبل خراب می شود. ( ICA8D1 ، B/297226562 )
نسخه 1.2.0-alpha10
18 اکتبر 2023
androidx.compose.material3:material3-*:1.2.0-alpha10
منتشر شد. نسخه 1.2.0-alpha10 شامل این تعهدات است.
تغییرات API
- تبلیغ
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 ) - [NAV RAIL/BAR] از رنگ شفاف برای نشانگر پشتیبانی می کند. ( IE0A9B ، B/267289987 )
نسخه 1.2.0-alpha09
4 اکتبر 2023
androidx.compose.material3:material3-*:1.2.0-alpha09
منتشر می شود. نسخه 1.2.0-alpha09 شامل این تعهدات است.
تغییرات API
-
ModalNavigationDrawer
وDismissibleNavigationDrawer
برای استفاده از API های جدیدAnchoredDraggable
مهاجرت کرده است.animateTo
DrawerState
با روش های باز و بسته جایگزین شده است و افست اکنون به جای یک شیء حالت ، به عنوان شناور در معرض دید قرار می گیرد. می توانید مستقیماً از طریقcurrentOffset
به افست دسترسی پیدا کنید. ( i0a72c ) - توابع غیر قابل مقایسه برای ایجاد مستقیم
DatePickerState
وDateRangePickerState
اضافه شده است. این توابع می توانند به عنوان جایگزینی برای ترکیباتrememberDatePickerState
و در صورت لزوم توابع راrememberDateRangePickerState
. ( i70326 ، b/291524052 ) -
TabRows
ثابت و قابل پیمایش اکنون دارای انواع اولیه و ثانویه هستند. اینها به درستی با رفتار رنگ و نشانگر همانطور که در Material3 تعریف شده است، نگاشت می شوند. -
PrimaryScrollableTabRow
وSecondaryScrollableTabRow
اکنون وضعیت اسکرول را نشان می دهند. ( Iec8f5 , b/260572337 ) - اضافه کردن یک پارامتر جدید
sheetMaxWidth
که توسعه دهندگان می توانند تنظیم کنند تا حداکثر عرض را مشخص کنند که ورق آن باشد. اگر برگه ای که کل عرض صفحه را شامل می شود ، می توان DP.Unspecified را برای پارامتر منتقل کرد. ( IFB7C9 ، B/266697696 ) - اضافه کردن API های
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 حاوی این commit ها است.
تغییر رفتار تغییر
-
ColorScheme
اکنون تغییر ناپذیر است و باعث می شود به روزرسانی های رنگ فردی کارآمدتر شود ، اما استفاده متداول تر از رنگ ها را کارآمدتر می کند. دلیل این تغییر این است که اکثر برنامهها بهروزرسانی رنگهای جداگانه را به عنوان یک مورد استفاده اصلی ندارند. این هنوز هم امکان پذیر است ، اما بیشتر از گذشته بازخوانی خواهد کرد ، به نوبه خود ما به طور قابل توجهی میزان اشتراک های حالت را از طریق تمام کد مواد کاهش می دهیم و بر اولیه سازی و هزینه زمان اجرای موارد استفاده استاندارد تأثیر می گذارد. ( IC447D ، B/297212873 ) - ارتفاع تونال دیگر در حالتهای مختلف تعامل برای مطابقت با مشخصات متحرک نیست. ( ICDD12 )
تغییرات API
- یک
BottomAppBar
جدید اضافه شده است که به عنوان پارامتر به عنوان یک پارامتر یکBottomAppBarScrollBehavior
می گیرد تا هنگام چاپ محتوا ، آن را مخفی کند. همچنین بهFabPosition.EndOverlay
اضافه شده است که به FAB اجازه می دهد تا به جای لنگر انداختن بالای آن ، نوار برنامه پایین را در داربست پوشانده باشد. ( 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 حاوی این commit ها است.
ویژگی های جدید
- پشتیبانی از آیکون های آینه خودکار در
compose material 1.6.0-alpha05
اضافه شده است ، لطفاً برای جزئیات بیشتر در مورد نمادهای آینه خودکار ، به یادداشت های انتشار مراجعه کنید.
تغییرات API
-
SliderState
DraggableState
پیاده سازی می کند ( I9B116 ) - تغییر شکل را به یک پارامتر مورد نیاز تغییر دهید. تغییر نام
position
بهindex
در عملکرد یاور شکل. ( i34941 ) - به روزرسانی The
DatePicker
formatWithSkeleton
برای شامل نقشه ای که به عنوان حافظه نهان برای بهبود عملکرد استفاده می شود. ( i3195f ) -
BasicTooltipBox
را بهcompose.foundation
اضافه کرده است. Foundation و به روز شدهPlainTooltipBox
وRichTooltipBox
برای استفاده ازTooltipBox
با ترکیبات جدیدPlainTooltip
وRichTooltip
. ( i79e1d )
رفع اشکال
-
dynamicLightColorScheme
وdynamicDarkColorScheme
اکنون رنگ های کروما بالاتر را برای نقش های سطح وsurfaceContainer
برمی گردانند. ( i5e901 ) - مسئله ای را برطرف کرد که برخی از مؤلفه ها با استفاده از زیرمجموعه (به عنوان مثال
BottomSheetScaffold
) در داخل یک داربست در داخل یکLookaheadScope
سعی در خواندن اندازه خود را خیلی زود داشتند. ( I297B4 ، I871F1 ، B/295536718 )
نسخه 1.2.0-alpha06
23 آگوست 2023
androidx.compose.material3:material3-*:1.2.0-alpha06
منتشر می شود. نسخه 1.2.0-alpha06 حاوی این commit ها است.
رفع اشکال
- محاسبه
offset
DropdownMenu
ثابت ، بنابراین جبران خسارات X فقط به جهت طرح محلی بستگی دارد ، و هنگامی که منو در نزدیکی پایین صفحه قرار دارد ، دیگر جبران نمی شود. ( ICCC74 ، B/294103942 ) - محاسبه
offset
DropdownMenu
ثابت ، بنابراین جبران خسارات X فقط به جهت طرح محلی بستگی دارد ، و هنگامی که منو در نزدیکی پایین صفحه قرار دارد ، دیگر جبران نمی شود. ( IB87A2 ، B/294103942 )
نسخه 1.2.0-alpha05
9 آگوست 2023
androidx.compose.material3:material3-*:1.2.0-alpha05
منتشر می شود. نسخه 1.2.0-alpha05 حاوی این commit ها است.
تغییرات API
- به روزرسانی در کادر انتخاب و رنگ های
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 حاوی این commit ها است.
ویژگی های جدید
- دکمه تقسیم بندی شده آزمایشی API ( IFC8FB )
- تقسیم کنندگان اکنون پارامتر برای کنترل جهت گیری برای پشتیبانی از تقسیم کننده های عمودی دارند. ( i4c899 ، b/288438593 )
تغییرات API
- ما وابستگی چگالی را به سطح مؤلفه منتقل می کنیم. این در مورد مؤلفه های زیر صدق می کند:
SwipeToDismiss
و اجزای مبتنی بر ورق. لطفاً از اضافه بار جدید ارائه شده در جایی که چگالی یک پارامتر است استفاده کنید. ( i1846e ) - حاشیه نویسی های اضافی برای مشخص کردن ورودی های مجاز به ترکیبات ( IEF234 )
- یک پارامتر نماد را به دکمه تقسیم بندی شده اضافه کنید ، معانی تقسیم شده به طوری که دکمه های تقسیم شده می توانند برای اجرای تک انتخاب و قابل انتخاب برای اجرای چند انتخابی ، با انتخاب
SelectableSegmentedButtonRow
وToggelableSegmentedButtonRow
انتخاب شوند. ( i38740 ) - تقسیم کننده به
HorizontalDivider
تغییر نام داده است. عملکردVerticalDivider
اضافه شده است. ( i5975c ) - استفاده از
ClosedFloatingPointRange
را برایFloatRange
وزن سبک تر در API های آزمایشی 3 تغییر دهید تا به حداقل برسد. ( 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 حاوی این commit ها است.
تغییرات رفتار
-
includeFontPadding
اکنون به طور پیش فرض در تایپوگرافی مواد 3false
است. سبک پیش فرض خط ارتفاع نیز بهTrim.None
وAlignment.Center
تغییر یافته است ، وlineHeight
صریح (در SP) به متنTextStyle
Typography
اضافه شده است. اگر می خواهید این مقادیر را سفارشی کنید ، با اسناد API مشورت کنید و برای یک توضیح دهنده عمیق از این تغییرات ، پست وبلاگ را ببینید. ( i6266f ، ICABC3 )
ویژگی های جدید
- اضافه بار اضافه شده برای
RangeSlider
که نسخه ای از این مؤلفه است. ایجاد شدهRangeSliderState
که تمام اطلاعات مربوط به مسیر فعال فعلی ، اندازه گیری اجزایRangeSlider
و منطق کشیدن و ژست را در خود جای داده است. ( i8c270 ) - نوار جستجو اکنون سایه ها را از طریق پارامتر تازه اضافه شده
shadowElevation
پشتیبانی می کند. ( IA5369 ، B/271040353 ) -
ColorScheme
اکنون از نقش های جدیدSurfaceContainer
پشتیبانی می کند. - روکش ارتفاع تونال سطح هم اکنون می تواند با ترکیب محلی
LocalTonalElevationEnabled
، غیرفعال شوند. ( IC203C ، B/277774590 )
تغییرات API
- سازه های Component Colors را باز کنید. ( i8c4a6 )
- اضافه کردن پارامتر قابل تمرکز به هر دو API Tooltip ، به طوری که توسعه دهندگان می توانند از برنامه های لمسی استفاده کنند یا نه. محتاط باشید که این ممکن است دسترسی را به صورت خودکار متمرکز کند. ( IE32D8 )
- دسترسی بهینه شده برای عملکرد و تخصیص حافظه. ( Iede48 )
-
DefaultSizeClasses
را در معرض نمایش قرار دهید وStandardSizeClasses
برایWindowSizeClasses
ایجاد کنید ( I91838 ) -
WindowWidth/HeightSizeClass
به کلاس های ارزش شناور تغییر دهید ( IE686E )
رفع اشکال
- پارامتر
contentWindowInsets
در حال حاضر به پنجره های مصرف شده احترام می گذارد. توجه داشته باشید که رفتار بالشتک محتوا بر اساسtopBar
وbottomBar
هنگام ارائه این پارامترها بدون تغییر باقی می ماند. ( I08B73 ، B/264601542 ) - برای اطمینان از اینکه یک عنوان طولانی از روی نمادهای عمل یا نماد ناوبری ارائه نمی شود ، تراز نوار برنامه اصلی را برطرف کنید. ( i4369f ، b/236994621 )
- موقعیت های برگه اکنون حداقل عرض محتوای 24.dp را اجرا می کنند. این یک هدف لمسی در دسترس برای شاخص های برگه فراهم می کند. ( id8861 )
- پالت های رنگی پویا از
dynamicLightColorScheme
وdynamicDarkColorScheme
اکنون از نقش های سطح جدید پشتیبانی می کنند. ( i1252e ) - به روزرسانی تراز اعلان نشان به کلیپ هنگام برخورد با پدربزرگ و مادربزرگ. ( IDF75a )
نسخه 1.2.0-alpha02
24 مه 2023
androidx.compose.material3:material3-*:1.2.0-alpha02
منتشر می شود. نسخه 1.2.0-alpha02 حاوی این commit ها است.
تغییرات API
- پارامتر Insets Window را به
ModalBottomSheet
اضافه کنید.- Scrim for
ModalBottomSheet
اکنون ممکن است در پشت نوار وضعیت باwindowInsets
تنظیم شده روی صفر ترسیم شود - عملکرد پیش فرض
ModalBottomSheet
برای ماندن در خارج از میله های سیستم از جمله ناوبری - استفاده از نوار نوار وضعیت توسط Drag Handle در حالت لبه به لبه ارائه می شود.
-
BottomSheetDefaults
شامل قسمتهای پنجره ای برایBottomSheetWindow
است. ( i31200 ، b/274872542 ، b/272973615 ، b /272334475 ، b/268432129 ، b/275849044 ، b/275486106 ، b/268433162 )
- Scrim for
-
Indicator
کاهش داده و برایSecondaryIndicator
باPrimary
M3 اضافه کنید.PrimaryIndicator
با عرض محتوای برگه مطابقت دارد در حالی کهSecondaryIndicator
عرض کامل موجود را در بر می گیرد.SecondaryIndicator
معادلIndicator
اکنون کاهش یافته است و می تواند یک جایگزین مستقیم باشد. ( I27604 ) - گزینه ای برای عبور در یک
ScrollState
هنگام ساخت یکDropdownMenu
یا یکExposedDropdownMenu
برای کنترل حالت پیمایش عمودی موارد منوی نمایش داده شده اضافه شده است. ( IA0734 ، B/185304441 ) - اضافه بار برای
Slider
که نسخه ای از مؤلفه است.SliderState
ایجاد شده است که تمام اطلاعات مربوط به مسیر فعال فعلی ، اندازه گیری اجزایSlider
و منطق کشیدن و ژست را در خود جای داده است. ( i124a5 ) - تغییر نام ویژگی Semantics
isContainer
بهisTraversalGroup
( I121f6 ) - اضافه شده بهینه شده
TextStyle.merge(...)
با لیست کامل پارامتر. ( IAD234 ، b/246961787 ) - رابط های عمومی Made
TooltipState
،RichTooltipState
وPlainTooltipState
.RichTooltipStateImpl
وPlainTooltipStateImpl
برای ایالات پیش فرض اضافه شد. اضافه شدهremember*State
برای به دست آوردن این کشورهای اجرا شده. حذفTooltipSync
به نفع یکTooltipDefault.GlobalMutatorMutex
. ( i7813d ) -
DatePickerColors
را به روز کرد تا گزینه های سفارشی سازی اضافی را برای رنگ های تقسیم کننده ، ناوبری و زمینه های ورودی متنی شامل رنگ های مختلف قرار دهد. ( i1a685 ، b/274626815 ) -
DatePickerState
وDateRangePickerState
اکنون رابط های عمومی با پیاده سازی های پیش فرض هستند که می توانند توسطrememberDatePickerState
وrememberDateRangePickerState
. ( i71c52 ) -
dateValidator
ازDatePicker
وDateRangePicker
حذف کرده و یک رابطSelectableDates
معرفی کرد که می تواند در حالت تنظیم شود تا کنترل کند کدام تاریخ یا سالها در UI قابل انتخاب است. ( IC2FC6 ) -
TimePicker
که از API پایدار حذف شده است ، تغییرات بیشتری در API ایالتی ( I3F39A ) پیش بینی می شود -
ModalBottomSheet
فقط به Android منتقل شد.ModalBottomSheet
برای استفاده از دسک تاپ توصیه نمی شود و عملکرد به طور فعال حفظ نمی شود. ( IB3778 )
رفع اشکال
- Fixed
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 حاوی این commit ها است.
نسخه 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 )
-
state.hour
ثابت. بازگشت مقدار نادرست برای 11:00. ( 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 حاوی این commit ها است.
رفع اشکال
- برای سازگاری باینری ، تماس با
ModalBottomSheet
بدونwindowInset
Param اضافه می کند. ( IB7959 ) - پارامتر Insets Window را به
ModalBottomSheet
اضافه کنید.- Scrim for
ModalBottomSheet
اکنون ممکن است در پشت نوار وضعیت باwindowInsets
تنظیم شده روی صفر ترسیم شود - عملکرد پیش فرض
ModalBottomSheet
برای ماندن در خارج از میله های سیستم از جمله ناوبری - استفاده از نوار نوار وضعیت توسط Drag Handle در حالت لبه به لبه ارائه می شود.
-
BottomSheetDefaults
شامل قسمتهای پنجره ای برایBottomSheetWindow
است. ( i31200 ، b/274872542 ، b/272973615 ، b /272334475 ، b/268432129 ، b/275849044 ، b/275486106 ، b/268433162 )
- Scrim for
نسخه 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 حاوی این commit ها است.
ویژگی های اصلی 1.1.0
طراحی مواد جدید 3 مؤلفه
پیشرفت به طراحی مواد موجود 3 مؤلفه.
API های تجربی را به ثبات!
لطفاً برای اطلاعات بیشتر به این پست وبلاگ مراجعه کنید!
نسخه 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 حاوی این commit ها است.
تغییرات API
-
TimePicker
که از API پایدار حذف شده است ، تغییرات بیشتری در API ایالتی ( 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 حاوی این تعهدات است.
تغییرات API
-
SheetState
اکنون پارامترskipHiddenState
اختیاری دارد -
rememberStandardBottomSheetState
اکنون پارامترskipHiddenState
اختیاری دارد -
BottomSheetScaffold
اکنون یک لنگر پنهان مشخص دارد ، اگرچه به طور پیش فرض غیرفعال است - مستندات
SheetState.requireOffset
به روز شده است -
BottomSheetDefaults.MinimizedShape
به عنوانBottomSheetDefaults.HiddenShape
( i839f4 ، b/273870234 ) تغییر نام داده است
رفع اشکال
- هنگام فعال شدن اکتشاف لمسی ، شماره گیری را از ساعت به دقیقه تغییر ندهید. ( I717D0 )
- معناشناسی دستگیره
ModalBottomSheet
وBottomSheetScaffold
Drag Handle در حال حاضر ادغام شده اند. ( 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 حاوی این تعهدات است.
تغییرات API
- اضافه کردن نوع چیدمان پارامتری به
TimePicker
Composable. بسته به پیکربندی صفحه ، از طرح های مختلف استفاده می کند ( IA0E16 ) -
SearchBarDefaults
به عنوان آزمایشی مشخص شده است. ( i65561 ) - Elevation Shadow Elevation به
BottomSheetScaffold
( I94E0F ) - پشتیبانی اضافه شده برای نمایش Date Pickers بدون قسمت Header. API تغییر می کند تا هنگام ایجاد یک انتخاب کننده تاریخ ، یک تیتر تهی را منتقل کند. اکنون می توانید به منظور نمایش یک انتخاب کننده بدون سر ، از عنوان ، عنوان ، عنوان و
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 )
تغییرات API
- قابلیت های اضافه شده به
DatePickerState
وDateRangePickerState
برای اجازه تنظیم تاریخ پس از ایجاد اولیه دولت و همچنین تنظیم مجدد انتخاب ها با تنظیم زمان های تهی. تنظیم تاریخ ها به صورت دستی باید با احتیاط انجام شود ، و عملکرد جدیدsetSelection
در صورت عدم موفقیت یک تاریخ ارائه شده ، یک استثنا را به وجود می آورد (به مستندات مراجعه کنید). ( IFA645 ، B/268609314 ، B/270427389 ) - تغییر نام
SheetValue
بهPartiallyExpanded
برای نشان دادن رفتار دقیق تر و انعطاف پذیر در این حالت ، تغییر نام داد. ( IA1491 ) - به روز شده نام پارامتر
ListItem
به جای _text به _content. گیرنده های پیش فرض در حال حاضر در صورت لزومReadOnlyComposables
هستند. ( i69a25 ) - API های سطح تعاملی فارغ التحصیل از آزمایش. ( i90d59 ، b/261561812 )
رفع اشکال
- مسئله ای را برطرف کرد که در آن حالت
HalfExpanded
ModalBottomSheet
به طور نادرست محاسبه شد و به نظر می رسد که این برگه شناور است. ( i45e84 ، b/268411386 ) - اضافه کردن بررسی
confirmValueChange
به شیر آب برایModalBottomSheet
. ( 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()
کار کند ، مشخصات M3 را برای ورودی زمان ( IA4FAB ) دنبال می کند - برای انتخاب طیف وسیعی از تاریخ ، یک API
DateRangePicker
Material 3 اضافه کرد. ( i7a6c3 ، b/267194809 ) - برای انتخاب دامنه تاریخ از طریق API
DateRangePicker
یک پشتیبانی از حالت ورودی 3 ماده اضافه شده است. ( IFDBC4 ) - رنگ های زمینه متن اکنون به شخصی سازی اجازه می دهند:
- قسمت ورودی و رنگهای متن نگهدارنده بر اساس حالت تمرکز و خطا. پارامتر
textColor
بهunfocusedTextColor
تغییر نام داده است ، وplaceholderColor
بهunfocusedPlaceholderColor
تغییر نام داده است. - رنگ کانتینر برای فیلدهای متن پر شده بر اساس حالت خطا با
errorContainerColor
Param جدید.
- قسمت ورودی و رنگهای متن نگهدارنده بر اساس حالت تمرکز و خطا. پارامتر
- منوی کشویی در معرض رنگهای متن زمینه با پارامترهایی برای پشتیبانی از پیشوند جدید و پسوند API به روز شده است. ( i9c8b4 ، b/254284181 ، b/264766350 )
تغییرات API
- بازگرداندن برخی از نسخه های API کشویی و از بین بردن اضافه بار کشویی اضافی که توسط کشویی آزمایشی جدید با انگشت شست و آهنگ های سفارشی پوشانده شده است. ارتقاء
RangeSlider
برای پایدار بودن. ( IE8FBD ) - در عملکردهای ارتفاع تراشه به
defaultElevation
بهelevation
تغییر نام داد. ( I0F872 ) - API های زمینه 3 متنی مواد زیر دیگر آزمایشی نیستند:
TextField
،OutlinedTextField
،textFieldWithLabelPadding
،textFieldWithoutLabelPadding
،outlinedTextFieldPadding
. ( IEB5C0 ، B/261561819 ) -
TimePickers
is24Hour
از تنظیمات سیستم استفاده می کند ( I18856 ) - حاشیه نویسی تجربی را از API های داربست حذف کرد. ( IBB51E ، B/261565765 ، B/261436953 )
رفع اشکال
- شکل پیش فرض
ModalBottomSheet
اکنون همیشهSheetDefaults.ExpandedShape
است. ( i0dfca ) - پیشرفت های دسترسی برای مواد 3
DatePicker
وDateRangePicker
. ( I5087E ) - رفع اشکال در جایی که محدودیت حداکثر ارتفاع پخش شده و ممکن است خراب شود. ( i30d8c )
- نقش های معنایی حذف شده از سطوح قابل کلیک و قابل انتخاب ، اجزای به روز شده که از آنها برای تنظیم نقش ها با استفاده از اصلاح کننده استفاده می کردند.
نسخه 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 حاوی این commit ها است.
ویژگی های جدید
- زمینه های متن اکنون از پیشوند و پسوند متن پشتیبانی می کنند ( IA8578 ، b/179884561 )
- یک تابع
TimePicker
اضافه کرد تا یک انتخاب کننده زمان راrememberTimePickerState
دنبال مشخصاتTimePickerState
- ورودی تاریخ اکنون یک حالت نمایش در
DatePicker
است. پشتیبانی اضافه شده برای تعویض بین حالت های ورودی و تاریخ ورودی تاریخ. ( ieeff7 ) - API اضافه شده برای
RichTextTooltips
. ( i58ef3 ) - اجرای ورق پایین معین برای مواد 3 ، از جمله
ModalBottomSheet
وModalBottomSheetDefaults
. همچنینSheetState
وrememberSheetState
که می تواند برای اجزای ورق آینده استفاده شود. ( i0853a ، b/244189383 )
تغییرات API
- Stablize the API
showSnackbar
( i195c2 ، b/261424370 ) - stablize API ها را برای تراشه کمک و تراشه پیشنهاد ( IBB67B ، B/261424370 )
-
ListItem
،ListItemDefaults
وListItemColors
API را به غیر تجربی ارتقا می بخشد ( I7E7FA ، B/26143882 ) - ارتقاء
SliderPositions
،SliderDefaults.Thumb
، وSliderDefaults.Track
به پایدار و اضافه کردن API هایSlider
وRangeSlider
غیر تجربی که حاوی شست و پیست سفارشی هستند. همچنین API هایSlider
وRangeSlider
قبلی را کاهش می دهد. ( IE5EA6 ، B/261566890 ) - made
Modifier.tooltipAnchor()
عمومی ، بنابراین Devs می تواند آن را به لنگر منتقل کند تا نشان دهد یک ابزار ابزار باید در مطبوعات طولانی نمایش داده شود. API به روز شدهPlainTooltipBox
API دیگر باعث ایجاد NullableTooltipState
نمی شود و اکنون پیش فرض دارد. ( IE2FB7 ) -
ProgressIndicatorDefaults.circularTrackColor
برای سازگاری@Composable
مشخص شده است. ( id29cc ) - املاک بازسازی شده
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 حاوی این commit ها است.
ویژگی های جدید
-
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 حاوی این commit ها است.
ویژگی های جدید
- API
DatePicker
اولیه برای انتخاب یک تاریخ از طریق UI تقویم. این API هنوز در حال تغییر است. ( i722b9 ) - پشتیبانی اضافه شده برای وسایل ابزار ساده از طریق
PlainTooltipBox
. ( i0cdfb ) - نوار جستجو ( IAD128 )
-
SwipeToDismiss
( i458a8 ، b/242889540 )
تغییرات API
- اضافه شده در دارایی
IsContainer
در سطوح. این خاصیت در تغییر بعدی مورد استفاده قرار می گیرد که بر اساس معنی معنایی عناصری مانند سطوح ، ترتیب گذر را تعیین می کند. ( i63379 ) - API های مربوط به کشو ناوبری را به عنوان پایدار علامت گذاری کنید. ( IAB01E ، B/261439597 )
- Added a track color parameter for circular progress indicators, and a stroke cap parameter for both circular and linear progress indicators. ( Ie668c , b/216325962 , b/222964817 )
- More return type nullability of deprecated-hidden functions ( Ibf7b0 )
- Add
Modifier.minimumInteractiveComponentSize
. It can be used to reserve at least 48.dp in size to disambiguate touch interactions if the element would measure smaller. ( I33f58 , b/258495559 ) - Added experimental API for
AlertDialog
composable that has a content slot. ( Iec4a2 )
رفع اشکال
- Progress for progress indicators is now properly bounded to its expected range. ( I8a7eb , b/262262727 )
موضوع شناخته شده
- When updating from
androidx.compose.foundation:1.4.0-alpha03
toandroidx.compose.foundation:1.4.0-alpha04
, you might experience ajava.lang.NoSuchFieldError
error. Here is where the issue was orginially reported. A fix has been submitted, and will be available on the next Compose update. As a work around, update yourandroidx.compose.material
andandroidx.compose.material3
libraries to the latest version(1.1.0-alpha04) or downgrade yourandroidx.compose.foundation
to 1.4.0-alpha03.
نسخه 1.1.0-alpha03
7 دسامبر 2022
androidx.compose.material3:material3:1.1.0-alpha03
and androidx.compose.material3:material3-window-size-class:1.1.0-alpha03
are released. نسخه 1.1.0-alpha03 حاوی این commit ها است.
تغییرات API
- Renamed
consumedWindowInsets()
toconsumeWindowInsets()
andwithConsumedWindowInsets()
toonConsumedWindowInsetsChanged()
and made the Modifiers public. ( Ie44e1 ) - Add new default content padding for text button with icon to use. ( I8f662 )
- Added disabled colors for navigation bar and rail. ( Ia7892 , b/258867034 )
- Added an Modifier API to query ancestors scroll info. ( I2ba9d , b/203141462 )
- Used in
Clickable
to correctly delay press interactions, when gestures could become scroll events. - Fixed
Clickables
not correctly delaying ripples, when used inside anScrollable ViewGroup
. - Updated Drawers and Sheets to correctly delay presses in case gestures can become scroll events.
به روز رسانی های وابستگی
-
Compose UI
andCompose Material
now depend on Lifecycle 2.5.1. ( i05ab0 ، b/258038814 )
نسخه 1.1.0-alpha02
9 نوامبر 2022
androidx.compose.material3:material3:1.1.0-alpha02
and androidx.compose.material3:material3-window-size-class:1.1.0-alpha02
are released. نسخه 1.1.0-alpha02 حاوی این commit ها است.
تغییرات API
-
awaitFirstDown
andwaitForUpOrCancellation
now accept aPointerEventPass
for greater flexibility (also fixesExposedDropdownMenuBox
showing a menu while scrolling).( I7579a , b/212091796 ) - Added
minLines
parameter into material and material3 Text,TextField
andOutlinedTextField
which allows setting the minimum height of the component in terms of number of lines ( I4af1d ) - Deprecate the
TopAppBarDefaults smallTopAppBarColors
function in favor of a newtopAppBarColors
function that should be used when creating aTopAppBar
. ( Ie6cb9 ) - Added
minLines
parameter to theBasicText
andBasicTextField
. It allows to set the minimum height of these composables in terms of number of lines ( I24294 , b/122476634 )
رفع اشکال
- Clip the content of a Material3
IconButton
andIconToggleBotton
to the component's state-layer shape (eg circular shape). ( I9da8f ) - Updates Material3 Medium and Large top app bars to apply the same background color across their entire surface, and to allow setting overriding the default colors with transparent color values. ( I67659 , b/249688556 , b/250838918 )
نسخه 1.1.0-alpha01
24 اکتبر 2022
androidx.compose.material3:material3:1.1.0-alpha01
and androidx.compose.material3:material3-window-size-class:1.1.0-alpha01
are released. نسخه 1.1.0-alpha01 حاوی این commit ها است.
رفع اشکال
- Fixes to the top app bar when title is applied with a TextStyle and a Brush. ( If667e )
نسخه 1.0
نسخه 1.0.1
9 نوامبر 2022
androidx.compose.material3:material3:1.0.1
and androidx.compose.material3:material3-window-size-class:1.0.1
are released. نسخه 1.0.1 حاوی این commit ها است.
رفع اشکال
- Updates Material3 Medium and Large top app bars to apply the same background color across their entire surface, and to allow setting overriding the default colors with transparent color values. ( I67659 , b/249688556 , b/250838918 )
نسخه 1.0.0
24 اکتبر 2022
androidx.compose.material3:material3:1.0.0
and androidx.compose.material3:material3-window-size-class:1.0.0
are released. نسخه 1.0.0 حاوی این commit ها است.
ویژگی های اصلی 1.0.0
This is the first stable release of Compose Material 3!
Material Design 3 theming and Material You dynamic color
طراحی متریال 3 جزء
- نشان
- نوار برنامه پایین
- دکمه ها
- FAB and extended FAB
- کارت ها
- چک باکس
- چیپس
- دیالوگ ها
- تقسیم کننده
- منوی کشویی
- فهرست کنید
- نوار ناوبری
- کشوی ناوبری
- ریل ناوبری
- شاخص پیشرفت
- دکمه رادیو
- لغزنده
- سوئیچ
- زبانه ها
- فیلدهای متنی
- Top app bar
- نماد
- متن
- سطح
- طرح بندی
- Content color
Window Size Class
material3-window-size-class
is a new library that provides support for window size classes: a set of opinionated viewport breakpoints for you to design, develop, and test resizable application layouts against. You can usecalculateWindowSizeClass
to retrieve a window size class instance, which you can use to determine how your UI should appear, such as showing a navigation rail instead of bottom navigation for larger window sizes. For more information and sample usage see the API reference documentation forWindowSizeClass
.Please see this blog post for more details!
نسخه 1.0.0-rc01
5 اکتبر 2022
androidx.compose.material3:material3:1.0.0-rc01
and androidx.compose.material3:material3-window-size-class:1.0.0-rc01
are released. نسخه 1.0.0-rc01 حاوی این commit ها است.
تغییرات API
- Added slot param for supporting text to text field API ( Iaac0d , b/227146125 )
نسخه 1.0.0-beta03
21 سپتامبر 2022
androidx.compose.material3:material3:1.0.0-beta03
and androidx.compose.material3:material3-window-size-class:1.0.0-beta03
are released. نسخه 1.0.0-beta03 حاوی این تعهدات است.
تغییرات API
-
ExposedDropdownMenuDefaults
now exposes a padding value for menu items. ( I34ee1 ) -
ExposedDropdownMenuBoxScope
now has aModifier.menuAnchor()
modifier that should be passed to the text field for proper a11y behavior. ( I27fa3 ) - Adding two overloaded methods for the current Slider API to allow users to pass in a thumb or track to populate the slider. ( I21c00 )
رفع اشکال
- Updated dark theme color mapping for On Error Container to tone 90 ( Ic5612 )
- Fix to allow setting a transparent background for small Material 3 top app bars. ( I645e2 , b/245575782 )
نسخه 1.0.0-beta02
7 سپتامبر 2022
androidx.compose.material3:material3:1.0.0-beta02
and androidx.compose.material3:material3-window-size-class:1.0.0-beta02
are released. نسخه 1.0.0-beta02 حاوی این تعهدات است.
تغییرات API
- Default components insets introduced in m3 components in beta01 version no longer account for IME insets.
- Material3 Scaffold component now has a
contentWindowInsets
parameter, allowing to specify the amount of insets to handle for the content slot. ( Icf11a , b/243713323 ) - Deprecates the experimental Material 3
SmallTopAppBar
function and introduces an equivalentTopAppBar
function. Please migrate your usage to the new one. ( I74404 , b/226918634 ) - Adds control over the top app bar fling and snap behaviors. ( I15c81 )
- Removes startIndent from Divider, moves color to last parameter. ( If7be2 )
رفع اشکال
- Have Dialogs identify themselves to talkback users by announcing the word Dialog when they are displayed. ( I857ef )
نسخه 1.0.0-beta01
24 آگوست 2022
androidx.compose.material3:material3:1.0.0-beta01
and androidx.compose.material3:material3-window-size-class:1.0.0-beta01
are released. نسخه 1.0.0-beta01 حاوی این تعهدات است.
مرجع API
To see latest theming, component and other composables available check out the Compose Material 3 API reference overview .
تغییرات API
- Updated the Material 3 top app bar to snap into a fully collapsed to a fully extended state. Also, updated the
TopAppBarDefaults
behavior function to be Composables and provide default values for their top app bar state and animation spec. ( I642b3 ) - Updated FAB component signatures to match surface API ( I3afaa )
- Added insets Build-in support for Top app bars, drawers, navigation bar and rail. These components, when used separately or with Scaffold will automatically handle insets for developers. Note: This change doesn't add automatic handling of status bar icons and transparency of the status and navigation bars. Please, continue to do it manually to ensure the best edge-to-edge experience. ( I7e4e6 , b/183161866 )
- Updated component defaults to reduce API surface for future flexibility and performance improvements. ( I31820 )
- Reordered chip and navigation drawer sheet parameters to maintain consistency within the API ( I45d0b )
- Removed
startIndent
from Divider and moved color to be the last parameter.( If7be2 )
نسخه 1.0.0-alpha16
10 آگوست 2022
androidx.compose.material3:material3:1.0.0-alpha16
and androidx.compose.material3:material3-window-size-class:1.0.0-alpha16
are released. نسخه 1.0.0-alpha16 حاوی این commit ها است.
ویژگی های جدید
- Support specifying a custom width on a navigation drawer. ( Ia7f10 )
تغییرات API
- Reorder Tab and Leading icon tab parameters to maintain consistency within the API ( Ie2637 )
- Marked
BadgeDefaults
as experimental. ( I98ef3 ) - Remove deprecated navigation drawer function. ( I4f2db )
- Reorder Slider parameters in Material 3 to maintain consistency within the API ( I0aee7 )
- Reorder
NavigationBar
andNavigationRail
parameters to maintain consistency within the API ( I51cda ) - Reorder parameters in Material 3 to maintain consistency across the API. ( If4ae1 )
- Reorder Slider parameters in Material 3 to maintain consistency within the API ( I62673 )
- Renamed icons parameter to actions to be consistent with top app bar ( Id75be )
- Mark
Badge
andBadgedBox
as experimental because the anchor alignment is still influx. ( I1712e , b/236524516 ) - Change
@ExperimentalMaterial3Api
annotations on icon button variants to@OptIn
( I070b5 ) - Separated a navigation drawer's content to its own composable to support specifying a custom width on it. ( Ia7f10 )
- Removes
Divider
fromMenuDefaults
andTabDefaults
( I4e33c )
نسخه 1.0.0-alpha15
27 جولای 2022
androidx.compose.material3:material3:1.0.0-alpha15
and androidx.compose.material3:material3-window-size-class:1.0.0-alpha15
are released. نسخه 1.0.0-alpha15 حاوی این commit ها است.
ویژگی های جدید
- Allow dragging the top app bar from the bar itself. ( I65c00 , b/205873416 )
تغییرات API
- Updates to the
FilterChip
andElevatedFilterChip
APIs to remove theselectedIcon
slot and promote reusing theleadingIcon
for displaying a selected state. ( Ie5dc2 ) - Add scrim and outline variant color roles. ( Id6d54 )
- Fix naming conventions for composable defaults. ( I62b27 )
- Mark
ListItemDefaults
andListItemColors
as experimental. ( I1f3ec ) - Changes to the top app bar API to better reflect the meaning of its state properties. Also, mark the top app bar API as experimental. ( Ic0ad8 )
- Text selection colors have now been added to
TextFieldColors
for better discoverability. ( Iba1b8 ) - Adding
ButtonDefault.ButtonWithIconContentPadding
to be used with buttons that contain an icon. ( I2bf9c ) - Text fields have been marked as experimental to allow for more flexibility in future API changes. ( I127b5 )
- Removed the
@ExperimentalMaterial3Api
annotation from theCheckbox
function. ( I5eefc ) - Removed the
@ExperimentalMaterial3Api
annotation from theRadioButton
function. ( I17e2a ) - Removed the
@ExperimentalMaterial3Api
annotation from the non-interactive Cards. ( I9bd49 ) - Updates various component defaults objects to include colors, shapes etc. ( I96e11 )
رفع اشکال
- Removed non-functioning trailing icons from input chip samples to avoid user confusion in the catalog app. ( I9846a )
نسخه 1.0.0-alpha14
29 ژوئن 2022
androidx.compose.material3:material3:1.0.0-alpha14
and androidx.compose.material3:material3-window-size-class:1.0.0-alpha14
are released. نسخه 1.0.0-alpha14 حاوی این commit ها است.
ویژگی های جدید
- Added M3 list implementation, see the documentation for sample usage ( Id7a20 )
تغییرات API
- Change parameter name from values to value in
RangeSlider
( I3b79a ) - API changes to the
InputChip
implementation to support a selectable state per the Material Design spec. Additional support at theFilterChip
colors for selected disabled state. ( I55244 , b/235792432 ) - Add
BottomAppBar
default FAB ( Ida4c8 ) -
ColorScheme.surfaceColorAtElevation
was added ( Id41af ) - رابطها در کتابخانههای کامپوزی اکنون با استفاده از روشهای رابط پیشفرض jdk8 ساخته میشوند ( I5bcf1 )
-
WindowWidthSizeClass
andWindowHeightSizeClass
now implement Comparable, so they can be compared using operators (<, <=, >=, >) and other APIs. ( I747d0 )
رفع اشکال
- Update badge sample to provide more meaningful content description. ( I10b9d )
- Adds option to use the system font size to the Material 3 catalog's theme picker. ( I10605 )
- Adds sample code for Badge and indeterminate progress indicators. ( I8fbe0 )
نسخه 1.0.0-alpha13
1 ژوئن 2022
androidx.compose.material3:material3:1.0.0-alpha13
and androidx.compose.material3:material3-window-size-class:1.0.0-alpha13
are released. نسخه 1.0.0-alpha13 حاوی این commit ها است.
تغییرات API
- Supports maintaining the top app bar position on configuration change. ( I10459 , b/216160958 )
نسخه 1.0.0-alpha12
18 مه 2022
androidx.compose.material3:material3:1.0.0-alpha12
and androidx.compose.material3:material3-window-size-class:1.0.0-alpha12
are released. نسخه 1.0.0-alpha12 حاوی این commit ها است.
رفع اشکال
- Slider parent can now have 0 width. ( b/231707291 )
نسخه 1.0.0-alpha11
11 مه 2022
androidx.compose.material3:material3:1.0.0-alpha11
and androidx.compose.material3:material3-window-size-class:1.0.0-alpha11
are released. نسخه 1.0.0-alpha11 حاوی این commit ها است.
ویژگی های جدید
- Added
RangeSlider
to Material 3 ( I18e38 ) - Adds Material3
AssistChip
andInputChip
support ( I0d25a ) - Adds Material3
FilterChip
andSuggestionChip
support ( I9fdf3 )
تغییرات API
- Renamed
TextFieldDefaults.BorderStroke
composable that draws a border stroke inOutlinedTextField
toTextFieldDefaults.BorderBox
. ( I5f295 ) - Switch m3 visual changes ( Iab30e )
- Allow passing colors to the standard icon buttons. ( Ia2445 )
رفع اشکال
- Add lint check to material3/Scaffold to ensure that the inner padding is used ( I72293 , b/226951418 )
نسخه 1.0.0-alpha10
20 آوریل 2022
androidx.compose.material3:material3:1.0.0-alpha10
and androidx.compose.material3:material3-window-size-class:1.0.0-alpha10
are released. نسخه 1.0.0-alpha10 حاوی این commit ها است.
ویژگی های جدید
-
material3-window-size-class
is a new library that provides support for window size classes: a set of opinionated viewport breakpoints for you to design, develop, and test resizable application layouts against. You can usecalculateWindowSizeClass
to retrieve a window size class instance, which you can use to determine how your UI should appear, such as showing a navigation rail instead of bottom navigation for larger window sizes. For more information and sample usage see the API reference documentation forWindowSizeClass
. For more information on window size class definitions, see the public guidance on supporting different screen sizes.
تغییرات API
- Adds default FAB elevation for
BottomAppBar
, removes trailing lambda fromBottomAppBar
with FAB. ( I92c47 ) - Adds Material3
FilledIconButton
,FilledTonalIconButton
, andOutlinedIconButton
. ( Ib2bda ) - Updates Material 3 Snackbar API to accept color values for the optional action and dismiss-action. ( Ibe4b4 )
- Partial consumption (down OR position) has been deprecated in
PointerInputChange
. You can useconsume()
to consume the change completely. برای تعیین اینکه آیا شخص دیگری قبلاً این تغییر را مصرف کرده است ، می توانید ازisConsumed
استفاده کنید. -
PointerInputChange::copy()
now always makes a shallow copy. این بدان معناست که پس از مصرف یکی از نسخه ها ، نسخه هایPointerInputChange
مصرف می شود. If you want to create an unboundPointerInputChange
, use constructor instead. ( IE6Be4 ، b/225669674 ) - Changes to the Cards API to receive the container and content colors via a
CardColors
interface, and to support a disabled state for clickable cards. ( I927df ) - The parameter
backgroundColor
has been renamedcontainerColor
in Material 3 text fields for improved consistency with other components. ( I6fbd9 )
رفع اشکال
- Updates to the standard
IconButton
to align it with the Material3 spec. ( I09eab ) - Move the top bar height of material3 Scaffold into the padding passed to content, allowing the content to render underneath the top app bar. If the
PaddingValues
are ignored, then the content might be obscured by the top bar. ( I83cbc , b/217776202 )
نسخه 1.0.0-alpha09
6 آوریل 2022
androidx.compose.material3:material3:1.0.0-alpha09
is released. نسخه 1.0.0-alpha09 حاوی این commit ها است.
ویژگی های جدید
- Added Material 3 Switch API ( I2c3ad )
تغییرات API
- Added support for dropdown menus with text fields (aka 'exposed dropdown menus' or 'combo boxes'.) ( I1b832 )
- Added shape parameter to MaterialTheme and Shape sub system. ( I37426 )
- Added an expanded parameter to
ExtendedFloatingActionButton
to control whether the FAB is expanded or collapsed, with animations between each state. Added Extended FAB overload for extended FABs with trailing text for ExtendedFABs without icon. ( Iba7f1 )
نسخه 1.0.0-alpha08
23 مارس 2022
androidx.compose.material3:material3:1.0.0-alpha08
is released. نسخه 1.0.0-alpha08 حاوی این commit ها است.
ویژگی های جدید
- Added support for Material 3 text fields. ( I795cc , b/199377790 )
تغییرات API
- Add default divider for menu ( I01374 )
- Added
surfaceTint
color parameter toColorScheme
class. ( I2f558 )
رفع اشکال
- Fix at the Material3 Button to read its default text style value from the MaterialTheme. ( Ie62fc )
نسخه 1.0.0-alpha07
9 مارس 2022
androidx.compose.material3:material3:1.0.0-alpha07
is released. نسخه 1.0.0-alpha07 حاوی این commit ها است.
تغییرات API
- Updates to Material 3 Surface API that brings back the overloaded functions for clickable Surfaces, as well as adding a function to support selectable and toggleable Surfaces. ( I4bf18 )
-
LazyVerticalGrid
andLazyHorizontalGrid
are now stable. ( I307c0 ) -
LazyVerticalGrid/LazyHorizontalGrid
and all related apis were moved into .grid subpackage. Please update your imports from androidx.compose.foundation.lazy to androidx.compose.foundation.lazy.grid. ( I2d446 ) - Reverted previous change of relying solely on a View for
WindowInsetsControllerCompat
, and again require a Window which is required for managing some window flags. DeprecatedViewCompat.getWindowInsetsController
in favor ofWindowCompat.getInsetsController
to ensure that the correct Window is used (such as if the View is in a dialog). ( I660ae , b/219572936 ) - Added a new
LazyVerticalGrid
API to define cross axis sizes ( I17723 )
رفع اشکال
- Updates to the Card API to follow changes at the Surface API ( I3c8b9 )
نسخه 1.0.0-alpha06
23 فوریه 2022
androidx.compose.material3:material3:1.0.0-alpha06
is released. نسخه 1.0.0-alpha06 حاوی این commit ها است.
تغییرات API
-
NavigationDrawerItem
is added that represents a single destination within the drawers ( Ic396f , b/218286829 ) -
PermanentNavigationDrawer
andDismissibleNavigationDrawer
have been added as experimental APIs. Those are the drawers suitable well for large screen devices. ( I5f8ab , b/218286829 ) - Adds Material 3 bottom app bar support ( Ic432a )
-
NavigationDrawer
has been renamed toModalNavigationDrawer
( I1807d , b/218286829 ) - Added Material 3 Slider class and tokens ( I1ccee )
- Added Tab implementation, see the documentation for sample usage ( Ie0146 )
رفع اشکال
- Fixed an issue where the
TalkBack
screen reader linear navigation selected an empty top app bar title. ( Id4690 ) - Added
IconSize
toFloatingActionButtonDefaults
. ( Ia71cf ) - Bug fix for hidden
AlertDialog
buttons when a long text is added with aLazyColumn
. ( Ib2cc9 , b/216663029 )
نسخه 1.0.0-alpha05
9 فوریه 2022
androidx.compose.material3:material3:1.0.0-alpha05
is released. نسخه 1.0.0-alpha05 حاوی این commit ها است.
ویژگی های جدید
Added Material Design 3 components
- منوی کشویی
- کارت ها
تغییرات API
- Deprecated
Surface
function that takes an onClick callback. Clickable surfaces should be created with anInteractionSource
and aModifier.clickable()
. ( I211c6 ) - Added pressed and focused elevation support for FAB. ( Ibb584 )
- Changed the
Surface
API to receive an InteractionSource which allows controlling its appearance in different states. ( Iafbc8 )
رفع اشکال
- Added missing tertiary colors in dynamic color schemes ( I456c4 , b/214588434 )
نسخه 1.0.0-alpha04
26 ژانویه 2022
androidx.compose.material3:material3:1.0.0-alpha04
is released. نسخه 1.0.0-alpha04 حاوی این commit ها است.
تغییرات API
- Added
NonRestartableComposable
to methods that are overloads of existing methods without complex logic. This reduces compiler generated memoization checks (equals) for all parameters which are repeated in the inner function that is called. ( I90490 ) - Added Material 3 divider. ( Ica5fc )
- Mark the Checkbox and RadioButton with an experimental API annotation. ( Ie44bb )
- Added support for Material 3 progress indicators. ( Iff232 , b/205023841 )
رفع اشکال
- Update a disabled
TextButton's
container color to be transparent ( I6b248 , b/213339737 )
نسخه 1.0.0-alpha03
12 ژانویه 2022
androidx.compose.material3:material3:1.0.0-alpha03
is released. نسخه 1.0.0-alpha03 حاوی این commit ها است.
رفع اشکال
- Add
LocalIndication
to Material 3'sMaterialTheme
. ( I7ce4e ) - Fix the corner radius that is applied for Checkboxes ( I38b03 , b/175198975 , b/202309440 )
به روز رسانی های وابستگی
- اکنون به Kotlin
1.6.10
بستگی دارد.
نسخه 1.0.0-alpha02
1 دسامبر 2021
androidx.compose.material3:material3:1.0.0-alpha02
is released. نسخه 1.0.0-alpha02 حاوی این commit ها است.
ویژگی های جدید
- Add support for checkbox and radiobutton.
- به روز شده تا با Kotlin
1.6.0
سازگار باشد
تغییرات API
- Remove drawer from Material 3's scaffold. ( I04f51 )
- Adds Material 3
Checkbox
support. ( Id5542 ) - Adds Material 3
RadioButton
support. ( I20334 )
رفع اشکال
- Reduce
IconButton
ripple radius from 40dp to 20dp. ( I68bbe , b/206674345 ) - Port string fast path for
Text
changes fromcompose.material
( I30b03 ) - Fixed but that hardcoded button to always be enabled. ( Iea832 , b/205335456 )
نسخه 1.0.0-alpha01
27 اکتبر 2021
androidx.compose.material3:material3:1.0.0-alpha01
is released. نسخه 1.0.0-alpha01 حاوی این commit ها است.
ویژگی های جدید
Material Design 3 theming and Material You dynamic color
طراحی متریال 3 جزء
- دکمه ها
- FAB and extended FAB
- دیالوگ ها
- نوار ناوبری
- کشوی ناوبری
- ریل ناوبری
- Top app bar
- نشان
- نماد
- متن
- سطح
- طرح بندی
- Content color
For more information, check out the Material Design 3 and Material You section in the Material Theming in Compose guide.