نوشتن مواد 3

نوشتن مواد 3

نمونه کد راهنمای کاربر

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

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

آخرین به روز رسانی	انتشار پایدار	کاندید را آزاد کنید	نسخه بتا	انتشار آلفا
12 مارس 2025	1.3.1	-	-	1.4.0-آلفا10

ساختار

Compose ترکیبی از هفت شناسه گروه Maven در androidx است. هر گروه شامل یک زیرمجموعه هدفمند از عملکرد است که هر کدام مجموعه ای از یادداشت های انتشار خود را دارند.

این جدول گروه ها و پیوندهای هر مجموعه از یادداشت های انتشار را توضیح می دهد.

گروه	توضیحات
آهنگسازی.انیمیشن	انیمیشن هایی را در برنامه های Jetpack Compose خود بسازید تا تجربه کاربر را غنی تر کنید.
compose.compiler	توابع @Composable را تغییر دهید و بهینه سازی ها را با افزونه کامپایلر Kotlin فعال کنید.
تألیف.بنیاد	برنامه های Jetpack Compose را با بلوک های ساختمانی آماده بنویسید و پایه را گسترش دهید تا قطعات سیستم طراحی خود را بسازید.
آهنگسازی.مواد	رابط کاربری Jetpack Compose را با اجزای طراحی مواد آماده برای استفاده بسازید. این نقطه ورود سطح بالاتر Compose است که برای ارائه مؤلفه هایی مطابق با آنچه در www.material.io توضیح داده شده است طراحی شده است.
نوشتن.مواد3	ایجاد رابط کاربری Jetpack Compose با 3 مؤلفه طراحی متریال، تکامل بعدی طراحی متریال. Material 3 شامل قالب‌ها و اجزای به‌روز شده و ویژگی‌های شخصی‌سازی Material You مانند رنگ پویا است و به گونه‌ای طراحی شده است که با سبک بصری جدید Android 12 و رابط کاربری سیستم هماهنگ باشد.
نوشتن. زمان اجرا	بلوک‌های بنیادی مدل برنامه‌نویسی Compose و مدیریت حالت، و زمان اجرا اصلی برای هدف قرار دادن افزونه Compose Compiler.
compose.ui	مؤلفه‌های اساسی نوشتن رابط کاربر برای تعامل با دستگاه، از جمله طرح‌بندی، طراحی، و ورودی مورد نیاز است.

اعلام وابستگی ها

برای افزودن وابستگی به Compose، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

Groovy

dependencies {
    implementation "androidx.compose.material3:material3:1.3.1"
    implementation "androidx.compose.material3:material3-window-size-class:1.3.1"
    implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha10"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    implementation("androidx.compose.material3:material3:1.3.1")
    implementation("androidx.compose.material3:material3-window-size-class:1.3.1")
    implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha10")
}

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، بسته androidx.compose.material3:material3-adaptive-navigation-suite به عنوان بخشی از بسته Compose Material3 (نسخه های Material3 1.3.0-*) منتشر می شود. در نتیجه، نسخه‌سازی مجموعه ناوبری تطبیقی ​​Compose Material3 از 1.0.0-xxxx به 1.3.0-xxxx رسیده است. برای یافتن یادداشت‌ها و تعهدات انتشار مجموعه ناوبری فعلی و آینده، به Compose Material3 نسخه 1.3.0 و نسخه‌های جدیدتر مراجعه کنید.

نسخه 1.0.0-alpha07

1 مه 2024

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

تغییرات API

• APIهای مجموعه ناوبری را غیر آزمایشی کنید ( If62af )

رفع اشکال

• به طور پیش‌فرض از ورودی‌ها برای محتوا استفاده کنید ( 50266df )

نسخه 1.0.0-alpha06

17 آوریل 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06 ، androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06 و androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06 منتشر شد. نسخه 1.0.0-alpha06 حاوی این تعهدات است.

تغییرات API

• containerColor و contentColor به NavigationSuiteScaffoldDefaults اضافه کنید. ( I64e3a , b/331993720 )
• افزودن تابع itemColors به NavigationSuiteDefaults . ( Idf719 , b/328480012 )
• NavigationSuiteScope را مهر و موم کنید. ( Iefa57 )

نسخه 1.0.0-alpha05

6 مارس 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05 ، androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05 و androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05 منتشر شد. نسخه 1.0.0-alpha05 حاوی این تعهدات است.

تغییرات API

• سازنده NavigationSuiteItemColors را عمومی کنید. ( Ica83a , b/324886877 )

نسخه 1.0.0-alpha04

21 فوریه 2024

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

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

• وابستگی های تطبیقی ​​Material3 را به مسیرهای ماژول جدید به روز کنید. ( IBC421 )
• برای استفاده از نسخه Window Manager کلاس‌های اندازه پنجره مهاجرت کنید. ( I3794d )

نسخه 1.0.0-alpha03

7 فوریه 2024

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

تغییرات API

• به روز رسانی نام بسته به navigationsuite از navigation-suite ( I7eff7 )
• مؤلفه‌های Material3 که یک MutableInteractionSource را در API خود نشان می‌دهند، به‌روزرسانی شده‌اند تا اکنون یک MutableInteractionSource قابل تهی را که پیش‌فرض آن null است، در معرض نمایش بگذارد. هیچ تغییر معنایی در اینجا وجود ندارد: عبور از null به این معنی است که شما نمی خواهید MutableInteractionSource را بالا ببرید و در صورت نیاز در داخل کامپوننت ایجاد می شود. تغییر به null به برخی از مؤلفه‌ها اجازه می‌دهد تا هرگز یک MutableInteractionSource را تخصیص ندهند، و به سایر مؤلفه‌ها اجازه می‌دهد فقط در صورت نیاز، نمونه‌ای را ایجاد کنند، که عملکرد این مؤلفه‌ها را بهبود می‌بخشد. اگر از MutableInteractionSource که به این مؤلفه ها منتقل می کنید استفاده نمی کنید، توصیه می شود به جای آن، null را ارسال کنید. همچنین توصیه می شود که تغییرات مشابهی را در اجزای خود ایجاد کنید. ( I41abb , b/298048146 )

نسخه 1.0.0-alpha02

13 دسامبر 2023

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

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

• یک NavigationSuiteType "None" اضافه کنید ( If8cb1 , b/313688598 )

رفع اشکال

• هنگامی که سطح ریشه دارای modifier.fillMaxSize است، اجزای ناوبری را برطرف کنید که کل صفحه را پر می کند. ( c9cf250 , b/312664933 )

نسخه 1.0.0-alpha01

15 نوامبر 2023

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

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

• NavigationSuiteScaffold
  • NavigationSuiteScaffoldLayout
  • NavigationSuite

Compose Material3 Adaptive Version 1.0

توجه: از 1.0.0-alpha07، androidx.compose.material3:material3-adaptive به androidx.compose.material3.adaptive منتقل شد. برای نسخه‌های بعدی، لطفاً از androidx.compose.material3.adaptive و یادداشت‌های انتشار مرتبط در صفحه Compose Material3 Adaptive ما استفاده کنید.

نسخه 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
  • محاسبهStandardPaneScaffoldDirective
  • محاسبه DensePaneScaffoldDirective
  • AdaptStrategy
  • ThreePaneScaffoldAdaptStrategies
  • HingePolicy

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

• APIهای پایه داربست
  • PaneScaffoldScope
  • ThreePaneScaffoldRole
  • PaneAdaptedValue
  • ThreePaneScaffoldValue
  • محاسبهThreePaneScaffoldValue
  • AnimatedPane

Compose Material3 نسخه 1.4

نسخه 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 ارائه‌شده در اشیاء مؤلفه پیش‌فرض برای Material 2 و Material 3 می‌شود. اگر این تغییر باعث رفتار نامطلوب شد، پارامتر WindowInsets به‌صورت دستی بر اساس هر مؤلفه مشخص کنید. ( I43ee9 , b/362508045 )

تغییرات API

