این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

نوشتن مواد 3

مرجع API
androidx.compose.material3
( به اسناد مرجع API برای همه بسته های نوشتن مراجعه کنید )

ایجاد رابط کاربری Jetpack Compose با 3 مؤلفه طراحی متریال، تکامل بعدی طراحی متریال. Material 3 شامل قالب‌ها و اجزای به‌روز شده و ویژگی‌های شخصی‌سازی Material You مانند رنگ پویا است و به گونه‌ای طراحی شده است که با سبک بصری جدید Android 12 و رابط کاربری سیستم هماهنگ باشد.

آخرین به روز رسانی	انتشار پایدار	کاندید را آزاد کنید	نسخه بتا	انتشار آلفا
13 آگوست 2025	1.3.2	-	1.4.0-beta02	1.5.0-alpha02

ساختار

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.2"     implementation "androidx.compose.material3:material3-window-size-class:1.3.2"     implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.5.0-alpha02" }  android {     buildFeatures {         compose true     }      composeOptions {         kotlinCompilerExtensionVersion = "1.1.1"     }      kotlinOptions {         jvmTarget = "1.8"     } }

Kotlin

dependencies {     implementation("androidx.compose.material3:material3:1.3.2")     implementation("androidx.compose.material3:material3-window-size-class:1.3.2")     implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.5.0-alpha02") }  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 حاوی این تعهدات است.

ویژگی های جدید

اجزای بدون مضمون که می توانند برای ساخت اجزای طراحی متریال استفاده شوند:

پالت تونال
- TonalPalette
نماد
- Icon
اندازه هدف را لمس کنید
- LocalMinimumInteractiveComponentSize

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 )

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 )

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 )

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 )

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 )

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 )

15 نوامبر 2023

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01 منتشر شد. نسخه 1.0.0-alpha01 حاوی این commit ها است.

ویژگی های جدید

NavigationSuiteScaffold
- NavigationSuiteScaffoldLayout
- NavigationSuite

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:

PaneScaffoldDirective

APIهای داربست صفحه تطبیقی Material3:

APIهای پایه داربست

Compose Material3 نسخه 1.5

نسخه 1.5.0-alpha02

13 آگوست 2025

androidx.compose.material3:material3-*:1.5.0-alpha02 منتشر شد. نسخه 1.5.0-alpha02 حاوی این تعهدات است.

تغییرات API

در PullToRefreshDefaults ، shape به indicatorShape و containerColor به indicatorContainerColor تغییر نام داد و indicatorMaxDistance برای استفاده از نشانگر اضافه کرد. ( Ib6cbe )
حذف برچسب منسوخ از PullToRefreshDefaults.indicatorColor ( Iaaee2 )
AppBarWithSearch اضافه شد، جایگزین TopSearchBar و پشتیبانی از نمادهای ناوبری/عمل. ( I213a5 )

رفع اشکال

رفع اشکال که در آن بکپرس به‌طور نادرست افست کشو را به‌روزرسانی می‌کند. ( I85624 , b/427778135 )
SwipeToDismissBox اکنون در صورت عدم وجود لنگرهای دیگر، به یک targetValue تعیین شده برمی گردد. BottomSheetScaffold اکنون به یک Expanded targetValue برمی گردد اگر هیچ لنگر دیگری وجود نداشته باشد. ( I73d5e , b/428856426 )
هنگامی که به صورت عمودی انباشته می شود، بالشتک دکمه ثابت در AlertDialog . ( Ia2118 )
[FAB] رفع اشکالی که در آن FAB پس از پنهان کردن Modifier.animateFloatingActionButton همچنان قابل کلیک است ( I8ea6c ، b/430336834 )
[Slider] پیمایش صفحه کلید ثابت برای Slider ( I3a405 )

نسخه 1.5.0-alpha01

30 جولای 2025

androidx.compose.material3:material3-*:1.5.0-alpha01 منتشر شد. نسخه 1.5.0-alpha01 حاوی این تعهدات است.

ویژگی های جدید

ارائه‌دهنده موقعیت بیشتری را برای راهنمایی‌های ابزار اضافه کنید تا اکنون توسعه‌دهندگان بتوانند کنترل کنند که راهنمای ابزار در بالا، پایین، چپ یا راست لنگر قرار گرفته باشد. یک API اضافه کنید که شکلی برای carets می گیرد تا شکل های سفارشی بیشتری ارائه شود. ( Ie513c )

تغییرات API

روش‌های TextFieldColors برای محاسبه رنگ‌های مؤلفه بر اساس حالت اکنون عمومی هستند. ( I03165 )
حاشیه نویسی Suspend از onDismiss callback حذف شده است. ( Ie3166 )
DatePickerState.getDisplayedMonth(): YearMonth? و DateRangePickerState.getDisplayedMonth(): YearMonth? به روز شدند تا مقدار غیر قابل تهی را برگردانند. ( Ice09c , b/427952972 )
ModalWideNavigationRailDefaults حذف کنید، محتوای آن را به WideNavigationRailDefaults منتقل کنید و نام‌های مربوط به شکل آن را تغییر دهید. ( IC5e61 )
رنگ‌های WideNavigationRailItem و توابع منسوخ شده کپی باید در سطح Hidden باشند. ( ID7e82 )
سطح Apis WideNavigationRail منسوخ شده را به Warning تغییر دهید و آنها را آزمایشی کنید. ( I89085 )

رفع اشکال

اطمینان حاصل می کند که DatePicker به محلی خاص خود برای قالب بندی اعداد احترام می گذارد. قبلاً، اگر DatePicker برای یک منطقه عربی پیکربندی شده بود، اگر منطقه سیستم دستگاه از سیستم شماره گذاری متفاوتی استفاده می کرد، می توانست ارقام لاتین را اشتباه ارائه کند. ( Iccf76 , b/432616196 )
مشکل LinearProgressIndicator را که نشانگر توقف را به درستی در طرح‌بندی‌های RTL ارائه نمی‌دهد، برطرف کنید. ( I0734c )
تقسیم‌کننده PrimaryScrollableTabRow و SecondaryScrollableTabRow اکنون به اندازه تمام صفحه گسترش می‌یابد، حتی زمانی که محتوای برگه تا انتهای صفحه گسترش نمی‌یابد. ( Ic1e9c , b/261741384 )

Compose Material3 نسخه 1.4

نسخه 1.4.0-beta02

13 آگوست 2025

androidx.compose.material3:material3-*:1.4.0-beta02 منتشر شد. نسخه 1.4.0-beta02 حاوی این تعهدات است.

تغییرات وابستگی

حذف وابستگی به graphics-shapes ( I219e0 ، b/436230765 )

تغییرات API

در PullToRefreshDefaults ، shape به indicatorShape و containerColor به indicatorContainerColor تغییر نام داد و indicatorMaxDistance برای استفاده از نشانگر اضافه کرد. ( Ib6cbe )
حذف برچسب منسوخ از PullToRefreshDefaults.indicatorColor ( Iaaee2 )
BasicAlertDialogOverrideScope به طور تصادفی به پایدار ارتقا یافت و حاشیه نویسی آزمایشی آن در aosp/3701846 حذف شد. علامت گذاری آن به عنوان داخلی به صورت آزمایشی عمومی در 1.5.0-alpha ( I9182a ) باقی خواهد ماند.

رفع اشکال

رفع اشکال که در آن بکپرس به‌طور نادرست افست کشو را به‌روزرسانی می‌کند. ( I85624 , b/427778135 )

نسخه 1.4.0-beta01

30 جولای 2025

androidx.compose.material3:material3-*:1.4.0-beta01 منتشر شد. نسخه 1.4.0-beta01 حاوی این تعهدات است.

شکستن تغییرات

همه APIهای عمومی برچسب‌گذاری شده با ExperimentalMaterial3ExpressiveApi یا ExperimentalMaterial3ComponentOverrideApi حذف شده‌اند، لطفاً برای ادامه بهره‌مندی از این ویژگی‌ها، به 1.5.0-alpha بروید. ( Ie4ae0 )
لطفاً انتظار داشته باشید که APIهای تثبیت شده pullToRefresh در نسخه بعدی تغییر نام دهند. ( Ib6cbe )

ویژگی های جدید

اکنون Tooltip از شکل و موقعیت چرخ دستی سفارشی (بالا، پایین، چپ یا راست لنگر) پشتیبانی می کند. ( Ie513c )

تغییرات API

حاشیه نویسی Suspend از onDismiss callback حذف شده است. ( Ie3166 )
DatePickerState.getDisplayedMonth(): YearMonth? و DateRangePickerState.getDisplayedMonth(): YearMonth? به روز شدند تا مقدار غیر قابل تهی را برگردانند. ( Ice09c , b/427952972 )
ModalWideNavigationRailDefaults حذف کنید، محتوای آن را به WideNavigationRailDefaults منتقل کنید و نام‌های مربوط به شکل آن را تغییر دهید. ( IC5e61 )

رفع اشکال

اطمینان حاصل می کند که DatePicker به محلی خود برای قالب بندی اعداد احترام می گذارد. قبلاً، اگر DatePicker برای یک منطقه عربی پیکربندی شده بود، اگر منطقه سیستم دستگاه از سیستم شماره گذاری متفاوتی استفاده می کرد، می توانست ارقام لاتین را اشتباه ارائه کند. ( Iccf76 , b/432616196 )
مشکل LinearProgressIndicator را که نشانگر توقف را به درستی در طرح‌بندی‌های RTL ارائه نمی‌دهد، برطرف کنید. ( I0734c )
تقسیم‌کننده PrimaryScrollableTabRow و SecondaryScrollableTabRow اکنون به اندازه تمام صفحه گسترش می‌یابد، حتی زمانی که محتوای برگه تا انتهای صفحه گسترش نمی‌یابد. ( Ic1e9c , b/261741384 )

نسخه 1.4.0-alpha18

16 جولای 2025

androidx.compose.material3:material3-*:1.4.0-alpha18 منتشر شد. نسخه 1.4.0-alpha18 حاوی این commit ها است.

ویژگی های جدید

ModalBottomSheetProperties اکنون گزینه ای را برای غیرفعال کردن dismissRequest از یک کلیک scrim ارائه می دهد. ( I8e715 )
پشتیبانی trackCornerSize به آهنگ RangeSlider اضافه کنید. ( Iec529 )

تغییرات API

railExpanded یک پارامتر مورد نیاز برای WideNavigationRailItem ، اضافه کردن modalContentColor برای WideNavigationRailColors و انتقال WideNavigationRailDefaults.modalContainerShape به ModalWideNavigationRailDefaults.containerShape . ( ID60c5 )
پارامتر تابع رنگهای جدید WideNavigationRail را به آخرین پارامتر منتقل کنید و تابع قدیمی را منسوخ کنید. ( Iac7f7 )
PullToRefresh اکنون یک API پایدار است ( I18537 )
به روز رسانی های DatePickers API. ما تاریخ پایان تهی پیش‌فرض را برای DateRangePicker حذف کردیم و ارسال آن را اجباری کردیم. همچنین استفاده نیمه‌شب UTC از نمایش تاریخ در اسناد API را روشن کردیم و آخرین دریافت‌کننده‌ها و تنظیم‌کننده‌هایی را که از APIهای java.time استفاده می‌کنند در حال حاضر به‌عنوان آزمایشی علامت‌گذاری کردیم. ( I121b3 , b/427952972 )
Icon with tint: ColorProducer param API را به غیر آزمایشی تغییر دهید. ( Ia0133 )
حاشیه‌نویسی‌های آزمایشی را از DatePicker ، DateRangePicker ، و حالت‌ها، کلاس‌ها و انواع پشتیبان آن‌ها حذف کرد. ( I0e4e0 , b/391848485 )
برای رفع فوکوس a11y، مقدار قابل تمرکز پیش‌فرض را به false تغییر داد و پارامتر hasAction را به TooltipBox اضافه کرد. ( I62998 )
APIهای WideNavigationRail ، ShortNavigationBar و NavigationItem تجربی فارغ التحصیل. ( I3ca3c )
حاشیه‌نویسی‌های @ExperimentalMaterial3Api را از برخی از عملکردهای بالای نوار برنامه، کلاس‌های پشتیبانی و اشیاء حذف کنید. ( I0a9b7 )

نسخه 1.4.0-alpha17

2 ژوئیه 2025

androidx.compose.material3:material3-*:1.4.0-alpha17 منتشر شد. نسخه 1.4.0-alpha17 حاوی این commit ها است.

ویژگی های جدید

انیمیشن گروه دکمه را به‌روزرسانی کنید تا به‌جای فشار دادن روی آن، 75 درصد انیمیشن را متحرک کنید. ( 593942a , b/423596967 )

رفع اشکال

