نوشتن مطالب ۳

ساختار

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

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

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

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

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

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

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

برای اطلاعات بیشتر در مورد وابستگی‌ها، به «افزودن وابستگی‌های ساخت» مراجعه کنید.

بازخورد

بازخورد شما به بهبود Jetpack کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نوشتن متریال۳ نسخه عمومی ۱.۰

نسخه ۱.۰.۰-آلفا۰۱

۱۷ آوریل ۲۰۲۴

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 نسخه ۱.۰

نسخه ۱.۰.۰-آلفا۰۷

۱ مه ۲۰۲۴

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 شامل این کامیت‌ها است.

تغییرات API

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

رفع اشکالات

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

نسخه ۱.۰.۰-alpha06

۱۷ آوریل ۲۰۲۴

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 )

نسخه ۱.۰.۰-آلفا۰۵

۶ مارس ۲۰۲۴

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 )

نسخه ۱.۰.۰-آلفا۰۴

۲۱ فوریه ۲۰۲۴

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

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

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

نسخه ۱.۰.۰-آلفا۰۳

۷ فوریه ۲۰۲۴

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 شامل این کامیت‌ها است.

تغییرات API

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

نسخه ۱.۰.۰-آلفا۰۲

۱۳ دسامبر ۲۰۲۳

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

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

• یک NavigationSuiteType «None» اضافه کنید ( If8cb1 ، b/313688598 )

رفع اشکالات

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

نسخه ۱.۰.۰-آلفا۰۱

۱۵ نوامبر ۲۰۲۳

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01 منتشر شد. نسخه 1.0.0-alpha01 شامل این کامیت‌ها است.

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

• NavigationSuiteScaffold
  • طرح بندی NavigationSuiteScaffold
  • ناوبری سوئیت

نوشتن متریال ۳ نسخه تطبیقی ​​۱.۰

نسخه ۱.۰.۰-alpha06

۷ فوریه ۲۰۲۴

androidx.compose.material3:material3-adaptive:1.0.0-alpha06 ، androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06 و androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06 منتشر شدند. نسخه 1.0.0-alpha06 شامل این کامیت‌ها است.

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

• گزینه‌های رفتاری بیشتری برای ناوبری برگشتی ThreePaneScaffoldNavigator اضافه شد. ( I858aa )
• محتوای مقصد اختیاری به تاریخچه ناوبری اضافه شد. ( Ibd7e6 )

نسخه ۱.۰.۰-آلفا۰۵

۲۴ ژانویه ۲۰۲۴

androidx.compose.material3:material3-adaptive:1.0.0-alpha05 ، androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05 و androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05 منتشر شده‌اند. نسخه 1.0.0-alpha05 شامل این کامیت‌ها است.

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

• پشتیبانی از آگاهی از تاریخچه در پیمایش داربست و محاسبه مقدار ( I71d46 )

نسخه ۱.۰.۰-آلفا۰۴

۱۰ ژانویه ۲۰۲۴

androidx.compose.material3:material3-adaptive:1.0.0-alpha04 ، androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04 و androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04 منتشر شده‌اند. نسخه 1.0.0-alpha04 شامل این کامیت‌ها است.

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

• پشتیبانی لبه به لبه در داربست‌های قاب اضافه شد ( I1b462 )

تغییرات API

• ویژگی‌های مرزهای لولا در Posture به لیستی از اطلاعات لولا ( I24f90 ) منتقل شد.

رفع اشکالات

• رفع مشکل عدم ترکیب مجدد AnimatedPane ( c3f573d )

نسخه ۱.۰.۰-آلفا۰۳

۱۳ دسامبر ۲۰۲۳

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 شامل این کامیت‌ها است.

تغییرات API

• نقش‌های scaffold را به نام‌های مستعار ThreePaneScaffoldRole تغییر دهید. ( I65bd1 )
• یک کلاس پایه برای نقش‌های scaffold ایجاد کنید ( I4784d )
• پارامتر غیرضروری را از محتوای AnimatedPane حذف کنید ( Ibc73b )
• تابع collectWindowSizeAsState را تغییر نام می‌دهد و به جای آن مقادیر خام را برمی‌گرداند ( I480f4 )

نسخه ۱.۰.۰-آلفا۰۲

۲۹ نوامبر ۲۰۲۳

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 شامل این کامیت‌ها است.

تغییرات API

• APIهای ناوبری را از APIهای داربست تطبیقی ​​جدا کنید. ( Ic4045 )
• کلاس GutterSize حذف کنید. ( I785b3 )

رفع اشکالات

• رفع مشکل عدم جابجایی پنل‌ها هنگام عدم استفاده از AnimatedPane ( d88f181 )

نسخه ۱.۰.۰-آلفا۰۱

۱۵ نوامبر ۲۰۲۳

androidx.compose.material3:material3-adaptive:1.0.0-alpha01 منتشر شد. نسخه 1.0.0-alpha01 شامل این کامیت‌ها است.

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

APIهای شرایط تطبیقی ​​Material3:

• وضعیت بدن

APIهای دستورالعمل داربست تطبیقی ​​​​Material3:

• دستورالعمل PaneScaffold
  • ‎راهنمای محاسبه StandardPaneScaffold‎
  • دستورالعمل محاسبه DensePaneScaffold
  • استراتژی تطبیق
  • ThreePaneScaffoldAdaptStrategies
  • سیاست لولا

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

• API های پایه داربست Pane
  • PaneScaffoldScope
  • نقش ThreePaneScaffold
  • مقدار تطبیقی ​​PaneAdaptedValue
  • مقدار ThreePaneScaffold
  • محاسبه‌ی مقدار ThreePaneScaffoldValue
  • پنل متحرک

نوشتن مطالب3 نسخه 1.5

نسخه ۱.۵.۰-آلفا۰۷

۲۲ اکتبر ۲۰۲۵

androidx.compose.material3:material3-*:1.5.0-alpha07 منتشر شد. نسخه 1.5.0-alpha07 شامل این کامیت‌ها است.

تغییرات API