• به‌روزرسانی‌های TopAppBar API. نوارهای برنامه متوسط ​​و بزرگ را با یک زیرنویس به *FlexibleTopAppBar تغییر نام دهید. تغییرات رنگ را در یک تابع TopAppBarDefault.topAppBarColors() یکپارچه کرد و یک پارامتر رنگ subtitle اضافه کرد تا برای زیرنویس Composable ارائه شده ( I41b65 ) اعمال شود.
• API WideNavigationRailArrangement به نفع Arrangement.Vertical حذف کنید ( Id0341 )
• یک VerticalSlider @Composable اضافه کنید. ( I2bfba )
• یک Track @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 در material3. ( 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 راهنمای ابزار اضافه شد که دارای پارامتر onDismissRequest است تا سازندگان بتوانند تصمیم بگیرند که وقتی کاربر خارج از راهنمای ابزار کلیک می کند چه اتفاقی می افتد. API قدیمی که حاوی این پارامتر جدید نیست منسوخ شد. ( I99aef )
• تغییر نام opticalCentering به horizontalCenterOptically . ساختن اصلاح کننده داخلی پارامتر padding را با حداکثر افست شروع و پایان جایگزین کنید. ( I0b904 )
• WideNavigationRailState برای داشتن مقدار فعلی/هدف تغییر دهید، enums را به نفع بولی حذف کنید. ( Idfa29 , b/356039090 )
• NavigationBarItemComponentOverride را اضافه کنید. ( I3a06a )

رفع اشکال

• رفتارهای نوار برنامه بالا و پایین را اصلاح کنید تا زمانی که محتوا تا انتها پیمایش می شود، رنگ آن به طور قابل اعتماد تغییر کند. ( Idc4e8 , b/293665988 )
• توابع رفتار اسکرول برای نوارهای برنامه بالا و پایین اکنون یک رفتار به خاطر سپردن را برای عملکرد بهتر در ترکیب‌های مجدد بازمی‌گردانند. ( I0fdbe , b/207957336 )
• پارامتر اصلاح‌کننده اکنون بعد از اصلاح‌کننده‌های داخلی مانند کشیدن رفتار و معنایی، به جای قبل اعمال می‌شود. این بر ترتیب اعمال اصلاح کننده ها تأثیر می گذارد. ( 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 حاوی این commit ها است.

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

• تغییرات رنگ معرفی شده در aosp/3212478 را به iconButtonColors ، iconToggleButtonColors ، outlinedIconButtonColors ، outlinedIconToggleButtonColors و outlinedIconToggleButtonBorder برگردانید. رفتار بازگردانده شده را به مجموعه جدیدی از توابع به نام iconButtonVibrantColors و غیره منتقل کرد تا بر رنگ‌های کنتراست بالا که برگردانده می‌شوند تأکید کند. ( Iffd8d )

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

• مولفه VerticalDragHandle معرفی کنید ( I6c770 )

تغییرات API

• تغییر نام DismissibleModalWideNavigationRailDefaults به ModalWideNavigationRailDefaults . ( I8e877 )
• NavigationBarComponentOverrides را اضافه کنید. ( I8a3f3 )
• NavigationRailComponentOverride را اضافه کنید. ( I83e13 )
• WideNavigationRailState برای مدیریت فروپاشی/بسط ریل معرفی کنید، اجازه دهید ModalWideNavigationRail قابل رد شود و DismissibleModalWideNavigationRail حذف کنید. ( I88568 )
• پیش‌فرض‌های اندازه xSmall، متوسط، بزرگ و xLarge را به پیش‌فرض‌های دکمه جابجایی اضافه کنید. ( Ie95d1 )
• اندازه های پیش فرض xSmall، متوسط، بزرگ و xLarge را به پیش فرض های دکمه اضافه کنید. ( If8b6d )

رفع اشکال

• رنگ نماد دنباله تراشه فیلتر براساس مشخصات از Primary به OnSurfaceContainer به‌روزرسانی شده است. همه رنگ‌های طرح کلی تراشه، بر اساس مشخصات، از Outline به Outline Variant به‌روزرسانی شده‌اند. ( I68bd4 )

نسخه 1.4.0-alpha03

30 اکتبر 2024

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

تغییرات API

• سازنده SheetState با چگالی به نفع آستانه های موقعیتی و سرعتی منسوخ شده است. ( Ifd16e )
• rememberTooltipPositionProvider اضافه شد که حاوی یک منطق موقعیت یابی به روز شده است. rememberPlainTooltipPositionProvider و rememberRichTooltipPositionProvider منسوخ شده است. ( Ie66e2 )
• ModalBottomSheetProperties اضافی امکان سفارشی‌سازی وضعیت و رنگ‌های نوار پیمایش را فراهم می‌کند. به‌طور پیش‌فرض، این به‌روزرسانی‌ها براساس رنگ محتوا به‌جای وضعیت تم تیره سیستم است. ( Ib874e , b/362539765 )
• تجربه ورودی برای انتخابگرهای تاریخ بهبود یافته است: در حالت ورودی، قسمت متن تاریخ برای وارد کردن متن فوری متمرکز می شود. این تغییر یک پارامتر requestFocus به DatePicker و DateRangePicker اضافه می کند. شما ممکن است با عبور false از تمرکز جلوگیری کنید. ( I12d09 , b/286399710 , b/340102743 )
• کش کردن شکل به صورت پیش فرض در شی Shape است. ایجاد شکل پیش فرض @Composable برای دکمه جابجایی. جمع کردن اشکال در یک شکل پیش‌فرض زیرا انواع به یک فایل توکن اشاره می‌کنند. ( Iaa014 )

رفع اشکال

• رفتار Scaffold contentPadding را بهینه کنید تا از ترکیب مجدد محتوای بدنه هنگام تغییر contentPadding جلوگیری کنید. ( I8c8e2 , b/373904168 )
• progress TextFieldLabelScope به labelMinimizedProgress تغییر نام داد
• Default TextFieldLabelPosition به Attached تغییر نام داد. اعضای رابط حذف شده اند. ( If75c6 )
• مشکل DatePicker در حالت ورودی که خطاهای اعتبارسنجی می‌تواند باعث تغییر ارتفاع مؤلفه شود، برطرف شد. ( I2e229 , b/280462363 )
• هنگامی که کلیدهای کنترل فشار داده می شوند، لغزنده مواد را تغییر دهید. ( I1c442 )

نسخه 1.4.0-alpha02

16 اکتبر 2024

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

تغییرات API

• به‌روزرسانی‌های انتخابگر تاریخ برای اطمینان از استفاده مداوم از Locale در سرتاسر DatePicker و DateRangePicker هنگام تنظیم یک Locale مستقیماً از طریق DatePickerState یا DateRangePickerState . توجه داشته باشید که وقتی Locales را مستقیماً روی حالت تنظیم می‌کنید، این شما هستید که باید اطمینان حاصل کنید که متون عنوان و عنوان بر اساس آن بومی‌سازی می‌شوند، زیرا متن پیش‌فرض آنها همچنان بر اساس پلتفرم پیش‌فرض Locale اعمال می‌شود. ( I37073 , b/326490763 , b/321657276 )
• SheetState.isAnimationRunning اکنون در معرض دید قرار گرفته است. ( I9a3d7 )
• اکنون DatePickerColors به ​​درستی بر رنگ‌های متضاد تعریف شده در سبک‌های متن تایپوگرافی موضوع اولویت دارد. همچنین توجه داشته باشید که این به‌روزرسانی موقعیت پارامتر color را در توابع انتخابگر تاریخ تنظیم می‌کند و یک پارامتر contentColor را برای سفارشی‌سازی رنگ‌های هدر و متن عنوان معرفی می‌کند. ( I30d03 , b/347031394 )
• تغییر نام SplitButton به SplitButtonLayout و حذف APIهای رنگی SplitButton ، انواع با استفاده مجدد از انواع دکمه ارائه شده توسط SplitButtonDefaults به دست خواهند آمد. ( I44c36 )
• ModalBottomSheet اکنون دارای پارامتر sheetGestureEnabled است ( I856cb , b/288211587 )
• standardMotionScheme و expressiveMotionScheme را به استاندارد و رسا تغییر نام داد. هر دو تابع اکنون از طریق شیء همراه MotionScheme با فراخوانی MotionScheme.standard() و MotionScheme.expressive() قابل دسترسی هستند. ( Iceccf )
• افزودن پارامتر maxWidth به راهنمای ابزار ساده و غنی. به طور پیش فرض مشخصات طراحی 200 dp برای راهنمای ابزار ساده و 320 dp برای راهنمای ابزار غنی است. ( I30ce9 )

رفع اشکال

• DatePicker و DateRangePicker اکنون زمانی که از طریق displayedMonthMillis ایالت خود تنظیم می شوند، ماه نمایش داده شده را به درستی به روز می کنند. ( If9e47 , b/333414302 )
• محتوای ModalBottomSheet اکنون محتوا را از نوار وضعیت دور می کند. ( I5114c , b/321877275 , b/336962418 , b/342093067 )
• [برگ پایین] اولویت پاسخ به تماس را به PRIORITY_DEFAULT تغییر دهید تا اجازه دهید صفحه کلید IME ابتدا رد شود. ( I447fb )
• هنگامی که حداقل سال قابل انتخاب روی سال آینده تنظیم شده باشد، خرابی ها را در DatePicker و DateRangePicker برطرف کنید. ( I78656 , b/319395747 )
• هنگامی که نمونه به‌روزرسانی‌شده SelectableDates اعمال می‌شود، برای به‌روزرسانی رابط کاربری، مشکل انتخابگر تاریخ را برطرف کنید. ( Iad59a , b/290135807 , b/339898760 )

نسخه 1.4.0-alpha01

2 اکتبر 2024

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

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

• Library دیگر وابستگی به material-icons-core اضافه نمی کند، بنابراین اگر پروژه شما به آن متکی است، باید به صراحت آن وابستگی را در فایل های build.gradle[.kts] خود اضافه کنید. ( I735ff , b/349894318 )
• رنگ برچسب فعال NavigationBarItem و NavigationRailItem از onSurface به secondary تغییر می کند تا قابلیت استفاده، کنتراست رنگ و هماهنگی را در سیستم بهبود بخشد ( Ibc297 )، برای بازگشت به رفتار قبلی، رنگ های پیش فرض را کپی کنید و selectedTextColor به MaterialTheme.colorScheme.onSurface تغییر دهید.
• اجزای Material 3 اکنون از MotionScheme جدید برای تعریف حرکت خود استفاده می کنند. ( Ie0f93 )
• تغییرات حرکتی نشانگر پیشرفت دایره ای نامشخص ( I3c07e )
• برای تضاد رنگ بهتر OutlinedIconButtonColors و OutlinedIconToggleButtonColors را به‌روزرسانی کنید. ( I2743d )
• ظرف و رنگ محتوا برای FilledIconToggleButtonColors و FilledTonalIconToggleButtonColors به‌روزرسانی شد. ( IC5d0f )
• رنگ حاشیه OutlinedButton از outline به outlineVariant به روز شد. ( 057f00 )

تغییرات API

• یک پارامتر reverseLayout اختیاری به تابع enterAlwaysScrollBehavior TopAppBar اضافه کرد تا از محتوایی که با reverseLayout تنظیم شده بود، بهتر پشتیبانی کند. ( I4e0e5 )
• SegmentedButton اکنون از آرگومان contentPadding پشتیبانی می کند. ( I5ad91 , b/358414376 )
• PullToRefreshState دیگر اجرای پیش‌فرض برای isAnimating را ندارد ( I6a593 )
• اضافه بارهای جدیدی از Material TextField و OutlinedTextField اضافه شده است که از TextFieldState استفاده می کنند. APIهای جعبه دکوراسیون اضافه شده که با TextFieldDecorator سازگار هستند. ( If13a1 )
• پارامتر برای کنترل labelPosition فیلد متنی اضافه شد. استفاده از alwaysMinimize به الگوی رابط کاربری اجازه می‌دهد تا یک برچسب و مکان‌نما را در یک فیلد متنی به‌طور هم‌زمان نمایش دهد، حتی زمانی که فیلد فوکوس نشده باشد. ( I1ef2c )
• مواد SecureTextField و OutlinedSecureTextField برای فیلدهای ورود رمز عبور اضافه شد. ( I7e22d )
• یک محدوده به برچسب‌های فیلد متنی برای جستجوی پیشرفت انیمیشن اضافه شده است. ( If5ec8 )
• پشتیبانی از MotionEvent.CLASSIFICATION_DEEP_PRESS را به نکات ابزار اضافه می کند. ( I62e6a )
• isAfternoon TimePickerState اکنون به جای var در رابط، یک Extension Val است که به isPm تغییر نام داده است ( I89a97 )
• به‌روزرسانی کلاس تایپوگرافی برای پشتیبانی از مقیاس‌های نوع تأکید شده. ( Ifa13c )
• ModalWideNavigationRail API اضافه شد و APIهای ModalExpandedNavigationRail به DismissibleModalWideNavigationRail تغییر نام داد. ( IC9118 )
• FloatingAppBarScrollBehavior برای محاسبه خودکار screenOffset و عدم نیاز به @Composable به روز شد. ( IDF349 )
• API LoadingIndicator را به‌روزرسانی می‌کند تا نام‌گذاری را در شیء پیش‌فرض آن اصلاح کند. یک ثابت LoadingIndicatorElevation در PullToRefresh اضافه شد. ( I1d72b )
• API LoadingIndicator را به‌روزرسانی می‌کند تا نام‌گذاری را در شیء پیش‌فرض آن اصلاح کند. یک ثابت LoadingIndicatorElevation در PullToRefresh اضافه شد. ( I1d72b )
• پارامترهای amplitude و waveSpeed را به تغییرات نامشخص LinearWavyProgressIndicator و CircularWavyProgressIndicator اضافه کرد. ( I2a0c5 )
• پشتیبانی از تغییر شکل دکمه جابجایی نماد بر اساس حالت فشار داده شده یا علامت زده آن. ( IBC781 )
• به‌روزرسانی کلاس تایپوگرافی برای پشتیبانی از مقیاس‌های نوع تأکید شده. ( Ifa13c )
• شکل SplitButton بر اساس حالت پیش‌فرض/فشرده تغییر شکل می‌دهد. Api AnimatedTrailingButton حذف شد زیرا api TrailingButton می تواند همان سفارشی سازی ها را ارائه دهد ( I95066 )
• اضافه کردن اصلاح کننده به متحرک نمایش و پنهان FAB، به عنوان مثال زمانی که محتوا اسکرول. ( I8338d )
• اضافه کردن اشکال گروه دکمه های متصل و فاصله به ButtonGroupDefaults برای استفاده در یک نمونه. ( I68e30 )
• دکمه تقسیم، بالشتک افقی را برای دکمه دنباله اضافه می کند و مرکز نوری محاسبه شده از تفاوت گوشه های شروع و پایان را فعال می کند ( I122e2 )
• معرفی یک Material MotionScheme جدید برای تنظیم یک طرح برای حرکت مولفه. این طرح از طریق MaterialTheme تنظیم می شود. ( ID50c2 )

رفع اشکال

• شاخص پیمایش فوکوس صحیح را روی Scaffold child Composables اعمال کنید. دستور topBar ، bottomBar ، fab، محتوا، اسنکبار است. ( I5936b )
• مشکلی در DatePicker و DateRangePicker رفع شد که در برخی از مناطق و اسکلت‌های قالبی خاص، برخی از عناصر تاریخ (مثلاً نام ماه) با حرف بزرگ شروع نمی‌شدند. ( I1430f )
• ادغام نشانه‌های کامپوننت منوی FAB و FAB (به‌روزرسانی‌های بصری جزئی برای بالشتک‌ها و متن) ( Ib57f3 )
• ModalBottomSheet اکنون در ترتیب پیمایش معنایی اول است و سپس scrim قرار دارد. ( I436f9 , b/358594665 )
• رفع نشدن نوار پایین برنامه هنگام پیمایش در زیر قرص پیمایش در حالت لبه به لبه ( I3ee21 )

Compose Material3 نسخه 1.3

نسخه 1.3.1

30 اکتبر 2024

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

رفع اشکال

• DatePicker و DateRangePicker اکنون زمانی که از طریق displayedMonthMillis ایالت خود تنظیم می شوند، ماه نمایش داده شده را به درستی به روز می کنند. ( If9e47 , b/333414302 )
• هنگامی که حداقل سال قابل انتخاب روی سال آینده تنظیم شده باشد، خرابی ها را در DatePicker و DateRangePicker برطرف کنید. ( I78656 , b/319395747 )
• هنگامی که نمونه به‌روزرسانی‌شده SelectableDates اعمال می‌شود، برای به‌روزرسانی رابط کاربری، مشکل انتخابگر تاریخ را برطرف کنید. ( Iad59a , b/290135807 , b/339898760 )
• اولویت برگشت به تماس مورد استفاده برگه های پایین را به PRIORITY_DEFAULT تغییر دهید تا صفحه کلید IME ابتدا رد شود. ( I447fb )

نسخه 1.3.0

4 سپتامبر 2024

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

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

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

مواد جدید طراحی 3 جزء

• چرخ فلک
  • ارتقاء HorizontalMultiBrowseCarousel و HorizontalUncontainedCarousel به اجزای طراحی متریال موجود 3.
• [ ModalBottomSheet ] اکنون از Predictive Back در U+ پشتیبانی می‌کند ( Iccf32 , b/281967264 , b/304850357 )
• [ SearchBar ] اکنون از Predictive Back در U+ ( I657f8 ) پشتیبانی می کند
• Nav Drawer ( ModalDrawerSheet و DismissibleDrawerSheet ) اکنون از Back Predictive Back در U+ به عنوان انتخاب ( Ie5b0b ) پشتیبانی می کند.
• اکنون DropdownMenu از رنگ، شکل، ارتفاع و حاشیه سفارشی پشتیبانی می کند. ( I8e981 , b/289554448 , b/301887035 , b/283654243 )
• لغزنده به روز شده برای بهبود دسترسی با افزودن نشانگر شکاف و توقف. ( I3058e )
• ProgressIndicator برای بهبود دسترسی با افزودن نشانگر شکاف و توقف به‌روزرسانی شد. ( I21451 )
• یک کارت پیش‌فرض برای راهنمایی ابزار غنی اضافه شده است، با توجه به لنگر LayoutCoordinates ، از کارت سفارشی پشتیبانی می‌کند. ( Ifd42c ) شکستن تغییرات
• APIهای کشش برای تازه کردن:
  • PullToRefreshState برای استفاده از مقادیر کسری به جای واحدهای Dp ساده کرد.
  • وضعیت isRefreshing به جای PullToRefreshState توسط کاربر کنترل می شود.
  • اتصال پیمایش تودرتو از PullToRefreshState جدا شد. توسط PullToRefreshBox یا Modifier.pullToRefresh جدید مدیریت می شود.
  • این به‌روزرسانی یک تغییر قطعی نسبت به APIهای آزمایشی قبلی است. ( I0adeb , b/314496282 , b/317177684 , b/323787138 , b/324573502 , b/317177683 ) Visual Breaking Changes
• برای اطمینان از کنتراست رنگ کافی، پوشش حالت فوکوس را 0.1f به روز کنید. ( I7ea77 )
• تنظیمات کوچک برای پیش‌فرض رنگ سطح و پس‌زمینه در lightColorScheme و darkColorScheme . ( I9db52 )
• رنگ‌های Slider و ProgressIndicator به‌روزرسانی شدند تا از مشخصات جدید Non-Text Contrast پیروی کنند. ( I26807 )
• انواع SurfaceContainer اکنون توسط کامپوننت ها استفاده می شود. اجزایی که به طور رسمی رنگ را با Surface و TonalElevation محاسبه می‌کنند، اکنون به‌طور پیش‌فرض از نقش‌های SurfaceContainer استفاده می‌کنند، که تحت تأثیر ارتفاع صدا قرار نمی‌گیرند. ( b/304584161 )
• نقش‌های خط پایه کانتینر سطحی و سطحی کمی تنظیم شده‌اند و رنگ بیشتری را در تم‌های روشن و تاریک ایجاد می‌کنند. ( I677a5 )
• APIهای آزمایشی را به پایداری ارتقا داد!
• بهبود عملکرد

نسخه 1.3.0-rc01

21 آگوست 2024

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

رفع اشکال

• ModalBottomSheet اکنون در ترتیب پیمایش معنایی اول است و سپس scrim قرار دارد. ( I436f9 , b/358594665 )

نسخه 1.3.0-beta05

24 جولای 2024

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

• رفع مشکل عدم وجود یا قطع محتوای BottomSheet در Android N و O ( a10a2d )
• مرزهای معنایی لغزنده را افزایش داد تا TalkBack به درستی نشانگرهای فوکوس را در اطراف انگشتان شست نشان دهد. ( 0b5a1d )

نسخه 1.3.0-beta04

26 ژوئن 2024

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

نسخه 1.3.0-beta03

12 ژوئن 2024

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

مشارکت خارجی

• androidx.compose.material3.DropdownMenu از مجموعه منبع رایج در دسترس قرار دهید. ( If62c0 )

نسخه 1.3.0-beta02

29 مه 2024

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

تغییرات API

• Modifier.pullToRefreshIndicator از elevation پشتیبانی می‌کند، APIهای Pull To Refresh را به‌روزرسانی می‌کند تا به جای لامبدا، یک Boolean را فعال کرده باشد. پشتیبانی از تراز محتوا در PullToRefreshBox ( I75679 )
• ساخت TooltipScope یک رابط مهر و موم شده و ایجاد یک پیاده سازی داخلی برای استفاده در TooltipBox و Label. ( I3833e )
• دو اصلاح‌کننده جدید به CarouselItemScope اضافه شد - maskClip و maskBorder - برای افزودن آسان شکل و حاشیه به هر مورد چرخ فلکی ( Id67a1 )
• TimePickerState اکنون یک رابط است و امکان تنظیم زمان را فراهم می کند ( I88546 )
• API به روز شده برای استایل دادن به پیوندها: TextLinkStyles را به TextStyle منتقل کرد و TextDefaults از مواد حذف کرد. ( I5477b )

رفع اشکال

• وضعیت ModalBottomSheet و نمادهای نوار ناوبری اکنون به وضعیت تم تیره پاسخ می دهند. ( Ie1fe7 , b/338342149 )
• به اسکریم ModalBottomSheet معنایی ورق نزدیک اضافه شد. ( 0e61cb , b/328801864 )

مشارکت خارجی

• androidx.compose.material3.AlertDialog از مجموعه منبع رایج در دسترس قرار دهید ( Ia33f5 )
• ModalBottomSheet از مجموعه منبع رایج در دسترس قرار دهید ( Id7cc7 )

نسخه 1.3.0-beta01

14 مه 2024

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

تغییرات API

• استفاده از DpSize به جای CaretProperties . حذف CaretProperties تغییر نام CaretScope به TooltipScope . ( ID9a76 )
• API را برای دریافت پیوندهای مضمون مواد در متن به روز کرد. به طور خاص، روش‌ها را از TextDefaults برای ساخت LinkAnnotations با مضمون حذف کرد و HTML را با پیوندهای مضمون تجزیه کرد. در عوض، یک کلاس TextLinkStyles اضافه کرد که اجازه می دهد تا به پیوندها به عنوان یک پارامتر به Text composable استایل دهید. ( I31b93 )

نسخه 1.3.0-alpha06

1 مه 2024

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

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

• APIهای کشش برای تازه کردن:

  • PullToRefreshState برای استفاده از مقادیر کسری به جای واحدهای Dp ساده کرد.
  • وضعیت isRefreshing به جای PullToRefreshState توسط کاربر کنترل می شود.
  • اتصال پیمایش تودرتو از PullToRefreshState جدا شد. توسط PullToRefreshBox یا Modifier.pullToRefresh جدید مدیریت می شود.
  • این به‌روزرسانی یک تغییر قطعی نسبت به APIهای آزمایشی قبلی است. ( I0adeb , b/314496282 , b/317177684 , b/323787138 , b/324573502 , b/317177683 )

تغییرات API

• RippleConfiguration#isEnabled حذف شده است و LocalRippleConfiguration پوچ شده است. برای غیرفعال کردن ریپل، به جای ارائه یک RippleConfiguration با isEnabled = false ، null به LocalRippleConfiguration ارائه کنید. ( I22725 )
• وقتی لبه به لبه فعال باشد، ModalBottomSheet با دقت بیشتری بر روی نوار وضعیت می‌کشد. محتوای ورق پایین معین هم اکنون می تواند از پنجره های پنجره استفاده کند و محتوای قابل مشاهده در بالای نوار ناوبری را فراهم می کند. 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 برای برچسب اکنون اندازه فونت سیستم را محاسبه می کند. ( 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 حاوی این commit ها است.

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

• به روزرسانی آهنگ M3 ModalBottomSheet برای پشتیبانی از پیش بینی برگشت در U+ ( ICCF32 ، B/281967264 ، B/304850357 )
• به روز شده آهنگ M3 SearchBar برای پشتیبانی از پیش بینی برگشت در U+ ( I657F8 )
• کشویی به روز شده برای بهبود دسترسی با اضافه کردن یک شکاف و نشانگر توقف. ( i3058e )
• با افزودن شکاف و توقف نشانگر ، ProgressIndicator برای بهبود دسترسی به روز کرد. ( I21451 )
• با اضافه کردن یک سرپرست پیش فرض برای Tooltip Rich ، API New Rich Tooltip API اکنون اجازه می دهد تا با توجه به LayoutCoordinates لنگرگاه ، Caret سفارشی ترسیم شود. ( IFD42C )

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

• اجزای متریال برای استفاده از APIهای ریپل جدید منتقل شده اند و دیگر RippleTheme پرس و جو نمی کنند.

تغییرات API

• Fun drawStopIndicator اکنون عمومی است. ( i3f59f )
• عملکرد formatWithSkeleton DatePicker به عنوان داخلی ( IC65DC ) علامت گذاری کنید
• DropdownMenu اکنون از رنگ ، شکل ، ارتفاع و مرز سفارشی پشتیبانی می کند. ( i8e981 ، b/289554448 ، b/301887035 ، b/283654243 )
• مؤلفه های Material3 در معرض یک MutableInteractionSource در API خود به روز شده اند تا اکنون یک MutableInteractionSource قابل تهی را که به طور پیش فرض برای null است ، در معرض دید قرار دهند. هیچ تغییر معنایی در اینجا وجود ندارد: عبور از null به این معنی است که شما نمی خواهید MutableInteractionSource را بالا ببرید و در صورت نیاز در داخل کامپوننت ایجاد می شود. تغییر به null به برخی از مؤلفه‌ها اجازه می‌دهد تا هرگز یک MutableInteractionSource را تخصیص ندهند، و به سایر مؤلفه‌ها اجازه می‌دهد فقط در صورت نیاز، نمونه‌ای را ایجاد کنند، که عملکرد این مؤلفه‌ها را بهبود می‌بخشد. اگر از MutableInteractionSource که به این مؤلفه ها منتقل می کنید استفاده نمی کنید، توصیه می شود به جای آن، null را ارسال کنید. همچنین توصیه می شود که تغییرات مشابهی را در اجزای خود ایجاد کنید. ( i41abb ، b/298048146 )
• اضافه کردن RippleConfiguration و LocalRippleConfiguration را اضافه می کند تا امکان سفارشی سازی هر جزء / زیر درخت از موج ها با استفاده از مقادیر ثابت فراهم شود. به عنوان مثال ، برای تغییر رنگ یک مؤلفه که کنترل نمی کنید ، یا یک موج را برای یک جزء غیرفعال می کنید. در بیشتر موارد از مقادیر پیش فرض باید استفاده شود: این API ها یک دریچه فرار برای شخصی سازی اجزای فردی / زیر درختان محدود هستند. برای تغییرات گسترده تر و سیستم های طراحی سفارشی ، در عوض باید با استفاده از createRippleModifierNode ، موج خود را بسازید. ( i7b5d6 ، b/298048146 )
• API جدید Ripple را در Material3 اضافه می کند که جایگزین rememberRipple مستهلک شده است. همچنین یک CompositionLocal موقت موقت ، LocalUseFallbackRippleImplementation استفاده می کند ، اما در صورت استفاده از API های مستهلک شده rememberRipple / RippleTheme ، قطعات 3 را برای بازگرداندن اجزای Material3 به Material3 بازگردانید. این مورد در نسخه پایدار بعدی حذف می‌شود و فقط به عنوان کمکی موقت برای مهاجرت برای مواردی در نظر گرفته شده است که یک RippleTheme سفارشی ارائه می‌کنید. ( i34cbc ، b/298048146 )

رفع اشکال

• برای بهبود عملکرد ، زیرمجموعه زیر ModalBottomSheet را حذف کرد. مسئله ای را برطرف کرد که در آن ModalBottomSheet می تواند در سناریوهای خاص در ترکیب با LookaheadScope سقوط کند. ( i2a198 )
• برای بهبود عملکرد، ترکیب فرعی داخل BottomSheetScaffold حذف شد. مشکلی که در آن BottomSheetScaffold در سناریوهای خاص در ترکیب با LookaheadScope از کار می افتاد، برطرف شد. ( IE6401 )
• تراز نشان تنظیم شده است تا با توجه به گوشه بالا سمت راست به مرکز محتوای لنگر نزدیکتر شود. ( i18a28 )
• یک مسئله A11y را با DateRangePicker که در آن عنوان متن ماه به عنوان عملی برای خواننده صفحه نمایش ، دسترسی به سوئیچ و کاربران دسترسی صوتی منتقل شده است ، برطرف کنید. ( I2AC55 )
• رفع اشکال Param Param mediumTopAppBarColors ثابت. ( ibe64a )

نسخه 1.2

نسخه 1.2.1

6 مارس 2024

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

رفع اشکال

• حالت های کشویی را دوباره پایدار کنید. ساخت State.onValueChangeFinished . بسته بندی onValueChangeFinished در یک rememberUpdatedState . ( IE8FD0 ، B/322269951 )
• از زمان تغییر state.onValueChangeFinished از var Slider @Stable می شود. ( i82ba1 ، b/322269951 )
• برای کپی کردن از پیش فرض ، رنگهای سفارشی NavigationBar برطرف کنید. ( 80a779 ، b/326894020 )
• رفع رگرسیون در ExposedDropdownMenu برای دوباره تمرکز آن ( 3FCEC1 ، B/323694447 )
• مشکل ذخیره سازی رنگ دکمه ( 3E5BBC B/327371655 )

نسخه 1.2.0

7 فوریه 2024

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

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

• یک اشکال رندر بین المللی با نمای در PrimaryTabRow به عنوان بخشی از تغییر بهبود عملکرد معرفی شد. راه حل استفاده از TabRow با TabRowDefaults.PrimaryIndicator است

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

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

• بکشید تا تازه شود
  • PulltoreFreshContainer
  • پله
• دکمه تقسیم شده
  • قطعه قطعه شده
  • singlechoicesedbittonrow
  • چندگانه

پیشرفت به طراحی مواد موجود 3 مؤلفه.

• نوار برنامه پایین (تراز RTL ، مخفی خودکار در پیمایش)
  • Bottomappbarscrollbehavior
• به روزرسانی بصری زبانه
  • رهبر اصلی
  • ثانویه
• نشان (به روزرسانی تراز)

API های تجربی را به ثبات!

بهبود عملکرد

• لطفاً برای اطلاعات بیشتر به این پست وبلاگ مراجعه کنید!

نسخه 1.2.0-rc01

24 ژانویه 2024

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

رفع اشکال

• رفع اشکال Param Param mediumTopAppBarColors ثابت. ( ibe64a )
• رفع اشکال معرفی شده در 1.2.0-beta02 در CardDefaults.cardColors که contentColor بر اساس مقدار param containerColor به روز نکرد. ( IEE041 ، b/319671246 )
• رفع اشکال در disabledContentColor در 1.2.0-beta02 معرفی شد و بهینه سازی کمی اضافه کرد. ( i6dda1 ، b/318428829 )

نسخه 1.2.0-beta02

10 ژانویه 2024

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

اشکال شناخته شده

• یک اشکال در IconButtonColors به ​​طور پیش فرض disabledContentColor به جای contentColor مشخص شده توسط کاربر ، به یک آلفا (0.38F) از LocalContentColor اختصاص می دهد. راه حل این است که صریحاً disabledContentColor را تنظیم کنید. این در نسخه بعدی ثابت خواهد شد.

تغییرات API

• افزودن قابلیت فعال کردن CADETS TOOLTIP برای API های Tooltip ساده. ( IBF767 )
• SwipeToDismissState ، rememberSwipeToDismiss wipetodismiss و SwipeToDismissValue همه به آنها تغییر نام داده اند تا _SwipeToDismissBox_ داشته باشند. ( i68d6d )

رفع اشکال

• مقدار ثابت ListItem PADDING برای تراز کردن با مشخصات. ( IBD68B ، B/305342674 )
• رنگ رئوس مطالب برای کارت مشخص شده اکنون به درستی نقشه برداری شده است تا به OutlineVariant . ( I75480 ، B/310979715 )
• رنگ پویا اکنون از نقش های رنگی تعریف شده سیستم بیرون می آید. این تضاد را برای محتوای در دسترس بهبود می بخشد و رنگ پویا را با مشخصات مواد نزدیک تر می کند. ( i1de96 )
• دست زدن به پشتی ModalBottomSheet بر روی Android T/13+ هنگام android:enableOnBackInvokedCallback="true" . ( I728DC ، B/306196110 )

نسخه 1.2.0-beta01

13 دسامبر 2023

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

تغییرات API

• Mark TabIndicatorScope به عنوان تجربی. ( i45c88 )
• از بین بردن API های تجربی مستهلک برای ابزار ابزار. ( i438cb )
• بیش از حد جدید TabRow تغییر دهید تا از زیر مجموعه استفاده نکنید. این امر به روشی متفاوت برای ساخت شاخص های TabRow با اصلاح کننده های سفارشی ارائه شده منجر می شود. ( IFE741 )
• Deprecate DismissDirection و DismissValue API. اینها با SwipeToDismissValue ادغام شده اند ، که مقادیر آن نشان دهنده موقعیت و جهت SwipeToDismissBox است. DismissState.progress اکنون به عنوان یک FloatRange بین 0.0 تا 1.0 مشخص شده است. Saver و سازنده مستهلک شده DismissState حذف شده است. مؤلفه SwipeToDismiss ، حالت و پیش فرض به عنوان تجربی مورد توجه قرار گرفته است. ( IB54F2 )

رفع اشکال

• نشانگر پیش فرض PullToRefresh اکنون به جای یک مثلث جامد ، یک فلش باز است. ( i67be3 )

نسخه 1.2.0-alpha12

29 نوامبر 2023

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

تغییرات API

• RangeSlider اکنون به جای یک کلاس با ارزش FloatRange سفارشی ، یک محدوده Kotlin (به عنوان مثال ، 0f..1f ) می گیرد. SnapFlingBehavior.kt هم اکنون از محدوده کوتلین نیز استفاده می کند. ( i025cb )
• توابع کارخانه اصلاح کننده را به عنوان @Stable انجام دهید. ( IB109F )

نسخه 1.2.0-alpha11

15 نوامبر 2023

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

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

• پیاده روی PullToRefreshContainer و PullToRefreshState ، که در کنار هم می توانند یک حرکت را برای تازه کردن اجرای در مواد 3 فراهم کنند. ( i16456 ، b/261760718 )

تغییرات API

• SwipeToDismissBox DismissDirection علامت گذاری کنید و به عنوان تجربی DismissValue . ( i517b0 )
• تغییر نام SwipeToDismiss به SwipeToDismissBox . background به backgroundContent تغییر نام دهید و به دنبال content لامبدا dismissContent . ( i7f4d3 )
• سازنده را برای ChipElevation و SelectableChipElevation عمومی انتخاب کنید. ( IE0C48 ، B/308432421 )
• افزودن ModalBottomSheetProperties . انتقال securePolicy به ModalBottomSheetProperties . افزودن isFocusable و shouldDismissOnBackPress به ModalBottomSheetProperties . این Booleans جدید به تعیین چگونگی رسیدگی به ورق پایین معین باید با وقایع IME کمک کند. ( IEA56F ، B/278216859 )
• دامنه های RangeSlider و Slider به روز شده برای حذف initialOnValueChange ، پیشوندهای اولیه و KDOC های مناسب. ( I57D30 )
• کلاس ChipBorder و تماس های عملکرد مرتبط با آن ، استفاده از BorderStroke مستقیماً به جای آن توصیه کنید. ( i89cc2 )
• API های بنیاد Tooltip اکنون @ExperimentalFoundationApi هستند. ( i30b0b )
• TabRow و ScrollableTabRow دیگر مستهلک نمی شوند. انواع جدید و ثانویه جدید به عنوان تجربی مشخص شده اند. ( i0def6 )
• تراشه های فیلتر و ورودی اکنون به طور مستقیم BorderStroke استفاده می کنند. ( i07a8d )
• SegmentedButton اکنون از BorderStroke مستقیم استفاده می کند. ( i89b9b )
• تابع AlertDialog عمومی را به BasicAlertDialog تغییر نام داد و عملکرد قبلی را کاهش داد. ( idbe52 )
• تغییر نام API های SwipeToDismiss به SwipeDismiss ، و ارتقاء API های جدید SwipeDismiss را به ثبات. ( i14cbe )
• افزودن tonalElevation و shadowElevation به API های Tooltip. علاوه بر این ، حرکت TooltipBox ، PlainTooltip و RichTooltip API به آزمایشی بازگشتند زیرا به طور تصادفی به عنوان پایدار آزاد شدند. ( IF0F66 ، B/293939035 )
• API های تراشه آزمایشی را به ثبات ارتقا دهید. ( IEA2C3 )
• حاشیه نویسی @ExperimentalMaterial3Api را از کارتهای قابل کلیک Material3 حذف کرد. ( i88dbf )

رفع اشکال

• مسئله ای را برطرف کرد که SwipeToDismiss در سناریوهای خاصی با طرح های تو در تو و چیدمان های تنبل خراب می شود. ( ICA8D1 ، B/297226562 )

نسخه 1.2.0-alpha10

18 اکتبر 2023

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

تغییرات API

• تبلیغ Badge و BadgedBox به پایدار. ( i67f16 ، b/261565132 )
• اضافه کردن securePolicy به عنوان یک پارامتر به ModalBottomSheet ، بنابراین کاربران می توانند رفتار WindowManager.LayoutParams.FLAG_SECURE را تعریف کنند. ( ICDAC8 ، B/296250262 )
• اضافه بارهای جدید از LinearProgressIndicator و CircularProgressIndicator که به عنوان یک لامبدا progress می کند ، اضافه شد. اینها باید نسبت به نسخه های قبلی عملکرد بیشتری داشته باشند. ( i824e6 ، b/295616656 )
• StandardSizeClasses به AllSizeClasses تغییر نام دهید. ( i8cb07 )
• توابع محاسبه کلاسهای اندازه پنجره را ترکیب کنید. ( IAD935 )

رفع اشکال

• هنگامی که ماه نمایش داده شده در حاشیه محدوده مجاز سالها قرار دارد ، یک تصادف DatePicker را برطرف کنید. ( I46F36 ، B/290954897 ، B/297002119 )
• [NAV RAIL/BAR] از رنگ شفاف برای نشانگر پشتیبانی می کند. ( IE0A9B ، B/267289987 )

نسخه 1.2.0-alpha09

4 اکتبر 2023

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

تغییرات API

• ModalNavigationDrawer و DismissibleNavigationDrawer برای استفاده از API های جدید AnchoredDraggable مهاجرت کرده است. animateTo DrawerState با روش های باز و بسته جایگزین شده است و افست اکنون به جای یک شیء حالت ، به عنوان شناور در معرض دید قرار می گیرد. می توانید مستقیماً از طریق currentOffset به افست دسترسی پیدا کنید. ( i0a72c )
• توابع غیر قابل مقایسه برای ایجاد مستقیم DatePickerState و DateRangePickerState اضافه شده است. این توابع می توانند به عنوان جایگزینی برای ترکیبات rememberDatePickerState و در صورت لزوم توابع را rememberDateRangePickerState . ( i70326 ، b/291524052 )
• TabRows ثابت و قابل پیمایش اکنون دارای انواع اولیه و ثانویه هستند. اینها به درستی به رفتار رنگ و نشانگر همانطور که در مواد 3 تعریف شده است ، نقشه می کنند.
• PrimaryScrollableTabRow و SecondaryScrollableTabRow اکنون وضعیت پیمایش را در معرض دید قرار می دهد. ( IEC8F5 ، B/260572337 )
• اضافه کردن یک پارامتر جدید sheetMaxWidth که توسعه دهندگان می توانند تنظیم کنند تا حداکثر عرض را مشخص کنند که ورق آن باشد. اگر برگه ای که کل عرض صفحه را شامل می شود ، می توان DP.Unspecified را برای پارامتر منتقل کرد. ( IFB7C9 ، B/266697696 )
• اضافه کردن API های PlainTooltipBox و RichTooltipBox به عنوان روشهای مستهلک. ( i246fa )

رفع اشکال

• هنگامی که DatePicker با یک DatePickerFormatter شروع می شود که دارای اسکلت های تاریخ خاصی است که هنگام تبدیل به الگوهای تاریخ (مانند YY) یکسان هستند ، یک تصادف را برطرف کنید. ( I01F29 )

نسخه 1.2.0-alpha08

20 سپتامبر 2023

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

تغییر رفتار

• ColorScheme اکنون تغییر ناپذیر است و باعث می شود به روزرسانی های رنگ فردی کارآمدتر شود ، اما استفاده متداول تر از رنگ ها را کارآمدتر می کند. دلیل این تغییر این است که اکثر برنامه‌ها به‌روزرسانی رنگ‌های جداگانه را به عنوان یک مورد استفاده اصلی ندارند. این هنوز هم امکان پذیر است ، اما بیشتر از گذشته بازخوانی خواهد کرد ، به نوبه خود ما به طور قابل توجهی میزان اشتراک های حالت را از طریق تمام کد مواد کاهش می دهیم و بر اولیه سازی و هزینه زمان اجرای موارد استفاده استاندارد تأثیر می گذارد. ( IC447D ، B/297212873 )
• ارتفاع تونال دیگر در حالتهای مختلف تعامل برای مطابقت با مشخصات متحرک نیست. ( ICDD12 )

تغییرات API

• یک BottomAppBar جدید اضافه شده است که به عنوان پارامتر به عنوان یک پارامتر یک BottomAppBarScrollBehavior می گیرد تا هنگام چاپ محتوا ، آن را مخفی کند. همچنین به FabPosition.EndOverlay اضافه شده است که به FAB اجازه می دهد تا به جای لنگر انداختن بالای آن ، نوار برنامه پایین را در داربست پوشانده باشد. ( IECB47 )
• یک مؤلفه برچسب ساده اضافه کرد که در بالای BasicTooltipBox ساخته شده است که هنگام ضربه زدن به خارج از محدوده برچسب ، برکنار نخواهد شد. ( i821f9 )

رفع اشکال

• استفاده از rememberSaveable برای وسایل ابزار را حذف کرد. ( ICC131 ، B/299500338 )
• یک پرچم موقت برای کنترل اینکه آیا Scaffold باید فرزندان خود را در حین اندازه گیری یا در حین قرار دادن اندازه گیری کند، معرفی کرد. به طور پیش فرض، این در اندازه گیری اندازه گیری می شود. اگر در رابطه با رفتار جدید با مشکلاتی روبرو هستید، لطفاً مشکلی را ثبت کنید. ( I0B354 )
• با استفاده از اندازه گیری صحیح برای عرض صفحه دستگاه ، لبه افقی را به لبه در BottomSheet ثابت ثابت کنید. ( i1df0c ، b/299058752 )
• رفع اشکال در جایی که ModalBottomSheet هنگام اخراج آن با کشیدن روی ورق ، از onDismissedRequest استفاده نمی کرد. ( IDFDD8 )

نسخه 1.2.0-alpha07

6 سپتامبر 2023

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

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

• پشتیبانی از آیکون های آینه خودکار در compose material 1.6.0-alpha05 اضافه شده است ، لطفاً برای جزئیات بیشتر در مورد نمادهای آینه خودکار ، به یادداشت های انتشار مراجعه کنید.

تغییرات API

• SliderState DraggableState را پیاده سازی می کند ( I9B116 )
• تغییر شکل را به یک پارامتر مورد نیاز تغییر دهید. تغییر نام position به index در عملکرد یاور شکل. ( i34941 )
• به روزرسانی The DatePicker formatWithSkeleton برای شامل نقشه ای که به عنوان حافظه نهان برای بهبود عملکرد استفاده می شود. ( i3195f )
• BasicTooltipBox به compose.foundation اضافه کرده است. Foundation و به روز شده PlainTooltipBox و RichTooltipBox برای استفاده از TooltipBox با ترکیبات جدید PlainTooltip و RichTooltip . ( i79e1d )

رفع اشکال

• dynamicLightColorScheme و dynamicDarkColorScheme اکنون رنگ های کروما بالاتر را برای نقش های سطح و surfaceContainer برمی گردانند. ( i5e901 )
• مشکلی را برطرف کرد که در آن برخی از مؤلفه‌ها با استفاده از Subcomposition (مثلاً BottomSheetScaffold ) در داخل یک داربست در یک LookaheadScope سعی داشتند اندازه خود را خیلی زود بخوانند. ( I297B4 ، I871F1 ، B/295536718 )

نسخه 1.2.0-alpha06

23 آگوست 2023

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

رفع اشکال

• محاسبه offset DropdownMenu ثابت شد، بنابراین افست های x صرفاً به جهت طرح بندی محلی بستگی دارد، و زمانی که منو نزدیک به پایین صفحه باشد، افست های y دیگر برعکس نمی شوند. ( Iccc74 , b/294103942 )
• محاسبه offset DropdownMenu ثابت شد، بنابراین افست های x صرفاً به جهت طرح بندی محلی بستگی دارد، و زمانی که منو نزدیک به پایین صفحه باشد، افست های y دیگر برعکس نمی شوند. ( IB87A2 ، B/294103942 )

نسخه 1.2.0-alpha05

9 آگوست 2023

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

تغییرات API

• به روزرسانی در کادر انتخاب و رنگ های TriStateCheckbox . CheckboxDefaults.colors() disabledUncheckedColor اکنون فقط بر مرز کادر تأیید تأثیر می گذارد. موارد خاصی که شما را ملزم به تنظیم رنگ جعبه داخلی در هنگام غیرفعال کردن و بررسی نشده نیاز دارید ، به یک نمونه ساخته شده سفارشی از یک CheckboxColors با مقادیر رنگی مورد نظر نیاز دارد. ( I77D17 ، B/291943198 )

نسخه 1.2.0-alpha04

26 جولای 2023

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

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

• دکمه تقسیم بندی شده آزمایشی API ( IFC8FB )
• تقسیم کنندگان اکنون پارامتر برای کنترل جهت گیری برای پشتیبانی از تقسیم کننده های عمودی دارند. ( i4c899 ، b/288438593 )

تغییرات API

• ما وابستگی چگالی را به سطح جزء منتقل می کنیم. این برای مؤلفه‌های زیر اعمال می‌شود: SwipeToDismiss و مؤلفه‌های مبتنی بر برگه. لطفاً از اضافه بار جدید ارائه شده در جایی که چگالی یک پارامتر است استفاده کنید. ( I1846e )
• حاشیه نویسی های اضافی برای مشخص کردن ورودی های مجاز به ترکیبات ( IEF234 )
• یک پارامتر نماد را به دکمه تقسیم بندی شده اضافه کنید ، معانی تقسیم شده به طوری که دکمه های تقسیم شده می توانند برای اجرای تک انتخاب و قابل انتخاب برای اجرای چند انتخابی ، با انتخاب SelectableSegmentedButtonRow و ToggelableSegmentedButtonRow انتخاب شوند. ( i38740 )
• تقسیم کننده به HorizontalDivider تغییر نام داده است. عملکرد VerticalDivider اضافه شده است. ( i5975c )
• استفاده از ClosedFloatingPointRange را برای FloatRange وزن سبک تر در API های آزمایشی 3 تغییر دهید تا به حداقل برسد. ( i4aab5 )
• تراز شروع جدید برای FabPosition اضافه شد ( Ib7aea , b/170592777 )

رفع اشکال

• ModalBottomSheet به جهت طرح محلی احترام می گذارد. ( IB4F44 ، B/285628622 )

نسخه 1.2.0-alpha03

21 ژوئن 2023

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

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

• includeFontPadding اکنون به طور پیش فرض در تایپوگرافی مواد 3 false است. سبک ارتفاع خط پیش‌فرض نیز به Trim.None و Alignment.Center تغییر یافته است و lineHeight صریح (در sp) به TextStyle Typography اضافه شده است. اگر می‌خواهید این مقادیر را سفارشی کنید، با اسناد API مشورت کنید و برای توضیح عمیق این تغییرات ، پست وبلاگ را ببینید. ( i6266f ، ICABC3 )

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

• اضافه بار اضافه شده برای RangeSlider که نسخه ای از این مؤلفه است. ایجاد شده RangeSliderState که تمام اطلاعات مربوط به مسیر فعال فعلی ، اندازه گیری اجزای RangeSlider و منطق کشیدن و ژست را در خود جای داده است. ( i8c270 )
• نوار جستجو اکنون سایه ها را از طریق پارامتر تازه اضافه شده shadowElevation پشتیبانی می کند. ( IA5369 ، B/271040353 )
• ColorScheme اکنون از نقش های جدید SurfaceContainer پشتیبانی می کند.
• روکش ارتفاع تونال سطح هم اکنون می تواند با ترکیب محلی محلی LocalTonalElevationEnabled غیرفعال شوند. ( IC203C ، B/277774590 )

تغییرات API

• سازه های Component Colors را باز کنید. ( i8c4a6 )
• اضافه کردن پارامتر قابل تمرکز به هر دو API Tooltip ، به طوری که توسعه دهندگان می توانند از برنامه های لمسی استفاده کنند یا نه. محتاط باشید که این ممکن است دسترسی را به صورت خودکار متمرکز کند. ( IE32D8 )
• دسترسی بهینه شده برای عملکرد و تخصیص حافظه. ( Iede48 )
• DefaultSizeClasses در معرض نمایش قرار دهید و StandardSizeClasses برای WindowSizeClasses ایجاد کنید ( I91838 )
• WindowWidth/HeightSizeClass به کلاس های ارزش شناور تغییر دهید ( IE686E )

رفع اشکال

• پارامتر contentWindowInsets WindowInsets در حال حاضر به پنجره های مصرف شده احترام می گذارد. توجه داشته باشید که رفتار بالشتک محتوا بر اساس topBar و bottomBar هنگام ارائه این پارامترها بدون تغییر باقی می ماند. ( I08B73 ، B/264601542 )
• برای اطمینان از اینکه یک عنوان طولانی از روی نمادهای عمل یا نماد ناوبری ارائه نمی شود ، تراز نوار برنامه اصلی را برطرف کنید. ( i4369f ، b/236994621 )
• موقعیت های برگه اکنون حداقل عرض محتوای 24.dp را اجرا می کنند. این یک هدف لمسی در دسترس برای شاخص های برگه فراهم می کند. ( id8861 )
• پالت های رنگی پویا از dynamicLightColorScheme و dynamicDarkColorScheme اکنون از نقش های سطح جدید پشتیبانی می کنند. ( i1252e )
• به روزرسانی تراز اعلان نشان به کلیپ هنگام برخورد با پدربزرگ و مادربزرگ. ( IDF75a )

نسخه 1.2.0-alpha02

24 مه 2023

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

تغییرات API

• پارامتر Insets Window را به ModalBottomSheet اضافه کنید.
  • Scrim for ModalBottomSheet اکنون ممکن است در پشت نوار وضعیت با windowInsets تنظیم شده روی صفر ترسیم شود
  • عملکرد پیش فرض ModalBottomSheet برای ماندن در خارج از میله های سیستم از جمله ناوبری
  • استفاده از نوار نوار وضعیت توسط Drag Handle در حالت لبه به لبه ارائه می شود.
  • BottomSheetDefaults شامل قسمتهای پنجره ای برای BottomSheetWindow است. ( i31200 ، b/274872542 ، b/272973615 ، b/272334475 ، b/268432129 ، b/275849044 ، b/275486106 ، b/268433162 )
• Indicator را Primary داده و برای مطابقت با مشخصات SecondaryIndicator اضافه کنید. PrimaryIndicator با عرض محتوای برگه مطابقت دارد در حالی که SecondaryIndicator عرض کامل موجود را در بر می گیرد. SecondaryIndicator معادل Indicator اکنون کاهش یافته است و می تواند یک جایگزین مستقیم باشد. ( I27604 )
• برای کنترل وضعیت اسکرول عمودی آیتم های منوی نمایش داده شده، گزینه ای برای عبور در یک ScrollState هنگام ساخت یک DropdownMenu یا یک ExposedDropdownMenu اضافه شده است. ( IA0734 ، B/185304441 )
• اضافه بار برای Slider که نسخه ای از مؤلفه است. SliderState ایجاد شده است که تمام اطلاعات مربوط به مسیر فعال فعلی ، اندازه گیری اجزای Slider و منطق کشیدن و ژست را در خود جای داده است. ( i124a5 )
• تغییر نام ویژگی Semantics isContainer به isTraversalGroup ( I121f6 )
• TextStyle.merge(...) بهینه شده با لیست پارامترهای کامل اضافه شد. ( Iad234 , b/246961787 )
• رابط های عمومی Made TooltipState ، RichTooltipState و PlainTooltipState . RichTooltipStateImpl و PlainTooltipStateImpl برای ایالات پیش فرض اضافه شد. اضافه شده remember*State برای به دست آوردن این کشورهای اجرا شده. حذف TooltipSync به نفع یک TooltipDefault.GlobalMutatorMutex . ( i7813d )
• DatePickerColors را به روز کرد تا گزینه های سفارشی سازی اضافی را برای رنگ های تقسیم کننده ، ناوبری و زمینه های ورودی متنی شامل رنگ های مختلف قرار دهد. ( i1a685 ، b/274626815 )
• DatePickerState و DateRangePickerState اکنون رابط های عمومی با پیاده سازی های پیش فرض هستند که می توانند توسط rememberDatePickerState و rememberDateRangePickerState . ( i71c52 )
• dateValidator از DatePicker و DateRangePicker حذف کرده و یک رابط SelectableDates معرفی کرد که می تواند در حالت تنظیم شود تا کنترل کند کدام تاریخ یا سالها در UI قابل انتخاب است. ( IC2FC6 )
• TimePicker که از API پایدار حذف شده است ، تغییرات بیشتری در API ایالتی ( I3F39A ) پیش بینی می شود
• ModalBottomSheet فقط به Android منتقل شد. ModalBottomSheet برای استفاده از دسک تاپ توصیه نمی شود و عملکرد به طور فعال حفظ نمی شود. ( IB3778 )

رفع اشکال

• عمل رد کردن AlertDialog را برطرف کرد تا زمانی که کنش‌ها روی هم قرار می‌گیرند تا در عرض گفتگو قرار گیرند، در زیر عمل تأیید ظاهر شود. این اصلاح پیاده سازی را با مشخصات طراحی متریال هماهنگ می کند. ( I029de , b/235454277 )
• اشکال ثابت در ListItem با استفاده از بالشتک نادرست برای موارد سه خط. ( i6e235 )
• ModalBottomSheet اکنون می تواند صفحه کلید IME را نمایش دهد ( IDC508 ، B/262140644 ، B/268380384 ، B/272483584 )

نسخه 1.2.0-alpha01

10 مه 2023

androidx.compose.material3:material3:1.2.0-alpha01 و androidx.compose.material3:material3-window-size-class:1.2.0-alpha01 منتشر می شود. نسخه 1.2.0-alpha01 حاوی این commit ها است.

نسخه 1.1

نسخه 1.1.2

20 سپتامبر 2023

androidx.compose.material3:material3:1.1.2 و androidx.compose.material3:material3-window-size-class:1.1.2 منتشر می شود. نسخه 1.1.2 شامل این تعهدات است.

رفع اشکال

• اصلاح کننده ثابت به طور نادرست به دو ترکیب منتقل می شود. ( b/282761472 )
• ثابت TimePickerState ساعت های نادرست را با 23 ساعت آغاز می کند. ( b/278242122 )
• اصلاحات اولیه ضامن برای ظهر و اعتبار سنجی دقیقه. ( b/269768197 ، b/282790635 )
• state.hour ثابت. بازگشت مقدار نادرست برای 11:00. ( b/282761472 ، b/278242122 )

نسخه 1.1.1

21 ژوئن 2023

androidx.compose.material3:material3:1.1.1 و androidx.compose.material3:material3-window-size-class:1.1.1 منتشر می شود. نسخه 1.1.1 حاوی این commit ها است.

رفع اشکال

• برای سازگاری باینری ، تماس با ModalBottomSheet بدون windowInset Param اضافه می کند. ( IB7959 )
• پارامتر Insets Window را به ModalBottomSheet اضافه کنید.
  • Scrim for ModalBottomSheet اکنون ممکن است در پشت نوار وضعیت با windowInsets تنظیم شده روی صفر ترسیم شود
  • عملکرد پیش فرض ModalBottomSheet برای ماندن در خارج از میله های سیستم از جمله ناوبری
  • استفاده از نوار نوار وضعیت توسط Drag Handle در حالت لبه به لبه ارائه می شود.
  • BottomSheetDefaults شامل قسمتهای پنجره ای برای BottomSheetWindow است. ( i31200 ، b/274872542 ، b/272973615 ، b/272334475 ، b/268432129 ، b/275849044 ، b/275486106 ، b/268433162 )

نسخه 1.1.0

10 مه 2023

androidx.compose.material3:material3:1.1.0 و androidx.compose.material3:material3-window-size-class:1.1.0 منتشر می شود. نسخه 1.1.0 حاوی این commit ها است.

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

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

• ورق های پایین
  • برگه modalbottomshe ، پایین صفحه
• خرماچیان
  • DatePicker ، DaterangePicker ، DatePickerdialog
• جستجو کنید
  • نوار جستجو ، dockedsearchbar
• سوسپتودیسم
• انتخاب کنندگان زمان
  • TimePicker
  • دوره زمانی
• نکات ابزار
  • Plaintooltipbox ، Richtooltip

پیشرفت به طراحی مواد موجود 3 مؤلفه.

API های تجربی را به ثبات!

لطفاً برای اطلاعات بیشتر به این پست وبلاگ مراجعه کنید!

نسخه 1.1.0-rc01

19 آوریل 2023

androidx.compose.material3:material3:1.1.0-rc01 و androidx.compose.material3:material3-window-size-class:1.1.0-rc01 منتشر می شود. نسخه 1.1.0-rc01 حاوی این commit ها است.

تغییرات API

• TimePicker که از API پایدار حذف شده است ، تغییرات بیشتری در API ایالتی ( I3F39A ) پیش بینی می شود
• ModalBottomSheet فقط به Android منتقل شد. ModalBottomSheet برای استفاده از دسک تاپ توصیه نمی شود و عملکرد به طور فعال حفظ نمی شود. ( IB3778 )

نسخه 1.1.0-beta02

5 آوریل 2023

androidx.compose.material3:material3:1.1.0-beta02 و androidx.compose.material3:material3-window-size-class:1.1.0-beta02 منتشر می شود. نسخه 1.1.0-beta02 حاوی این تعهدات است.

تغییرات API

• SheetState اکنون پارامتر skipHiddenState اختیاری دارد
• rememberStandardBottomSheetState اکنون پارامتر skipHiddenState اختیاری دارد
• BottomSheetScaffold اکنون یک لنگر پنهان مشخص دارد ، اگرچه به طور پیش فرض غیرفعال است
• مستندات SheetState.requireOffset به روز شده است
• BottomSheetDefaults.MinimizedShape به عنوان BottomSheetDefaults.HiddenShape ( i839f4 ، b/273870234 ) تغییر نام داده است

رفع اشکال

• هنگام فعال شدن اکتشاف لمسی ، شماره گیری را از ساعت به دقیقه تغییر ندهید. ( I717D0 )
• معناشناسی دستگیره ModalBottomSheet و BottomSheetScaffold Drag Handle در حال حاضر ادغام شده اند. ( I05AFB )
• پارامترهای اصلاح کننده BottomSheetScaffold ، containerColor و contentColor اکنون فقط بر محتوا تأثیر می گذارد. ( i992cb )
• BottomSheetScaffold nestedScroll برای محتوای ورق اکنون در حال اجرا است. ( i992cb )

نسخه 1.1.0-beta01

22 مارس 2023

androidx.compose.material3:material3:1.1.0-beta01 و androidx.compose.material3:material3-window-size-class:1.1.0-beta01 منتشر می شود. نسخه 1.1.0-beta01 حاوی این تعهدات است.

تغییرات API

• اضافه کردن نوع چیدمان پارامتری به TimePicker Composable. 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 )

نسخه 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. نسخه 1.1.0-alpha06 حاوی این commit ها است.

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

• 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 )
• گیرنده ویژگی بازیابی LocalMinimuTouchTargetEnforcement و علامت گذاری آن به عنوان منسوخ شده و هدایت به LocalMinimumInteractiveComponentEnforcement . ( I60dd5 )

نسخه 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. نسخه 1.1.0-alpha05 حاوی این commit ها است.

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

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

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

• Compose UI and Compose Material now depend on Lifecycle 2.6.0 .

نسخه 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. نسخه 1.1.0-alpha04 حاوی این commit ها است.

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

• 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

• در ویژگی معنایی IsContainer در Surfaces اضافه شده است. این ویژگی در تغییر بعدی استفاده خواهد شد که ترتیب پیمایش را بر اساس معنای معنایی عناصری مانند سطوح تعیین می کند. ( I63379 )
• Mark navigation drawer related APIs as stable. ( Iab01e , b/261439597 )
• یک پارامتر رنگ مسیر برای نشانگرهای پیشرفت دایره ای، و یک پارامتر سرپوش برای هر دو شاخص پیشرفت دایره ای و خطی اضافه شده است. ( Ie668c , b/216325962 , b/222964817 )
• تهی پذیری بیشتر نوع بازگشت توابع منسوخ-مخفی ( Ibf7b0 )
• Modifier.minimumInteractiveComponentSize اضافه کنید. اگر عنصر کوچکتر باشد، می توان از آن برای رزرو حداقل 48.dp در اندازه برای رفع ابهام از تعاملات لمسی استفاده کرد. ( I33f58 , b/258495559 )
• Added experimental API for AlertDialog composable that has a content slot. ( Iec4a2 )

رفع اشکال

• پیشرفت برای شاخص های پیشرفت اکنون به درستی به محدوده مورد انتظار آن محدود شده است. ( I8a7eb , b/262262727 )

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

• هنگام به‌روزرسانی از androidx.compose.foundation:1.4.0-alpha03 به androidx.compose.foundation:1.4.0-alpha04 ، ممکن است با خطای java.lang.NoSuchFieldError مواجه شوید. اینجا جایی است که موضوع در ابتدا گزارش شده است. اصلاحی ارسال شده است و در به‌روزرسانی بعدی Compose در دسترس خواهد بود. به عنوان یک کار، کتابخانه های androidx.compose.material و androidx.compose.material3 خود را به آخرین نسخه (1.1.0-alpha04) به روز کنید یا androidx.compose.foundation خود را به 1.4.0-alpha03 تنزل دهید.

نسخه 1.1.0-alpha03

7 دسامبر 2022

androidx.compose.material3:material3:1.1.0-alpha03 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha03 are released. نسخه 1.1.0-alpha03 حاوی این commit ها است.

تغییرات 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 )
• یک Modifier API برای جستجوی اطلاعات اسکرول اجداد اضافه شده است. ( I2ba9d , b/203141462 )
• در Clickable برای به تأخیر انداختن صحیح تعاملات مطبوعاتی استفاده می‌شود، زمانی که حرکات ممکن است به رویدادهای پیمایش تبدیل شوند.
• هنگامی که در داخل یک Scrollable ViewGroup استفاده می شود، Clickables کلیکی ثابت شد که امواج را به درستی به تاخیر نمی اندازند.
• کشوها و برگه‌ها برای تأخیر صحیح فشارها در صورتی که حرکات ممکن است به رویدادهای پیمایش تبدیل شوند، به‌روزرسانی شدند.

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