رفع مشکلی که در آن یک آیتم چرخ فلک می‌تواند در برخی موارد از اندازه عنصر بزرگ در طول محاسبات طرح‌بندی فراتر رود، که کل ویجت را قطع می‌کند. ( I1c3d7 , b/397489534 )
رد شدن از قبل beforeContentPadding هنگام پیمایش چرخ و فلک‌ها با تغییر شیفت شروع و پایان که همپوشانی داشتند، رفع شد. ( c3d5f3a , b/420618979 )
رفتار فعال SwipeToDismiss را به‌روزرسانی کنید تا به جای وضعیت فعلی، وضعیت ساکن را مشاهده کنید. رفتار موجود را که در آن رفتار لنگر فقط زمانی غیرفعال می‌شود که مؤلفه در حالت رد شده قرار گرفته باشد، بازیابی می‌کند. ( 3844e07 , b/425006844 )
اکنون منوی بازشو ExposedDropdownMenu را می توان از طریق ورودی صفحه کلید باز کرد. همچنین اصلاح منو اکنون از طریق صفحه کلید برای تغییرات قابل ویرایش قابل دسترسی است. ( 46ead03 )

نسخه 1.4.0-alpha16

18 ژوئن 2025

androidx.compose.material3:material3-*:1.4.0-alpha16 منتشر شد. نسخه 1.4.0-alpha16 حاوی این commit ها است.

ویژگی های جدید

یک جزء چرخ فلک قهرمان تراز شده در مرکز اضافه شد ( I6f6d3 )

تغییرات API

پیاده‌سازی نوار ابزار عمودی لغو XR ( Ia1604 )
اضافه شدن توابع اسکرول برنامه‌ریزی شده به CarouselState ( I12f8e )
افزودن ComponentOverride برای ModalWideNavigationRail ( I4f440 )
افزودن ComponentOverride برای WideNavigationRail ( I6354f )
ایجاد ComponentOverride برای HorizontalFloatingToolbar ( I51116 )
ایجاد ComponentOverride برای ShortNavigationBar ( I30e24 )
ارجاعات SwipeToDismissBoxState برای confirmValueChange منسوخ شده است. کاربران باید در عوض از SwipeToDismissBox API onDismissed callback استفاده کنند. ( Iee780 )
پارامتر userScrollEnabled به Composable های Carousel اضافه شد. ( I1d4d2 )
Carousel's currentItem اکنون از CarouselState قابل مشاهده است. ( Ie87e9 )

رفع اشکال

مشکلی را برطرف کنید که در آن یک شکل دلخواه در یک FAB به FloatingToolbar ارسال می شود که سایه خود را به درستی اعمال نمی کند. ( Icdcc9 , b/423336922 )
اکنون همه چرخ و فلک ها به طور پیش فرض از نقش معنایی چرخ فلک استفاده می کنند. ( I7af12 )
رفع حرکت نادرست انگشت شست هنگام به روز رسانی حالت لغزنده از طریق LaunchedEffect ( Id9f31 , b/302774166 )

نسخه 1.4.0-alpha15

20 مه 2025

androidx.compose.material3:material3-*:1.4.0-alpha15 منتشر شد. نسخه 1.4.0-alpha15 حاوی این commit ها است.

تغییرات API

MotionTheme.LocalMotionScheme اضافه شد، ترکیب محلی. این امکان دسترسی به طرح حرکت تم را از CompositionLocalConsumerModifierNodes ، با currentValueOf(MotionTheme.LocalMotionScheme) می دهد. ( I014b1 )
سازنده ColorScheme بدون نقش های رنگ ثابت اکنون منسوخ شده است. لطفاً به سازنده ای که دارای نقش های ثابت است مهاجرت کنید. ( Iad0ee )
کامپوننت M3 Text اکنون از TextAutoSize پشتیبانی می کند. ( I7f524 )
api را برای ساخت انواع اندازه دکمه های تقسیم اضافه کنید و نمونه ها را اضافه کنید. ( Ice30b )

رفع اشکال

مشکلی که در آن Snackbar و FloatingActionButton در هنگام فعال بودن لبه به لبه به درستی قرار نداشتند، برطرف شد. اکنون داربست به درستی دریچه های افقی را روی این اجزا اعمال می کند. ( Ib7c30 , b/244400727 )
حرکت BottomSheet را از کاملاً باز به نیمه باز شده ثابت کنید. اکنون BottomSheet از جلوه سریع MotionScheme در هنگام مخفی شدن یا جمع شدن، و پیش فرض فضایی هنگام گسترش استفاده می کند. ( Ifa46f , b/416063171 )
سازنده ColorScheme بدون نقش ظروف سطحی به صورت مخفی علامت گذاری شده است و دیگر برای استفاده توصیه نمی شود. ( Ia7237 )
یک نیاز CircularWavyProgressIndicator Size.minDimension > 0 را حذف کرد، که برای ایجاد یک استثناء استفاده می‌شد تا انعطاف‌پذیری بیشتری داشته باشد. ( Ic9418 , b/377531195 )
هایپرلینک ها در Text(AnnotatedString) اکنون به طور پیش فرض دارای استایل متریال هستند. ( I78288 , b/339843816 )
مشکلی را برطرف کنید که در آن تابع toShape() در RoundedPolygon یک Path را کش می‌کند و هنگام برقراری تماس‌های متعدد createOutline با اندازه‌های مختلف مشکل ایجاد می‌کند. ( I4026d )

نسخه 1.4.0-alpha14

7 مه 2025

androidx.compose.material3:material3-*:1.4.0-alpha14 منتشر شد. نسخه 1.4.0-alpha14 حاوی این commit ها است.

تغییرات API

یک AppBarColumn جدید اضافه شد که به همان شیوه AppBarRow کار می کند اما برای محتوایی که در یک ستون قرار داده شده است. ( Iaf6bd )
حداکثر موارد به AppBarRow اضافه شده است، این برای اجرای صحیح مشخصات مواد برای نوارهای برنامه بالا ضروری است. ( I92ce4 )
روشی را در TooltipScope برای بدست آوردن layoutCoordinates لنگر اضافه کرد. منسوخ کردن روش drawCaret زیرا توسعه دهندگان می توانند از این روش جدید برای به دست آوردن layoutCoordinates کرانه های لنگر و ایجاد یک شکل مناسب که حاوی یک حفره است استفاده کنند. ( Ia2e12 , b/329470609 )
پشتیبانی java.time برای Date Pickers اضافه شد: اضافه بارهای rememberDatePickerState/rememberDateRangePickerState که اشیاء java.time را می پذیرند (به عنوان مثال، LocalDate اولیه، YearMonth ) معرفی شد. همچنین توابع افزودنی را بر روی اشیاء حالت اضافه کرد تا مقادیر را با استفاده از انواعی مانند LocalDate و YearMonth دریافت/تنظیم کرد. به API 26+ یا شیرین‌زدایی نیاز دارد. ( I70f29 , b/266202516 , b/281859606 )
افزودن CenteredTrack composable که امکان استفاده از یک لغزنده را با آهنگی که از مرکز شروع می‌شود، فراهم می‌کند. ( I5b1d6 )

رفع اشکال

بهبود عملکرد شاخص‌های پیشرفت موج‌دار: انواع خطی اکنون 8.5% سریع‌تر با 11% تخصیص کمتر بارگیری می‌شوند، در حالی که انواع دایره‌ای شاهد افزایش قابل‌توجه 47% سرعت و 39% کاهش تخصیص هستند. ( I595d8 )

نسخه 1.4.0-alpha13

23 آوریل 2025

androidx.compose.material3:material3-*:1.4.0-alpha13 منتشر شد. نسخه 1.4.0-alpha13 حاوی این commit ها است.

تغییرات API

isAppearanceLightStatusBars و isAppearanceLightNavigationBars به‌عنوان پارامترهای فقط اندروید به ModalBottomSheetProperties معرفی شدند. ( ID4bc0 )
یک AppBarRow قابل ترکیب اضافه کنید، که سرریز مواردی را که خارج از محدوده آن قرار می‌گیرند، کنترل می‌کند. ( I742bd )
API DatePicker و DateRangePicker را برای درخواست فوکوس هنگام تغییر به حالت ورودی تاریخ، به‌روزرسانی کنید. ما پارامتر بولی requestFocus را با یک پارامتر اختیاری focusRequester که یک FocusRequester می گیرد، جایگزین کرده ایم. ( I14b69 )
اصلاح کننده و منبع تعامل را از موارد پیش فرض قابل کلیک و تغییر حذف کنید. در عوض آن را به عنوان جزییات پیاده سازی داشته باشید. ( I95ed6 )
ButtonGroup به‌روزرسانی کرد تا وقتی دکمه‌های زیادی روی صفحه وجود داشته باشد، به منوی کشویی سرریز شود. ( I7b88b )

رفع اشکال

صفحه پایین اکنون وقتی کوچکتر از افست فعلی است، ورودی های بالایی را مصرف می کند. این به کاربران اجازه می‌دهد تا ورودی‌های بالایی را برای رفتار گسترده ارائه کنند. BottomSheetDefaults.windowInsets اکنون شامل WindowInsets.safeDrawing.Top است. ( I0ab67 , b/321877275 , b/336962418 , b/342093067 )
فعال کردن انیمیشن‌های ورود/خروج (محو شدن/اسلاید) برای نمادها/آواتارهای اصلی تراشه و آیکون‌های دنباله‌دار وقتی اضافه یا حذف می‌شوند. این در درجه اول به نفع تراشه های قابل انتخاب (فیلتر، ورودی) است، اما به طور کلی اعمال می شود. ( I9af21 )
رفتار شکسته لغزنده RTL ناشی از LookaheadScope را برطرف کنید. ( Ieb152 , b/408118041 )
خرابی Bottom AppBar مربوط به پیمایش با رابط کاربری پنهان سیستم را برطرف کنید. ( IC6140 , b/405996228 )

نسخه 1.4.0-alpha12

9 آوریل 2025

androidx.compose.material3:material3-*:1.4.0-alpha12 منتشر شد. نسخه 1.4.0-alpha12 حاوی این commit ها است.

تغییرات API

پارامترهای خاص اندروید از ModalBottomSheetProperties حذف شد ( Iab97f , b/362539765 )
معرفی توابع اضافه بار برای پیش‌فرض اندازه دستگیره کشیدن ( I0ed0d )
توابع NavigationSuiteScaffold و NavigationSuiteScaffoldLayout جدید برای پشتیبانی از انواع طرح‌بندی جدید و افزودن پشتیبانی برای محتوای اقدام اولیه اختیاری اضافه کنید. ( Ib262a , b/353144478 )
Modifier.weight با پارامتر fill در ButtonGroup منسوخ کنید. اضافه کردن یک نسخه بدون پر. ( ID32bb )
تغییر نام xSmall- و xLarge- مؤلفه IconButton به طور پیش فرض برای املای extra . ( Ib6e0f )
برای پشتیبانی از انواع طرح بندی جدید، توابع NavigationSuite ، NavigationSuiteItem و NavigationSuiteColors جدید اضافه کنید. ( I203d6 )
افزودن NavigationSuiteTypes جدید و اضافه کردن تابع navigationSuiteType جدید که شامل آن گزینه‌های طرح‌بندی می‌شود ( If68f9 )

رفع اشکال

ColorScheme.contentColorFor اکنون surfaceDim به onSurface نگاشت می کند. ( I8891a )
اجرای DateInputTextField برای رسیدگی به مشکلی که در آن قسمت ورودی تاریخ تنظیم شده از نظر برنامه‌ریزی را منعکس نمی‌کند، به‌روزرسانی شد. ( I6c8d1 , b/401143451 )
ترتیب فوکوس تاک بک برای ریل ناوبری و ریل ناوبری عریض ( I6cf6f , b/407048224 ) ثابت شد

نسخه 1.4.0-alpha11

26 مارس 2025

androidx.compose.material3:material3-*:1.4.0-alpha11 منتشر شد. نسخه 1.4.0-alpha11 حاوی این commit ها است.

تغییرات API

به روز رسانی حروف بزرگ برای ویژگی های قابل ترکیب در اشیاء پیش فرض برای دکمه و دکمه جابجایی. بسته به ارتفاع ظرف، روش‌هایی را در ToggleButtonDefaults و ButtonDefaults برای محتوای توصیه‌شده، شکل‌ها، اندازه نمادها، فاصله بین نمادها و سبک متن اضافه کنید. ( Iea69e )
توابع و ثابت های آزمایشی منسوخ شده از FloatingToolbar حذف شد. ( I8f339 )
اجزای ارتفاع اکنون یک رابط مشترک دارند و سازنده ها و خصوصیات عمومی دارند. ( Ibb172 )
افزودن اصلاح‌کننده animateWidth در ButtonGroupScope که برای متحرک سازی صحیح کودکان باید با کودکان گروه دکمه‌ها استفاده شود. ( Ia3bb6 )