• SearchBar.InputField بهبود یافته با پارامتر keyboardOptions ، که امکان ورودی متن بهینه را با تعیین گزینه‌های صفحه کلید فراهم می‌کند و پارامتر lineLimits که امکان تعیین پیمایش متن را فراهم می‌کند ( Id08a4 ، b/416991049 )

رفع اشکالات

• اشکالی در اسلایدر که در آن تعاملات فشاری هنگام فرود منتشر نمی‌شد، برطرف شد. این تغییر تضمین می‌کند که PressInteraction.Press بلافاصله هنگام awaitFirstDown منتشر می‌شود و بازخورد بصری فوری را ارائه می‌دهد. ( If9e25 , b/308501482 )
• مشکلی که باعث می‌شد نشانگر Tooltip هنگام اسکرول کردن جهت خود را تغییر ندهد، برطرف شد. TooltipBox اکنون هر زمان که پنجره‌ی راهنمای ابزار تغییر جهت می‌دهد، یک تغییر ترکیب ایجاد می‌کند تا از به‌روزرسانی صحیح جهت نشانگر اطمینان حاصل شود. ( I5ad1e ، b/438875827 )

نسخه ۱.۵.۰-alpha06

۸ اکتبر ۲۰۲۵

androidx.compose.material3:material3-*:1.5.0-alpha06 منتشر شد. نسخه 1.5.0-alpha06 شامل این کامیت‌ها است.

تغییرات API

• رنگ‌های اسکرول شده برای AppBarWithSearch اضافه شد. علاوه بر این، رنگ محفظه فیلد ورودی نوار جستجو اکنون به طور پیش‌فرض شفاف است. رنگ محفظه پیش‌فرض خود نوار جستجو بدون تغییر باقی می‌ماند. ( I4fe32 )
• یک نشانگر سرریز پیش‌فرض قابل ترکیب با FloatingToolbar اضافه شد. ( I6a6f8 ، b/415833723 )
• به‌روزرسانی isExpanded به isShowing برای APIهای منو در گروه دکمه‌ها. ( I86309 ، b/412419514 )
• initialIsExpanded به initialIsShowing به‌روزرسانی شد و یک نشانگر سرریز پیش‌فرض قابل ترکیب در ButtonGroupDefaults اضافه شد. ( I6e67c ، b/412419514 )
• ویژگی کشیدن برای تغییر اندازه را از سطح API عمومی حذف کنید ( Ic85ba ، b/437953743 ، b/442636084 )

رفع اشکالات

• ترتیب فوکوس کلیدها در پیمایش صفحه کلید و همچنین RTL را اصلاح کنید. ( Ibba27 ، b/422220597 )
• رفع مشکل پیمایش صفحه کلید شبکه‌ای انتخاب سال در انتخابگر تاریخ. ( I02363 ، b/422425720 ، b/446814683 )
• مشکل پیمایش صفحه‌کلید برای شبکه انتخاب تاریخ در انتخابگرهای تاریخ برطرف شد. ( I594ef ، b/422220597 ، b/422223115 )
• مشکل دریافت فوکوس کیبورد توسط نوار ابزار خارج از صفحه نمایش برطرف شد. ( I01a73 , b/422786812 )
• رفع مشکل نوار ناوبری کیبورد RangeSlider و Slider ( Ib6bcf ، b/424845268 ، b/422942624 )

نسخه ۱.۵.۰-آلفا۰۴

۱۰ سپتامبر ۲۰۲۵

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

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

• اضافه بارهای قابل ترکیب Text اضافه شده که یک لامبدا ColorProducer را می‌پذیرند که امکان تغییر رنگ کارآمد را بدون ایجاد یک ترکیب مجدد کامل فراهم می‌کند. ( I9ff25 ، b/407055128 )

تغییرات API

• نام Scrim() را به LevitatedPaneScrim() تغییر دهید و ویژگی‌های کلاس‌های Levitated و Reflowed را پنهان کنید. ( I090e1 ، b/427953101 )
• مخفی کردن تابع calculatePosture() به عنوان تابع داخلی ( Ie7227 ، b/424442112 )
• نمایش PaneScaffoldHorizontalOrder به عنوان یک API عمومی مهر و موم شده ( Ia4ebe )
• APIهای مربوط به اندازه و وضعیت پنجره را به عنوان آزمایشی علامت‌گذاری کنید. ( I4ee96 )

رفع اشکالات

• ترتیب پیمایش صفحه‌کلید اصلاح شد، به طوری که فوکوس از دکمه‌ی fab به اولین مورد در بالا منتقل شود. ( Icaaa1 ، b/422762939 )
• بهبود ناوبری کشوی کیبورد a11y: کشو دیگر هنگام بسته شدن قابل فوکوس نیست، می‌توان آن را از طریق کلید esc بست و محتوای آن هنگام باز شدن، فوکوس دریافت می‌کند. ( Idb995 ، b/422793544 ، b/422793651 ، b/422797424 )
• صفحه ساعتِ انتخابگر زمان، اکنون به پیمایش/ورودی صفحه‌کلید پاسخ می‌دهد. ( I9d5d9 ، b/425710631 )
• استفاده از لنگر اولیه جدید هنگام تغییر لیست لنگرهای گسترش صفحه ( I91cd1 ، b/438829477 )

نسخه ۱.۵.۰-آلفا۰۳

۲۷ آگوست ۲۰۲۵

androidx.compose.material3:material3-*:1.5.0-alpha03 منتشر شد. نسخه 1.5.0-alpha03 شامل این کامیت‌ها است.

تغییر رفتار

• اندازه کادر انتخاب و رنگ‌های نشانگر برای هماهنگی با مشخصات تنظیم شده‌اند. برای به حداقل رساندن اختلال در رابط کاربری، پرچم isCheckboxStylingFixEnabled برای کمک به مهاجرت اضافه شده است. لطفاً آن را به صورت دستی در برنامه‌های خود فعال کنید. این پرچم در نهایت در نسخه‌های آینده حذف خواهد شد. ( I5bcd3 ، b/304300693 )

تغییرات API