• Compose UI و Compose Material اکنون به Lifecycle 2.5.1 بستگی دارد. ( I05ab0 , b/258038814 )

نسخه 1.1.0-alpha02

9 نوامبر 2022

androidx.compose.material3:material3:1.1.0-alpha02 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 are released. نسخه 1.1.0-alpha02 حاوی این commit ها است.

تغییرات API

• awaitFirstDown and waitForUpOrCancellation now accept a PointerEventPass for greater flexibility (also fixes ExposedDropdownMenuBox showing a menu while scrolling).( I7579a , b/212091796 )
• اضافه شدن پارامتر minLines به متریال و متریال3 Text، TextField و OutlinedTextField که امکان تنظیم حداقل ارتفاع جزء بر حسب تعداد خطوط را فراهم می کند ( I4af1d )
• Deprecate the TopAppBarDefaults smallTopAppBarColors function in favor of a new topAppBarColors function that should be used when creating a TopAppBar . ( Ie6cb9 )
• پارامتر minLines به BasicText و BasicTextField اضافه شد. این اجازه می دهد تا حداقل ارتفاع این ترکیبات را از نظر تعداد خطوط تنظیم کنید ( 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 )

نسخه 1.1.0-alpha01

24 اکتبر 2022

androidx.compose.material3:material3:1.1.0-alpha01 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 are released. نسخه 1.1.0-alpha01 حاوی این commit ها است.