رفع اشکال

پد نوار ابزار شناور را برای اطمینان از تعادل بصری در هنگام فروپاشی، و انعطاف‌پذیری بهبود یافته برای محتوای بزرگ‌تر، ثابت کرد. ( I06c00 )

نسخه 1.4.0-alpha10

12 مارس 2025

androidx.compose.material3:material3-*:1.4.0-alpha10 منتشر شد. نسخه 1.4.0-alpha10 حاوی این commit ها است.

تغییرات API

TabRowDefaults.tabIndicatorOffset به نفع TabIndicatorScope.tabIndicatorOffset منسوخ شده است. ( IB36b3 )
رفع اشتباه تایپی برای محتوای کم حجم در پیش‌فرض دکمه‌ها. ( I19bfe )
TabRow و ScrollableTabRow به نفع انواع اولیه و ثانویه هر کدام منسوخ شده اند. ردیف‌های برگه اصلی و ثانویه از نظر مشخصات عملکرد و دقت بیشتری دارند. ( I918e2 )
rememberSliderState و rememberRangeSliderState اضافه شد. ( I8e384 )
shouldAutoSnap به SliderState برای کنترل مکانیسم snapping خودکار اضافه شود، غیرفعال کردن آن ممکن است برای انیمیشن های سفارشی مفید باشد. ( I07745 )
حداقل عرض برگه ردیف برگه قابل پیمایش اکنون یک پارامتر است. انواع ردیف برگه اصلی و ثانویه دیگر آزمایشی نیستند. ( If6f15 , b/226665301 )
کلاس ExitAlwaysFloatingToolbarScrollBehavior را عمومی کرد و اجازه ایجاد بدون ترکیب را داد. ( IBF31c )

نسخه 1.4.0-alpha09

26 فوریه 2025

androidx.compose.material3:material3-*:1.4.0-alpha09 منتشر شد. نسخه 1.4.0-alpha09 حاوی این تعهدات است.

تغییرات API

تغییر نام فیلدهای تنظیمات DragHandle در حالت پیش فرض. حالت های فشرده و کشیده جدا. اندازه های پیش فرض را عمومی کنید. ( I787b9 )
به‌روزرسانی‌های TowRowsTopAppBar API. پارامتر لامبدا expanded حذف شد و پارامترهای جداگانه برای ارتفاعات منبسط شده و فرو ریخته اضافه شد. ( Idd677 , b/306697446 , b/229134133 , b/268068946 )

رفع اشکال

نوارهای پایین برنامه اکنون سرویس کاوش لمسی (مثلاً TalkBack ) را مشاهده می کنند و هر زمان که سرویس روشن است، آنها را قابل مشاهده نگه می دارند. ( I4b34d )

نسخه 1.4.0-alpha08

12 فوریه 2025

androidx.compose.material3:material3-*:1.4.0-alpha08 منتشر شد. نسخه 1.4.0-alpha08 حاوی این commit ها است.

ویژگی های جدید

یک API TimePickerDialog اضافه شده است که می تواند برای TimePicker ، TimeInput یا برای داشتن نسخه قابل تعویض استفاده شود. ( ID2d83 )
APIهای نوار جستجوی جدید:
- نوارهای جستجوی جمع‌شده و «نماهای» جستجوی گسترده اکنون قابلیت‌های جداگانه‌ای هستند.
- SearchBar نشان دهنده یک نوار جستجو در حالت جمع شده است.
- ExpandedFullScreenSearchBar و ExpandedDockedSearchBar نوار جستجو را در حالت گسترش یافته نشان می دهند. اینها در یک پنجره جدید باز می شوند.
- SearchBarState برای کنترل وضعیت نوار جستجو
- TopSearchBar برای افزودن کنترل و رفتار اسکرول درونی ها
- اضافه بار جدید InputField که از SearchBarState استفاده می‌کند ( Ie0723 , b/261496232 , b/283311462 , b/350916229 , b/352872248 )

تغییرات API

پشتیبانی از شکل‌گیری شکل گوشه دکمه‌های آیکون در فشار. ( I21843 )
APIهای دکوراتور/جعبه تزئینات فیلد متن دیگر آزمایشی نیستند. ( I31d95 )
نمونه ها و پیش فرض ها برای نوع متصل برای ButtonGroup اضافه شده است. ( I5c8ce )
پارامتر حالت را در NavigationSuiteScaffold و NavigationSuiteScaffoldLayout آخرین پارامتر کنید. ( I9cc7b )

رفع اشکال

اقدامات دسترس‌پذیری سفارشی را به FloatingToolbars اضافه کرد تا سرویس‌های دسترس‌پذیری اکنون بتوانند همه تغییرات FloatingToolbar را گسترش یا جمع کنند. نسخه مجهز به FAB این را برای FAB اعمال می کند، در حالی که نسخه بدون FAB آن را برای محتوای اصلی اعمال می کند. ( I26420 )
FloatingToolbars اکنون سرویس کاوش لمسی (مثلا TalkBack) را مشاهده می کند و هر زمان که سرویس روشن است نوار ابزار را باز و قابل مشاهده نگه می دارد. ( I02172 )
در صورتی که Float.NaN به عنوان پیشرفت ارسال شود، خرابی در نشانگرهای پیشرفت و بارگذاری برطرف شد. ( I4fa96 , b/352364576 )

نسخه 1.4.0-alpha07

29 ژانویه 2025

androidx.compose.material3:material3-*:1.4.0-alpha07 منتشر شد. نسخه 1.4.0-alpha07 حاوی این commit ها است.

ویژگی های جدید

انعطاف پذیری بیشتری در سفارشی کردن ظاهر چک باکس ها با یک API جدید اضافه شده است. این API پارامترهای Stroke را فراهم می کند که امکان کنترل بیشتر بر نحوه نمایش علامت چک و چک باکس را فراهم می کند. ( I65a88 )
TwoRowsTopAppBar API اضافه شد، یک جایگزین قابل تنظیم بیشتر برای نوارهای برنامه متوسط و بزرگ برای ایجاد نوارهای بالای برنامه دو ردیفه. توسعه‌دهندگان اکنون بر محتوای عناوین و زیرنویس‌ها در هر دو حالت جمع‌شده و گسترش‌یافته، با ارتفاع‌های قابل تنظیم برای هر ایالت، کنترل دارند. ( I0be3c , b/306697446 , b/229134133 , b/268068946 )

تغییرات API

یک تغییر آزمایشی BottomAppBar به FlexibleBottomAppBar تغییر نام داد که کنترل بیشتری بر ترتیب و ارتفاع محتوا فراهم می‌کند. ( Iaa448 )
به‌روزرسانی نام‌گذاری ویژگی‌ها در شی پیش‌فرض Button Group به CapitalCase . نام animateFraction را به‌روزرسانی کنید تا رفتاری که نشان می‌دهد دقیق‌تر باشد. ( I545cd )
اضافه کردن اضافه بار برای دکمه های رایج که امکان ایجاد اشکال متحرک در تعامل مطبوعاتی را فراهم می کند. اشکال دکمه های ذخیره شده در حافظه پنهان اضافه شده است. ( I5ec20 )
اکنون می‌توانید با ارائه یک FloatingToolbarScrollBehavior ، نحوه واکنش نوار FloatingToolbar با FAB به پیمایش را کنترل کنید. برای نوار ابزارهایی که در امتداد لبه مرکزی قرار دارند (مانند مرکز بالا یا پایین)، توصیه می‌کنیم از یک رفتار اسکرول برای پنهان کردن کل مؤلفه در اسکرول استفاده کنید تا ظاهری تمیزتر داشته باشید. این همچنین از خارج شدن FAB از مرکز جلوگیری می کند، که ممکن است هنگام استفاده از پرچم expanded برای فروپاشی اتفاق بیفتد. ( I33f67 )
APIهای آزمایشی TopAppBar را برای استفاده از Alignment.Horizontal به جای TopAppBarTitleAlignment سفارشی هنگام تنظیم تراز عنوان و زیرنویس به روز می کند. ( I70ca2 )
SliderState#onValueChange اکنون عمومی است تا کنترل بیشتری به کاربر بدهد ( I104eb )
NavigationSuiteScaffoldState را معرفی کنید تا امکان متحرک سازی جزء ناوبری فراهم شود. همچنین اضافه بارهای NavigationSuiteScaffold و NavigationSuiteScaffoldLayout را معرفی کنید که دارای پارامتر حالت هستند. ( I6a8c9 , b/328674235 )

رفع اشکال

کلاس‌های IconButtonColors و IconToggleButtonColors را از IconButtonDefaults.kt به IconButton.kt برگردانید. ( I3c233 )

مشارکت خارجی

SliderState#isDragging اکنون عمومی است. ( I8458a )

نسخه 1.4.0-alpha06

15 ژانویه 2025

androidx.compose.material3:material3-*:1.4.0-alpha06 منتشر شد. نسخه 1.4.0-alpha06 حاوی این commit ها است.

تغییر رفتار

displayCutout به گروه ورودی‌هایی اضافه کرد که اجزای Material به طور پیش‌فرض در نظر می‌گیرند تا از همپوشانی محتوا با برش نمایشگر جلوگیری شود. این یک تغییر رفتار است که بر نحوه رفتار اجزای آگاه در اطراف صفحه نمایش تأثیر می گذارد. این شامل مقدار پیش فرض پارامتر WindowInsets برای اجزای inset-Aware Material 3 است ، و مقادیر WindowInsets ارائه شده در اجزای پیش فرض اشیاء برای هر دو ماده 2 و ماده 3. اگر این تغییر باعث رفتار نامطلوب می شود ، پارامتر WindowInsets به صورت دستی مشخص کنید. ( i43ee9 ، b/362508045 )

تغییرات API

به روزرسانی در API TopAppBar . نوارهای برنامه متوسط و بزرگ را با زیرنویس به *FlexibleTopAppBar تغییر نام دهید. تغییرات رنگ را به یک عملکرد TopAppBarDefault.topAppBarColors() یکپارچه کرد و یک پارامتر رنگ subtitle اضافه کرد تا برای یک ترکیب زیرنویس ارائه شده اعمال شود ( I41B65 )
حذف API WideNavigationRailArrangement به نفع Arrangement.Vertical بالاتر ( ID0341 )
یک VerticalSlider @Composable اضافه کنید. ( i2bfba )
یک آهنگ جدید اضافه کنید @Composable که به مشخص کردن گوشه های آهنگ خارجی سفارشی و نمادهای پیگیری می دهد. ( i436a4 )
API های نوار ابزار شناور را به روز کنید تا به جای یک رنگ ظرف واحد ، از شیء FloatingToolbarColors استفاده کنید. ( i9a054 )
اضافه و استفاده از حاشیه نویسی آزمایشی جدید ExperimentalMaterial3ComponentOverrideApi ( IA1EAF )
Modifier.indicatorLine اکنون شکل می گیرد تا قسمت متن بتواند بریده شود. ( i8c5f3 ، b/380704151 )
تغییر نام توابع FloatingAppBar به FloatingToolbar ( I1DBF8 )
یک floatingToolbarVerticalNestedScroll جدید اضافه شده است که می تواند به یک ظرف قابل پیمایش وصل شود تا وضعیت انبساط نوار ابزار شناور را بر اساس یک حرکت پیمایش که از آستانه عبور می کند ، به روز کند. ( i6d65f )
معرفی یک API جدید برای ایجاد نوار ابزار شناور با یک دکمه اکشن شناور متصل (FAB). API گزینه های سفارشی سازی انعطاف پذیر را ارائه می دهد ، به شما امکان می دهد نوار ابزار را به صورت افقی یا عمودی ترتیب دهید و FAB را در شروع یا انتهای نوار ابزار قرار دهید. ( i9e350 )

رفع اشکال

مسئله دسترسی SNACKBAR را برطرف کنید که باعث شده است که هنگام شروع TalkBack ، خود را در مورد اخراج اعلام کند. ( /i9db53 )

سهم خارجی

BasicTooltip متداول در پایه و BasicTooltip/Tooltip در مواد 3. ( IFC2E6 )

نسخه 1.4.0-alpha05

12 دسامبر 2024

androidx.compose.material3:material3-*:1.4.0-alpha05 منتشر می شود. نسخه 1.4.0-alpha05 شامل این تعهدات است.

تغییرات API