• پارامتر contentPadding برای TopAppBar ( Ia5fea ) اضافه شد.
• اضافه کردن لغو کامپوننت برای داربست مجموعه ناوبری ( I85312 )

رفع اشکالات

• پارامتر containerColor در TimePickerDialog اکنون به درستی اعمال شده است و امکان سفارشی‌سازی رنگ پس‌زمینه‌ی کادر محاوره‌ای را فراهم می‌کند. ( I47f89 , b/403183883 )
• ریل ناوبری مودال دیگر هنگام جمع شدن فوکوس را از دست نمی‌دهد و اکنون در پاسخ به کلید ESC بسته می‌شود. ( ۴۲۵۵۲۵۷ )
• Snackbar حالا ترتیب فوکوس کیبورد را برای دکمه‌های اکشن و رد کردن درست کرده است، دکمه رد کردن همچنین از نمایش یک راهنمای ابزار پشتیبانی می‌کند. ( 11fa13d )

نسخه ۱.۵.۰-آلفا۰۲

۱۳ آگوست ۲۰۲۵

androidx.compose.material3:material3-*:1.5.0-alpha02 منتشر شد. نسخه 1.5.0-alpha02 شامل این کامیت‌ها است.

تغییرات API

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

رفع اشکالات

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

نسخه ۱.۵.۰-آلفا۰۱

۳۰ ژوئیه ۲۰۲۵

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

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

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

تغییرات API

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

رفع اشکالات

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

نوشتن مطالب3 نسخه 1.4

نسخه ۱.۴.۰

۲۴ سپتامبر ۲۰۲۵

androidx.compose.material3:material3-*:1.4.0 منتشر شد. نسخه ۱.۴.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۳.۰:

اطلاعیه‌های تغییر کتابخانه

کتابخانه androidx.compose.material.icons دیگر برای نمایش آیکون‌های متریال در Compose توصیه نمی‌شود ، زیرا نمادهای متریال راه جدید پیش رو هستند. ما انتشار به‌روزرسانی‌های این کتابخانه را متوقف کرده‌ایم و از آخرین نسخه کتابخانه متریال ۳ حذف شده است، اگر هنوز نمی‌توانید مهاجرت کنید، می‌توانید به صورت دستی به آن مراجعه کنید.

در عوض، توصیه می‌کنیم یک فایل XML با فرمت Vector Drawable را از تب اندروید در آدرس https://fonts.google.com/icons دانلود کنید تا به جدیدترین آیکون‌های استایل‌دار دسترسی پیدا کنید: Material Symbols.

چرا دیگر این کتابخانه را توصیه نمی‌کنیم؟ کتابخانه آیکون‌ها ("آیکون‌های متریال") با ظاهر جدیدتر Material Symbols جایگزین شده است و ما دیده‌ایم که این کتابخانه می‌تواند زمان ساخت برنامه‌های شما را به میزان قابل توجهی افزایش دهد زیرا شامل تمام آیکون‌های مختلفی است که ممکن است مورد نیاز نباشند.

برای اطلاعات بیشتر: https://developer.android.com/develop/ui/compose/graphics/images/material

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

• این کتابخانه دیگر وابستگی به material-icons-core اضافه نمی‌کند، بنابراین اگر پروژه شما به آن وابسته است، باید صریحاً آن وابستگی را در فایل‌های build.gradle[.kts] خود اضافه کنید. ( I735ff , b/349894318 )

• رنگ برچسب فعال NavigationBarItem و NavigationRailItem از onSurface به secondary تغییر می‌کند تا قابلیت استفاده، کنتراست رنگ و انسجام درون سیستم ( Ibc297 ) بهبود یابد، برای بازگشت به رفتار قبلی، رنگ‌های پیش‌فرض را کپی کرده و selectedTextColor به MaterialTheme.colorScheme.onSurface تغییر دهید.

• اجزای Material 3 اکنون از MotionScheme جدید برای تعریف حرکت خود استفاده می‌کنند. ( Ie0f93 )

• تغییرات حرکت شاخص پیشرفت دایره‌ای نامعین ( I3c07e )

اجزای جدید طراحی متریال ۳

• HorizontalCenteredHeroCarousel
• VerticalDragHandle
• فیلدهای متنی امن برای فیلدهای ورود رمز عبور
  • SecureTextField
  • OutlinedSecureTextField

بهبودهایی در کامپوننت‌های موجود Material Design 3

• متن اکنون از autoSize پشتیبانی می‌کند
  • متن با رشته
  • متن با annotatedString
• دکوراتورهای Material 3 برای BasicTextField2 اضافه شد
  • Textfield
  • OutlineTextfield
• یک API TimePickerDialog اضافه شده است که می‌تواند برای TimePicker ، TimeInput یا برای داشتن یک نسخه قابل تغییر استفاده شود.
• API های جدید نوار جستجو:
  • نوارهای جستجوی جمع‌شده و «نماهای» جستجوی بسط‌یافته، اکنون ترکیبات جداگانه‌ای هستند:
  • SearchBar یک نوار جستجو را در حالت جمع شده نشان می‌دهد.
  • ExpandedFullScreenSearchBar و ExpandedDockedSearchBar نوار جستجو را در حالت باز شده نشان می‌دهند. این نوارها در یک پنجره جدید باز می‌شوند.
  • SearchBarState برای کنترل وضعیت نوار جستجو
• API های آزمایشی به نسخه پایدار ارتقا یافتند!
• بهبود عملکرد

نسخه ۱.۴.۰-rc01

۱۰ سپتامبر ۲۰۲۵

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

نسخه ۱.۴.۰-بتا۰۳

۲۷ آگوست ۲۰۲۵

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

نسخه ۱.۴.۰-بتا۰۲

۱۳ آگوست ۲۰۲۵

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

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

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

تغییرات API

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

رفع اشکالات

• رفع اشکالی که باعث می‌شد فشردن دکمه‌ی بازگشت، افست کشو را به اشتباه به‌روزرسانی کند. ( I85624 ، b/427778135 )

نسخه ۱.۴.۰-بتا۰۱

۳۰ ژوئیه ۲۰۲۵

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

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

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

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

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