رفع اشکال

• Fixes to the top app bar when title is applied with a TextStyle and a Brush. ( If667e )

نسخه 1.0

نسخه 1.0.1

9 نوامبر 2022

androidx.compose.material3:material3:1.0.1 and androidx.compose.material3:material3-window-size-class:1.0.1 are released. نسخه 1.0.1 حاوی این commit ها است.

رفع اشکال

• Updates Material3 Medium and Large top app bars to apply the same background color across their entire surface, and to allow setting overriding the default colors with transparent color values. ( I67659 , b/249688556 , b/250838918 )

نسخه 1.0.0

24 اکتبر 2022

androidx.compose.material3:material3:1.0.0 and androidx.compose.material3:material3-window-size-class:1.0.0 are released. نسخه 1.0.0 حاوی این commit ها است.

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

This is the first stable release of Compose Material 3!

Material Design 3 theming and Material You dynamic color

• MaterialTheme
• رنگ
  • ColorScheme
  • lightColorScheme , darkColorScheme
• Dynamic color
  • dynamicLightColorScheme , dynamicDarkColorScheme
• تایپوگرافی
  • تایپوگرافی
• اشکال
  • اشکال

Material Design 3 components

• نشان
  • Badge , BadgedBox
• Bottom App Bar
  • BottomAppBar
• دکمه ها
  • Button , ElevatedButton , FilledTonalButton , OutlinedButton , TextButton
• FAB and extended FAB
  • SmallFloatingActionButton , FloatingActionButton , LargeFloatingActionButton , ExtendedFloatingActionButton
• کارت ها
  • Card , OutlinedCard , ElevatedCard
• چک باکس
  • چک باکس
• چیپس
  • AssistChip , ElevatedAssistChip , FilterChip , ElevatedFilterChip , InputChip , SuggestionChip , ElevatedSuggestionChip
• دیالوگ ها
  • AlertDialog
• تقسیم کننده
  • تقسیم کننده
• منوی کشویی
  • DropdownMenu , DropdownMenuItem , ExposedDropdownMenuBox
• فهرست کنید
  • List Item
• نوار ناوبری
  • نوار ناوبری
• کشوی ناوبری
  • ModalNavigationDrawer , ModalDrawerSheet , DismissibleNavigationDrawer , DismissibleDrawerSheet , PermanentNavigationDrawer , PermanentDrawerSheet
• ریل ناوبری
  • NavigationRail
• شاخص پیشرفت
  • CircularProgressIndicator , LinearProgressIndicator
• دکمه رادیو
  • RadioButton
• لغزنده
  • Slider , RangeSlider
• سوئیچ
  • سوئیچ
• زبانه ها
  • Tab , LeadingIconTab , TabRow , ScrollableTabRow
• فیلدهای متنی
  • TextField , OutlinedTextField
• نوار برنامه بالا
  • TopAppBar , CenterAlignedTopAppBar , MediumTopAppBar , LargeTopAppBar
• نماد
  • Icon , IconButton
• متن
  • متن
• سطح
  • سطح
• طرح بندی
  • داربست
• Content color
  • LocalContentColor

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!

نسخه 1.0.0-rc01

5 اکتبر 2022

androidx.compose.material3:material3:1.0.0-rc01 and androidx.compose.material3:material3-window-size-class:1.0.0-rc01 are released. نسخه 1.0.0-rc01 حاوی این commit ها است.

تغییرات API

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

نسخه 1.0.0-beta03

21 سپتامبر 2022

androidx.compose.material3:material3:1.0.0-beta03 and androidx.compose.material3:material3-window-size-class:1.0.0-beta03 are released. نسخه 1.0.0-beta03 شامل این تعهدات است.

تغییرات API

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

نسخه 1.0.0-beta02

7 سپتامبر 2022

androidx.compose.material3:material3:1.0.0-beta02 and androidx.compose.material3:material3-window-size-class:1.0.0-beta02 are released. نسخه 1.0.0-beta02 شامل این تعهدات است.

تغییرات API

• Default components insets introduced in m3 components in beta01 version no longer account for IME insets.
• Material3 Scaffold component now has a contentWindowInsets parameter, allowing to specify the amount of insets to handle for the content slot. ( Icf11a , b/243713323 )
• Deprecates the experimental Material 3 SmallTopAppBar function and introduces an 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 )

نسخه 1.0.0-beta01

24 آگوست 2022

androidx.compose.material3:material3:1.0.0-beta01 and androidx.compose.material3:material3-window-size-class:1.0.0-beta01 are released. نسخه 1.0.0-beta01 شامل این تعهدات است.

مرجع API

To see latest theming, component and other composables available check out the Compose Material 3 API reference overview .

تغییرات API

• Updated the Material 3 top app bar to snap into a fully collapsed to a fully extended state. Also, updated the TopAppBarDefaults behavior function to be Composables and provide default values for their top app bar state and animation spec. ( I642b3 )
• Updated FAB component signatures to match surface API ( I3afaa )
• Added insets Build-in support for Top app bars, drawers, navigation bar and rail. These components, when used separately or with Scaffold will automatically handle insets for developers. Note: This change doesn't add automatic handling of status bar icons and transparency of the status and navigation bars. Please, continue to do it manually to ensure the best edge-to-edge experience. ( I7e4e6 , b/183161866 )
• Updated component defaults to reduce API surface for future flexibility and performance improvements. ( I31820 )
• Reordered chip and navigation drawer sheet parameters to maintain consistency within the API ( I45d0b )
• Removed startIndent from Divider and moved color to be the last parameter.( If7be2 )

نسخه 1.0.0-alpha16

10 آگوست 2022

androidx.compose.material3:material3:1.0.0-alpha16 and androidx.compose.material3:material3-window-size-class:1.0.0-alpha16 are released. نسخه 1.0.0-alpha16 حاوی این commit ها است.

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

• Support specifying a custom width on a navigation drawer. ( Ia7f10 )

تغییرات API

• Reorder Tab and Leading icon tab parameters to maintain consistency within the API ( Ie2637 )
• Marked BadgeDefaults as experimental. ( I98ef3 )
• Remove deprecated navigation drawer function. ( I4f2db )
• Reorder Slider parameters in Material 3 to maintain consistency within the API ( I0aee7 )
• Reorder NavigationBar 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 )

نسخه 1.0.0-alpha15

27 جولای 2022

androidx.compose.material3:material3:1.0.0-alpha15 and androidx.compose.material3:material3-window-size-class:1.0.0-alpha15 are released. نسخه 1.0.0-alpha15 حاوی این commit ها است.

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

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

تغییرات API

• Updates to the FilterChip 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 )

نسخه 1.0.0-alpha14

29 ژوئن 2022

androidx.compose.material3:material3:1.0.0-alpha14 and androidx.compose.material3:material3-window-size-class:1.0.0-alpha14 are released. نسخه 1.0.0-alpha14 حاوی این commit ها است.

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

• Added M3 list implementation, see the documentation for sample usage ( Id7a20 )

تغییرات API

• تغییر نام پارامتر از مقادیر به مقدار در 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 )
• رابط‌ها در کتابخانه‌های کامپوزی اکنون با استفاده از روش‌های رابط پیش‌فرض jdk8 ساخته می‌شوند ( I5bcf1 )
• WindowWidthSizeClass and WindowHeightSizeClass now implement Comparable, so they can be compared using operators (<, <=, >=, >) and other APIs. ( I747d0 )

رفع اشکال

• نمونه نشان را به‌روزرسانی کنید تا توضیحات محتوای معنادارتری ارائه کنید. ( I10b9d )
• Adds option to use the system font size to the Material 3 catalog's theme picker. ( I10605 )
• Adds sample code for Badge and indeterminate progress indicators. ( I8fbe0 )