نوع در WideNavigationRailState.current/target را برای یک enum برای خوانایی بهتر جایگزین کنید ( I2D6AB )
SplitButton API شکل را از کلاس داده به کلاس برای سازگاری باینری تغییر می دهد. ( i53812 )
یک API Tooltip اضافه شده است که دارای یک پارامتر onDismissRequest است تا سازندگان بتوانند تصمیم بگیرند که وقتی کاربر در خارج از ابزار ابزار کلیک می کند چه اتفاقی می افتد. API قدیمی را که حاوی این پارامتر جدید نیست ، مستهلک کرد. ( i99aef )
تغییر نام opticalCentering به horizontalCenterOptically . ایجاد اصلاح کننده داخلی. پارامتر بالشتک را با جبران حداکثر شروع و پایان جایگزین کنید. ( I0B904 )
تغییر WideNavigationRailState برای داشتن مقدار فعلی/هدف ، حذف Enums به نفع بولی. ( IDFA29 ، B/356039090 )
NavigationBarItemComponentOverride را اضافه کنید. ( i3a06a )

رفع اشکال

رفتارهای نوار بالا و پایین را برطرف کنید تا هنگام تغییر محتوا در تمام راه ، با اطمینان تغییر رنگ شود. ( IDC4E8 ، B/293665988 )
توابع رفتار پیمایش برای میله های برنامه بالا و پایین اکنون یک رفتار به یادگار را برمی گرداند تا عملکرد بهتری را در مورد بازپرداخت ها انجام دهد. ( i0fdbe ، b/207957336 )
Pararemeter اصلاح کننده اکنون پس از اصلاح کننده های داخلی مانند کشیدن رفتار و معناشناسی ، به جای قبل اعمال می شود. این بر ترتیب اعمال اصلاح کننده ها تأثیر می گذارد. ( i8d83f )
ورق پایین گسترش یافته در تغییر اندازه گسترش یافته است. ( i2870b ، b/324934884 )
پرچم های نوار ناوبری را برای خصوصیات ویندوز به درستی مسیریابی کنید. ( IE674D ، B/362539765 )
همانطور که مستند شده است ، پارامتر اصلاح کننده را به ریشه داربست ها منتقل کنید. این اجرای با M2 را تراز می کند. ( I0235E ، B/372311595 )

سهم خارجی

عملکرد متداول DatePickerDialog . ( i7dced )

نسخه 1.4.0-alpha04

13 نوامبر 2024

androidx.compose.material3:material3-*:1.4.0-alpha04 منتشر شده است. نسخه 1.4.0-alpha04 شامل این تعهدات است.

تغییرات رفتار

تغییرات رنگی معرفی شده در 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 )

رفع اشکال

رنگ نماد تراشه فیلتر از هر مشخصات از ابتدایی تا OnSurfaceContainer به روز شده است. تمام رنگهای تراز تراشه از هر مشخصه از طرح کلی تا طرح کلی به روز شده اند. ( i68bd4 )

نسخه 1.4.0-alpha03

30 اکتبر 2024

androidx.compose.material3:material3-*:1.4.0-alpha03 منتشر می شود. نسخه 1.4.0-alpha03 شامل این تعهدات است.

تغییرات API

سازنده SheetState با چگالی به نفع آستانه موقعیت و سرعت کاهش یافته است. ( IFD16E )
به rememberTooltipPositionProvider که شامل یک منطق موقعیت یابی به روز شده است. به یاد داشته باشید rememberPlainTooltipPositionProvider و rememberRichTooltipPositionProvider . ( IE66E2 )
ModalBottomSheetProperties اضافی امکان سفارشی سازی وضعیت و نوار ناوبری را فراهم می کند. به طور پیش فرض ، این بروزرسانی ها بر اساس رنگ محتوا به جای وضعیت موضوع تاریک سیستم. ( IB874E ، B/362539765 )
تجربه ورودی را برای انتخاب کنندگان تاریخ بهبود بخشید: در حالت ورودی ، قسمت متن تاریخ برای ورود به متن فوری متمرکز خواهد شد. تغییر یک پارامتر requestFocus به DatePicker و DateRangePicker اضافه می کند. شما ممکن است با عبور false از تمرکز جلوگیری کنید. ( I12D09 ، B/286399710 ، B/340102743 )
ذخیره کردن شکل به صورت پیش فرض در شیء شکل. ساخت دکمه به صورت پیش فرض برای دکمه @Composable . فروپاشی اشکال به یک شکل به طور پیش فرض از آنجا که انواع مختلف به همان پرونده توکن اشاره می کنند. ( IAA014 )

رفع اشکال

برای جلوگیری از بازپرداخت محتوای بدن در هنگام تغییر contentPadding ، از رفتار contentPadding -Content استفاده کنید. ( i8c8e2 ، b/373904168 )
TextFieldLabelScope progress به labelMinimizedProgress تغییر نام داده است
TextFieldLabelPosition Default به 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

به روزرسانی های مربوط به انتخاب کنندگان تاریخ برای اطمینان از استفاده مداوم از محلی در طول DatePicker و DateRangePicker هنگام تنظیم مستقیم یک محل از طریق DatePickerState یا DateRangePickerState . توجه داشته باشید که هنگام تنظیم مستقیم محلی به دولت ، این وظیفه شماست که اطمینان حاصل کنید که عنوان و متون تیتر بر این اساس بومی سازی می شوند ، زیرا متن پیش فرض آنها همچنان مطابق با محلی پیش فرض پلت فرم اعمال می شود. ( 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 به استاندارد و بیانگر. هم اکنون هر دو کارکرد از طریق شیء Companion 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 به روز شده ، یک مسئله پیکر تاریخ را برطرف کنید تا UI را به روز کنید. ( IAD59A ، B/290135807 ، B/339898760 )

نسخه 1.4.0-alpha01

2 اکتبر 2024

androidx.compose.material3:material3-*:1.4.0-alpha01 منتشر شده است. نسخه 1.4.0-alpha01 شامل این تعهدات است.

تغییرات رفتار

کتابخانه دیگر وابستگی به material-icons-core اضافه نمی کند ، بنابراین اگر پروژه شما به آن اعتماد داشته باشد ، باید صریحاً آن وابستگی را در پرونده های build.gradle[.kts] . ( i735ff ، b/349894318 )
تغییر رنگ onSurface فعال NavigationBarItem و NavigationRailItem به منظور بهبود قابلیت استفاده ، کنتراست رنگ و بهبود انسجام در سیستم ( IBC297 ) ، برای بازگشت به رفتار قبلی ، کپی کردن رنگ secondary پیش فرض و تغییر رنگ selectedTextColor به MaterialTheme.colorScheme.onSurface .
اجزای ماده 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 ) ندارد
اضافه بار جدید از مواد TextField با مواد و OutlinedTextField که TextFieldState استفاده می کنند اضافه شده است. API های جعبه دکوراسیون اضافه شده که با TextFieldDecorator سازگار هستند. ( if13a1 )
پارامتر اضافه شده برای کنترل labelPosition زمینه متن. استفاده از alwaysMinimize اجازه می دهد تا الگوی UI نمایش یک برچسب و مکان نگهدارنده در یک قسمت متن در همان زمان حتی اگر این زمینه فوکوس نشده باشد. ( i1ef2c )
مواد اضافه شده SecureTextField و OutlinedSecureTextField برای زمینه های ورود به رمز عبور. ( i7e22d )
برای پرس و جو از پیشرفت انیمیشن ، دامنه ای را به برچسب های زمینه متن اضافه کرد. ( IF5EC8 )
پشتیبانی از MotionEvent.CLASSIFICATION_DEEP_PRESS را به نوک ابزار اضافه می کند. ( i62e6a )
isAfternoon TimePickerState اکنون به جای VAR در رابط ، به isPm تغییر نام داده است ( I89A97 )
به روزرسانی کلاس تایپوگرافی برای پشتیبانی از مقیاس های نوع تأکید شده. ( IFA13C )
اضافه شده API ModalWideNavigationRail و 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 شکل بر اساس حالت پیش فرض / فشرده شده. API AnimatedTrailingButton را حذف کرد زیرا API TrailingButton می تواند همان سفارشی سازی ها را ارائه دهد ( I95066 )
به عنوان مثال هنگام پیمایش محتوا ، اصلاح کننده را به نمایش و مخفی کردن FAB اضافه کنید. ( i8338d )
اضافه کردن شکل های گروه دکمه اتصال و فاصله به ButtonGroupDefaults که در یک نمونه استفاده می شود. ( i68e30 )
دکمه اسپلیت اضافه کردن بالشتک افقی برای دکمه دنباله دار و فعال کردن محور نوری محاسبه شده از اختلاف گوشه شروع و پایان ( I122E2 )
معرفی یک Material MotionScheme برای ایجاد یک طرح برای حرکت مؤلفه. این طرح از طریق MaterialTheme تنظیم شده است. ( id50c2 )

رفع اشکال

شاخص صحیح تمرکز را در ترکیبات کودک Scaffold استفاده کنید. سفارش topBar ، bottomBar ، Fab ، محتوا ، Snackbar است. ( i5936b )
مسئله ای را در DatePicker و DateRangePicker رفع کرد که در برخی از مناطق و اسکلت های فرمت برخی از عناصر تاریخ (به عنوان مثال نام ماه) با نامه بزرگ شروع نکردند. ( i1430f )
ادغام توکن های جزء منوی Fab و Fab (به روزرسانی های جزئی بصری به بالشتک ها و متن) ( IB57F3 )
ModalBottomSheet اکنون برای اولین بار به ترتیب معنایی معنایی است و پس از آن Scrim. ( i436f9 ، b/358594665 )
رفع نوار برنامه پایین هنگام پیمایش زیر قرص ناوبری در حالت لبه به لبه (I3EE21) کاملاً ناپدید نمی شود ( I3EE21 )

Matere Material3 نسخه 1.3

نسخه 1.3.2

9 آوریل 2025

androidx.compose.material3:material3-*:1.3.2 منتشر می شود. نسخه 1.3.2 شامل این تعهدات است.

رفع اشکال

ListItem محاسبه ارتفاع ذاتی خود را اصلاح می کند ، اکنون مقدار مناسب فضای را در چیدمان رزرو می کند.
بالشتک برچسب NavigationBarItem اضافی را حذف کرده و به درستی با مشخصات تراز کنید.
TabRow بندی را در حالت RTL اصلاح می کند.

نسخه 1.3.1

30 اکتبر 2024

androidx.compose.material3:material3-*:1.3.1 منتشر می شود. نسخه 1.3.1 شامل این تعهدات است.

رفع اشکال

DatePicker و DateRangePicker اکنون ماه نمایش داده شده را هنگام تنظیم از طریق displayedMonthMillis حالت خود به درستی به روز می کنند. ( IF9E47 ، B/333414302 )
هنگامی که حداقل سال قابل انتخاب در یک سال آینده تعیین شده است ، تصادفات را در DatePicker و DateRangePicker رفع کنید. ( i78656 ، b/319395747 )
هنگام استفاده از نمونه SelectableDates به روز شده ، یک مسئله پیکر تاریخ را برطرف کنید تا UI را به روز کنید. ( IAD59A ، B/290135807 ، B/339898760 )
تغییر اولویت پاسخ به برگشتی که توسط برگه های پایین به PRIORITY_DEFAULT استفاده می شود تا صفحه کلید IME را ابتدا رد کند. ( i447fb )

نسخه 1.3.0

4 سپتامبر 2024

androidx.compose.material3:material3-*:1.3.0 منتشر می شود. نسخه 1.3.0 شامل این تعهدات است.

تغییرات مهم از 1.2.0

ویژگی های اصلی 1.3.0

طراحی مواد جدید 3 مؤلفه