تغییرات API

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

رفع اشکالات

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

نسخه ۱.۴.۰-آلفا۱۸

۱۶ ژوئیه ۲۰۲۵

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

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

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

تغییرات API

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

نسخه ۱.۴.۰-آلفا۱۷

۲ ژوئیه ۲۰۲۵

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

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

• انیمیشن گروه دکمه‌ها را به‌روزرسانی کنید تا هنگام کلیک به جای فشرده شدن، ۷۵٪ از انیمیشن را به حرکت دربیاورد. ( ۵۹۳۹۴۲a ، b/۴۲۳۵۹۶۹۶۷ )

رفع اشکالات

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

نسخه ۱.۴.۰-آلفا۱۶

۱۸ ژوئن ۲۰۲۵

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

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

• یک کامپوننت چرخ فلک قهرمان با تراز وسط اضافه شد ( I6f6d3 )

تغییرات API

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

رفع اشکالات

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

نسخه ۱.۴.۰-آلفا۱۵

۲۰ مه ۲۰۲۵

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

تغییرات API

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

رفع اشکالات

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

نسخه ۱.۴.۰-آلفا۱۴

۷ مه ۲۰۲۵

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

تغییرات API

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

رفع اشکالات

• بهبود عملکرد شاخص‌های پیشرفت موجی: انواع خطی اکنون حدود ۸.۵٪ سریع‌تر و حدود ۱۱٪ تخصیص کمتر بارگذاری می‌شوند، در حالی که انواع دایره‌ای شاهد افزایش قابل توجه سرعت حدود ۴۷٪ و حدود ۳۹٪ کاهش تخصیص هستند. ( I595d8 )

نسخه ۱.۴.۰-آلفا۱۳

۲۳ آوریل ۲۰۲۵

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

تغییرات API

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

رفع اشکالات

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

نسخه ۱.۴.۰-آلفا۱۲

۹ آوریل ۲۰۲۵

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

تغییرات API

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

رفع اشکالات

• ColorScheme.contentColorFor اکنون surfaceDim به onSurface نگاشت می‌کند. ( I8891a )
• پیاده‌سازی DateInputTextField به‌روزرسانی شد تا مشکلی که در آن فیلد ورودی، تاریخ تنظیم‌شده توسط برنامه‌نویسی را نشان نمی‌داد، برطرف شود. ( I6c8d1 ، b/401143451 )
• ترتیب فوکوس talkback برای ریل ناوبری و ریل ناوبری عریض ( I6cf6f ، b/407048224 ) اصلاح شد.

نسخه ۱.۴.۰-آلفا۱۱

۲۶ مارس ۲۰۲۵

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

تغییرات API

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

رفع اشکالات

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

نسخه ۱.۴.۰-آلفا۱۰

۱۲ مارس ۲۰۲۵

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

تغییرات API

• TabRowDefaults.tabIndicatorOffset به نفع TabIndicatorScope.tabIndicatorOffset منسوخ شده است. ( Ib36b3 )
• رفع اشکال تایپی مربوط به فاصله‌گذاری کم محتوا در دکمه‌های پیش‌فرض. ( I19bfe )
• TabRow و ScrollableTabRow به نفع انواع Primary و Secondary از هر کدام منسوخ شده‌اند. ردیف‌های تب Primary و Secondary از نظر مشخصات، عملکرد بهتری دارند و دقیق‌تر هستند. ( I918e2 )
• rememberSliderState و 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 )

نسخه ۱.۴.۰-آلفا۰۹

۲۶ فوریه ۲۰۲۵

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 )

نسخه ۱.۴.۰-آلفا۰۸

۱۲ فوریه ۲۰۲۵

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

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

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

Version 1.4.0-alpha07

۲۹ ژانویه ۲۰۲۵

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

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

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

Version 1.4.0-alpha06

۱۵ ژانویه ۲۰۲۵

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

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 is a behavior change that will impact how inset-aware components behave around a 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 )

Version 1.4.0-alpha05

۱۲ دسامبر ۲۰۲۴

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

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

Version 1.4.0-alpha04

۱۳ نوامبر ۲۰۲۴

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

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

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

Version 1.4.0-alpha03

۳۰ اکتبر ۲۰۲۴

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 )

رفع اشکالات

• Optimize Scaffold contentPadding behavior to avoid always recomposing the body content when the contentPadding changes. ( 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 )
• Make the material Slider change its value when control keys are pressed. ( I1c442 )

Version 1.4.0-alpha02

۱۶ اکتبر ۲۰۲۴

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 )
• Renamed the standardMotionScheme and the expressiveMotionScheme to standard and expressive. 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 )

Version 1.4.0-alpha01

۲ اکتبر ۲۰۲۴

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

نسخه ۱.۳.۲

۹ آوریل ۲۰۲۵

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

رفع اشکالات

• ListItem corrects its intrinsic height calculation, now reserving the appropriate amount of space in Layout.
• Remove excess NavigationBarItem label padding, correctly aligning with spec.
• Corrects TabRow Layout in RTL mode.

نسخه ۱.۳.۱

۳۰ اکتبر ۲۰۲۴

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

رفع اشکالات

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

نسخه ۱.۳.۰

۴ سپتامبر ۲۰۲۴

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

Important changes since 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!
• بهبود عملکرد

Version 1.3.0-rc01

۲۱ آگوست ۲۰۲۴

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

۲۴ ژوئیه ۲۰۲۴

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

۲۶ ژوئن ۲۰۲۴

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

Version 1.3.0-beta03

۱۲ ژوئن ۲۰۲۴

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 )

Version 1.3.0-beta02

۲۹ مه ۲۰۲۴

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 )

Version 1.3.0-beta01

۱۴ مه ۲۰۲۴

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 )
• Updated the API for getting Material themed links in text. Specifically, removed the methods from the TextDefaults for constructing themed LinkAnnotations and parse HTML with themed links. Instead, added a TextLinkStyles class that allows to style the links as a parameter to the Text composable. ( I31b93 )

Version 1.3.0-alpha06