نسخه 1.0.0-alpha13

1 ژوئن 2022

androidx.compose.material3:material3:1.0.0-alpha13 and androidx.compose.material3:material3-window-size-class:1.0.0-alpha13 are released. نسخه 1.0.0-alpha13 حاوی این commit ها است.

تغییرات API

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

نسخه 1.0.0-alpha12

18 مه 2022

androidx.compose.material3:material3:1.0.0-alpha12 and androidx.compose.material3:material3-window-size-class:1.0.0-alpha12 are released. نسخه 1.0.0-alpha12 حاوی این commit ها است.

رفع اشکال

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

نسخه 1.0.0-alpha11

11 مه 2022

androidx.compose.material3:material3:1.0.0-alpha11 and androidx.compose.material3:material3-window-size-class:1.0.0-alpha11 are released. نسخه 1.0.0-alpha11 حاوی این commit ها است.

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

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

تغییرات API

• تغییر نام TextFieldDefaults.BorderStroke که یک خط مرزی را در OutlinedTextField به 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 )

نسخه 1.0.0-alpha10

20 آوریل 2022

androidx.compose.material3:material3:1.0.0-alpha10 and androidx.compose.material3:material3-window-size-class:1.0.0-alpha10 are released. نسخه 1.0.0-alpha10 حاوی این commit ها است.

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

• material3-window-size-class is a new library that provides support for window size classes: a set of opinionated viewport breakpoints for you to design, develop, and test resizable application layouts against. You can 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 )
• مصرف جزئی (موقعیت پایین یا پایین) در PointerInputChange منسوخ شده است. می توانید از consume() برای مصرف کامل تغییر استفاده کنید. می توانید از isConsumed برای تعیین اینکه آیا شخص دیگری قبلاً تغییر را مصرف کرده است یا خیر استفاده کنید.
• PointerInputChange::copy() اکنون همیشه یک کپی کم عمق ایجاد می کند. این بدان معنی است که کپی های PointerInputChange پس از مصرف یکی از کپی ها مصرف می شود. اگر می خواهید یک PointerInputChange بدون محدودیت ایجاد کنید، به جای آن از سازنده استفاده کنید. ( 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 )

نسخه 1.0.0-alpha09

6 آوریل 2022

androidx.compose.material3:material3:1.0.0-alpha09 is released. نسخه 1.0.0-alpha09 حاوی این commit ها است.

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

• Added Material 3 Switch API ( I2c3ad )

تغییرات API

• Added support for dropdown menus with text fields (aka 'exposed dropdown menus' or 'combo boxes'.) ( I1b832 )
• Added shape parameter to MaterialTheme and Shape sub system. ( I37426 )
• Added an expanded parameter to ExtendedFloatingActionButton to control whether the FAB is expanded or collapsed, with animations between each state. Added Extended FAB overload for extended FABs with trailing text for ExtendedFABs without icon. ( Iba7f1 )

نسخه 1.0.0-alpha08

23 مارس 2022

androidx.compose.material3:material3:1.0.0-alpha08 is released. نسخه 1.0.0-alpha08 حاوی این commit ها است.

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

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

تغییرات API

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

رفع اشکال

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

نسخه 1.0.0-alpha07

9 مارس 2022

androidx.compose.material3:material3:1.0.0-alpha07 is released. نسخه 1.0.0-alpha07 حاوی این commit ها است.

تغییرات API

• Updates to Material 3 Surface API that brings back the overloaded functions for clickable Surfaces, as well as adding a function to support selectable and toggleable Surfaces. ( I4bf18 )
• LazyVerticalGrid و LazyHorizontalGrid اکنون پایدار هستند. ( I307c0 )
• LazyVerticalGrid/LazyHorizontalGrid و تمام apiهای مرتبط به زیر بسته .grid منتقل شدند. لطفا واردات خود را از androidx.compose.foundation.lazy به androidx.compose.foundation.lazy.grid به روز کنید. ( I2d446 )
• تغییر قبلی مربوط به تکیه صرفاً به View برای WindowInsetsControllerCompat برگردانده شد و دوباره به یک پنجره نیاز داشت که برای مدیریت برخی از پرچم‌های پنجره لازم است. ViewCompat.getWindowInsetsController به نفع WindowCompat.getInsetsController منسوخ کرد تا اطمینان حاصل شود که از پنجره صحیح استفاده می شود (مثلاً اگر View در یک گفتگو باشد). ( I660ae , b/219572936 )
• یک LazyVerticalGrid API جدید برای تعریف اندازه‌های محوری اضافه کرد ( I17723 )

رفع اشکال

• Updates to the Card API to follow changes at the Surface API ( I3c8b9 )

نسخه 1.0.0-alpha06

23 فوریه 2022

androidx.compose.material3:material3:1.0.0-alpha06 is released. نسخه 1.0.0-alpha06 حاوی این commit ها است.

تغییرات API

• NavigationDrawerItem is added that represents a single destination within the drawers ( Ic396f , b/218286829 )
• PermanentNavigationDrawer 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 )

نسخه 1.0.0-alpha05

9 فوریه 2022

androidx.compose.material3:material3:1.0.0-alpha05 is released. نسخه 1.0.0-alpha05 حاوی این commit ها است.

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

Added Material Design 3 components

• منوی کشویی
  • 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 )

نسخه 1.0.0-alpha04

26 ژانویه 2022

androidx.compose.material3:material3:1.0.0-alpha04 is released. نسخه 1.0.0-alpha04 حاوی این commit ها است.

تغییرات API

• NonRestartableComposable به متدهایی اضافه شد که بیش از حد متدهای موجود بدون منطق پیچیده هستند. این بررسی‌های حافظه‌سازی تولید شده توسط کامپایلر را کاهش می‌دهد (برابر) برای همه پارامترهایی که در تابع داخلی که فراخوانی می‌شود تکرار می‌شوند. ( I90490 )
• Added Material 3 divider. ( Ica5fc )
• Mark the Checkbox and RadioButton with an experimental API annotation. ( Ie44bb )
• Added support for Material 3 progress indicators. ( Iff232 , b/205023841 )

رفع اشکال

• Update a disabled TextButton's container color to be transparent ( I6b248 , b/213339737 )

نسخه 1.0.0-alpha03

12 ژانویه 2022

androidx.compose.material3:material3:1.0.0-alpha03 is released. نسخه 1.0.0-alpha03 حاوی این commit ها است.

رفع اشکال

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

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

• اکنون به Kotlin 1.6.10 بستگی دارد.

نسخه 1.0.0-alpha02

1 دسامبر 2021

androidx.compose.material3:material3:1.0.0-alpha02 is released. نسخه 1.0.0-alpha02 حاوی این commit ها است.

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

• Add support for checkbox and radiobutton.
• به روز شده تا با Kotlin 1.6.0 سازگار باشد

تغییرات API

• Remove drawer from Material 3's scaffold. ( I04f51 )
• Adds Material 3 Checkbox support. ( Id5542 )
• Adds Material 3 RadioButton support. ( I20334 )

رفع اشکال

• Reduce IconButton ripple radius from 40dp to 20dp. ( I68bbe , b/206674345 )
• Port string fast path for Text changes from compose.material ( I30b03 )
• Fixed but that hardcoded button to always be enabled. ( Iea832 , b/205335456 )

نسخه 1.0.0-alpha01

27 اکتبر 2021

androidx.compose.material3:material3:1.0.0-alpha01 is released. نسخه 1.0.0-alpha01 حاوی این commit ها است.

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

Material Design 3 theming and Material You dynamic color

• MaterialTheme
• رنگ
  • ColorScheme
  • lightColorScheme , darkColorScheme
• Dynamic color
  • dynamicLightColorScheme , dynamicDarkColorScheme
• تایپوگرافی
  • Typography

Material Design 3 components

• دکمه ها
  • Button , ElevatedButton , FilledTonalButton , OutlinedButton , TextButton
• FAB and extended FAB
  • SmallFloatingActionButton , FloatingActionButton , LargeFloatingActionButton , ExtendedFloatingActionButton
• دیالوگ ها
  • AlertDialog
• نوار ناوبری
  • NavigationBar
• کشوی ناوبری
  • NavigationDrawer
• ریل ناوبری
  • 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.

،

Compose Material 3

نمونه کد راهنمای کاربر

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

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

آخرین به روز رسانی	انتشار پایدار	کاندید را آزاد کنید	نسخه بتا	انتشار آلفا
12 مارس 2025	1.3.1	-	-	1.4.0-alpha10

ساختار

Compose is combination of seven Maven Group IDs within androidx . هر گروه شامل یک زیرمجموعه هدفمند از عملکرد است که هر کدام مجموعه ای از یادداشت های انتشار خود را دارند.

این جدول گروه ها و پیوندهای هر مجموعه از یادداشت های انتشار را توضیح می دهد.

گروه	توضیحات
آهنگسازی.انیمیشن	انیمیشن هایی را در برنامه های Jetpack Compose خود بسازید تا تجربه کاربر را غنی تر کنید.
compose.compiler	توابع @Composable را تغییر دهید و بهینه سازی ها را با افزونه کامپایلر Kotlin فعال کنید.
تألیف.بنیاد	برنامه های Jetpack Compose را با بلوک های ساختمانی آماده بنویسید و پایه را گسترش دهید تا قطعات سیستم طراحی خود را بسازید.
آهنگسازی.مواد	رابط کاربری Jetpack Compose را با اجزای طراحی مواد آماده برای استفاده بسازید. این نقطه ورود سطح بالاتر Compose است که برای ارائه مؤلفه هایی مطابق با آنچه در www.material.io توضیح داده شده است طراحی شده است.
نوشتن.مواد3	ایجاد رابط کاربری Jetpack Compose با 3 مؤلفه طراحی متریال، تکامل بعدی طراحی متریال. Material 3 شامل قالب‌ها و اجزای به‌روز شده و ویژگی‌های شخصی‌سازی Material You مانند رنگ پویا است و به گونه‌ای طراحی شده است که با سبک بصری جدید Android 12 و رابط کاربری سیستم هماهنگ باشد.
نوشتن. زمان اجرا	بلوک‌های بنیادی مدل برنامه‌نویسی Compose و مدیریت حالت، و زمان اجرا اصلی برای هدف قرار دادن افزونه Compose Compiler.
compose.ui	مؤلفه‌های اساسی نوشتن رابط کاربر برای تعامل با دستگاه، از جمله طرح‌بندی، طراحی، و ورودی مورد نیاز است.

اعلام وابستگی ها

برای افزودن وابستگی به Compose، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

Groovy

dependencies {
    implementation "androidx.compose.material3:material3:1.3.1"
    implementation "androidx.compose.material3:material3-window-size-class:1.3.1"
    implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha10"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    implementation("androidx.compose.material3:material3:1.3.1")
    implementation("androidx.compose.material3:material3-window-size-class:1.3.1")
    implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha10")
}

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 , and androidx.compose.material3:material3-common-desktop:1.0.0-alpha01 are released. Version 1.0.0-alpha01 contains these commits .

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

Themeless components that can be used to build Material Design components:

• Tonal Palette
  • TonalPalette
• نماد
  • Icon
• اندازه هدف را لمس کنید
  • LocalMinimumInteractiveComponentSize

Compose Material3 Adaptive Navigation Suite Version 1.0

Note: As of 1.0.0-alpha07, the androidx.compose.material3:material3-adaptive-navigation-suite package is released as part of the Compose Material3 package (Material3 versions 1.3.0-*). As a result, Compose Material3 adaptive navigation suite versioning has jumped from 1.0.0-xxxx to 1.3.0-xxxx. To find the current and future navigation suite release notes and commits, see Compose Material3 Version 1.3.0 and later versions.

نسخه 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 , and androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07 are released. Version 1.0.0-alpha07 contains these commits .

تغییرات API

• Make navigation suite APIs non-experimental ( If62af )

رفع اشکال

• Consume insets for content by default ( 50266df )

نسخه 1.0.0-alpha06

17 آوریل 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06 , androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06 , and androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06 are released. Version 1.0.0-alpha06 contains these commits .

تغییرات API

• Add containerColor and contentColor to NavigationSuiteScaffoldDefaults . ( I64e3a , b/331993720 )
• Adding itemColors function to NavigationSuiteDefaults . ( Idf719 , b/328480012 )
• Make NavigationSuiteScope sealed. ( Iefa57 )

نسخه 1.0.0-alpha05

6 مارس 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05 , androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05 , and androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05 are released. Version 1.0.0-alpha05 contains these commits .

تغییرات API

• Make NavigationSuiteItemColors constructor public. ( Ica83a , b/324886877 )

نسخه 1.0.0-alpha04

21 فوریه 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04 , androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04 , and androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04 are released. نسخه 1.0.0-alpha04 حاوی این commit ها است.

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

• Update Material3 adaptive dependencies to the new module paths. ( Ibc421 )
• Migrate to use Window Manager version of window size classes. ( I3794d )

نسخه 1.0.0-alpha03

7 فوریه 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03 , androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03 , and androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03 are released. نسخه 1.0.0-alpha03 حاوی این commit ها است.

تغییرات API

• Update package name to navigationsuite from navigation-suite ( I7eff7 )
• Material3 components exposing a MutableInteractionSource in their API have been updated to now expose a nullable MutableInteractionSource that defaults to null. هیچ تغییر معنایی در اینجا وجود ندارد: عبور از null به این معنی است که شما نمی خواهید MutableInteractionSource را بالا ببرید و در صورت نیاز در داخل کامپوننت ایجاد می شود. تغییر به null به برخی از مؤلفه‌ها اجازه می‌دهد تا هرگز یک MutableInteractionSource را تخصیص ندهند، و به سایر مؤلفه‌ها اجازه می‌دهد فقط در صورت نیاز، نمونه‌ای را ایجاد کنند، که عملکرد این مؤلفه‌ها را بهبود می‌بخشد. اگر از MutableInteractionSource که به این مؤلفه ها منتقل می کنید استفاده نمی کنید، توصیه می شود به جای آن، null را ارسال کنید. همچنین توصیه می شود که تغییرات مشابهی را در اجزای خود ایجاد کنید. ( I41abb , b/298048146 )

نسخه 1.0.0-alpha02

13 دسامبر 2023

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02 , androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02 , and androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02 are released. نسخه 1.0.0-alpha02 حاوی این commit ها است.

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

• Add a 'None' NavigationSuiteType ( If8cb1 , b/313688598 )

رفع اشکال

• Fix navigation component filling entire screen when root surface has modifier.fillMaxSize . ( c9cf250 , b/312664933 )

نسخه 1.0.0-alpha01

15 نوامبر 2023

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01 is released. نسخه 1.0.0-alpha01 حاوی این commit ها است.

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

• NavigationSuiteScaffold
  • NavigationSuiteScaffoldLayout
  • NavigationSuite

Compose Material3 Adaptive Version 1.0

Note: As of 1.0.0-alpha07, androidx.compose.material3:material3-adaptive was migrated to androidx.compose.material3.adaptive . For future releases, please use androidx.compose.material3.adaptive and the associated release notes on our Compose Material3 Adaptive page.

نسخه 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 , and androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06 are released. نسخه 1.0.0-alpha06 حاوی این commit ها است.

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