چرخ فلک
- پیشرفتهای HorizontalMultiBrowseCarousel HorizontalUncontainedCarousel به طراحی مواد موجود 3 مؤلفه.
[ ModalBottomSheet ] اکنون از پیش بینی پیش بینی در U+ ( ICCF32 ، B/281967264 ، B/304850357 ) پشتیبانی می کند
[ SearchBar ] اکنون از پیش بینی U+ ( I657F8 ) پشتیبانی می کند
کشو NAV ( ModalDrawerSheet و DismissibleDrawerSheet ) اکنون از پیش بینی U+ به عنوان Opt-in پشتیبانی می کند ( IE5B0B )
DropdownMenu اکنون از رنگ ، شکل ، ارتفاع و مرز سفارشی پشتیبانی می کند. ( i8e981 ، b/289554448 ، b/301887035 ، b/283654243 )
کشویی به روز شده برای بهبود دسترسی با اضافه کردن یک شکاف و نشانگر توقف. ( i3058e )
با افزودن شکاف و توقف نشانگر ، ProgressIndicator برای بهبود دسترسی به روز کرد. ( I21451 )
یک CARET پیش فرض برای Tooltip Rich اضافه شده ، از CARET سفارشی پشتیبانی می شود تا با توجه به LayoutCoordinates لنگرگاه ترسیم شود. ( IFD42C ) شکستن تغییرات
API های جدید Pull-to-Refresh:
- PullToRefreshState ساده شده برای استفاده از مقادیر کسری به جای واحدهای DP.
- isRefreshing حالت به جای PullToRefreshState توسط کاربر کنترل می شود.
- اتصال پیمایش تو در تو را از PullToRefreshState جدا کرد. این کار توسط PullToRefreshBox جدید یا Modifier.pullToRefresh انجام می شود.
- این بروزرسانی یک تغییر در API های آزمایشی قبلی است. ( i0adeb ، b/314496282 ، b/317177684 ، b/323787138 ، b/324573502 ، b/317177683 )
برای اطمینان از کنتراست رنگ کافی ، روکش حالت تمرکز را به روز کنید. ( i7ea77 )
تنظیمات کوچک به پیش فرض های رنگ سطح و پس زمینه در lightColorScheme و darkColorScheme . ( i9db52 )
رنگهای کشویی و ProgressIndicator به روز شده برای دنبال کردن مشخصات جدید کنتراست غیر متن. ( 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 شامل این تعهدات است.

رفع اشکال

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 از ارتفاع پشتیبانی می کند ، به روزرسانی را برای تازه کردن API ها به روز کنید تا به جای یک لامبدا یک بولی باشد. پشتیبانی از تراز محتوا در PullToRefreshBox ( I75679 )
ساخت TooltipScope یک رابط مهر و موم شده و ایجاد یک اجرای داخلی برای استفاده در TooltipBox و Label. ( i3833e )
دو اصلاح کننده جدید به CarouselItemScope - maskClip و maskBorder - اضافه شده است تا به راحتی یک شکل و مرز را به هر مورد چرخ فلک اضافه کنید ( ID67A1 )
TimePickerState اکنون یک رابط است و امکان تنظیم زمان را فراهم می کند ( I88546 )
API به روز شده برای یک ظاهر طراحی پیوندها: TextLinkStyles را به TextStyle منتقل کرده و TextDefaults از مواد حذف کرد. ( i5477b )

رفع اشکال

وضعیت ModalBottomSheet و نمادهای NAV BAR اکنون به وضعیت موضوع تاریک پاسخ می دهند. ( IE1FE7 ، B/338342149 )
معانی ورق نزدیک به scrim 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 اضافه شده است که به شما امکان می دهد پیوندها را به عنوان یک پارامتر برای ترکیب متن سبک کنید. ( i31b93 )

نسخه 1.3.0-alpha06

1 مه 2024

androidx.compose.material3:material3-*:1.3.0-alpha06 منتشر می شود. نسخه 1.3.0-alpha06 شامل این تعهدات است.

شکستن تغییرات

API های جدید Pull-to-Refresh:
- 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 با دقت بیشتری هنگام فعال کردن لبه به لبه ، Scrim را از نوار وضعیت ترسیم می کند. محتوای ورق پایین معین هم اکنون می تواند از پنجره های پنجره استفاده کند و محتوای قابل مشاهده در بالای نوار ناوبری را فراهم می کند. windowInsets پارامتر ModalBottomSheet به contentWindowInsets تغییر نام داده اند تا مشخص کنند که در آن موارد استفاده می شود ، اینها دیگر به منطق پنجره گره خورده اند. نوع contentWindowInsets به تابعی تغییر یافته است که WindowInsets برمی گرداند ، تا اجازه دهد در پنجره جدید خود حل شود. ( i39630 ، b/274872542 ، b/300280229 ، b/290893168 )
PrimaryScrollableTabRow و SecondaryScrollableTabRow اکنون به جای زیرمجموعه از طرح بندی سفارشی استفاده می کنند که باید عملکرد را بهبود بخشد. ( i991e0 )
لینک های متنی علاوه بر یک ظاهر طراحی شده معمولی ، گزینه یک ظاهر طراحی شده حالت را تحت فشار قرار داده اند. روشهای TextDefaults هر یک از آنها یک استدلال pressedStyle برای پشتیبانی از آن دریافت کردند. ( IC473F ، B/139312671 )

رفع اشکال

لنگرگاه های کشو ناوبری اکنون با عرض drawerContent مطابقت دارد. ( IBC72F ، B/245355396 )
OutlinedTextField Top Padding برای برچسب اکنون اندازه فونت سیستم را تشکیل می دهد. ( IDC781 )
محل بسته ثابت CalendarLocale . ( IFA235 )
[پیش بینی پشت] به روزرسانی انیمیشن های پیش بینی کننده پشت برای استفاده از منحنی درون یابی (0.1 ، 0.1 ، 0 ، 1) ( I2591A )

نسخه 1.3.0-alpha05

17 آوریل 2024

androidx.compose.material3:material3-*:1.3.0-alpha05 منتشر می شود. نسخه 1.3.0-alpha05 شامل این تعهدات است.

ویژگی های جدید

SearchBar و DockedSearchBar دارای اضافه بار جدیدی هستند که یک پارامتر فیلد متن را می گیرند. این امر به یک ظاهر طراحی شده در قسمت متن به طور جداگانه از بقیه نوار جستجو و همچنین عبور در زمینه های متن سفارشی امکان می دهد. زمینه متن اجرای فعلی به عنوان SearchBarDefaults.InputField در دسترس است. ( I50C73 ، B/275074248 ، B/278773336 ، B/326627700 )
Lambda drawTick برای سفارشی کردن کنه ها در صورت لزوم به API عمومی اضافه شده است ( I0C048 )

تغییرات API

پیوندهای متنی علاوه بر یک ظاهر طراحی شده معمولی ، گزینه یک ظاهر طراحی شده حالت فشرده شده ، معلق و متمرکز شده است ( I5F864 ، B/139312671 )
به روز شده CarouselItemInfo برای افشای یک ماسک راست که این کالا توسط ( I785D8 ) قطع شده است
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 شامل این تعهدات است.

ویژگی های جدید

دو نسخه آزمایشی از Carousel Material3 اضافه شده است - HorizontalMultiBrowseCarousel و HorizontalUncontainedCarousel ( I88D64 )
به روز شده Compose M3 NAV کشو ( ModalDrawerSheet و DismissibleDrawerSheet ) برای پشتیبانی از پیش بینی برگشت در U+ به عنوان OPT-IN ( 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 )
جدا شده از DismissDirection و حذف و تخلیه و API های DismissValue . ( i89ccd )
یک برچسب آزمایشی به شیء همراه CarouselState Carousel اضافه کرد. ( I94154 )
deprecate 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 شامل این تعهدات است.

تغییرات شکستن بصری

برای اطمینان از کنتراست رنگ کافی ، روکش حالت تمرکز را به روز کنید. ( 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 )
پارامترهای تنظیم مجدد در آهنگ کشویی قابل تنظیم. ( i9f315 )
اکنون ExposedDropdownMenu با استفاده از Popup اجرا شده است. این رفتار باید یکسان باشد به جز منوهای قابل توجه با زمینه های متن قابل ویرایش ممکن است هنگام تایپ روی صفحه کلید رد شود.

رفع اشکال

نقش های پایه سطحی و سطحی کمی تنظیم شده است و رنگ بیشتری را در مضامین سبک و تیره فراهم می کند. ( i677a5 )
رنگهای کشویی و ProgressIndicator به روز شده برای دنبال کردن مشخصات جدید کنتراست غیر متن. ( I26807 )
برای اطمینان از کنتراست رنگ کافی ، روکش حالت تمرکز را به روز کنید. ( i7ea77 )
تنظیمات کوچک به پیش فرض های رنگ سطح و پس زمینه در lightColorScheme و darkColorScheme . ( i9db52 )

نسخه 1.3.0-alpha02

6 مارس 2024

androidx.compose.material3:material3-*:1.3.0-alpha02 منتشر می شود. نسخه 1.3.0-alpha02 شامل این تعهدات است.

تغییرات API

دوباره حالت کشویی را پایدار می کند. ساخت State.onValueChangeFinished . بسته بندی onValueChangeFinished در یک rememberUpdatedState . ( I82AB2 ، B/322269951 )
اجزای ناوبری اکنون از نقش های جدید SurfaceContainer استفاده می کنند. DrawerDefaults اکنون ویژگی های standardContainerColor متمایز و modalContainerColor را ارائه می دهد. DrawerDefaults.ModalDrawerElevation اکنون 0.dp است. ( i7fbac )
از زمان تغییر state.onValueChangeFinished از var Slider @Stable می شود. ( IED34A ، B/322269951 )
مشخصات انیمیشن ModalBottomSheet و StandardBottomSheet اکنون یک TweenSpec است که از یک انیمیشن بهاری به روز شده است. این مسئله مسئله ای را با استفاده از بیش از حد قابل مشاهده برطرف می کند. سازندگان SheetState مستهلک شده بدون چگالی اکنون برداشته شده اند. ( i7babc ، b/285847707 )

رفع اشکال

انواع SurfaceContainer اکنون توسط قطعات استفاده می شود. مؤلفه هایی که به طور رسمی رنگ را با سطح و 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 است. رنگ onScroll TopAppBar اکنون 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 شامل این تعهدات است.

ویژگی های جدید

به روزرسانی آهنگ 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 است ، در معرض دید قرار دهند. در اینجا هیچ تغییر معنایی وجود ندارد: عبور از تهی به این معنی است که شما مایل به بلند کردن MutableInteractionSource نیستید و در صورت لزوم در داخل مؤلفه ایجاد می شود. Changing to null allows for some components to never allocate a MutableInteractionSource , and allows for other components to only lazily create an instance when they need to, which improves performance across these components. If you are not using the MutableInteractionSource you pass to these components, it is recommended that you pass null instead. It is also recommended that you make similar changes in your own components. ( I41abb , b/298048146 )
Adds RippleConfiguration and LocalRippleConfiguration to allow for per-component / sub-tree customization of ripples using fixed values. For example, to change the color of a component you don't control, or to disable a ripple for a component. In most cases the default values should be used: these APIs are an escape hatch for customization of individual components / limited sub-trees. For wider changes and custom design systems, you should instead build your own ripple using createRippleModifierNode . ( I7b5d6 , b/298048146 )
Adds new ripple API in material3 which replaces the deprecated rememberRipple . Also adds a temporary CompositionLocal , LocalUseFallbackRippleImplementation , to revert material3 components to using the deprecated rememberRipple / RippleTheme APIs. This will be removed in the next stable release, and is only intended to be a temporary migration aid for cases where you are providing a custom RippleTheme . ( I34cbc , b/298048146 )

رفع اشکال

Removed subcomposition inside ModalBottomSheet to improve performance. Fixed an issue where ModalBottomSheet could crash in specific scenarios in combination with LookaheadScope . ( I2a198 )
Removed subcomposition inside BottomSheetScaffold to improve performance. Fixed an issue where BottomSheetScaffold would crash in specific scenarios in combination with LookaheadScope . ( Ie6401 )
The badge alignment is adjusted to be closer to the center of the anchor content in respect to the top-right corner. ( I18a28 )
Fix an a11y issue with the DateRangePicker where the Month-Year text title was conveyed as actionable to the screen reader, Switch access, and Voice access users. ( I2ac55 )
Fixed mediumTopAppBarColors param order bug. ( Ibe64a )

نسخه 1.2

نسخه 1.2.1

6 مارس 2024

androidx.compose.material3:material3-*:1.2.1 is released. Version 1.2.1 contains these commits .

رفع اشکال

Make the Slider states stable again. Making State.onValueChangeFinished a val again. Wrapping onValueChangeFinished in a rememberUpdatedState . ( Ie8fd0 , b/322269951 )
Removing @Stable from the states of Slider since we're changing state.onValueChangeFinished to a var . ( I82ba1 , b/322269951 )
Fix NavigationBar custom colors to copy from defaults. ( 80a779 , b/326894020 )
Fix regression in ExposedDropdownMenu to make it focusable again ( 3fcec1 , b/323694447 )
Fix button color caching issue ( 3e5bbc b/327371655 )

نسخه 1.2.0

7 فوریه 2024

androidx.compose.material3:material3-*:1.2.0 is released. Version 1.2.0 contains these commits.

موضوع شناخته شده

A View-Compose interop rendering bug was introduced in PrimaryTabRow as part of a performance improvement change. The workaround is to use TabRow with TabRowDefaults.PrimaryIndicator

Important changes since 1.1.0

New Material Design 3 Components

بکشید تا تازه شود
- PullToRefreshContainer
- PullToRefreshState
Segmented Button

Enhancements to existing Material Design 3 components.

Bottom app bar (RTL alignment, auto-hide on scroll)
- BottomAppBarScrollBehavior
Tabs visual update
- PrimaryIndicator
- SecondaryIndicator
Badge (alignment update)

Promoted experimental APIs to stable!

بهبود عملکرد

Please see this blog post for more details!

Version 1.2.0-rc01

24 ژانویه 2024

androidx.compose.material3:material3-*:1.2.0-rc01 is released. Version 1.2.0-rc01 contains these commits.

رفع اشکال

Fixed mediumTopAppBarColors param order bug. ( Ibe64a )
Fixed a bug introduced in 1.2.0-beta02 in CardDefaults.cardColors that did not update contentColor based on the containerColor param value. ( Iee041 , b/319671246 )
Fixed a bug in disabledContentColor introduced in 1.2.0-beta02 and added small optimization. ( I6dda1 , b/318428829 )

Version 1.2.0-beta02

10 ژانویه 2024

androidx.compose.material3:material3-*:1.2.0-beta02 is released. Version 1.2.0-beta02 contains these commits.

Known Bug

A bug in IconButtonColors will by default assign disabledContentColor to an alpha (0.38f) of LocalContentColor instead of the user specified contentColor . The workaround is to explicitly set the disabledContentColor . This will be fixed in the next release.

تغییرات API

Adding the capability to enable tooltip carets for Plain Tooltip APIs. ( Ibf767 )
SwipeToDismissState , rememberSwipeToDismiss and SwipeToDismissValue are all renamed to have _SwipeToDismissBox_ . ( I68d6d )

رفع اشکال

Fixed ListItem end padding value to align with spec. ( Ibd68b , b/305342674 )
Outline color for outlined card is now correctly mapped to OutlineVariant . ( I75480 , b/310979715 )
Dynamic color now pulls from system defined color roles. This improves contrast for accessible content, and more closely aligns dynamic color to the Material spec. ( I1de96 )
Fixed ModalBottomSheet back handling on Android T/13+ when android:enableOnBackInvokedCallback="true" . ( I728dc , b/306196110 )

Version 1.2.0-beta01

13 دسامبر 2023

androidx.compose.material3:material3-*:1.2.0-beta01 is released. Version 1.2.0-beta01 contains these commits.

تغییرات API

Mark TabIndicatorScope as experimental. ( I45c88 )
Removing deprecated experimental APIs for tooltip. ( I438cb )
Change new TabRow overloads to not use subcompositions. This results in a different way to build the TabRow indicators with custom modifiers provided. ( Ife741 )
Deprecate DismissDirection and DismissValue API's. These have been merged to SwipeToDismissValue , whose values indicate both position and direction of SwipeToDismissBox . DismissState.progress is now marked as a FloatRange between 0.0 and 1.0 . DismissState deprecated Saver and Constructor have now been removed. SwipeToDismiss component, state and defaults object have been remarked as experimental. ( Ib54f2 )

رفع اشکال

The default indicator for PullToRefresh is now an open arrowhead instead of a solid triangle. ( I67be3 )

Version 1.2.0-alpha12

29 نوامبر 2023

androidx.compose.material3:material3-*:1.2.0-alpha12 is released. Version 1.2.0-alpha12 contains these commits.

تغییرات API

RangeSlider now takes a Kotlin range (eg, 0f..1f ) instead of a custom FloatRange value class. SnapFlingBehavior.kt now also uses a Kotlin range. ( I025cb )
Mark Modifier factory functions as @Stable . ( Ib109f )

Version 1.2.0-alpha11

15 نوامبر 2023

androidx.compose.material3:material3-*:1.2.0-alpha11 is released. Version 1.2.0-alpha11 contains these commits.

ویژگی های جدید

Implements PullToRefreshContainer and PullToRefreshState , which together provide a pull to refresh implementation in Material3. ( I16456 , b/261760718 )

تغییرات API

Mark the SwipeToDismissBox DismissDirection and DismissValue as experimental. ( I517b0 )
Rename SwipeToDismiss to SwipeToDismissBox . Rename background to backgroundContent and dismissContent to trailing content lambda. ( I7f4d3 )
Make the constructor for ChipElevation and SelectableChipElevation public. ( Ie0c48 , b/308432421 )
Adding ModalBottomSheetProperties . Moving securePolicy into ModalBottomSheetProperties . Adding isFocusable and shouldDismissOnBackPress to ModalBottomSheetProperties . These new booleans help determine how modal bottom sheet should handle IME events. ( Iea56f , b/278216859 )
Updated RangeSlider and Slider states to remove initialOnValueChange , the initial prefixes, and appropriate kdocs. ( I57d30 )
Deprecate ChipBorder class and its associated function calls, recommend using BorderStroke directly instead. ( I89cc2 )
Foundation Tooltip APIs are now @ExperimentalFoundationApi . ( I30b0b )
TabRow and ScrollableTabRow are no longer deprecated. The new Primary and Secondary variants are marked as experimental. ( I0def6 )
Filter and input chips now use BorderStroke directly. ( I07a8d )
SegmentedButton now uses BorderStroke directly. ( I89b9b )
Renamed the generic AlertDialog function to BasicAlertDialog , and deprecate the previous function. ( Idbe52 )
Rename SwipeToDismiss APIs to SwipeDismiss , and promote the new SwipeDismiss APIs to stable. ( I14cbe )
Adding tonalElevation and shadowElevation to tooltip APIs. Additionally, moving TooltipBox , PlainTooltip , and RichTooltip APIs back to experimental since they were accidentally released as stable. ( If0f66 , b/293939035 )
Promote experimental chip APIs to stable. ( Iea2c3 )
Removed the @ExperimentalMaterial3Api annotation from the Material3 clickable Cards. ( I88dbf )

رفع اشکال

Fixed an issue where SwipeToDismiss would crash in certain scenarios with nested Lookahead and Lazy layouts. ( Ica8d1 , b/297226562 )

Version 1.2.0-alpha10

18 اکتبر 2023

androidx.compose.material3:material3-*:1.2.0-alpha10 is released. Version 1.2.0-alpha10 contains these commits.

تغییرات API

Promoting Badge and BadgedBox to stable. ( I67f16 , b/261565132 )
Adding securePolicy as a parameter to ModalBottomSheet , so users can define the behavior for WindowManager.LayoutParams.FLAG_SECURE . ( Icdac8 , b/296250262 )
Added new overloads of LinearProgressIndicator and CircularProgressIndicator that take progress as a lambda. These should be more performant than the previous versions. ( I824e6 , b/295616656 )
Renames StandardSizeClasses to AllSizeClasses . ( I8cb07 )
Combine calculation functions of window size classes. ( Iad935 )

رفع اشکال

Fix a DatePicker crash when quickly clicking the navigation arrow buttons when the displayed month is at the edge of the allowed range of years. ( I46f36 , b/290954897 , b/297002119 )
[Nav rail/bar] Support transparent color for indicator. ( Ie0a9b , b/267289987 )

Version 1.2.0-alpha09

4 اکتبر 2023

androidx.compose.material3:material3-*:1.2.0-alpha09 is released. Version 1.2.0-alpha09 contains these commits.

تغییرات API

Migrated ModalNavigationDrawer and DismissibleNavigationDrawer to use new AnchoredDraggable APIs. DrawerState 's animateTo has been replaced by the open and close methods, and the offset is now exposed as a float instead of a state object. You can access the offset directly through currentOffset . ( I0a72c )
Non-Composable functions have been added for creating a DatePickerState and DateRangePickerState directly. These functions can be used as an alternative to the Composable rememberDatePickerState and rememberDateRangePickerState functions when needed. ( I70326 , b/291524052 )
Fixed and Scrollable TabRows now have Primary and Secondary variants. These correctly map to the color and indicator behavior as defined in Material3.
PrimaryScrollableTabRow and SecondaryScrollableTabRow now expose scroll state. ( Iec8f5 , b/260572337 )
Adding a new sheetMaxWidth parameter that developers can set to specify a maximum width that the sheet will span. Dp.Unspecified can be passed in for the parameter if a sheet that spans the entire screen width is desired. ( Ifb7c9 , b/266697696 )
Adding back PlainTooltipBox and RichTooltipBox APIs as deprecated methods. ( I246fa )

رفع اشکال

Fix a crash when the DatePicker is initialized with a DatePickerFormatter that has certain date skeletons that stay the same when converted to date patterns (such as YY). ( I01f29 )

Version 1.2.0-alpha08

20 سپتامبر 2023

androidx.compose.material3:material3-*:1.2.0-alpha08 is released. Version 1.2.0-alpha08 contains these commits.

Behavior Breaking Change

ColorScheme is now Immutable, making individual color updates less efficient, but making more common usage of colors more efficient. The reasoning behind this change is that the majority of apps wouldn't have updating individual colors as a main use case. This is still possible but it will recompose more than before, in turn we significantly decrease the amount of state subscriptions through all of Material code and will impact initialization and runtime cost of more standard use cases. ( Ic447d , b/297212873 )
Tonal Elevation no longer animates in different interaction states to match spec. ( Icdd12 )

تغییرات API

Added a new BottomAppBar that takes as parameter a BottomAppBarScrollBehavior in order to auto-hide it when content is scrolled. Also added FabPosition.EndOverlay allowing the FAB to overlay the bottom app bar in the scaffold instead of being anchored above it. ( Iecb47 )
Added a simple Label component that builds on top of BasicTooltipBox that won't dismiss when tapping outside of the bounds of the label. ( I821f9 )

رفع اشکال

Removed the use of rememberSaveable for tooltips. ( Icc131 , b/299500338 )
Introduced a temporary flag to control whether Scaffold should measure its children during measurement or during placement. By default, this will measure in measurement. If you are facing issues with the new behavior, please file an issue. ( I0b354 )
Fixed horizontal Edge to Edge in BottomSheet by using the correct measurement for device screen width. ( I1df0c , b/299058752 )
Fixed a bug where ModalBottomSheet was not calling onDismissedRequest when dismissing it by swiping down on the sheet. ( Idfdd8 )

Version 1.2.0-alpha07

6 سپتامبر 2023

androidx.compose.material3:material3-*:1.2.0-alpha07 is released. Version 1.2.0-alpha07 contains these commits.

ویژگی های جدید

Auto-mirror icons support has been added in compose material 1.6.0-alpha05 , please see the release notes for details on auto-mirror icons.

تغییرات API

SliderState implements DraggableState ( I9b116 )
Change shape to be a required param. Rename position to index in shape helper function. ( I34941 )
Updates the DatePicker formatWithSkeleton to include a map that is used as a cache for performance improvements. ( I3195f )
Added BasicTooltipBox to compose.foundation and updated PlainTooltipBox and RichTooltipBox to use TooltipBox with new PlainTooltip and RichTooltip composables. ( I79e1d )

رفع اشکال

dynamicLightColorScheme and dynamicDarkColorScheme now return higher chroma colors for surface and surfaceContainer roles. ( I5e901 )
Fixed an issue where some components using Subcomposition (eg BottomSheetScaffold ) inside a Scaffold inside a LookaheadScope were attempting to read their size too early. ( I297b4 , I871f1 , b/295536718 )

Version 1.2.0-alpha06

23 آگوست 2023

androidx.compose.material3:material3-*:1.2.0-alpha06 is released. Version 1.2.0-alpha06 contains these commits.

رفع اشکال

Fixed DropdownMenu 's offset calculation so x offsets depend solely on the local layout direction, and y offsets will no longer be reversed when the menu is near the bottom of the screen. ( Iccc74 , b/294103942 )
Fixed DropdownMenu 's offset calculation so x offsets depend solely on the local layout direction, and y offsets will no longer be reversed when the menu is near the bottom of the screen. ( Ib87a2 , b/294103942 )

Version 1.2.0-alpha05

9 آگوست 2023

androidx.compose.material3:material3-*:1.2.0-alpha05 is released. Version 1.2.0-alpha05 contains these commits.

تغییرات API

Updates to the Checkbox and TriStateCheckbox colors. The CheckboxDefaults.colors() disabledUncheckedColor now only affects the border of the checkbox. Special cases that require you to set the internal box color when disabled and unchecked requires a custom constructed instance of a CheckboxColors with the desired color values. ( I77d17 , b/291943198 )

Version 1.2.0-alpha04

26 جولای 2023

androidx.compose.material3:material3-*:1.2.0-alpha04 is released. Version 1.2.0-alpha04 contains these commits.

ویژگی های جدید

Experimental Segmented Button API ( Ifc8fb )
Dividers now have a parameter to control orientation to support vertical dividers. ( I4c899 , b/288438593 )

تغییرات API

We are moving the density dependency to the component level. This applies to the following components: SwipeToDismiss and Sheet based components. Please use the new overload provided where density is a parameter. ( I1846e )
Additional annotations to specify allowed inputs to composables ( Ief234 )
Add an icon parameter to segmented button, split semantics so that segmented buttons can be selectable to implement single-select, and toggleable to implement multi-select, with SelectableSegmentedButtonRow and ToggelableSegmentedButtonRow respectively. ( I38740 )
Divider has been renamed to HorizontalDivider . Added VerticalDivider functionality. ( I5975c )
Change the use of ClosedFloatingPointRange for the lighter weight FloatRange in experimental Material3 APIs to minimize autoboxing. ( I4aab5 )
Added new Start alignment for FabPosition ( Ib7aea , b/170592777 )

رفع اشکال

ModalBottomSheet respects local layout direction. ( Ib4f44 , b/285628622 )

Version 1.2.0-alpha03

21 ژوئن 2023

androidx.compose.material3:material3-*:1.2.0-alpha03 is released. Version 1.2.0-alpha03 contains these commits.

تغییرات رفتار

includeFontPadding is now false by default in Material 3 typography. The default line height style has also been changed to Trim.None and Alignment.Center , and explicit lineHeight (in sp) have been added to the TextStyle s of Typography . Consult the API docs if you want to customize these values, and see the blog post for an in-depth explainer of these changes. ( I6266f , Icabc3 )

ویژگی های جدید

Added an overload for RangeSlider that is a stateful version of the component. Created RangeSliderState that holds all of the information for the current active track, the measurements of the components of the RangeSlider , and the drag and gesture logic. ( I8c270 )
Search bar now supports shadows via the newly added shadowElevation parameter. ( Ia5369 , b/271040353 )
ColorScheme now supports new SurfaceContainer roles .
Surface tonal elevation overlay can now be disabled with the LocalTonalElevationEnabled composition local. ( Ic203c , b/277774590 )

تغییرات API

Open the component colors constructors. ( I8c4a6 )
Adding focusable parameter to both tooltip APIs, so that developers can have the tooltip consume touch events or not. Be cautious that this might break accessibility focus automatic traversal. ( Ie32d8 )
Optimized accessibility for performance and memory allocations. ( Iede48 )
Expose DefaultSizeClasses and create StandardSizeClasses for WindowSizeClasses ( I91838 )
change WindowWidth/HeightSizeClass to float value classes ( Ie686e )

رفع اشکال

Scaffold's contentWindowInsets parameter now respects consumed window insets. Note that the behavior of content padding based on topBar and bottomBar remains unchanged when these parameters are provided. ( I08b73 , b/264601542 )
Fix the alignment of the center top app bar to ensure that a long title doesn't render over the action icons or the navigation icon. ( I4369f , b/236994621 )
Tab positions now enforce a minimum content width of 24.dp. This provides an accessible touch target for tab indicators. ( Id8861 )
Dynamic color palettes from dynamicLightColorScheme and dynamicDarkColorScheme now support new surface roles. ( I1252e )
Updating the badge notification alignment to not clip when colliding with great grandparent. ( Idf75a )

Version 1.2.0-alpha02

24 مه 2023

androidx.compose.material3:material3-*:1.2.0-alpha02 is released. Version 1.2.0-alpha02 contains these commits.

تغییرات API

Add window insets parameter to ModalBottomSheet .
- Scrim for ModalBottomSheet may now be drawn behind status bar with windowInsets set to zero
- Updated default ModalBottomSheet functionality to stay outside of system bars including navigation
- Status bar inset handling is provided by drag handle in edge-to-edge mode.
- BottomSheetDefaults includes window insets for BottomSheetWindow . ( I31200 , b/274872542 , b/272973615 , b/272334475 , b/268432129 , b/275849044 , b/275486106 , b/268433162 )
Deprecate Indicator and add Primary / SecondaryIndicator to match the M3 specs. PrimaryIndicator matches the width of the tab's content whereas SecondaryIndicator spans the full available width. SecondaryIndicator is equivalent to the now deprecated Indicator and can be a direct replacement. ( I27604 )
Added an option to pass in a ScrollState when constructing a DropdownMenu or an ExposedDropdownMenu for controlling the vertical scroll state of the displayed menu items. ( Ia0734 , b/185304441 )
Added an overload for Slider that is a stateful version of the component. Created SliderState that holds all of the information for the current active track, the measurements of the components of the Slider , and the drag and gesture logic. ( I124a5 )
Renaming the Semantics property isContainer to isTraversalGroup ( I121f6 )
Added optimized TextStyle.merge(...) with full parameter list. ( Iad234 , b/246961787 )
Made TooltipState , RichTooltipState , and PlainTooltipState public interfaces. Added RichTooltipStateImpl and PlainTooltipStateImpl for default states. Added remember*State functions to obtain these implemented states. Removed TooltipSync in favor of an TooltipDefault.GlobalMutatorMutex . ( I7813d )
Updated the DatePickerColors to include additional customization options for the date picker divider, navigation, and text input fields colors. ( I1a685 , b/274626815 )
DatePickerState and the DateRangePickerState are now public interfaces with default implementations that can be retrieved by the rememberDatePickerState and rememberDateRangePickerState . ( I71c52 )
Removed the dateValidator from DatePicker and DateRangePicker and introduced a SelectableDates interface that can be set on the state to control which dates or years are selectable in the UI. ( Ic2fc6 )
TimePicker removed from stable API, further changes are expected in the state API ( I3f39a )
ModalBottomSheet moved to android only. ModalBottomSheet is not recommended for desktop use, and the functionality is not actively maintained. ( Ib3778 )

رفع اشکال

Fixed the AlertDialog dismiss action to appear below the confirm action when the actions stacked over each other to fit into the dialog's width. This fix aligns the implementation with the Material Design spec. ( I029de , b/235454277 )
Fixed bug in ListItem using incorrect padding for three-line items. ( I6e235 )
ModalBottomSheet now can display IME keyboard ( Idc508 , b/262140644 , b/268380384 , b/272483584 )

Version 1.2.0-alpha01

10 مه 2023

androidx.compose.material3:material3:1.2.0-alpha01 and androidx.compose.material3:material3-window-size-class:1.2.0-alpha01 are released. Version 1.2.0-alpha01 contains these commits.

نسخه 1.1

نسخه 1.1.2

20 سپتامبر 2023

androidx.compose.material3:material3:1.1.2 and androidx.compose.material3:material3-window-size-class:1.1.2 are released. Version 1.1.2 contains these commits.

رفع اشکال

Fixed modifier incorrectly being passed to two composables. ( b/282761472 )
Fixed TimePickerState returns incorrect hours when initialized with 23 hours. ( b/278242122 )
Fixed initial toggle state for noon and minute validation. ( b/269768197 , b/282790635 )
Fixed state.hour returning incorrect value for 11pm. ( b/282761472 , b/278242122 )

نسخه 1.1.1

21 ژوئن 2023

androidx.compose.material3:material3:1.1.1 and androidx.compose.material3:material3-window-size-class:1.1.1 are released. Version 1.1.1 contains these commits.

رفع اشکال

Adds call for ModalBottomSheet without windowInset param for binary compatibility. ( Ib7959 )
Add window insets parameter to ModalBottomSheet .
- Scrim for ModalBottomSheet may now be drawn behind status bar with windowInsets set to zero
- Updated default ModalBottomSheet functionality to stay outside of system bars including navigation
- Status bar inset handling is provided by drag handle in edge-to-edge mode.
- BottomSheetDefaults includes window insets for BottomSheetWindow . ( I31200 , b/274872542 , b/272973615 , b/272334475 , b/268432129 , b/275849044 , b/275486106 , b/268433162 )

نسخه 1.1.0

10 مه 2023

androidx.compose.material3:material3:1.1.0 and androidx.compose.material3:material3-window-size-class:1.1.0 are released. Version 1.1.0 contains these commits.

Major features of 1.1.0

New Material Design 3 components

Enhancements to existing Material Design 3 components.

Promoted experimental APIs to stable!

Please see this blog post for more details!

Version 1.1.0-rc01

19 آوریل 2023

androidx.compose.material3:material3:1.1.0-rc01 and androidx.compose.material3:material3-window-size-class:1.1.0-rc01 are released. Version 1.1.0-rc01 contains these commits.

تغییرات API

TimePicker removed from stable API, further changes are expected in the state API ( I3f39a )
ModalBottomSheet moved to android only. ModalBottomSheet is not recommended for desktop use, and the functionality is not actively maintained. ( Ib3778 )

Version 1.1.0-beta02

5 آوریل 2023

androidx.compose.material3:material3:1.1.0-beta02 and androidx.compose.material3:material3-window-size-class:1.1.0-beta02 are released. Version 1.1.0-beta02 contains these commits.

تغییرات API

SheetState now has optional skipHiddenState parameter
rememberStandardBottomSheetState now has optional skipHiddenState parameter
BottomSheetScaffold now has a defined Hidden anchor, though it is disabled by default
SheetState.requireOffset documentation has been updated
BottomSheetDefaults.MinimizedShape has been renamed as BottomSheetDefaults.HiddenShape ( I839f4 , b/273870234 )

رفع اشکال

Do not switch the dial face from hour to minute when touch exploration is enabled. ( I717d0 )
ModalBottomSheet and BottomSheetScaffold drag handle semantics are now merged. ( I05afb )
BottomSheetScaffold modifier, containerColor and contentColor parameters now only affect content. ( I992cb )
BottomSheetScaffold nestedScroll for sheet content now implements flings. ( I992cb )

Version 1.1.0-beta01

22 مارس 2023

androidx.compose.material3:material3:1.1.0-beta01 and androidx.compose.material3:material3-window-size-class:1.1.0-beta01 are released. Version 1.1.0-beta01 contains these commits.

تغییرات API

Add layout type param to TimePicker composable. It allows to use different layouts, depending on the screen configuration ( Ia0e16 )
SearchBarDefaults has been marked as experimental. ( I65561 )
Added shadow elevation to BottomSheetScaffold ( I94e0f )
Added support for displaying the date pickers without the header part. API changes to allow passing a null headline when creating a date picker. You can now pass null headline, title, and showToggleMode = false in order to display a headless picker. ( Id3f3a , b/266132421 , b/267194809 )

رفع اشکال

Search bars now automatically clear focus when made inactive. ( I22a7c , b/261444487 )
Updated the DateRangePicker to allow selecting a range with the same date for its start and end. ( I16529 , b/272882497 )
Text fields now properly position their text elements when font size is smaller than expected. This may result in a few pixels change in your apps based on font settings and script. ( I8b8d0 )
Bottom sheet semantic actions now have labels. ( I277b0 )

Version 1.1.0-alpha08

8 مارس 2023

androidx.compose.material3:material3:1.1.0-alpha08 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha08 are released. Version 1.1.0-alpha08 contains these commits.

ویژگی های جدید

Added support for BottomSheetScaffold and BottomSheetScaffoldState . ( I063d4 )

تغییرات API

Added functionality to the DatePickerState and the DateRangePickerState to allow setting dates after the initial creation of the state, as well as resetting selections by setting null timestamps. Setting dates manually should be made with caution, and the new setSelection function will throw an exception in case a provided date fails a precondition (see documentation). ( Ifa645 , b/268609314 , b/270427389 )
Rename Collapsed SheetValue to PartiallyExpanded to more accurately and flexibly depict behavior in this state. ( Ia1491 )
Updated ListItem parameter names to _content instead of _text. Default getters are now ReadOnlyComposables where relevant. ( I69a25 )
Graduate interactive Surface APIs from experimental. ( I90d59 , b/261561812 )

رفع اشکال

Fixed an issue where ModalBottomSheet 's HalfExpanded state was calculated incorrectly and the sheet would appear to be floating. ( I45e84 , b/268411386 )
Add confirmValueChange check to scrim tap for ModalBottomSheet . ( I2311a , b/270425759 )
Move semantic BottomSheet actions to drag handle. ( I158ba )
ModalBottomSheet now commands focus on launch, handles back button. ( I4d2ab )
ModalBottomSheet onDismissRequest is now also handled during nested scroll flings. ( I655c5 , b/268433166 )

Version 1.1.0-alpha07

22 فوریه 2023

androidx.compose.material3:material3:1.1.0-alpha07 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha07 are released. Version 1.1.0-alpha07 contains these commits.

ویژگی های جدید

Add a Time Input composable that works with rememberTimePickerState() , it follows the M3 spec for time input ( Ia4fab )
Added a Material 3 DateRangePicker API for selecting a range of dates. ( I7a6c3 , b/267194809 )
Added a Material 3 input mode support for selecting date ranges via the DateRangePicker API. ( Ifdbc4 )
Text field colors now allow customizing:
- The input field and placeholder text colors based on focus and error state. The textColor parameter has been renamed to unfocusedTextColor , and placeholderColor has been renamed to unfocusedPlaceholderColor .
- The container color for filled text fields based on error state with the new errorContainerColor param.
Exposed dropdown menu text field colors have been updated with parameters to support the new prefix and suffix API. ( I9c8b4 , b/254284181 , b/264766350 )

تغییرات API

Reverting some Slider API versions and removing redundant Slider overloads that are covered by the new experimental Slider with custom thumb and track. Promoting RangeSlider to be stable. ( Ie8fbd )
Renamed defaultElevation to elevation in chip's elevation functions. ( I0f872 )
The following Material 3 text field APIs are no longer experimental: TextField , OutlinedTextField , textFieldWithLabelPadding , textFieldWithoutLabelPadding , outlinedTextFieldPadding . ( Ieb5c0 , b/261561819 )
TimePickers is24Hour uses system setting ( I18856 )
Removed experimental annotation from scaffold apis. ( Ibb51e , b/261565765 , b/261436953 )

رفع اشکال

ModalBottomSheet default shape is now always SheetDefaults.ExpandedShape . ( I0dfca )
Accessibility improvements for Material 3 DatePicker and DateRangePicker . ( I5087e )
Fix bug where max height constraint is propagated and may crash. ( I30d8c )
Removed semantic roles from clickable and selectable surfaces, updated components that used them to set roles using modifier.semantics ( I793d9 )

Version 1.1.0-alpha06

8 فوریه 2023

androidx.compose.material3:material3:1.1.0-alpha06 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha06 are released. Version 1.1.0-alpha06 contains these commits.

ویژگی های جدید

Text fields now support prefix and suffix text ( Ia8578 , b/179884561 )
Added a TimePicker function to show a time picker following the Material 3 spec, used in conjunction with TimePickerState and convenience method rememberTimePickerState ( I71910 )
A date input is now a display mode at the DatePicker . Added support for switching between date picker and date input modes. ( Ieeff7 )
Added API for RichTextTooltips . ( I58ef3 )
Modal bottom sheet implementation for Material 3, including ModalBottomSheet and ModalBottomSheetDefaults . Also introduces SheetState and rememberSheetState which can be used for future sheet components. ( I0853a , b/244189383 )

تغییرات API

Stablize the API showSnackbar ( I195c2 , b/261424370 )
Stablize the APIs for assist chip and suggestion chip ( Ibb67b , b/261424370 )
Promotes ListItem , ListItemDefaults and ListItemColors API to non-experimental ( I7e7fa , b/261438882 )
Promoting SliderPositions , SliderDefaults.Thumb , and SliderDefaults.Track to stable and adding non-experimental Slider and RangeSlider APIs that contain custom thumbs and track. Also deprecating the previous Slider and RangeSlider APIs. ( Ie5ea6 , b/261566890 )
Made Modifier.tooltipAnchor() public, so devs can pass it to the anchor to indicate a tooltip should be displayed on long press. Updated PlainTooltipBox API to no longer make TooltipState nullable and now has a default. ( Ie2fb7 )
ProgressIndicatorDefaults.circularTrackColor has been marked @Composable for consistency. ( Id29cc )
Restored property getter LocalMinimuTouchTargetEnforcement and mark it as deprecated and redirect to LocalMinimumInteractiveComponentEnforcement . ( I60dd5 )

Version 1.1.0-alpha05

26 ژانویه 2023

androidx.compose.material3:material3:1.1.0-alpha05 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha05 are released. Version 1.1.0-alpha05 contains these commits.

ویژگی های جدید

DatePickerDialog and accessibility support
Added Custom thumb and track to RangeSlider .

به روز رسانی های وابستگی

Compose UI and Compose Material now depend on Lifecycle 2.6.0 .

Version 1.1.0-alpha04

11 ژانویه 2023

androidx.compose.material3:material3:1.1.0-alpha04 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha04 are released. Version 1.1.0-alpha04 contains these commits.

ویژگی های جدید

Initial DatePicker API for picking a single date via a calendar UI. This API is still undergoing changes. ( I722b9 )
Added support for plain tooltips via PlainTooltipBox . ( I0cdfb )
Search bar ( Iad128 )
SwipeToDismiss ( I458a8 , b/242889540 )

تغییرات API

Added in IsContainer semantics property on Surfaces. This property will be used in a later change that determines traversal order based on the semantic meaning of elements such as surfaces. ( I63379 )
Mark navigation drawer related APIs as stable. ( 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 to androidx.compose.foundation:1.4.0-alpha04 , you might experience a java.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 your androidx.compose.material and androidx.compose.material3 libraries to the latest version(1.1.0-alpha04) or downgrade your androidx.compose.foundation to 1.4.0-alpha03.

Version 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. Version 1.1.0-alpha03 contains these commits.

تغییرات API

Renamed consumedWindowInsets() to consumeWindowInsets() and withConsumedWindowInsets() to onConsumedWindowInsetsChanged() 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 an Scrollable ViewGroup .
Updated Drawers and Sheets to correctly delay presses in case gestures can become scroll events.

به روز رسانی های وابستگی

Compose UI and Compose Material now depend on Lifecycle 2.5.1. ( I05ab0 , b/258038814 )

Version 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. Version 1.1.0-alpha02 contains these commits.

تغییرات API

awaitFirstDown and waitForUpOrCancellation now accept a PointerEventPass for greater flexibility (also fixes ExposedDropdownMenuBox showing a menu while scrolling).( I7579a , b/212091796 )
Added minLines parameter into material and material3 Text, TextField and OutlinedTextField 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 new topAppBarColors function that should be used when creating a TopAppBar . ( Ie6cb9 )
Added minLines parameter to the BasicText and BasicTextField . 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 and IconToggleBotton 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 )

Version 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. Version 1.1.0-alpha01 contains these commits.

رفع اشکال

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. Version 1.0.1 contains these commits.

رفع اشکال

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. Version 1.0.0 contains these commits.

Major features of 1.0.0

This is the first stable release of Compose Material 3!

Material Design 3 theming and Material You dynamic color

Material Design 3 components

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 use calculateWindowSizeClass 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 for WindowSizeClass .
Please see this blog post for more details!

Version 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. Version 1.0.0-rc01 contains these commits.

تغییرات API

Added slot param for supporting text to text field API ( Iaac0d , b/227146125 )

Version 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. Version 1.0.0-beta03 contains these commits.

تغییرات API

ExposedDropdownMenuDefaults now exposes a padding value for menu items. ( I34ee1 )
ExposedDropdownMenuBoxScope now has a Modifier.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 )