۱ مه ۲۰۲۴

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

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 )

تغییرات API

• RippleConfiguration#isEnabled has been removed, and LocalRippleConfiguration has been made nullable. To disable a ripple, instead of providing a RippleConfiguration with isEnabled = false , provide null to 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 )
• Text links got pressed state styling option in addition to normal styling, hovered and focused. 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 top padding for label now accounts for system font size. ( 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 )

Version 1.3.0-alpha05

۱۷ آوریل ۲۰۲۴

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

• Text links got pressed state styling option in addition to normal styling, hovered and focused ( 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 )

Version 1.3.0-alpha04

۳ آوریل ۲۰۲۴

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 )

Version 1.3.0-alpha03

۲۰ مارس ۲۰۲۴

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

• The ScaffoldSubcomposeInMeasureFix flag has been removed. ( 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 )

Version 1.3.0-alpha02

۶ مارس ۲۰۲۴

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 )

Version 1.3.0-alpha01

۲۱ فوریه ۲۰۲۴

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

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

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

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

• Material components have been migrated to use the new ripple APIs, and no longer query 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 . There are no semantic changes here: passing null means that you do not wish to hoist the MutableInteractionSource , and it will be created inside the component if needed. Changing to null allows for some components to never allocate a MutableInteractionSource , and allows for other components to only lazily create an instance when they need to, which improves performance across these components. If you are not using the MutableInteractionSource you pass to these components, it is recommended that you pass null instead. It is also recommended that you make similar changes in your own components. ( I41abb , b/298048146 )
• Adds RippleConfiguration and LocalRippleConfiguration to allow for per-component / sub-tree customization of ripples using fixed values. For example, to change the color of a component you don't control, or to disable a ripple for a component. In most cases the default values should be used: these APIs are an escape hatch for customization of individual components / limited sub-trees. For wider changes and custom design systems, you should instead build your own ripple using createRippleModifierNode . ( I7b5d6 , b/298048146 )
• Adds new ripple API in material3 which replaces the deprecated rememberRipple . Also adds a temporary CompositionLocal , LocalUseFallbackRippleImplementation , to revert material3 components to using the deprecated rememberRipple / RippleTheme APIs. This will be removed in the next stable release, and is only intended to be a temporary migration aid for cases where you are providing a custom RippleTheme . ( I34cbc , b/298048146 )

رفع اشکالات

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

Version 1.2

Version 1.2.1

۶ مارس ۲۰۲۴

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 )

نسخه ۱.۲.۰

۷ فوریه ۲۰۲۴

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

Known Issue

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

Important changes since 1.1.0

New Material Design 3 Components

• برای تازه کردن بکشید
  • PullToRefreshContainer
  • PullToRefreshState
• Segmented Button
  • 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!

Version 1.2.0-rc01

۲۴ ژانویه ۲۰۲۴

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

رفع اشکالات

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

Version 1.2.0-beta02

۱۰ ژانویه ۲۰۲۴

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

Known Bug

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

تغییرات API

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

رفع اشکالات

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

Version 1.2.0-beta01

۱۳ دسامبر ۲۰۲۳

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

تغییرات API

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

رفع اشکالات

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

Version 1.2.0-alpha12

۲۹ نوامبر ۲۰۲۳

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

۱۵ نوامبر ۲۰۲۳

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

۱۸ اکتبر ۲۰۲۳

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

۴ اکتبر ۲۰۲۳

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 و SecondaryScrollableTabRow اکنون حالت اسکرول را نمایش می‌دهند. ( Iec8f5 ، b/260572337 )
• Adding a new sheetMaxWidth parameter that developers can set to specify a maximum width that the sheet will span. Dp.Unspecified can be passed in for the parameter if a sheet that spans the entire screen width is desired. ( Ifb7c9 , b/266697696 )
• Adding back PlainTooltipBox and RichTooltipBox APIs as deprecated methods. ( I246fa )

رفع اشکالات

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

Version 1.2.0-alpha08

۲۰ سپتامبر ۲۰۲۳

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

Behavior Breaking Change

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

تغییرات API

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

رفع اشکالات

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

Version 1.2.0-alpha07

۶ سپتامبر ۲۰۲۳

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

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

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

تغییرات API

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

رفع اشکالات

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

Version 1.2.0-alpha06

۲۳ آگوست ۲۰۲۳

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

رفع اشکالات

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

Version 1.2.0-alpha05

۹ آگوست ۲۰۲۳

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

تغییرات API

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

Version 1.2.0-alpha04

۲۶ ژوئیه ۲۰۲۳

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

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

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

تغییرات API

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

رفع اشکالات

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

Version 1.2.0-alpha03

۲۱ ژوئن ۲۰۲۳

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

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

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

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

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

تغییرات API

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

رفع اشکالات

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

Version 1.2.0-alpha02

۲۴ مه ۲۰۲۳

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

تغییرات API

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

رفع اشکالات

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

Version 1.2.0-alpha01

۱۰ مه ۲۰۲۳

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

Version 1.1

Version 1.1.2

۲۰ سپتامبر ۲۰۲۳

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 )

Version 1.1.1

۲۱ ژوئن ۲۰۲۳

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

رفع اشکالات

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

نسخه ۱.۱.۰

۱۰ مه ۲۰۲۳

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

Major features of 1.1.0

New Material Design 3 components

• Bottom sheets
  • ModalBottomSheet , BottomSheetScaffold
• Date pickers
  • DatePicker , DateRangePicker , DatePickerDialog
• جستجو
  • SearchBar , DockedSearchBar
• SwipeToDismiss
• Time Pickers
  • TimePicker
  • TimeInput
• Tooltips
  • PlainTooltipBox , RichTooltip

Enhancements to existing Material Design 3 components.

Promoted experimental APIs to stable!

Please see this blog post for more details!

Version 1.1.0-rc01

۱۹ آوریل ۲۰۲۳

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

تغییرات API

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

Version 1.1.0-beta02

۵ آوریل ۲۰۲۳

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

تغییرات API

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

رفع اشکالات

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

Version 1.1.0-beta01

۲۲ مارس ۲۰۲۳

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