• Added additional behavior options for ThreePaneScaffoldNavigator back navigation. ( I858aa )
• Added optional destination content to navigation history. ( 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 , and androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05 are released. نسخه 1.0.0-alpha05 حاوی این commit ها است.

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

• Support history-awareness in scaffold navigation and value calc ( 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 , and androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04 are released. نسخه 1.0.0-alpha04 حاوی این commit ها است.

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

• Added edge-to-edge support in pane scaffolds ( I1b462 )

تغییرات API

• Moved hinge bounds properties in Posture to a list of hinge info ( I24f90 )

رفع اشکال

• Fix AnimatedPane is not recomposed ( 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 , and androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03 are released. نسخه 1.0.0-alpha03 حاوی این commit ها است.

تغییرات API

• Change scaffold roles to aliases of ThreePaneScaffoldRole . ( I65bd1 )
• Create a base class for scaffold roles ( I4784d )
• Remove unnecessary parameter from AnimatedPane 's content ( Ibc73b )
• Renames collectWindowSizeAsState and returns raw values instead ( 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 , and androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02 are released. نسخه 1.0.0-alpha02 حاوی این commit ها است.

تغییرات API

• Split navigation APIs from adaptive scaffold APIs. ( Ic4045 )
• Remove GutterSize class. ( I785b3 )

رفع اشکال

• Fix panes are not switched when AnimatedPane is not used ( d88f181 )

نسخه 1.0.0-alpha01

15 نوامبر 2023

androidx.compose.material3:material3-adaptive:1.0.0-alpha01 is released. نسخه 1.0.0-alpha01 حاوی این commit ها است.

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

Material3 adaptive condition APIs:

• وضعیت بدن

Material3 adaptive pane scaffold directive APIs:

• PaneScaffoldDirective
  • calculateStandardPaneScaffoldDirective
  • calculateDensePaneScaffoldDirective
  • AdaptStrategy
  • ThreePaneScaffoldAdaptStrategies
  • HingePolicy

Material3 adaptive pane scaffold APIs:

• Pane scaffold basic APIs
  • PaneScaffoldScope
  • ThreePaneScaffoldRole
  • PaneAdaptedValue
  • ThreePaneScaffoldValue
  • calculateThreePaneScaffoldValue
  • AnimatedPane

Compose Material3 Version 1.4

Version 1.4.0-alpha10

12 مارس 2025

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

تغییرات API

• TabRowDefaults.tabIndicatorOffset has been deprecated in favor of TabIndicatorScope.tabIndicatorOffset . ( Ib36b3 )
• Fix typo for small content padding in button defaults. ( I19bfe )
• TabRow and ScrollableTabRow are deprecated in favor of Primary and Secondary variants of each. Primary and Secondary tab rows are more performant and accurate to spec. ( I918e2 )
• Added rememberSliderState and rememberRangeSliderState . ( I8e384 )
• Added shouldAutoSnap to SliderState to control the auto-snapping mechanism, disabling it may be useful for custom animations. ( I07745 )
• Scrollable tab row's minimum tab width is now a parameter. Primary and Secondary tab row variants are no longer experimental. ( If6f15 , b/226665301 )
• Made the class ExitAlwaysFloatingToolbarScrollBehavior public allowing creation without composition. ( Ibf31c )

Version 1.4.0-alpha09

26 فوریه 2025

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

تغییرات API

• Rename DragHandle 's setting fields in the default state; separate pressed and dragged states; make the default sizes be public. ( I787b9 )
• Updates to the TowRowsTopAppBar API. Removed the expanded lambda parameter and added separate parameters for the expanded and collapsed heights. ( Idd677 , b/306697446 , b/229134133 , b/268068946 )

رفع اشکال

• The bottom app bars now observe the touch exploration service (eg, TalkBack ) and keep them visible whenever the service is on. ( I4b34d )

نسخه 1.4.0-alpha08

12 فوریه 2025

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

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

• Added an TimePickerDialog API that can be used for TimePicker , TimeInput or to have a switchable version. ( Id2d83 )

• New search bar APIs:

  • Collapsed search bars and expanded search "views" are now separate composables.
  • SearchBar represents a search bar in the collapsed state.
  • ExpandedFullScreenSearchBar and ExpandedDockedSearchBar represent the search bar in the expanded state. These open in a new window.
  • SearchBarState to control the state of the search bar
  • TopSearchBar to add insets handling and scroll behavior
  • New overload of InputField which uses SearchBarState ( Ie0723 , b/261496232 , b/283311462 , b/350916229 , b/352872248 )

تغییرات API

• Support corner shape morphing of icon buttons on press. ( I21843 )
• Text field decorator/decoration box APIs are no longer experimental. ( I31d95 )
• Added samples and defaults for the connected variant for ButtonGroup . ( I5c8ce )
• Make state param the last one in NavigationSuiteScaffold and NavigationSuiteScaffoldLayout . ( I9cc7b )

رفع اشکال

• Added custom accessibility actions to the FloatingToolbars so accessibility services can now expand or collapse all FloatingToolbar variations. The FAB-equipped version applies this to the FAB, while the FAB-less version applies it to the main content. ( I26420 )
• The FloatingToolbars now observe the touch exploration service (eg, TalkBack) and keep the toolbar expanded and visible whenever the service is on. ( I02172 )
• Fixed a crash at the progress and loading indicators in case a Float.NaN is passed in as a progress. ( I4fa96 , b/352364576 )

نسخه 1.4.0-alpha07

29 ژانویه 2025

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

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

• Added more flexibility in customizing the appearance of Checkboxes with a new API. This API provides Stroke parameters that allow for greater control over how the checkmark and the checkbox-outline are rendered. ( I65a88 )
• Added TwoRowsTopAppBar API, a more customizable alternative to Medium and Large app bars for creating two-row top app bars. Developers now have control over the content of titles and subtitles in both collapsed and expanded states, with customizable heights for each state. ( I0be3c , b/306697446 , b/229134133 , b/268068946 )

تغییرات API

• Renamed an experimental BottomAppBar variation to FlexibleBottomAppBar , providing more control over content arrangement and height. ( Iaa448 )
• Update naming for properties in Button Group default object to be CapitalCase . Update the name of animateFraction to be more precise to the behavior that it's representing. ( I545cd )
• Adding overloads for common buttons that allow for animated shapes on press interaction. Added cached button shapes. ( I5ec20 )
• You can now control how a FloatingToolbar with FAB reacts to scrolling by providing a FloatingToolbarScrollBehavior . For toolbars positioned along a center edge (like top or bottom center), we recommend using a scroll behavior to hide the entire component on scroll for a cleaner look. This also prevents the FAB from becoming off-center, which could happen when using the expanded flag for collapsing. ( I33f67 )
• Updates the experimental TopAppBar APIs to use Alignment.Horizontal instead of a custom TopAppBarTitleAlignment when setting the alignment of the title and subtitle. ( I70ca2 )
• SliderState#onValueChange is now public to give more control to the user ( I104eb )
• Introduce NavigationSuiteScaffoldState to allow for animation of the navigation component. Also introduce overloads of NavigationSuiteScaffold and NavigationSuiteScaffoldLayout that have a state param. ( I6a8c9 , b/328674235 )

رفع اشکال

• Move IconButtonColors and IconToggleButtonColors classes from IconButtonDefaults.kt back to IconButton.kt . ( I3c233 )

مشارکت خارجی

• SliderState#isDragging is now public. ( I8458a )

نسخه 1.4.0-alpha06

15 ژانویه 2025

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

Behavior Change

• Added displayCutout to the group of insets that Material components take into account by default, to avoid content overlapping with the display cutout. این یک تغییر رفتار است که بر نحوه رفتار اجزای آگاه در اطراف صفحه نمایش تأثیر می گذارد. This includes the default value of the WindowInsets parameter for inset-aware Material 3 components, and the WindowInsets values provided in the component Defaults objects for both Material 2 and Material 3. If this change causes undesirable behavior, manually specify the WindowInsets parameter on a per-component basis. ( I43ee9 , b/362508045 )

تغییرات API

• Updates to the TopAppBar API. Rename the medium and large top app bars with a subtitle to *FlexibleTopAppBar . Unified the color variations into a single TopAppBarDefault.topAppBarColors() function, and added a subtitle color parameter to be applied for a provided subtitle Composable ( I41b65 )
• Remove WideNavigationRailArrangement API in favor of Arrangement.Vertical ( Id0341 )
• Add a new VerticalSlider @Composable . ( I2bfba )
• Add a new Track @Composable that allows specifying custom external track corners and track icons. ( I436a4 )
• Update the floating toolbar APIs to use the FloatingToolbarColors object instead of a single container color. ( I9a054 )
• Add and use new experimental annotation ExperimentalMaterial3ComponentOverrideApi ( Ia1eaf )
• Modifier.indicatorLine now takes a shape for the text field to handle clipping. ( I8c5f3 , b/380704151 )
• Rename the experimental FloatingAppBar functions to FloatingToolbar ( I1dbf8 )
• Added a new floatingToolbarVerticalNestedScroll that can be attached to a scrollable container to update the floating toolbar expansion state based on a scroll motion that crosses a threshold. ( I6d65f )
• Introducing a new API for creating a floating toolbar with an attached Floating Action Button (FAB). The API provides flexible customization options, allowing you to arrange the toolbar horizontally or vertically and place the FAB at the start or end of the toolbar. ( I9e350 )

رفع اشکال

• Fix a Snackbar accessibility issue that caused it to announce itself on dismiss when TalkBack is on. ( /I9db53 )

مشارکت خارجی

• Commonized BasicTooltip in foundation and BasicTooltip/Tooltip in material3. ( Ifc2e6 )

نسخه 1.4.0-alpha05

12 دسامبر 2024

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

تغییرات API

• Replace type in WideNavigationRailState.current/target value for an enum for better readability ( I2d6ab )
• SplitButton change Shape api from data class to class for binary compatibility. ( I53812 )
• Added a tooltip API that has a onDismissRequest parameter so makers can decide what happens when a user clicks outside of the tooltip. Deprecated the old API that doesn't contain this new parameter. ( I99aef )
• Change naming of opticalCentering to horizontalCenterOptically . Making the modifier internal. Replace padding parameter with max start and end offset. ( I0b904 )
• Change WideNavigationRailState to have current/target value, remove enums in favor of boolean. ( Idfa29 , b/356039090 )
• Add NavigationBarItemComponentOverride . ( I3a06a )

رفع اشکال

• Fix the top and bottom app-bar behaviors to reliably change color when content is scrolled all the way. ( Idc4e8 , b/293665988 )
• Scroll behavior functions for top and bottom app bars now return a remembered behavior to perform better across recompositions. ( I0fdbe , b/207957336 )
• Modifier pararemeter is now applied after internal modifiers such as dragging behavior and semantics, instead of before. This affects the ordering in which modifiers are applied. ( I8d83f )
• Expanded bottom sheet remains expanded on size change. ( I2870b , b/324934884 )
• Correctly route status and navigation bar flags for windows properties. ( Ie674d , b/362539765 )
• Move modifier parameter to the scaffolds root, as documented. This aligns implementation with M2. ( I0235e , b/372311595 )

مشارکت خارجی

• Commonized DatePickerDialog function. ( I7dced )

نسخه 1.4.0-alpha04

13 نوامبر 2024

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

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

• Revert color changes introduced in aosp/3212478 to iconButtonColors , iconToggleButtonColors , outlinedIconButtonColors , outlinedIconToggleButtonColors and outlinedIconToggleButtonBorder . Moved the now-reverted behavior into a new set of functions called iconButtonVibrantColors and so forth to emphasize the high contrast colors being returned. ( Iffd8d )

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

• Introduce VerticalDragHandle component ( I6c770 )

تغییرات API

• Rename DismissibleModalWideNavigationRailDefaults to ModalWideNavigationRailDefaults . ( I8e877 )
• Add NavigationBarComponentOverrides . ( I8a3f3 )
• Add NavigationRailComponentOverride . ( I83e13 )
• Introduce WideNavigationRailState to handle collapsing/expanding of the rail, allow ModalWideNavigationRail to be dismissible and delete DismissibleModalWideNavigationRail . ( I88568 )
• Add xSmall, medium, large, and xLarge size defaults into toggle button defaults. ( Ie95d1 )
• Add xSmall, medium, large, and xLarge size defaults into button defaults. ( If8b6d )

رفع اشکال

• Filter chip trailing icon color has been updated from Primary to OnSurfaceContainer , per spec. All chip outline colors have been updated from Outline to Outline Variant, per spec. ( I68bd4 )

نسخه 1.4.0-alpha03

30 اکتبر 2024

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

تغییرات API

• SheetState constructor with density has been deprecated in favor of positional and velocity thresholds. ( Ifd16e )
• Added rememberTooltipPositionProvider that contains an updated positioning logic. Deprecated rememberPlainTooltipPositionProvider and rememberRichTooltipPositionProvider . ( Ie66e2 )
• Additional ModalBottomSheetProperties allow for customization of status and navigation bar colors. By default, these update based on content color instead of system dark theme status. ( Ib874e , b/362539765 )
• Improved the input experience for date pickers: when in input mode, the date text field will be focused for immediate text entry. The change adds a requestFocus parameter to the DatePicker and the DateRangePicker . You may prevent a focus by passing false . ( I12d09 , b/286399710 , b/340102743 )
• Caching the shape defaults into the Shape object. Making the shape defaults @Composable for toggle button. Collapsing the shapes into one shape default since the variants point to the same token file. ( Iaa014 )

رفع اشکال

• رفتار Scaffold contentPadding را بهینه کنید تا از ترکیب مجدد محتوای بدنه هنگام تغییر contentPadding جلوگیری کنید. ( I8c8e2 , b/373904168 )
• TextFieldLabelScope progress renamed to labelMinimizedProgress
• TextFieldLabelPosition Default renamed to Attached . Interface members have been removed. ( If75c6 )
• Fixed an issue with the DatePicker in input mode where validation errors could cause the component's height to change. ( I2e229 , b/280462363 )
• هنگامی که کلیدهای کنترل فشار داده می شوند، لغزنده مواد را تغییر دهید. ( I1c442 )

نسخه 1.4.0-alpha02

16 اکتبر 2024

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

تغییرات API

• Updates to the date pickers to ensure consistent Locale usage throughout the DatePicker and DateRangePicker when setting a Locale directly through a DatePickerState or a DateRangePickerState . Note that when setting Locales directly to the state, it's up to you to ensure that the title and headline texts are localized accordingly, as their default text will still be applied according to the default platform Locale. ( I37073 , b/326490763 , b/321657276 )
• SheetState.isAnimationRunning is now exposed. ( I9a3d7 )
• DatePickerColors now correctly take precedence over any conflicting colors defined at the theme's Typography text styles. Also note that this update adjusts the color parameter's position in the date picker functions and introduces a contentColor parameter for customizing the header and title text colors. ( I30d03 , b/347031394 )
• Rename SplitButton to SplitButtonLayout and remove SplitButton color variants APIs, variants will be achieve by re-using button variants provided by SplitButtonDefaults . ( I44c36 )
• ModalBottomSheet now has sheetGestureEnabled parameter ( I856cb , b/288211587 )
• standardMotionScheme و expressiveMotionScheme را به استاندارد و رسا تغییر نام داد. Both functions are now accessible through the MotionScheme companion object by calling MotionScheme.standard() and MotionScheme.expressive() . ( Iceccf )
• Adding maxWidth parameter to plain and rich tooltips. It defaults to the design spec of 200 dp for plain tooltips and 320 dp for rich tooltips. ( I30ce9 )

رفع اشکال

• The DatePicker and DateRangePicker now correctly update the displayed month when set via their state's displayedMonthMillis . ( If9e47 , b/333414302 )
• ModalBottomSheet content now moves content away from status bar. ( I5114c , b/321877275 , b/336962418 , b/342093067 )
• [Bottom Sheet] Change back callback priority to PRIORITY_DEFAULT to allow IME keyboard to dismiss first. ( I447fb )
• Fix crashes in the DatePicker and DateRangePicker when the minimum selectable year is set to a future year. ( I78656 , b/319395747 )
• Fix a date-picker issue to update the UI when an updated SelectableDates instance is applied. ( Iad59a , b/290135807 , b/339898760 )

نسخه 1.4.0-alpha01

2 اکتبر 2024

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

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

• Library no longer adds a dependency to material-icons-core so if your project relied on that, you will have to explicitly add that dependency in your build.gradle[.kts] files. ( I735ff , b/349894318 )
• NavigationBarItem and NavigationRailItem 's active label color change from onSurface to secondary in order to improve usability, color contrast and improve coherence within the system ( Ibc297 ), to revert to the previous behavior, copy the default colors and change the selectedTextColor to MaterialTheme.colorScheme.onSurface .
• Material 3 components are now using the new MotionScheme to define their motion. ( Ie0f93 )
• Indeterminate circular Progress Indicator motion changes ( I3c07e )
• Update OutlinedIconButtonColors and OutlinedIconToggleButtonColors for better color contrast. ( I2743d )
• Updated container and content color for FilledIconToggleButtonColors and FilledTonalIconToggleButtonColors . ( Ic5d0f )
• Updated OutlinedButton border color from outline to outlineVariant . ( 057f00 )

تغییرات API

• Added an optional reverseLayout parameter to the TopAppBar 's enterAlwaysScrollBehavior function to better support content that was set with a reverseLayout . ( I4e0e5 )
• SegmentedButton now supports contentPadding argument. ( I5ad91 , b/358414376 )
• PullToRefreshState does no longer have default implementation for isAnimating ( I6a593 )
• Added new overloads of Material TextField and OutlinedTextField that use TextFieldState . Added decoration box APIs that are compatible with TextFieldDecorator . ( If13a1 )
• Added parameter to control text field's labelPosition . Using alwaysMinimize allows the UI pattern of displaying a label and placeholder in a text field at the same time even when the field is unfocused. ( I1ef2c )
• Added Material SecureTextField and OutlinedSecureTextField for password entry fields. ( I7e22d )
• Added a scope to text field labels to query animation progress. ( If5ec8 )
• Adds support for MotionEvent.CLASSIFICATION_DEEP_PRESS to tooltips. ( I62e6a )
• TimePickerState 's isAfternoon is now an extension val instead of a var in the interface, renamed to isPm ( I89a97 )
• Updating typography class to support emphasized type scales. ( Ifa13c )
• Added ModalWideNavigationRail API and renamed ModalExpandedNavigationRail APIs to DismissibleModalWideNavigationRail . ( Ic9118 )
• Updated FloatingAppBarScrollBehavior to auto-calculate the screenOffset and not require a @Composable . ( Idf349 )
• Updates to the LoadingIndicator API to fix the naming at its defaults object. Added a LoadingIndicatorElevation constant at the PullToRefresh . ( I1d72b )
• Updates to the LoadingIndicator API to fix the naming at its defaults object. Added a LoadingIndicatorElevation constant at the PullToRefresh . ( I1d72b )
• Added an amplitude and a waveSpeed parameters to the indeterminate variations of the LinearWavyProgressIndicator and the CircularWavyProgressIndicator . ( I2a0c5 )
• Support changing an icon toggle button's shape based on its pressed or checked state. ( Ibc781 )
• Updating typography class to support emphasized type scales. ( Ifa13c )
• SplitButton shape morphs based on default / pressed state. Removed AnimatedTrailingButton api because TrailingButton api can offer the same customizations ( I95066 )
• Add modifier to animate showing and hiding of FAB, eg when content scrolls. ( I8338d )
• Adding connected button group shapes and spacing to ButtonGroupDefaults to be used in a sample. ( I68e30 )
• Split button add horizontal padding for trailing button and enable optical centering calculated from start and end corner differences ( I122e2 )
• Introducing a new Material MotionScheme to allow setting a scheme for the component's motion. The scheme is set through the MaterialTheme . ( Id50c2 )

رفع اشکال

• Apply the correct focus traversal index to Scaffold child Composables. The order is topBar , bottomBar , fab, content, snackbar. ( I5936b )
• Fixed an issue at the DatePicker and DateRangePicker where in certain locales and format-skeletons some of the date elements (eg month names) did not start with a capital letter. ( I1430f )
• Integrate FAB and FAB Menu component tokens (minor visual updates to paddings and text) ( Ib57f3 )
• ModalBottomSheet is now first in semantic traversal order, followed by the scrim. ( I436f9 , b/358594665 )
• Fix bottom app bar not disappearing entirely when scrolling under the navigation pill in edge to edge mode ( I3ee21 )

Compose Material3 Version 1.3

نسخه 1.3.1

30 اکتبر 2024

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

رفع اشکال

• The DatePicker and DateRangePicker now correctly update the displayed month when set via their state's displayedMonthMillis . ( If9e47 , b/333414302 )
• Fix crashes in the DatePicker and DateRangePicker when the minimum selectable year is set to a future year. ( I78656 , b/319395747 )
• Fix a date-picker issue to update the UI when an updated SelectableDates instance is applied. ( Iad59a , b/290135807 , b/339898760 )
• Change back callback priority used by bottom sheets to PRIORITY_DEFAULT to allow IME keyboard to dismiss first. ( I447fb )

نسخه 1.3.0

4 سپتامبر 2024

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

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

Major features of 1.3.0

New Material Design 3 components

• چرخ فلک
  • HorizontalMultiBrowseCarousel and HorizontalUncontainedCarousel Enhancements to existing Material Design 3 components.
• [ ModalBottomSheet ] now supports Predictive Back on U+ ( Iccf32 , b/281967264 , b/304850357 )
• [ SearchBar ] now supports Predictive Back on U+ ( I657f8 )
• Nav Drawer ( ModalDrawerSheet and DismissibleDrawerSheet ) now supports Predictive Back on U+ as opt-in ( Ie5b0b )
• DropdownMenu now supports custom color, shape, elevation, and border. ( I8e981 , b/289554448 , b/301887035 , b/283654243 )
• Updated Slider to improve accessibility by adding a gap and stop indicator. ( I3058e )
• Updated ProgressIndicator to improve accessibility by adding a gap and stop indicator. ( I21451 )
• Added a default caret for rich tooltip, support custom caret to be drawn given anchor LayoutCoordinates . ( Ifd42c ) Breaking Changes
• New pull-to-refresh APIs:
  • Simplified PullToRefreshState to use fractional values instead of Dp units.
  • isRefreshing state is controlled by the user instead of PullToRefreshState .
  • Separated out the nested scroll connection from PullToRefreshState . It is handled by the new PullToRefreshBox or Modifier.pullToRefresh .
  • This update is a breaking change to previous experimental APIs. ( I0adeb , b/314496282 , b/317177684 , b/323787138 , b/324573502 , b/317177683 ) Visual Breaking Changes
• Update focus state overlay to be 0.1f to ensure sufficient color contrast. ( I7ea77 )
• Small adjustments to surface and background color defaults in lightColorScheme and darkColorScheme . ( I9db52 )
• Updated Slider and ProgressIndicator colors to follow the new Non-Text Contrast specs. ( I26807 )
• SurfaceContainer variants are now used by components. Components which formally calculated color with Surface and TonalElevation now use SurfaceContainer roles by default, which are not affected by tonal elevation. ( b/304584161 )
• Surface and Surface container baseline roles have been slightly adjusted, providing more tint in light and dark themes. ( I677a5 )
• Promoted experimental APIs to stable!
• بهبود عملکرد

نسخه 1.3.0-rc01

21 آگوست 2024

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

رفع اشکال

• ModalBottomSheet is now first in semantic traversal order, followed by the scrim. ( I436f9 , b/358594665 )

Version 1.3.0-beta05

24 جولای 2024

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

• Fixed issue where BottomSheet content is missing or cut off on Android N and O ( a10a2d )
• Increased slider's semantics bounds in order for TalkBack to properly show the focus indicators around the thumbs. ( 0b5a1d )

Version 1.3.0-beta04

26 ژوئن 2024

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

نسخه 1.3.0-beta03

12 ژوئن 2024

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

مشارکت خارجی

• Make androidx.compose.material3.DropdownMenu available from common source set. ( If62c0 )

نسخه 1.3.0-beta02

29 مه 2024

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

تغییرات API

• Modifier.pullToRefreshIndicator supports elevation, update Pull To Refresh APIs to have enabled be a boolean, instead of a lambda. Support content alignment in PullToRefreshBox ( I75679 )
• Making TooltipScope a sealed interface and creating an internal implementation to use in TooltipBox and Label. ( I3833e )
• Added two new modifiers to CarouselItemScope - maskClip and maskBorder - to easily add a shape and border to any carousel item ( Id67a1 )
• TimePickerState is now an interface and allows for setting the time ( I88546 )
• Updated API for styling the links: moved the TextLinkStyles to the TextStyle and removed the TextDefaults from material. ( I5477b )

رفع اشکال

• ModalBottomSheet status and nav bar icons now respond to dark theme status. ( Ie1fe7 , b/338342149 )
• Added close sheet semantics to ModalBottomSheet scrim. ( 0e61cb , b/328801864 )

مشارکت خارجی

• Make androidx.compose.material3.AlertDialog available from common source set ( Ia33f5 )
• Make ModalBottomSheet available from common source set ( Id7cc7 )

نسخه 1.3.0-beta01

14 مه 2024

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

تغییرات API

• Using DpSize instead of CaretProperties . Removing CaretProperties . Rename CaretScope to TooltipScope . ( Id9a76 )
• API را برای دریافت پیوندهای مضمون مواد در متن به روز کرد. به طور خاص، روش‌ها را از TextDefaults برای ساخت LinkAnnotations با مضمون حذف کرد و HTML را با پیوندهای مضمون تجزیه کرد. در عوض، یک کلاس TextLinkStyles اضافه کرد که اجازه می دهد تا به پیوندها به عنوان یک پارامتر به Text composable استایل دهید. ( I31b93 )

نسخه 1.3.0-alpha06

1 مه 2024

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

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

• New pull-to-refresh APIs:

  • Simplified PullToRefreshState to use fractional values instead of Dp units.
  • isRefreshing state is controlled by the user instead of PullToRefreshState .
  • Separated out the nested scroll connection from PullToRefreshState . It is handled by the new PullToRefreshBox or Modifier.pullToRefresh .
  • This update is a breaking change to previous experimental APIs. ( I0adeb , b/314496282 , b/317177684 , b/323787138 , b/324573502 , b/317177683 )

تغییرات API

• RippleConfiguration#isEnabled حذف شده است و LocalRippleConfiguration پوچ شده است. برای غیرفعال کردن ریپل، به جای ارائه یک RippleConfiguration با isEnabled = false ، null به LocalRippleConfiguration ارائه کنید. ( I22725 )
• ModalBottomSheet more accurately draws scrim over status bar when edge to edge is enabled. Modal bottom sheet content can now consume window insets, allowing for visible content above the navigation bar. ModalBottomSheet parameter windowInsets renamed to contentWindowInsets to specify where the insets will be applied, these are no longer tied to window logic. contentWindowInsets type has been changed to a function which returns WindowInsets , to allow it to be resolved within its new window. ( I39630 , b/274872542 , b/300280229 , b/290893168 )
• PrimaryScrollableTabRow and SecondaryScrollableTabRow now use custom layout instead of subcomposition, which should improve performance. ( I991e0 )
• پیوندهای متنی علاوه بر استایل معمولی، گزینه استایل حالت فشرده را نیز دریافت کردند، شناور و فوکوس شدند. TextDefaults methods each got a pressedStyle argument to support that. ( IC473f , b/139312671 )

رفع اشکال

• Navigation drawer drag anchors now match the drawerContent 's width. ( Ibc72f , b/245355396 )
• پوشش بالای OutlinedTextField برای برچسب اکنون اندازه فونت سیستم را محاسبه می کند. ( IDc781 )
• Fixed package location of CalendarLocale . ( Ifa235 )
• [Predictive Back] Update predictive back animations to use interpolation curve of (0.1, 0.1, 0, 1) ( I2591a )

نسخه 1.3.0-alpha05

17 آوریل 2024

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

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

• SearchBar and DockedSearchBar have new overloads that take a text field parameter. This allows styling the text field separately from the rest of the search bar as well as passing in custom text fields. The text field of the current implementation has been made available as SearchBarDefaults.InputField . ( I50c73 , b/275074248 , b/278773336 , b/326627700 )
• the lambda drawTick has been added to the public API in order to customize the ticks if needed ( I0c048 )

تغییرات API

• پیوندهای متنی علاوه بر استایل معمولی، گزینه استایل حالت فشرده را نیز دریافت کردند، شناور و فوکوس شدند ( I5f864 ، b/139312671 )
• Updated CarouselItemInfo to expose a mask Rect that the item is being clipped by ( I785d8 )
• Removed BasicTooltipState from the Material 3 public API. Its functionality is combined with TooltipState until Foundation's BasicTooltip is stabilized. ( Icda29 )
• Added a TextDefaults object that contains methods to construct a LinkAnnotation and parse HTML-tagged string which apply MaterialTheme to the links ( I98532 , b/139312671 )
• ExposedDropdownMenuBoxScope no longer permits subclasses. Exposed dropdown menus now have a MenuAnchorType which should be passed to menuAnchor to support better a11y. This should be used instead of passing focusable to ExposedDropdownMenu , which is now deprecated. menuAnchor has a new parameter to control enabled state. ( I55ee6 , b/257209915 , b/308840226 )
• Fixed the border color of OutlinedButton when disabled. Added ButtonDefaults.outlinedButtonBorder("enabled") overload that takes the enabled state. ( Ie650b , b/318461363 )
• Added a new CarouselItemInfo class to help clients get information about the item sizes. ( I9070c )
• ColorScheme constructor without surface containers is now deprecated. Please migrate to the constructor that includes surface containers. ( I35c11 )
• [Outlined] TextFieldDefaults ContainerBox renamed to Container . ( Ie8d3b )

رفع اشکال

• BottomSheetScaffold will no longer scroll from nested scroll if sheetSwipeEnabled is false. ( I5e1c1 , b/306464779 )
• Removed some ExperimentalMaterial3Api OptIn annotation in IconButtonSamples.kt . ( I111d1 )

نسخه 1.3.0-alpha04

3 آوریل 2024

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

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

• Added two experimental versions of the Material3 Carousel - HorizontalMultiBrowseCarousel and HorizontalUncontainedCarousel ( I88d64 )
• Updated Compose M3 Nav Drawer ( ModalDrawerSheet and DismissibleDrawerSheet ) to support Predictive Back on U+ as opt-in ( Ie5b0b )
• Added a new API in Icon to allow passing color tint as lambda to avoid recomposing. ( I5b5a2 )
• Top app bar APIs now support custom heights for both fixed and collapsible sections. ( Ib8b0c , b/323403446 )

تغییرات API

• Top app bar APIs now support custom heights for both fixed and collapsible sections. Fixed an issue that caused single-line top app bars to recompose too many times when scrolling content. Resolved an issue where MediumTopAppBar truncated titles on devices with large font/display settings. ( Ib8b0c , b/323403446 , b/300953236 , b/286296147 , b/330410290 , b/308540676 )
• SegmentedButton and associated APIs are now stable ( I8a158 )
• SwipeToDismissBox , SwipeToDismissBoxDefaults , SwipeToDismissBoxState and SwipeToDismissBoxValue are now marked stable. ( I5f000 )
• Removed deprecated DismissDirection and DismissValue enums and APIs. ( I89ccd )
• Added an experimental tag to Carousel's CarouselState companion object. ( I94154 )
• Deprecate LocalMinimumInteractiveComponentEnforcement and introduced LocalMinimumInteractiveComponentSize to replace it. ( I7a7ac )
• SearchBarColors constructor is now public. ( I769ca )
• Added a gesturesEnabled parameter to SwipeToDismissBox . ( Idc59f , b/324170119 )
• Removed text field APIs that were marked as deprecated and experimental. ( I1305f )

نسخه 1.3.0-alpha03

20 مارس 2024

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

Visual Breaking Changes

• Update focus state overlay to be 0.1f to ensure sufficient color contrast. ( I7ea77 )
• Small adjustments to surface and background color defaults in lightColorScheme and darkColorScheme . ( I9db52 )

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

• Added parameters to customize ExposedDropdownMenu . In particular, menus now have a focusable parameter (default true ) that should be set to false when working with editable text fields. ( I4184c , b/323694447 , b/278609042 )

تغییرات API

• پرچم ScaffoldSubcomposeInMeasureFix حذف شده است. ( Ie2a4b )
• NavigationRailItemColors is now marked as @Immutable . ( If6112 , b/327660613 )
• NavigationBarItemColors is now marked as @Immutable . ( I42a30 , b/298064514 )
• Reorder params in Slider Track composable. ( I9f315 )
• ExposedDropdownMenu is now implemented using Popup . The behavior should be the same except focusable menus with editable text fields may be dismissed when typing on the keyboard.

رفع اشکال

• Surface and Surface container baseline roles have been slightly adjusted, providing more tint in light and dark themes. ( I677a5 )
• Updated Slider and ProgressIndicator colors to follow the new Non-Text Contrast specs. ( I26807 )
• Update focus state overlay to be 0.1f to ensure sufficient color contrast. ( I7ea77 )
• Small adjustments to surface and background color defaults in lightColorScheme and darkColorScheme . ( I9db52 )

نسخه 1.3.0-alpha02

6 مارس 2024

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

تغییرات API

• Making the slider states stable again. Making State.onValueChangeFinished a val again. Wrapping onValueChangeFinished in a rememberUpdatedState . ( I82ab2 , b/322269951 )
• The Navigation components now use the new SurfaceContainer roles. DrawerDefaults now provides distinct standardContainerColor and modalContainerColor attributes. DrawerDefaults.ModalDrawerElevation is now 0.dp . ( I7fbac )
• Removing @Stable from the states of Slider since we're changing state.onValueChangeFinished to a var . ( Ied34a , b/322269951 )
• ModalBottomSheet and StandardBottomSheet animation spec is now a TweenSpec , updated from a spring animation. This resolves an issue with a visible overshoot. Deprecated SheetState constructors without density have now been removed. ( I7babc , b/285847707 )

رفع اشکال

• SurfaceContainer variants are now used by components. Components which formally calculated color with Surface and TonalElevation now use SurfaceContainer roles by default, which are not affected by tonal elevation. ( b/304584161 )
• Fixed bug that caused ElevatedFilterChip 's unselected, disabled container color to be black. ( I400e6 , b/322407043 )
• Fix indeterminate progress indicator when the progress is 0 ( Id6582 )
• Fixed an issue with Slider and RangeSlider on RTL layout ( Iab0e1 )
• Adding SliderRangeTolerance for the slider range calculation since Float rounding can be inaccurate. ( Ic918a , b/324934900 )
• Ensure that the DatePickerDialog displays its buttons when nesting a DateRangePicker or when displaying any type of date picker on small screens with larger fonts. ( Ie4758 , b/325107799 , b/277768544 )
• Menu now leverages the SurfaceContainer role for container color. MenuDefaults.TonalElevation is now 0.dp . ( I135b7 )
• TextField now leverages the SurfaceContainerHighest role for container color. ( I4dced )
• Elevated chips now leverage the SurfaceContainerLow role ( I7cd2f )
• DatePicker container color is now SurfaceContainerHigh . DatePickerDefaults.TonalElevation is now 0.dp . ( Ida753 )
• Updates Bottom Sheets container color and drag handle color. ( I72a0a )
• RichTooltip container color is now SurfaceContainer . ( Ia8b45 )
• SearchBar container color is now SurfaceContainerHighest . SearchBarDefaults.TonalElevation is now 0.dp . ( I88604 )
• Updates switch disabled and unselected tracks/icons to leverage the SurfaceContainerHighest color role. ( I7687a )
• AlertDialog container color is now SurfaceContainerHigh . ( Ie0433 )
• BottomAppBar container color is now SurfaceContainer . TopAppBar onScroll color is now SurfaceContainer . ( I41630 )
• ElevatedCard container color is now SurfaceContainerLow . FilledCard 's container color of SurfaceContainerHighest . ( I35141 )
• ElevatedButton container color is now SurfaceContainerLow . FilledIconButton 's when unselected now have a container color of SurfaceContainerHighest . ( I792c9 )
• Updates TimePicker container color and clock dial color role to SurfaceContainerHighest . ( I43b93 )

نسخه 1.3.0-alpha01

21 فوریه 2024

androidx.compose.material3:material3-*:1.3.0-alpha01 is released. نسخه 1.3.0-alpha01 حاوی این commit ها است.

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

• Update Compose M3 ModalBottomSheet to support Predictive Back on U+ ( Iccf32 , b/281967264 , b/304850357 )
• Updated Compose M3 SearchBar to support Predictive Back on U+ ( I657f8 )
• Updated Slider to improve accessibility by adding a gap and stop indicator. ( I3058e )
• Updated ProgressIndicator to improve accessibility by adding a gap and stop indicator. ( I21451 )
• Adding a default caret for rich tooltip, new rich tooltip API now allows for custom caret to be drawn given anchor LayoutCoordinates . ( Ifd42c )

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

• اجزای متریال برای استفاده از APIهای ریپل جدید منتقل شده اند و دیگر RippleTheme پرس و جو نمی کنند.

تغییرات API

• The fun drawStopIndicator is now public. ( I3f59f )
• Mark the DatePicker 's formatWithSkeleton function as internal ( Ic65dc )
• DropdownMenu now supports custom color, shape, elevation, and border. ( I8e981 , b/289554448 , b/301887035 , b/283654243 )
• Material3 components exposing a MutableInteractionSource in their API have been updated to now expose a nullable MutableInteractionSource that defaults to null . هیچ تغییر معنایی در اینجا وجود ندارد: عبور از null به این معنی است که شما نمی خواهید MutableInteractionSource را بالا ببرید و در صورت نیاز در داخل کامپوننت ایجاد می شود. تغییر به null به برخی از مؤلفه‌ها اجازه می‌دهد تا هرگز یک MutableInteractionSource را تخصیص ندهند، و به سایر مؤلفه‌ها اجازه می‌دهد فقط در صورت نیاز، نمونه‌ای را ایجاد کنند، که عملکرد این مؤلفه‌ها را بهبود می‌بخشد. اگر از MutableInteractionSource که به این مؤلفه ها منتقل می کنید استفاده نمی کنید، توصیه می شود به جای آن، null را ارسال کنید. همچنین توصیه می شود که تغییرات مشابهی را در اجزای خود ایجاد کنید. ( 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. این مورد در نسخه پایدار بعدی حذف می‌شود و فقط به عنوان کمکی موقت برای مهاجرت برای مواردی در نظر گرفته شده است که یک 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 )
• برای بهبود عملکرد، ترکیب فرعی داخل BottomSheetScaffold حذف شد. مشکلی که در آن BottomSheetScaffold در سناریوهای خاص در ترکیب با 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. نسخه 1.2.0 حاوی این commit ها است.

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

• 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

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

New Material Design 3 Components

• بکشید تا تازه شود
  • PullToRefreshContainer
  • PullToRefreshState
• دکمه تقسیم شده
  • SegmentedButton
  • SingleChoiceSegmentedButtonRow
  • MultiChoiceSegmentedButtonRow

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!

نسخه 1.2.0-rc01

24 ژانویه 2024

androidx.compose.material3:material3-*:1.2.0-rc01 is released. نسخه 1.2.0-rc01 حاوی این commit ها است.

رفع اشکال

• 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 )

نسخه 1.2.0-beta02

10 ژانویه 2024

androidx.compose.material3:material3-*:1.2.0-beta02 is released. نسخه 1.2.0-beta02 حاوی این تعهدات است.

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 )

نسخه 1.2.0-beta01

13 دسامبر 2023

androidx.compose.material3:material3-*:1.2.0-beta01 is released. نسخه 1.2.0-beta01 حاوی این تعهدات است.

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

نسخه 1.2.0-alpha08

20 سپتامبر 2023

androidx.compose.material3:material3-*:1.2.0-alpha08 is released. نسخه 1.2.0-alpha08 حاوی این commit ها است.

تغییر رفتار

• ColorScheme is now Immutable, making individual color updates less efficient, but making more common usage of colors more efficient. دلیل این تغییر این است که اکثر برنامه‌ها به‌روزرسانی رنگ‌های جداگانه را به عنوان یک مورد استفاده اصلی ندارند. 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 )
• یک پرچم موقت برای کنترل اینکه آیا Scaffold باید فرزندان خود را در حین اندازه گیری یا در حین قرار دادن اندازه گیری کند، معرفی کرد. به طور پیش فرض، این در اندازه گیری اندازه گیری می شود. اگر در رابطه با رفتار جدید با مشکلاتی روبرو هستید، لطفاً مشکلی را ثبت کنید. ( 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 )

نسخه 1.2.0-alpha07

6 سپتامبر 2023

androidx.compose.material3:material3-*:1.2.0-alpha07 is released. نسخه 1.2.0-alpha07 حاوی این commit ها است.

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

• 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 )
• مشکلی را برطرف کرد که در آن برخی از مؤلفه‌ها با استفاده از Subcomposition (مثلاً BottomSheetScaffold ) در داخل یک داربست در یک LookaheadScope سعی داشتند اندازه خود را خیلی زود بخوانند. ( I297b4 , I871f1 , b/295536718 )