Version 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. Version 1.0.0-beta02 contains these commits.

تغییرات 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 equivalent TopAppBar 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 )

Version 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. Version 1.0.0-beta01 contains these commits.

مرجع 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 )

Version 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. Version 1.0.0-alpha16 contains these commits.

ویژگی های جدید

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 and NavigationRail 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 and BadgedBox 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 from MenuDefaults and TabDefaults ( I4e33c )

Version 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. Version 1.0.0-alpha15 contains these commits.

ویژگی های جدید

Allow dragging the top app bar from the bar itself. ( I65c00 , b/205873416 )

تغییرات API

Updates to the FilterChip and ElevatedFilterChip APIs to remove the selectedIcon slot and promote reusing the leadingIcon for displaying a selected state. ( Ie5dc2 )
Add scrim and outline variant color roles. ( Id6d54 )
Fix naming conventions for composable defaults. ( I62b27 )
Mark ListItemDefaults and ListItemColors 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 the Checkbox function. ( I5eefc )
Removed the @ExperimentalMaterial3Api annotation from the RadioButton 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 )

Version 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. Version 1.0.0-alpha14 contains these commits.

ویژگی های جدید

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 the FilterChip colors for selected disabled state. ( I55244 , b/235792432 )
Add BottomAppBar default FAB ( Ida4c8 )
ColorScheme.surfaceColorAtElevation was added ( Id41af )
Interfaces in compose libraries are now built using jdk8 default interface methods ( I5bcf1 )
WindowWidthSizeClass and WindowHeightSizeClass 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 )