تغییرات API

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

رفع اشکالات

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

Version 1.1.0-alpha08

۸ مارس ۲۰۲۳

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

February 22, 2023

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

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

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

تغییرات API

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

رفع اشکالات

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

Version 1.1.0-alpha06

February 8, 2023

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

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

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

تغییرات API

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

Version 1.1.0-alpha05

۲۶ ژانویه ۲۰۲۳

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

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

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

Dependency Updates

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

Version 1.1.0-alpha04

۱۱ ژانویه ۲۰۲۳

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

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

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

تغییرات API

• Added in IsContainer semantics property on Surfaces. This property will be used in a later change that determines traversal order based on the semantic meaning of elements such as surfaces. ( I63379 )
• Mark navigation drawer related APIs as stable. ( Iab01e , b/261439597 )
• Added a track color parameter for circular progress indicators, and a stroke cap parameter for both circular and linear progress indicators. ( Ie668c , b/216325962 , b/222964817 )
• More return type nullability of deprecated-hidden functions ( Ibf7b0 )
• Add Modifier.minimumInteractiveComponentSize . It can be used to reserve at least 48.dp in size to disambiguate touch interactions if the element would measure smaller. ( I33f58 , b/258495559 )
• Added experimental API for AlertDialog composable that has a content slot. ( Iec4a2 )

رفع اشکالات

• Progress for progress indicators is now properly bounded to its expected range. ( I8a7eb , b/262262727 )

Known Issue

• When updating from androidx.compose.foundation:1.4.0-alpha03 to androidx.compose.foundation:1.4.0-alpha04 , you might experience a java.lang.NoSuchFieldError error. Here is where the issue was orginially reported. A fix has been submitted, and will be available on the next Compose update. As a work around, update your androidx.compose.material and androidx.compose.material3 libraries to the latest version(1.1.0-alpha04) or downgrade your androidx.compose.foundation to 1.4.0-alpha03.

Version 1.1.0-alpha03

۷ دسامبر ۲۰۲۲

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

تغییرات API

• Renamed consumedWindowInsets() to consumeWindowInsets() and withConsumedWindowInsets() to onConsumedWindowInsetsChanged() and made the Modifiers public. ( Ie44e1 )
• Add new default content padding for text button with icon to use. ( I8f662 )
• Added disabled colors for navigation bar and rail. ( Ia7892 , b/258867034 )
• Added an Modifier API to query ancestors scroll info. ( I2ba9d , b/203141462 )
• Used in Clickable to correctly delay press interactions, when gestures could become scroll events.
• Fixed Clickables not correctly delaying ripples, when used inside an Scrollable ViewGroup .
• Updated Drawers and Sheets to correctly delay presses in case gestures can become scroll events.

Dependency Updates

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

Version 1.1.0-alpha02

۹ نوامبر ۲۰۲۲

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

تغییرات API

• awaitFirstDown and waitForUpOrCancellation now accept a PointerEventPass for greater flexibility (also fixes ExposedDropdownMenuBox showing a menu while scrolling).( I7579a , b/212091796 )
• Added minLines parameter into material and material3 Text, TextField and OutlinedTextField which allows setting the minimum height of the component in terms of number of lines ( I4af1d )
• Deprecate the TopAppBarDefaults smallTopAppBarColors function in favor of a new topAppBarColors function that should be used when creating a TopAppBar . ( Ie6cb9 )
• Added minLines parameter to the BasicText and BasicTextField . It allows to set the minimum height of these composables in terms of number of lines ( I24294 , b/122476634 )

رفع اشکالات

• Clip the content of a Material3 IconButton and IconToggleBotton to the component's state-layer shape (eg circular shape). ( I9da8f )
• Updates Material3 Medium and Large top app bars to apply the same background color across their entire surface, and to allow setting overriding the default colors with transparent color values. ( I67659 , b/249688556 , b/250838918 )

Version 1.1.0-alpha01

October 24, 2022

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

رفع اشکالات

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

نسخه ۱.۰

نسخه ۱.۰.۱

۹ نوامبر ۲۰۲۲

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

رفع اشکالات

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

نسخه ۱.۰.۰

October 24, 2022

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

Major features of 1.0.0

This is the first stable release of Compose Material 3!

Material Design 3 theming and Material You dynamic color

• MaterialTheme
• Color
  • ColorScheme
  • lightColorScheme , darkColorScheme
• Dynamic color
  • dynamicLightColorScheme , dynamicDarkColorScheme
• Typography
  • Typography
• اشکال
  • اشکال

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
• Checkbox
  • Checkbox
• چیپس
  • AssistChip , ElevatedAssistChip , FilterChip , ElevatedFilterChip , InputChip , SuggestionChip , ElevatedSuggestionChip
• Dialogs
  • AlertDialog
• Divider
  • Divider
• Dropdown Menu
  • DropdownMenu , DropdownMenuItem , ExposedDropdownMenuBox
• فهرست
  • ListItem
• نوار ناوبری
  • NavigationBar
• Navigation drawer
  • ModalNavigationDrawer , ModalDrawerSheet , DismissibleNavigationDrawer , DismissibleDrawerSheet , PermanentNavigationDrawer , PermanentDrawerSheet
• Navigation rail
  • NavigationRail
• Progress Indicator
  • CircularProgressIndicator , LinearProgressIndicator
• دکمه رادیویی
  • RadioButton
• اسلایدر
  • Slider , RangeSlider
• سوئیچ
  • سوئیچ
• تب‌ها
  • Tab , LeadingIconTab , TabRow , ScrollableTabRow
• Text Fields
  • TextField , OutlinedTextField
• Top app bar
  • TopAppBar , CenterAlignedTopAppBar , MediumTopAppBar , LargeTopAppBar
• Icon
  • Icon , IconButton
• متن
  • متن
• Surface
  • Surface
• طرح بندی
  • Scaffold
• 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!

Version 1.0.0-rc01

October 5, 2022

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

تغییرات API

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

Version 1.0.0-beta03

۲۱ سپتامبر ۲۰۲۲

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

تغییرات API