نسخه 1.2.0-alpha06

23 آگوست 2023

androidx.compose.material3:material3-*:1.2.0-alpha06 is released. نسخه 1.2.0-alpha06 حاوی این commit ها است.

رفع اشکال

• محاسبه offset DropdownMenu ثابت شد، بنابراین افست های x صرفاً به جهت طرح بندی محلی بستگی دارد، و زمانی که منو نزدیک به پایین صفحه باشد، افست های y دیگر برعکس نمی شوند. ( Iccc74 , b/294103942 )
• محاسبه offset DropdownMenu ثابت شد، بنابراین افست های x صرفاً به جهت طرح بندی محلی بستگی دارد، و زمانی که منو نزدیک به پایین صفحه باشد، افست های y دیگر برعکس نمی شوند. ( Ib87a2 , b/294103942 )

نسخه 1.2.0-alpha05

9 آگوست 2023

androidx.compose.material3:material3-*:1.2.0-alpha05 is released. نسخه 1.2.0-alpha05 حاوی این commit ها است.

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

نسخه 1.2.0-alpha04

26 جولای 2023

androidx.compose.material3:material3-*:1.2.0-alpha04 is released. نسخه 1.2.0-alpha04 حاوی این commit ها است.

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

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

تغییرات API

• ما وابستگی چگالی را به سطح جزء منتقل می کنیم. این برای مؤلفه‌های زیر اعمال می‌شود: SwipeToDismiss و مؤلفه‌های مبتنی بر برگه. لطفاً از اضافه بار جدید ارائه شده در جایی که چگالی یک پارامتر است استفاده کنید. ( 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 )
• تراز شروع جدید برای FabPosition اضافه شد ( Ib7aea , b/170592777 )

رفع اشکال

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

نسخه 1.2.0-alpha03

21 ژوئن 2023

androidx.compose.material3:material3-*:1.2.0-alpha03 is released. نسخه 1.2.0-alpha03 حاوی این commit ها است.

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

• includeFontPadding is now false by default in Material 3 typography. سبک ارتفاع خط پیش‌فرض نیز به Trim.None و Alignment.Center تغییر یافته است و lineHeight صریح (در sp) به TextStyle Typography اضافه شده است. اگر می‌خواهید این مقادیر را سفارشی کنید، با اسناد API مشورت کنید و برای توضیح عمیق این تغییرات ، پست وبلاگ را ببینید. ( 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 )
• دسترسی بهینه شده برای عملکرد و تخصیص حافظه. ( 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 )

نسخه 1.2.0-alpha02

24 مه 2023

androidx.compose.material3:material3-*:1.2.0-alpha02 is released. نسخه 1.2.0-alpha02 حاوی این commit ها است.

تغییرات 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 )
• برای کنترل وضعیت اسکرول عمودی آیتم های منوی نمایش داده شده، گزینه ای برای عبور در یک ScrollState هنگام ساخت یک DropdownMenu یا یک ExposedDropdownMenu اضافه شده است. ( 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 )
• تغییر نام ویژگی Semantics isContainer به isTraversalGroup ( I121f6 )
• TextStyle.merge(...) بهینه شده با لیست پارامترهای کامل اضافه شد. ( 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 )

رفع اشکال

• عمل رد کردن AlertDialog را برطرف کرد تا زمانی که کنش‌ها روی هم قرار می‌گیرند تا در عرض گفتگو قرار گیرند، در زیر عمل تأیید ظاهر شود. این اصلاح پیاده سازی را با مشخصات طراحی متریال هماهنگ می کند. ( 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 )

نسخه 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. نسخه 1.2.0-alpha01 حاوی این commit ها است.

نسخه 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. نسخه 1.1.1 حاوی این commit ها است.

رفع اشکال

• 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. نسخه 1.1.0 حاوی این commit ها است.

Major features of 1.1.0

New Material Design 3 components

• ورق های پایین
  • ModalBottomSheet , BottomSheetScaffold
• خرماچیان
  • DatePicker , DateRangePicker , DatePickerDialog
• جستجو کنید
  • SearchBar , DockedSearchBar
• SwipeToDismiss
• انتخاب کنندگان زمان
  • TimePicker
  • TimeInput
• نکات ابزار
  • PlainTooltipBox , RichTooltip

Enhancements to existing Material Design 3 components.

Promoted experimental APIs to stable!

Please see this blog post for more details!

نسخه 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. نسخه 1.1.0-rc01 حاوی این commit ها است.

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

نسخه 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. نسخه 1.1.0-beta02 حاوی این تعهدات است.

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

نسخه 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. نسخه 1.1.0-beta01 حاوی این تعهدات است.

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

نسخه 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. نسخه 1.1.0-alpha06 حاوی این commit ها است.

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