Version 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. Version 1.0.0-alpha13 contains these commits.

تغییرات API

Supports maintaining the top app bar position on configuration change. ( I10459 , b/216160958 )

Version 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. Version 1.0.0-alpha12 contains these commits.

رفع اشکال

Slider parent can now have 0 width. ( b/231707291 )

Version 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. Version 1.0.0-alpha11 contains these commits.

ویژگی های جدید

Added RangeSlider to Material 3 ( I18e38 )
Adds Material3 AssistChip and InputChip support ( I0d25a )
Adds Material3 FilterChip and SuggestionChip support ( I9fdf3 )

تغییرات API

Renamed TextFieldDefaults.BorderStroke composable that draws a border stroke in OutlinedTextField to TextFieldDefaults.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 )

Version 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. Version 1.0.0-alpha10 contains these commits.

ویژگی های جدید

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 use calculateWindowSizeClass 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 for WindowSizeClass . 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 from BottomAppBar with FAB. ( I92c47 )
Adds Material3 FilledIconButton , FilledTonalIconButton , and OutlinedIconButton . ( 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 use consume() to consume the change completely. You can use isConsumed to determine whether or not someone else has previously consumed the change.
PointerInputChange::copy() now always makes a shallow copy. It means that copies of PointerInputChange will be consumed once one of the copies is consumed. If you want to create an unbound PointerInputChange , 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 renamed containerColor 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 )