• ExposedDropdownMenuDefaults now exposes a padding value for menu items. ( I34ee1 )
• ExposedDropdownMenuBoxScope now has a Modifier.menuAnchor() modifier that should be passed to the text field for proper a11y behavior. ( I27fa3 )
• Adding two overloaded methods for the current Slider API to allow users to pass in a thumb or track to populate the slider. ( I21c00 )

رفع اشکالات

• Updated dark theme color mapping for On Error Container to tone 90 ( Ic5612 )
• Fix to allow setting a transparent background for small Material 3 top app bars. ( I645e2 , b/245575782 )

Version 1.0.0-beta02

۷ سپتامبر ۲۰۲۲

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

تغییرات API

• Default components insets introduced in m3 components in beta01 version no longer account for IME insets.
• Material3 Scaffold component now has a contentWindowInsets parameter, allowing to specify the amount of insets to handle for the content slot. ( Icf11a , b/243713323 )
• Deprecates the experimental Material 3 SmallTopAppBar function and introduces an equivalent TopAppBar function. Please migrate your usage to the new one. ( I74404 , b/226918634 )
• Adds control over the top app bar fling and snap behaviors. ( I15c81 )
• Removes startIndent from Divider, moves color to last parameter. ( If7be2 )

رفع اشکالات

• Have Dialogs identify themselves to talkback users by announcing the word Dialog when they are displayed. ( I857ef )

Version 1.0.0-beta01

August 24, 2022

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

مرجع API

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

تغییرات API

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

Version 1.0.0-alpha16

August 10, 2022

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

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

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

تغییرات API

• Reorder Tab and Leading icon tab parameters to maintain consistency within the API ( Ie2637 )
• Marked BadgeDefaults as experimental. ( I98ef3 )
• Remove deprecated navigation drawer function. ( I4f2db )
• Reorder Slider parameters in Material 3 to maintain consistency within the API ( I0aee7 )
• Reorder NavigationBar and NavigationRail parameters to maintain consistency within the API ( I51cda )
• Reorder parameters in Material 3 to maintain consistency across the API. ( If4ae1 )
• Reorder Slider parameters in Material 3 to maintain consistency within the API ( I62673 )
• Renamed icons parameter to actions to be consistent with top app bar ( Id75be )
• Mark Badge and BadgedBox as experimental because the anchor alignment is still influx. ( I1712e , b/236524516 )
• Change @ExperimentalMaterial3Api annotations on icon button variants to @OptIn ( I070b5 )
• Separated a navigation drawer's content to its own composable to support specifying a custom width on it. ( Ia7f10 )
• Removes Divider from MenuDefaults and TabDefaults ( I4e33c )

Version 1.0.0-alpha15

July 27, 2022

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

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

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

تغییرات API

• Updates to the FilterChip and ElevatedFilterChip APIs to remove the selectedIcon slot and promote reusing the leadingIcon for displaying a selected state. ( Ie5dc2 )
• Add scrim and outline variant color roles. ( Id6d54 )
• Fix naming conventions for composable defaults. ( I62b27 )
• Mark ListItemDefaults and ListItemColors as experimental. ( I1f3ec )
• Changes to the top app bar API to better reflect the meaning of its state properties. Also, mark the top app bar API as experimental. ( Ic0ad8 )
• Text selection colors have now been added to TextFieldColors for better discoverability. ( Iba1b8 )
• Adding ButtonDefault.ButtonWithIconContentPadding to be used with buttons that contain an icon. ( I2bf9c )
• Text fields have been marked as experimental to allow for more flexibility in future API changes. ( I127b5 )
• Removed the @ExperimentalMaterial3Api annotation from the Checkbox function. ( I5eefc )
• Removed the @ExperimentalMaterial3Api annotation from the RadioButton function. ( I17e2a )
• Removed the @ExperimentalMaterial3Api annotation from the non-interactive Cards. ( I9bd49 )
• Updates various component defaults objects to include colors, shapes etc. ( I96e11 )

رفع اشکالات

• Removed non-functioning trailing icons from input chip samples to avoid user confusion in the catalog app. ( I9846a )

Version 1.0.0-alpha14

June 29, 2022

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

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

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

تغییرات API

• Change parameter name from values to value in RangeSlider ( I3b79a )
• API changes to the InputChip implementation to support a selectable state per the Material Design spec. Additional support at the FilterChip colors for selected disabled state. ( I55244 , b/235792432 )
• Add BottomAppBar default FAB ( Ida4c8 )
• ColorScheme.surfaceColorAtElevation was added ( Id41af )
• Interfaces in compose libraries are now built using jdk8 default interface methods ( I5bcf1 )
• WindowWidthSizeClass and WindowHeightSizeClass now implement Comparable, so they can be compared using operators (<, <=, >=, >) and other APIs. ( I747d0 )

رفع اشکالات

• Update badge sample to provide more meaningful content description. ( I10b9d )
• Adds option to use the system font size to the Material 3 catalog's theme picker. ( I10605 )
• Adds sample code for Badge and indeterminate progress indicators. ( I8fbe0 )

Version 1.0.0-alpha13

۱ ژوئن ۲۰۲۲

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

تغییرات API

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

Version 1.0.0-alpha12

۱۸ مه ۲۰۲۲

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

رفع اشکالات

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

Version 1.0.0-alpha11

۱۱ مه ۲۰۲۲

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

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

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

تغییرات API

• Renamed TextFieldDefaults.BorderStroke composable that draws a border stroke in OutlinedTextField to TextFieldDefaults.BorderBox . ( I5f295 )
• Switch m3 visual changes ( Iab30e )
• Allow passing colors to the standard icon buttons. ( Ia2445 )

رفع اشکالات

• Add lint check to material3/Scaffold to ensure that the inner padding is used ( I72293 , b/226951418 )

Version 1.0.0-alpha10

۲۰ آوریل ۲۰۲۲

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

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