• 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 )
• گیرنده ویژگی بازیابی LocalMinimuTouchTargetEnforcement و علامت گذاری آن به عنوان منسوخ شده و هدایت به LocalMinimumInteractiveComponentEnforcement . ( I60dd5 )

نسخه 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. نسخه 1.1.0-alpha05 حاوی این commit ها است.

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

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

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

• Compose UI and Compose Material now depend on Lifecycle 2.6.0 .

نسخه 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. نسخه 1.1.0-alpha04 حاوی این commit ها است.

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

• 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

• در ویژگی معنایی IsContainer در Surfaces اضافه شده است. این ویژگی در تغییر بعدی استفاده خواهد شد که ترتیب پیمایش را بر اساس معنای معنایی عناصری مانند سطوح تعیین می کند. ( I63379 )
• Mark navigation drawer related APIs as stable. ( Iab01e , b/261439597 )
• یک پارامتر رنگ مسیر برای نشانگرهای پیشرفت دایره ای، و یک پارامتر سرپوش برای هر دو شاخص پیشرفت دایره ای و خطی اضافه شده است. ( Ie668c , b/216325962 , b/222964817 )
• تهی پذیری بیشتر نوع بازگشت توابع منسوخ-مخفی ( Ibf7b0 )
• Modifier.minimumInteractiveComponentSize اضافه کنید. اگر عنصر کوچکتر باشد، می توان از آن برای رزرو حداقل 48.dp در اندازه برای رفع ابهام از تعاملات لمسی استفاده کرد. ( I33f58 , b/258495559 )
• Added experimental API for AlertDialog composable that has a content slot. ( Iec4a2 )

رفع اشکال

• پیشرفت برای شاخص های پیشرفت اکنون به درستی به محدوده مورد انتظار آن محدود شده است. ( I8a7eb , b/262262727 )

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

• هنگام به‌روزرسانی از androidx.compose.foundation:1.4.0-alpha03 به androidx.compose.foundation:1.4.0-alpha04 ، ممکن است با خطای java.lang.NoSuchFieldError مواجه شوید. اینجا جایی است که موضوع در ابتدا گزارش شده است. اصلاحی ارسال شده است و در به‌روزرسانی بعدی Compose در دسترس خواهد بود. به عنوان یک کار، کتابخانه های androidx.compose.material و androidx.compose.material3 خود را به آخرین نسخه (1.1.0-alpha04) به روز کنید یا androidx.compose.foundation خود را به 1.4.0-alpha03 تنزل دهید.

نسخه 1.1.0-alpha03

7 دسامبر 2022

androidx.compose.material3:material3:1.1.0-alpha03 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha03 are released. نسخه 1.1.0-alpha03 حاوی این commit ها است.

تغییرات 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 )
• یک Modifier API برای جستجوی اطلاعات اسکرول اجداد اضافه شده است. ( I2ba9d , b/203141462 )
• در Clickable برای به تأخیر انداختن صحیح تعاملات مطبوعاتی استفاده می‌شود، زمانی که حرکات ممکن است به رویدادهای پیمایش تبدیل شوند.
• هنگامی که در داخل یک Scrollable ViewGroup استفاده می شود، Clickables کلیکی ثابت شد که امواج را به درستی به تاخیر نمی اندازند.
• کشوها و برگه‌ها برای تأخیر صحیح فشارها در صورتی که حرکات ممکن است به رویدادهای پیمایش تبدیل شوند، به‌روزرسانی شدند.

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

• Compose UI و Compose Material اکنون به Lifecycle 2.5.1 بستگی دارد. ( I05ab0 , b/258038814 )

نسخه 1.1.0-alpha02

9 نوامبر 2022

androidx.compose.material3:material3:1.1.0-alpha02 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 are released. نسخه 1.1.0-alpha02 حاوی این commit ها است.

تغییرات API

• awaitFirstDown and waitForUpOrCancellation now accept a PointerEventPass for greater flexibility (also fixes ExposedDropdownMenuBox showing a menu while scrolling).( I7579a , b/212091796 )
• اضافه شدن پارامتر minLines به متریال و متریال3 Text، TextField و OutlinedTextField که امکان تنظیم حداقل ارتفاع جزء بر حسب تعداد خطوط را فراهم می کند ( I4af1d )
• Deprecate the TopAppBarDefaults smallTopAppBarColors function in favor of a new topAppBarColors function that should be used when creating a TopAppBar . ( Ie6cb9 )
• پارامتر minLines به BasicText و BasicTextField اضافه شد. این اجازه می دهد تا حداقل ارتفاع این ترکیبات را از نظر تعداد خطوط تنظیم کنید ( 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 )

نسخه 1.1.0-alpha01

24 اکتبر 2022

androidx.compose.material3:material3:1.1.0-alpha01 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 are released. نسخه 1.1.0-alpha01 حاوی این commit ها است.

رفع اشکال

• Fixes to the top app bar when title is applied with a TextStyle and a Brush. ( If667e )

نسخه 1.0

نسخه 1.0.1

9 نوامبر 2022

androidx.compose.material3:material3:1.0.1 and androidx.compose.material3:material3-window-size-class:1.0.1 are released. نسخه 1.0.1 حاوی این commit ها است.

رفع اشکال

• Updates Material3 Medium and Large top app bars to apply the same background color across their entire surface, and to allow setting overriding the default colors with transparent color values. ( I67659 , b/249688556 , b/250838918 )

نسخه 1.0.0

24 اکتبر 2022

androidx.compose.material3:material3:1.0.0 and androidx.compose.material3:material3-window-size-class:1.0.0 are released. نسخه 1.0.0 حاوی این commit ها است.

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

This is the first stable release of Compose Material 3!

Material Design 3 theming and Material You dynamic color

• MaterialTheme
• رنگ
  • ColorScheme
  • lightColorScheme , darkColorScheme
• Dynamic color
  • dynamicLightColorScheme , dynamicDarkColorScheme
• تایپوگرافی
  • تایپوگرافی
• اشکال
  • اشکال

Material Design 3 components

• نشان
  • Badge , BadgedBox
• Bottom App Bar
  • BottomAppBar
• دکمه ها
  • Button , ElevatedButton , FilledTonalButton , OutlinedButton , TextButton
• FAB and extended FAB
  • SmallFloatingActionButton , FloatingActionButton , LargeFloatingActionButton , ExtendedFloatingActionButton
• کارت ها
  • Card , OutlinedCard , ElevatedCard
• چک باکس
  • چک باکس
• چیپس
  • AssistChip , ElevatedAssistChip , FilterChip , ElevatedFilterChip , InputChip , SuggestionChip , ElevatedSuggestionChip
• دیالوگ ها
  • AlertDialog
• تقسیم کننده
  • تقسیم کننده
• منوی کشویی
  • DropdownMenu , DropdownMenuItem , ExposedDropdownMenuBox
• فهرست کنید
  • List Item
• نوار ناوبری
  • نوار ناوبری
• کشوی ناوبری
  • ModalNavigationDrawer , ModalDrawerSheet , DismissibleNavigationDrawer , DismissibleDrawerSheet , PermanentNavigationDrawer , PermanentDrawerSheet
• ریل ناوبری
  • NavigationRail
• شاخص پیشرفت
  • CircularProgressIndicator , LinearProgressIndicator
• دکمه رادیو
  • RadioButton
• لغزنده
  • Slider , RangeSlider
• سوئیچ
  • سوئیچ
• زبانه ها
  • Tab , LeadingIconTab , TabRow , ScrollableTabRow
• فیلدهای متنی
  • TextField , OutlinedTextField
• نوار برنامه بالا
  • TopAppBar , CenterAlignedTopAppBar , MediumTopAppBar , LargeTopAppBar
• نماد
  • Icon , IconButton
• متن
  • متن
• سطح
  • سطح
• طرح بندی
  • داربست
• Content color
  • LocalContentColor

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!

نسخه 1.0.0-rc01

5 اکتبر 2022

androidx.compose.material3:material3:1.0.0-rc01 and androidx.compose.material3:material3-window-size-class:1.0.0-rc01 are released. نسخه 1.0.0-rc01 حاوی این commit ها است.

تغییرات API

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

نسخه 1.0.0-beta03

21 سپتامبر 2022

androidx.compose.material3:material3:1.0.0-beta03 and androidx.compose.material3:material3-window-size-class:1.0.0-beta03 are released. نسخه 1.0.0-beta03 شامل این تعهدات است.

تغییرات API

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

نسخه 1.0.0-beta02

7 سپتامبر 2022

androidx.compose.material3:material3:1.0.0-beta02 and androidx.compose.material3:material3-window-size-class:1.0.0-beta02 are released. نسخه 1.0.0-beta02 شامل این تعهدات است.

تغییرات API

• Default components insets introduced in m3 components in beta01 version no longer account for IME insets.
• Material3 Scaffold component now has a contentWindowInsets parameter, allowing to specify the amount of insets to handle for the content slot. ( Icf11a , b/243713323 )
• Deprecates the experimental Material 3 SmallTopAppBar function and introduces an 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 )

نسخه 1.0.0-beta01

24 آگوست 2022

androidx.compose.material3:material3:1.0.0-beta01 and androidx.compose.material3:material3-window-size-class:1.0.0-beta01 are released. نسخه 1.0.0-beta01 شامل این تعهدات است.

مرجع API

To see latest theming, component and other composables available check out the Compose Material 3 API reference overview .

تغییرات API

• Updated the Material 3 top app bar to snap into a fully collapsed to a fully extended state. Also, updated the TopAppBarDefaults behavior function to be Composables and provide default values for their top app bar state and animation spec. ( I642b3 )
• Updated FAB component signatures to match surface API ( I3afaa )
• Added insets Build-in support for Top app bars, drawers, navigation bar and rail. These components, when used separately or with Scaffold will automatically handle insets for developers. Note: This change doesn't add automatic handling of status bar icons and transparency of the status and navigation bars. Please, continue to do it manually to ensure the best edge-to-edge experience. ( I7e4e6 , b/183161866 )
• Updated component defaults to reduce API surface for future flexibility and performance improvements. ( I31820 )
• Reordered chip and navigation drawer sheet parameters to maintain consistency within the API ( I45d0b )
• Removed startIndent from Divider and moved color to be the last parameter.( If7be2 )

نسخه 1.0.0-alpha16

10 آگوست 2022

androidx.compose.material3:material3:1.0.0-alpha16 and androidx.compose.material3:material3-window-size-class:1.0.0-alpha16 are released. نسخه 1.0.0-alpha16 حاوی این commit ها است.

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

• Support specifying a custom width on a navigation drawer. ( Ia7f10 )

تغییرات API

• Reorder Tab and Leading icon tab parameters to maintain consistency within the API ( Ie2637 )
• Marked BadgeDefaults as experimental. ( I98ef3 )
• Remove deprecated navigation drawer function. ( I4f2db )
• Reorder Slider parameters in Material 3 to maintain consistency within the API ( I0aee7 )
• Reorder NavigationBar 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 )

نسخه 1.0.0-alpha15

27 جولای 2022

androidx.compose.material3:material3:1.0.0-alpha15 and androidx.compose.material3:material3-window-size-class:1.0.0-alpha15 are released. نسخه 1.0.0-alpha15 حاوی این commit ها است.

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

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

تغییرات API

• Updates to the FilterChip 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 )

نسخه 1.0.0-alpha14

29 ژوئن 2022

androidx.compose.material3:material3:1.0.0-alpha14 and androidx.compose.material3:material3-window-size-class:1.0.0-alpha14 are released. نسخه 1.0.0-alpha14 حاوی این commit ها است.

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

• Added M3 list implementation, see the documentation for sample usage ( Id7a20 )

تغییرات API

• تغییر نام پارامتر از مقادیر به مقدار در 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 )
• رابط‌ها در کتابخانه‌های کامپوزی اکنون با استفاده از روش‌های رابط پیش‌فرض jdk8 ساخته می‌شوند ( I5bcf1 )
• WindowWidthSizeClass and WindowHeightSizeClass now implement Comparable, so they can be compared using operators (<, <=, >=, >) and other APIs. ( I747d0 )

رفع اشکال

• نمونه نشان را به‌روزرسانی کنید تا توضیحات محتوای معنادارتری ارائه کنید. ( I10b9d )
• Adds option to use the system font size to the Material 3 catalog's theme picker. ( I10605 )
• Adds sample code for Badge and indeterminate progress indicators. ( I8fbe0 )

نسخه 1.0.0-alpha13

1 ژوئن 2022

androidx.compose.material3:material3:1.0.0-alpha13 and androidx.compose.material3:material3-window-size-class:1.0.0-alpha13 are released. نسخه 1.0.0-alpha13 حاوی این commit ها است.

تغییرات API

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

نسخه 1.0.0-alpha12

18 مه 2022

androidx.compose.material3:material3:1.0.0-alpha12 and androidx.compose.material3:material3-window-size-class:1.0.0-alpha12 are released. نسخه 1.0.0-alpha12 حاوی این commit ها است.

رفع اشکال

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

نسخه 1.0.0-alpha11

11 مه 2022

androidx.compose.material3:material3:1.0.0-alpha11 and androidx.compose.material3:material3-window-size-class:1.0.0-alpha11 are released. نسخه 1.0.0-alpha11 حاوی این commit ها است.

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

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

تغییرات API

• تغییر نام TextFieldDefaults.BorderStroke که یک خط مرزی را در OutlinedTextField به 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 )

نسخه 1.0.0-alpha10

20 آوریل 2022

androidx.compose.material3:material3:1.0.0-alpha10 and androidx.compose.material3:material3-window-size-class:1.0.0-alpha10 are released. نسخه 1.0.0-alpha10 حاوی این commit ها است.

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

• material3-window-size-class is a new library that provides support for window size classes: a set of opinionated viewport breakpoints for you to design, develop, and test resizable application layouts against. You can 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 )
• مصرف جزئی (موقعیت پایین یا پایین) در PointerInputChange منسوخ شده است. می توانید از consume() برای مصرف کامل تغییر استفاده کنید. می توانید از isConsumed برای تعیین اینکه آیا شخص دیگری قبلاً تغییر را مصرف کرده است یا خیر استفاده کنید.
• PointerInputChange::copy() اکنون همیشه یک کپی کم عمق ایجاد می کند. این بدان معنی است که کپی های PointerInputChange پس از مصرف یکی از کپی ها مصرف می شود. اگر می خواهید یک PointerInputChange بدون محدودیت ایجاد کنید، به جای آن از سازنده استفاده کنید. ( 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 )

نسخه 1.0.0-alpha09

6 آوریل 2022

androidx.compose.material3:material3:1.0.0-alpha09 is released. نسخه 1.0.0-alpha09 حاوی این commit ها است.

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

• Added Material 3 Switch API ( I2c3ad )

تغییرات API

• Added support for dropdown menus with text fields (aka 'exposed dropdown menus' or 'combo boxes'.) ( I1b832 )
• Added shape parameter to MaterialTheme and Shape sub system. ( I37426 )
• Added an expanded parameter to ExtendedFloatingActionButton to control whether the FAB is expanded or collapsed, with animations between each state. Added Extended FAB overload for extended FABs with trailing text for ExtendedFABs without icon. ( Iba7f1 )

نسخه 1.0.0-alpha08

23 مارس 2022

androidx.compose.material3:material3:1.0.0-alpha08 is released. نسخه 1.0.0-alpha08 حاوی این commit ها است.

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

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

تغییرات API

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

رفع اشکال

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

نسخه 1.0.0-alpha07

9 مارس 2022

androidx.compose.material3:material3:1.0.0-alpha07 is released. نسخه 1.0.0-alpha07 حاوی این commit ها است.

تغییرات API

• Updates to Material 3 Surface API that brings back the overloaded functions for clickable Surfaces, as well as adding a function to support selectable and toggleable Surfaces. ( I4bf18 )
• LazyVerticalGrid و LazyHorizontalGrid اکنون پایدار هستند. ( I307c0 )
• LazyVerticalGrid/LazyHorizontalGrid و تمام apiهای مرتبط به زیر بسته .grid منتقل شدند. لطفا واردات خود را از androidx.compose.foundation.lazy به androidx.compose.foundation.lazy.grid به روز کنید. ( I2d446 )
• تغییر قبلی مربوط به تکیه صرفاً به View برای WindowInsetsControllerCompat برگردانده شد و دوباره به یک پنجره نیاز داشت که برای مدیریت برخی از پرچم‌های پنجره لازم است. ViewCompat.getWindowInsetsController به نفع WindowCompat.getInsetsController منسوخ کرد تا اطمینان حاصل شود که از پنجره صحیح استفاده می شود (مثلاً اگر View در یک گفتگو باشد). ( I660ae , b/219572936 )
• یک LazyVerticalGrid API جدید برای تعریف اندازه‌های محوری اضافه کرد ( I17723 )

رفع اشکال

• Updates to the Card API to follow changes at the Surface API ( I3c8b9 )

نسخه 1.0.0-alpha06

23 فوریه 2022

androidx.compose.material3:material3:1.0.0-alpha06 is released. نسخه 1.0.0-alpha06 حاوی این commit ها است.

تغییرات API

• NavigationDrawerItem is added that represents a single destination within the drawers ( Ic396f , b/218286829 )
• PermanentNavigationDrawer 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 )

نسخه 1.0.0-alpha05

9 فوریه 2022

androidx.compose.material3:material3:1.0.0-alpha05 is released. نسخه 1.0.0-alpha05 حاوی این commit ها است.

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

Added Material Design 3 components

• منوی کشویی
  • 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 )

نسخه 1.0.0-alpha04

26 ژانویه 2022

androidx.compose.material3:material3:1.0.0-alpha04 is released. نسخه 1.0.0-alpha04 حاوی این commit ها است.

تغییرات API

• NonRestartableComposable به متدهایی اضافه شد که بیش از حد متدهای موجود بدون منطق پیچیده هستند. این بررسی‌های حافظه‌سازی تولید شده توسط کامپایلر را کاهش می‌دهد (برابر) برای همه پارامترهایی که در تابع داخلی که فراخوانی می‌شود تکرار می‌شوند. ( I90490 )
• Added Material 3 divider. ( Ica5fc )
• Mark the Checkbox and RadioButton with an experimental API annotation. ( Ie44bb )
• Added support for Material 3 progress indicators. ( Iff232 , b/205023841 )

رفع اشکال

• Update a disabled TextButton's container color to be transparent ( I6b248 , b/213339737 )

نسخه 1.0.0-alpha03

12 ژانویه 2022

androidx.compose.material3:material3:1.0.0-alpha03 is released. نسخه 1.0.0-alpha03 حاوی این commit ها است.

رفع اشکال

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

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

• اکنون به Kotlin 1.6.10 بستگی دارد.

نسخه 1.0.0-alpha02

1 دسامبر 2021

androidx.compose.material3:material3:1.0.0-alpha02 is released. نسخه 1.0.0-alpha02 حاوی این commit ها است.

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

• Add support for checkbox and radiobutton.
• به روز شده تا با Kotlin 1.6.0 سازگار باشد

تغییرات API

• Remove drawer from Material 3's scaffold. ( I04f51 )
• Adds Material 3 Checkbox support. ( Id5542 )
• Adds Material 3 RadioButton support. ( I20334 )

رفع اشکال

• Reduce IconButton ripple radius from 40dp to 20dp. ( I68bbe , b/206674345 )
• Port string fast path for Text changes from compose.material ( I30b03 )
• Fixed but that hardcoded button to always be enabled. ( Iea832 , b/205335456 )

نسخه 1.0.0-alpha01

27 اکتبر 2021

androidx.compose.material3:material3:1.0.0-alpha01 is released. نسخه 1.0.0-alpha01 حاوی این commit ها است.

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

Material Design 3 theming and Material You dynamic color

• MaterialTheme
• رنگ
  • ColorScheme
  • lightColorScheme , darkColorScheme
• Dynamic color
  • dynamicLightColorScheme , dynamicDarkColorScheme
• تایپوگرافی
  • Typography

Material Design 3 components

• دکمه ها
  • Button , ElevatedButton , FilledTonalButton , OutlinedButton , TextButton
• FAB and extended FAB
  • SmallFloatingActionButton , FloatingActionButton , LargeFloatingActionButton , ExtendedFloatingActionButton
• دیالوگ ها
  • AlertDialog
• نوار ناوبری
  • NavigationBar
• کشوی ناوبری
  • NavigationDrawer
• ریل ناوبری
  • 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.