Version 1.0.0-alpha09

April 6, 2022

androidx.compose.material3:material3:1.0.0-alpha09 is released. Version 1.0.0-alpha09 contains these commits.

ویژگی های جدید

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 )

Version 1.0.0-alpha08

23 مارس 2022

androidx.compose.material3:material3:1.0.0-alpha08 is released. Version 1.0.0-alpha08 contains these commits.

ویژگی های جدید

Added support for Material 3 text fields. ( I795cc , b/199377790 )

تغییرات API

Add default divider for menu ( I01374 )
Added surfaceTint color parameter to ColorScheme class. ( I2f558 )

رفع اشکال

Fix at the Material3 Button to read its default text style value from the MaterialTheme. ( Ie62fc )

Version 1.0.0-alpha07

9 مارس 2022

androidx.compose.material3:material3:1.0.0-alpha07 is released. Version 1.0.0-alpha07 contains these commits.

تغییرات 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 and LazyHorizontalGrid 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. Deprecated ViewCompat.getWindowInsetsController in favor of WindowCompat.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 )

Version 1.0.0-alpha06

23 فوریه 2022

androidx.compose.material3:material3:1.0.0-alpha06 is released. Version 1.0.0-alpha06 contains these commits.

تغییرات API

NavigationDrawerItem is added that represents a single destination within the drawers ( Ic396f , b/218286829 )
PermanentNavigationDrawer and DismissibleNavigationDrawer 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 to ModalNavigationDrawer ( 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 to FloatingActionButtonDefaults . ( Ia71cf )
Bug fix for hidden AlertDialog buttons when a long text is added with a LazyColumn . ( Ib2cc9 , b/216663029 )

Version 1.0.0-alpha05

9 فوریه 2022

androidx.compose.material3:material3:1.0.0-alpha05 is released. Version 1.0.0-alpha05 contains these commits.

ویژگی های جدید

Added Material Design 3 components

Dropdown menu
- DropdownMenu , DropdownMenuItem
کارت ها
- Card , OutlinedCard , ElevatedCard

تغییرات API

Deprecated Surface function that takes an onClick callback. Clickable surfaces should be created with an InteractionSource and a Modifier.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 )

Version 1.0.0-alpha04

26 ژانویه 2022

androidx.compose.material3:material3:1.0.0-alpha04 is released. Version 1.0.0-alpha04 contains these commits.

تغییرات 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 )

Version 1.0.0-alpha03

12 ژانویه 2022

androidx.compose.material3:material3:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.

رفع اشکال

Add LocalIndication to Material 3's MaterialTheme . ( I7ce4e )
Fix the corner radius that is applied for Checkboxes ( I38b03 , b/175198975 , b/202309440 )

به روز رسانی های وابستگی

Now depends on Kotlin 1.6.10 .

Version 1.0.0-alpha02

December 1, 2021

androidx.compose.material3:material3:1.0.0-alpha02 is released. Version 1.0.0-alpha02 contains these commits.

ویژگی های جدید

Add support for checkbox and radiobutton.
Updated to be compatible with 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 from compose.material ( I30b03 )
Fixed but that hardcoded button to always be enabled. ( Iea832 , b/205335456 )

Version 1.0.0-alpha01

27 اکتبر 2021

androidx.compose.material3:material3:1.0.0-alpha01 is released. Version 1.0.0-alpha01 contains these commits.

ویژگی های جدید

Material Design 3 theming and Material You dynamic color

Material Design 3 components

دکمه ها
- Button , ElevatedButton , FilledTonalButton , OutlinedButton , TextButton
FAB and extended FAB
- SmallFloatingActionButton , FloatingActionButton , LargeFloatingActionButton , ExtendedFloatingActionButton
دیالوگ ها
- AlertDialog
نوار ناوبری
- NavigationBar
Navigation drawer
- NavigationDrawer
Navigation rail
- NavigationRail
نوار برنامه بالا
- SmallTopAppBar , CenterAlignedTopAppBar , MediumTopAppBar , LargeTopAppBar
نشان
- Badge , BadgedBox
نماد
- Icon , IconButton
متن
- Text
سطح
- Surface
طرح بندی
- Scaffold
Content color
- LocalContentColor

For more information, check out the Material Design 3 and Material You section in the Material Theming in Compose guide.