• material3-window-size-class is a new library that provides support for window size classes: a set of opinionated viewport breakpoints for you to design, develop, and test resizable application layouts against. You can use calculateWindowSizeClass to retrieve a window size class instance, which you can use to determine how your UI should appear, such as showing a navigation rail instead of bottom navigation for larger window sizes. For more information and sample usage see the API reference documentation for WindowSizeClass . For more information on window size class definitions, see the public guidance on supporting different screen sizes.

تغییرات API

• Adds default FAB elevation for BottomAppBar , removes trailing lambda from BottomAppBar with FAB. ( I92c47 )
• Adds Material3 FilledIconButton , FilledTonalIconButton , and OutlinedIconButton . ( Ib2bda )
• Updates Material 3 Snackbar API to accept color values for the optional action and dismiss-action. ( Ibe4b4 )
• Partial consumption (down OR position) has been deprecated in PointerInputChange . You can use consume() to consume the change completely. You can use isConsumed to determine whether or not someone else has previously consumed the change.
• PointerInputChange::copy() now always makes a shallow copy. It means that copies of PointerInputChange will be consumed once one of the copies is consumed. If you want to create an unbound PointerInputChange , use constructor instead. ( Ie6be4 , b/225669674 )
• Changes to the Cards API to receive the container and content colors via a CardColors interface, and to support a disabled state for clickable cards. ( I927df )
• The parameter backgroundColor has been renamed containerColor in Material 3 text fields for improved consistency with other components. ( I6fbd9 )

رفع اشکالات

• Updates to the standard IconButton to align it with the Material3 spec. ( I09eab )
• Move the top bar height of material3 Scaffold into the padding passed to content, allowing the content to render underneath the top app bar. If the PaddingValues are ignored, then the content might be obscured by the top bar. ( I83cbc , b/217776202 )

Version 1.0.0-alpha09

April 6, 2022

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

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

• Added Material 3 Switch API ( I2c3ad )

تغییرات API

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

Version 1.0.0-alpha08

۲۳ مارس ۲۰۲۲

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

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

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

تغییرات API

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

رفع اشکالات

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

Version 1.0.0-alpha07

March 9, 2022

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

تغییرات API

• Updates to Material 3 Surface API that brings back the overloaded functions for clickable Surfaces, as well as adding a function to support selectable and toggleable Surfaces. ( I4bf18 )
• LazyVerticalGrid and LazyHorizontalGrid are now stable. ( I307c0 )
• LazyVerticalGrid/LazyHorizontalGrid and all related apis were moved into .grid subpackage. Please update your imports from androidx.compose.foundation.lazy to androidx.compose.foundation.lazy.grid. ( I2d446 )
• Reverted previous change of relying solely on a View for WindowInsetsControllerCompat , and again require a Window which is required for managing some window flags. Deprecated ViewCompat.getWindowInsetsController in favor of WindowCompat.getInsetsController to ensure that the correct Window is used (such as if the View is in a dialog). ( I660ae , b/219572936 )
• Added a new LazyVerticalGrid API to define cross axis sizes ( I17723 )

رفع اشکالات

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

Version 1.0.0-alpha06

۲۳ فوریه ۲۰۲۲

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

تغییرات API

• NavigationDrawerItem is added that represents a single destination within the drawers ( Ic396f , b/218286829 )
• PermanentNavigationDrawer and DismissibleNavigationDrawer have been added as experimental APIs. Those are the drawers suitable well for large screen devices. ( I5f8ab , b/218286829 )
• Adds Material 3 bottom app bar support ( Ic432a )
• NavigationDrawer has been renamed to ModalNavigationDrawer ( I1807d , b/218286829 )
• Added Material 3 Slider class and tokens ( I1ccee )
• Added Tab implementation, see the documentation for sample usage ( Ie0146 )

رفع اشکالات

• Fixed an issue where the TalkBack screen reader linear navigation selected an empty top app bar title. ( Id4690 )
• Added IconSize to FloatingActionButtonDefaults . ( Ia71cf )
• Bug fix for hidden AlertDialog buttons when a long text is added with a LazyColumn . ( Ib2cc9 , b/216663029 )

Version 1.0.0-alpha05

۹ فوریه ۲۰۲۲

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

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

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 )

Version 1.0.0-alpha04

۲۶ ژانویه ۲۰۲۲

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

تغییرات API

• Added NonRestartableComposable to methods that are overloads of existing methods without complex logic. This reduces compiler generated memoization checks (equals) for all parameters which are repeated in the inner function that is called. ( I90490 )
• Added Material 3 divider. ( Ica5fc )
• Mark the Checkbox and RadioButton with an experimental API annotation. ( Ie44bb )
• Added support for Material 3 progress indicators. ( Iff232 , b/205023841 )

رفع اشکالات

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

Version 1.0.0-alpha03

۱۲ ژانویه ۲۰۲۲

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

رفع اشکالات

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

Dependency Updates

• Now depends on Kotlin 1.6.10 .

Version 1.0.0-alpha02

۱ دسامبر ۲۰۲۱

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

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

• Add support for checkbox and radiobutton.
• Updated to be compatible with Kotlin 1.6.0

تغییرات API

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

رفع اشکالات

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

Version 1.0.0-alpha01

۲۷ اکتبر ۲۰۲۱

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

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

Material Design 3 theming and Material You dynamic color

• MaterialTheme
• Color
  • ColorScheme
  • lightColorScheme , darkColorScheme
• Dynamic color
  • dynamicLightColorScheme , dynamicDarkColorScheme
• Typography
  • Typography

Material Design 3 components

• دکمه‌ها
  • Button , ElevatedButton , FilledTonalButton , OutlinedButton , TextButton
• FAB and extended FAB
  • SmallFloatingActionButton , FloatingActionButton , LargeFloatingActionButton , ExtendedFloatingActionButton
• Dialogs
  • AlertDialog
• نوار ناوبری
  • NavigationBar
• Navigation drawer
  • NavigationDrawer
• Navigation rail
  • NavigationRail
• Top app bar
  • SmallTopAppBar , CenterAlignedTopAppBar , MediumTopAppBar , LargeTopAppBar
• نشان
  • Badge , BadgedBox
• Icon
  • Icon , IconButton
• متن
  • Text
• Surface
  • 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.