نوشتن مواد 3

نوشتن مواد 3

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

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

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

آخرین به روز رسانی	انتشار پایدار	کاندید را آزاد کنید	نسخه بتا	انتشار آلفا
29 ژانویه 2025	1.3.1	-	-	1.4.0-alpha07

ساختار

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

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

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

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

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

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

شیار

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

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

کاتلین

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

بازخورد

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

یک شماره جدید ایجاد کنید

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

Compose Material3 Common Version 1.0

نسخه 1.0.0-alpha01

17 آوریل 2024

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

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

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

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

Compose Material3 Adaptive Navigation Suite نسخه 1.0

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

نسخه 1.0.0-alpha07

1 مه 2024

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

تغییرات API

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

رفع اشکال

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

نسخه 1.0.0-alpha06

17 آوریل 2024

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

تغییرات API

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

نسخه 1.0.0-alpha05

6 مارس 2024

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

تغییرات API

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

نسخه 1.0.0-alpha04

21 فوریه 2024

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

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

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

نسخه 1.0.0-alpha03

7 فوریه 2024

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

تغییرات API

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

نسخه 1.0.0-alpha02

13 دسامبر 2023

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

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

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

رفع اشکال

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

نسخه 1.0.0-alpha01

15 نوامبر 2023

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

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

• NavigationSuiteScaffold
  • NavigationSuiteScaffoldLayout
  • NavigationSuite

Compose Material3 Adaptive Version 1.0

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

نسخه 1.0.0-alpha06

7 فوریه 2024

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

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

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

نسخه 1.0.0-alpha05

24 ژانویه 2024

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

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

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

نسخه 1.0.0-alpha04

10 ژانویه 2024

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

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

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

تغییرات API

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

رفع اشکال

• رفع AnimatedPane دوباره ساخته نشده است ( c3f573d )

نسخه 1.0.0-alpha03

13 دسامبر 2023

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

تغییرات API

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

نسخه 1.0.0-alpha02

29 نوامبر 2023

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

تغییرات API

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

رفع اشکال

• وقتی از AnimatedPane استفاده نمی‌شود، پنجره‌های ثابت تغییر نمی‌کنند ( d88f181 )

نسخه 1.0.0-alpha01

15 نوامبر 2023

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

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

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

• وضعیت بدن

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

• PaneScaffoldDirective
  • محاسبهStandardPaneScaffoldDirective
  • محاسبه DensePaneScaffoldDirective
  • AdaptStrategy
  • ThreePaneScaffoldAdaptStrategies
  • HingePolicy

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

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

Compose Material3 نسخه 1.4

نسخه 1.4.0-alpha07

29 ژانویه 2025

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

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

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

تغییرات API

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

رفع اشکال

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

مشارکت خارجی

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

نسخه 1.4.0-alpha06

15 ژانویه 2025

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

تغییر رفتار

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

تغییرات API

• به‌روزرسانی‌های TopAppBar API. نوارهای برنامه متوسط ​​و بزرگ را با یک زیرنویس به *FlexibleTopAppBar تغییر نام دهید. تغییرات رنگ را در یک تابع TopAppBarDefault.topAppBarColors() یکپارچه کرد و یک پارامتر رنگ subtitle اضافه کرد تا برای زیرنویس Composable ارائه شده ( I41b65 ) اعمال شود.
• API WideNavigationRailArrangement به نفع Arrangement.Vertical حذف کنید ( Id0341 )
• یک VerticalSlider @Composable اضافه کنید. ( I2bfba )
• یک Track @Composable جدید اضافه کنید که اجازه می‌دهد گوشه‌های آهنگ خارجی سفارشی و نمادهای آهنگ را مشخص کنید. ( I436a4 )
• APIهای نوار ابزار شناور را به‌روزرسانی کنید تا از شی FloatingToolbarColors به ​​جای یک رنگ ظرف استفاده کنید. ( I9a054 )
• اضافه کردن و استفاده از حاشیه نویسی آزمایشی جدید ExperimentalMaterial3ComponentOverrideApi ( Ia1eaf )
• Modifier.indicatorLine اکنون شکلی برای فیلد متنی می گیرد تا برش را مدیریت کند. ( I8c5f3 , b/380704151 )
• تغییر نام توابع آزمایشی FloatingAppBar به FloatingToolbar ( I1dbf8 )
• یک floatingToolbarVerticalNestedScroll جدید اضافه شده است که می تواند به یک ظرف قابل پیمایش متصل شود تا وضعیت گسترش نوار ابزار شناور بر اساس حرکت اسکرول که از آستانه عبور می کند، به روز شود. ( I6d65f )
• معرفی یک API جدید برای ایجاد یک نوار ابزار شناور با یک دکمه عمل شناور متصل (FAB). API گزینه های سفارشی سازی انعطاف پذیری را ارائه می دهد که به شما امکان می دهد نوار ابزار را به صورت افقی یا عمودی مرتب کنید و FAB را در ابتدا یا انتهای نوار ابزار قرار دهید. ( I9e350 )

رفع اشکال

• مشکل دسترس‌پذیری Snackbar را برطرف کنید که باعث شد وقتی TalkBack روشن است، خود را در هنگام رد کردن اعلام کند. ( /I9db53 )

مشارکت خارجی

• BasicTooltip مشترک در فونداسیون و BasicTooltip/Tooltip در material3. ( Ifc2e6 )

نسخه 1.4.0-alpha05

12 دسامبر 2024

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

تغییرات API

• برای خوانایی بهتر، نوع را در مقدار WideNavigationRailState.current/target برای یک enum جایگزین کنید ( I2d6ab )
• SplitButton برای سازگاری باینری، api شکل را از کلاس داده به کلاس تغییر می دهد. ( I53812 )
• یک API راهنمای ابزار اضافه شد که دارای پارامتر onDismissRequest است تا سازندگان بتوانند تصمیم بگیرند که وقتی کاربر خارج از راهنمای ابزار کلیک می کند چه اتفاقی می افتد. API قدیمی که حاوی این پارامتر جدید نیست منسوخ شد. ( I99aef )
• تغییر نام opticalCentering به horizontalCenterOptically . ساختن اصلاح کننده داخلی پارامتر padding را با حداکثر افست شروع و پایان جایگزین کنید. ( I0b904 )
• WideNavigationRailState برای داشتن مقدار فعلی/هدف تغییر دهید، enums را به نفع بولی حذف کنید. ( Idfa29 , b/356039090 )
• NavigationBarItemComponentOverride را اضافه کنید. ( I3a06a )

رفع اشکال

• رفتارهای نوار برنامه بالا و پایین را اصلاح کنید تا زمانی که محتوا تا انتها پیمایش می شود، رنگ آن به طور قابل اعتماد تغییر کند. ( Idc4e8 , b/293665988 )
• توابع رفتار اسکرول برای نوارهای برنامه بالا و پایین اکنون یک رفتار به خاطر سپردن را برای عملکرد بهتر در ترکیب‌های مجدد بازمی‌گردانند. ( I0fdbe , b/207957336 )
• پارامتر اصلاح‌کننده اکنون بعد از اصلاح‌کننده‌های داخلی مانند کشیدن رفتار و معنایی، به جای قبل اعمال می‌شود. این بر ترتیب اعمال اصلاح کننده ها تأثیر می گذارد. ( I8d83f )
• صفحه پایینی باز شده با تغییر اندازه باز می‌ماند. ( I2870b , b/324934884 )
• وضعیت مسیریابی و پرچم های نوار ناوبری را برای ویژگی های ویندوز به درستی انجام دهید. ( Ie674d , b/362539765 )
• همانطور که مستند شده است، پارامتر اصلاح کننده را به ریشه داربست منتقل کنید. این پیاده سازی را با M2 هماهنگ می کند. ( I0235e , b/372311595 )

مشارکت خارجی

• تابع DatePickerDialog مشترک. ( I7dced )

نسخه 1.4.0-alpha04

13 نوامبر 2024

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

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

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

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

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

تغییرات API

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

رفع اشکال

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

نسخه 1.4.0-alpha03

30 اکتبر 2024

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

تغییرات API

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

رفع اشکال

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

نسخه 1.4.0-alpha02

16 اکتبر 2024

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

تغییرات API

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

رفع اشکال

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

نسخه 1.4.0-alpha01

2 اکتبر 2024

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

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

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

تغییرات API

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

رفع اشکال

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

Compose Material3 نسخه 1.3

نسخه 1.3.1

30 اکتبر 2024

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

رفع اشکال

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

نسخه 1.3.0

4 سپتامبر 2024

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

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

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

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

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

نسخه 1.3.0-rc01

21 آگوست 2024

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

رفع اشکال

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

نسخه 1.3.0-beta05

24 جولای 2024

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

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

نسخه 1.3.0-beta04

26 ژوئن 2024

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

نسخه 1.3.0-beta03

12 ژوئن 2024

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

مشارکت خارجی

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

نسخه 1.3.0-beta02

29 مه 2024

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

تغییرات API

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

رفع اشکال

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

مشارکت خارجی

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

نسخه 1.3.0-beta01

14 مه 2024

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

تغییرات API

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

نسخه 1.3.0-alpha06

1 مه 2024

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

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

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

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

تغییرات API

• RippleConfiguration#isEnabled حذف شده است ، و LocalRippleConfiguration قابل برگشت است. برای غیرفعال کردن موج دار ، به جای فراهم کردن یک RippleConfiguration با isEnabled = false ، null به LocalRippleConfiguration ارائه دهید. ( I22725 )
• ModalBottomSheet با دقت بیشتری هنگام فعال کردن لبه به لبه ، Scrim را از نوار وضعیت ترسیم می کند. محتوای ورق پایین معین هم اکنون می تواند از پنجره های پنجره استفاده کند و محتوای قابل مشاهده در بالای نوار ناوبری را فراهم می کند. windowInsets پارامتر ModalBottomSheet به contentWindowInsets تغییر نام داده اند تا مشخص کنند که در آن موارد استفاده می شود ، اینها دیگر به منطق پنجره گره خورده اند. نوع contentWindowInsets به تابعی تغییر یافته است که WindowInsets برمی گرداند ، تا اجازه دهد در پنجره جدید خود حل شود. ( i39630 ، b/274872542 ، b/300280229 ، b/290893168 )
• PrimaryScrollableTabRow و SecondaryScrollableTabRow اکنون به جای زیرمجموعه از طرح بندی سفارشی استفاده می کنند که باید عملکرد را بهبود بخشد. ( i991e0 )
• لینک های متنی علاوه بر یک ظاهر طراحی شده معمولی ، گزینه یک ظاهر طراحی شده حالت را تحت فشار قرار داده اند. روشهای TextDefaults هر یک برای پشتیبانی از آن یک آرگومان pressedStyle به دست آوردند. ( IC473F ، B/139312671 )

رفع اشکال

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

نسخه 1.3.0-alpha05

17 آوریل 2024

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

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

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

تغییرات API

• پیوندهای متنی علاوه بر یک ظاهر طراحی شده معمولی ، گزینه یک ظاهر طراحی شده حالت فشرده شده ، معلق و متمرکز شده است ( I5F864 ، B/139312671 )
• به روز شده CarouselItemInfo برای افشای یک ماسک راست که این کالا توسط ( I785D8 ) قطع شده است
• BasicTooltipState از API عمومی Material 3 حذف کرد. عملکرد آن با TooltipState ترکیب می شود تا زمانی که BasicTooltip بنیاد تثبیت شود. ( ICDA29 )
• یک شیء TextDefaults اضافه شده است که شامل روش هایی برای ساخت یک LinkAnnotation و تجزیه رشته با برچسب HTML است که MaterialTheme به لینک ها اعمال می کند ( I98532 ، B/139312671 )
• ExposedDropdownMenuBoxScope دیگر زیر کلاس ها اجازه نمی دهد. منوهای کشویی در معرض اکنون دارای یک MenuAnchorType هستند که برای پشتیبانی از بهتر A11y باید به menuAnchor منتقل شود. این باید به جای عبور از focusable در معرض ExposedDropdownMenu ، که اکنون کاهش یافته است ، استفاده شود. menuAnchor یک پارامتر جدید برای کنترل حالت enabled دارد. ( i55ee6 ، b/257209915 ، b/308840226 )
• در هنگام غیرفعال کردن ، رنگ مرزی OutlinedButton را برطرف کرد. اضافه بار اضافه بار ButtonDefaults.outlinedButtonBorder("enabled") اضافه بار که وضعیت فعال شده را می گیرد. ( IE650B ، b/318461363 )
• برای کمک به مشتریان در مورد اطلاعات در مورد اندازه مورد ، یک کلاس جدید CarouselItemInfo اضافه کرد. ( i9070c )
• سازنده ColorScheme بدون ظروف سطحی اکنون کاهش یافته است. لطفاً به سازنده ای که شامل ظروف سطحی است ، مهاجرت کنید. ( i35c11 )
• [مشخص شده] TextFieldDefaults ContainerBox به Container تغییر نام داد. ( IE8D3B )

رفع اشکال

• اگر sheetSwipeEnabled نادرست باشد ، دیگر از طریق صفحه BottomSheetScaffold از پیمایش تو در تو کشت نمی شود. ( i5e1c1 ، b/306464779 )
• برخی از حاشیه نویسی های ExperimentalMaterial3Api Optin را در IconButtonSamples.kt حذف کرد. ( I111D1 )

نسخه 1.3.0-alpha04

3 آوریل 2024

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

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

• دو نسخه آزمایشی از Carousel Material3 اضافه شده است - HorizontalMultiBrowseCarousel و HorizontalUncontainedCarousel ( I88D64 )
• به روز شده Compose M3 NAV کشو ( ModalDrawerSheet و DismissibleDrawerSheet ) برای پشتیبانی از پیش بینی برگشت در U+ به عنوان OPT-IN ( IE5B0B )
• یک API جدید را در نماد اضافه کرد تا رنگ رنگی به عنوان لامبدا برای جلوگیری از بازپرداخت. ( i5b5a2 )
• API های نوار برنامه برتر اکنون از ارتفاعات سفارشی برای هر دو بخش ثابت و جمع آوری شده پشتیبانی می کنند. ( IB8B0C ، B/323403446 )

تغییرات API

• API های نوار برنامه برتر اکنون از ارتفاعات سفارشی برای هر دو بخش ثابت و جمع آوری شده پشتیبانی می کنند. مسئله ای را برطرف کرد که باعث شد میله های برنامه های برتر تک خطی در هنگام پیمایش محتوا بارها و بارها دوباره به دست بیاورند. مشکلی را حل کرد که در آن MediumTopAppBar عناوین را در دستگاه هایی با تنظیمات بزرگ قلم/نمایشگر کوتاه کرد. ( IB8B0C ، B/323403446 ، B/300953236 ، B/286296147 ، B/330410290 ، B/308540676 )
• SegmentedButton و API های مرتبط اکنون پایدار هستند ( i8a158 )
• SwipeToDismissBox ، SwipeToDismissBoxDefaults ، SwipeToDismissBoxState و SwipeToDismissBoxValue اکنون پایدار هستند. ( i5f000 )
• جدا شده DismissDirection و حذف و تخلیه و API های DismissValue . ( i89ccd )
• یک برچسب آزمایشی به شیء همراه CarouselState Carousel اضافه کرد. ( I94154 )
• deprecate LocalMinimumInteractiveComponentEnforcement کاهش داده و LocalMinimumInteractiveComponentSize برای جایگزینی آن معرفی کنید. ( i7a7ac )
• سازنده SearchBarColors اکنون عمومی است. ( i769ca )
• یک پارامتر gesturesEnabled به SwipeToDismissBox اضافه کرد. ( IDC59F ، B/324170119 )
• API های فیلد متن حذف شده که به عنوان مستهلک و تجربی مشخص شده اند. ( i1305f )

نسخه 1.3.0-alpha03

20 مارس 2024

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

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

• برای اطمینان از کنتراست رنگ کافی ، روکش حالت تمرکز را به روز کنید. ( i7ea77 )
• تنظیمات کوچک به پیش فرض های رنگ سطح و پس زمینه در lightColorScheme و darkColorScheme . ( i9db52 )

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

• پارامترهای اضافه شده برای سفارشی سازی ExposedDropdownMenu . به طور خاص ، منوها اکنون یک پارامتر focusable ( true پیش فرض) دارند که هنگام کار با زمینه های متن قابل ویرایش باید روی false تنظیم شود. ( i4184c ، b/323694447 ، b/278609042 )

تغییرات API

• پرچم ScaffoldSubcomposeInMeasureFix حذف شده است. ( IE2A4B )
• NavigationRailItemColors اکنون به عنوان @Immutable مشخص شده است. ( IF6112 ، b/327660613 )
• NavigationBarItemColors اکنون به عنوان @Immutable مشخص شده است. ( i42a30 ، b/298064514 )
• پارامترهای تنظیم مجدد در آهنگ کشویی قابل تنظیم. ( i9f315 )
• اکنون ExposedDropdownMenu با استفاده از Popup اجرا شده است. این رفتار باید یکسان باشد به جز منوهای قابل توجه با زمینه های متن قابل ویرایش ممکن است هنگام تایپ روی صفحه کلید رد شود.

رفع اشکال

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

نسخه 1.3.0-alpha02

6 مارس 2024

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

تغییرات API

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

رفع اشکال

• انواع SurfaceContainer اکنون توسط قطعات استفاده می شود. مؤلفه هایی که به طور رسمی رنگ را با سطح و TonalElevation محاسبه می کنند ، اکنون به طور پیش فرض از نقش های SurfaceContainer استفاده می کنند ، که تحت تأثیر ارتفاع تونال قرار نمی گیرند. ( b/304584161 )
• اشکال ثابت که باعث شده رنگ کانتینر غیر منتخب و غیر قابل انتخاب ElevatedFilterChip سیاه شود. ( i400e6 ، b/322407043 )
• هنگامی که پیشرفت 0 است ، نشانگر پیشرفت نامشخص را برطرف کنید ( ID6582 )
• مسئله ای را با Slider و RangeSlider بر روی چیدمان RTL ( IAB0E1 ) برطرف کرد
• اضافه کردن SliderRangeTolerance برای محاسبه دامنه کشویی از دور شدن شناور می تواند نادرست باشد. ( IC918A ، B/324934900 )
• اطمینان حاصل کنید که DatePickerDialog هنگام لانه سازی DateRangePicker یا هنگام نمایش هر نوع انتخاب کننده تاریخ در صفحه های کوچک با فونت های بزرگتر ، دکمه های خود را نشان می دهد. ( IE4758 ، B/325107799 ، B/277768544 )
• اکنون Menu نقش SurfaceContainer را برای رنگ کانتینر اعمال می کند. MenuDefaults.TonalElevation اکنون 0.dp است. ( i135b7 )
• TextField اکنون نقش SurfaceContainerHighest را برای رنگ کانتینر اعمال می کند. ( i4dced )
• تراشه های مرتفع اکنون نقش SurfaceContainerLow ( I7CD2F ) را اهرم می کنند
• رنگ کانتینر DatePicker اکنون SurfaceContainerHigh است. DatePickerDefaults.TonalElevation اکنون 0.dp است. ( IDA753 )
• ورق های پایین رنگ کانتینر و رنگ دسته را بکشید. ( i72a0a )
• رنگ ظروف RichTooltip اکنون SurfaceContainer است. ( IA8B45 )
• رنگ کانتینر SearchBar اکنون SurfaceContainerHighest است. SearchBarDefaults.TonalElevation اکنون 0.dp است. ( i88604 )
• به روزرسانی ها آهنگ ها و آیکون های غیرفعال و غیر منتخب را سوئیچ می کنند تا از نقش رنگی SurfaceContainerHighest استفاده کنند. ( i7687a )
• رنگ کانتینر AlertDialog اکنون SurfaceContainerHigh است. ( IE0433 )
• رنگ کانتینر BottomAppBar اکنون SurfaceContainer است. رنگ onScroll TopAppBar اکنون SurfaceContainer است. ( I41630 )
• رنگ کانتینر ElevatedCard اکنون SurfaceContainerLow است. رنگ کانتینر FilledCard از SurfaceContainerHighest . ( i35141 )
• رنگ ظروف ElevatedButton اکنون SurfaceContainerLow است. FilledIconButton در هنگام انتخاب نشده اکنون دارای رنگ کانتینر SurfaceContainerHighest است. ( i792c9 )
• به روزرسانی های Container Container TimePicker و نقش شماره شماره گیری ساعت به SurfaceContainerHighest . ( i43b93 )

نسخه 1.3.0-alpha01

21 فوریه 2024

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

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

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

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

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

تغییرات API

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

رفع اشکال

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

نسخه 1.2

نسخه 1.2.1

6 مارس 2024

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

رفع اشکال

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

نسخه 1.2.0

7 فوریه 2024

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

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

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

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

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

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

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

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

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

بهبود عملکرد

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

نسخه 1.2.0-RC01

24 ژانویه 2024

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

رفع اشکال

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

نسخه 1.2.0-beta02

10 ژانویه 2024

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

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

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

تغییرات API

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

رفع اشکال

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

نسخه 1.2.0-beta01

13 دسامبر 2023

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

تغییرات API

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

رفع اشکال

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

نسخه 1.2.0-alpha12

29 نوامبر 2023

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

تغییرات API

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

نسخه 1.2.0-alpha11

15 نوامبر 2023

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

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

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

تغییرات API

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

رفع اشکال

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

نسخه 1.2.0-alpha10

18 اکتبر 2023

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

تغییرات API

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

رفع اشکال

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

نسخه 1.2.0-alpha09

4 اکتبر 2023

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

تغییرات API

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

رفع اشکال

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

نسخه 1.2.0-alpha08

20 سپتامبر 2023

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

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

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

تغییرات API

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

رفع اشکال

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

نسخه 1.2.0-alpha07

6 سپتامبر 2023

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

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

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

تغییرات API

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

رفع اشکال

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

نسخه 1.2.0-alpha06

23 آگوست 2023

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

رفع اشکال

• محاسبه offset DropdownMenu ثابت ، بنابراین جبران خسارات X فقط به جهت طرح محلی بستگی دارد ، و هنگامی که منو در نزدیکی پایین صفحه قرار دارد ، دیگر جبران نمی شود. ( ICCC74 ، B/294103942 )
• محاسبه offset DropdownMenu ثابت ، بنابراین جبران خسارات X فقط به جهت طرح محلی بستگی دارد ، و هنگامی که منو در نزدیکی پایین صفحه قرار دارد ، دیگر جبران نمی شود. ( IB87A2 ، B/294103942 )

نسخه 1.2.0-alpha05

9 آگوست 2023

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

تغییرات API

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

نسخه 1.2.0-alpha04

26 جولای 2023

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

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

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

تغییرات API

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

رفع اشکال

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

نسخه 1.2.0-alpha03

21 ژوئن 2023

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

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

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

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

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

تغییرات API

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

رفع اشکال

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

نسخه 1.2.0-alpha02

24 مه 2023

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

تغییرات API

• پارامتر Insets Window را به ModalBottomSheet اضافه کنید.
  • Scrim for ModalBottomSheet اکنون ممکن است در پشت نوار وضعیت با windowInsets تنظیم شده روی صفر ترسیم شود
  • عملکرد پیش فرض ModalBottomSheet برای ماندن در خارج از میله های سیستم از جمله ناوبری
  • استفاده از نوار نوار وضعیت توسط Drag Handle در حالت لبه به لبه ارائه می شود.
  • BottomSheetDefaults شامل قسمتهای پنجره ای برای BottomSheetWindow است. ( i31200 ، b/274872542 ، b/272973615 ، b /272334475 ، b/268432129 ، b/275849044 ، b/275486106 ، b/268433162 )
• Indicator کاهش داده و برای SecondaryIndicator با Primary M3 اضافه کنید. PrimaryIndicator با عرض محتوای برگه مطابقت دارد در حالی که SecondaryIndicator عرض کامل موجود را در بر می گیرد. SecondaryIndicator معادل Indicator اکنون کاهش یافته است و می تواند یک جایگزین مستقیم باشد. ( I27604 )
• گزینه ای برای عبور در یک ScrollState هنگام ساخت یک DropdownMenu یا یک ExposedDropdownMenu برای کنترل حالت پیمایش عمودی موارد منوی نمایش داده شده اضافه شده است. ( IA0734 ، B/185304441 )
• اضافه بار برای Slider که نسخه ای از مؤلفه است. SliderState ایجاد شده است که تمام اطلاعات مربوط به مسیر فعال فعلی ، اندازه گیری اجزای Slider و منطق کشیدن و ژست را در خود جای داده است. ( i124a5 )
• تغییر نام املاک معنایی isContainer به isTraversalGroup ( I121F6 )
• اضافه شده بهینه شده TextStyle.merge(...) با لیست کامل پارامتر. ( IAD234 ، b/246961787 )
• رابط های عمومی Made TooltipState ، RichTooltipState و PlainTooltipState . Added RichTooltipStateImpl and PlainTooltipStateImpl for default states. Added remember*State functions to obtain these implemented states. Removed TooltipSync in favor of an TooltipDefault.GlobalMutatorMutex . ( I7813d )
• Updated the DatePickerColors to include additional customization options for the date picker divider, navigation, and text input fields colors. ( I1a685 , b/274626815 )
• DatePickerState and the DateRangePickerState are now public interfaces with default implementations that can be retrieved by the rememberDatePickerState and rememberDateRangePickerState . ( I71c52 )
• Removed the dateValidator from DatePicker and DateRangePicker and introduced a SelectableDates interface that can be set on the state to control which dates or years are selectable in the UI. ( Ic2fc6 )
• TimePicker removed from stable API, further changes are expected in the state API ( I3f39a )
• ModalBottomSheet moved to android only. ModalBottomSheet is not recommended for desktop use, and the functionality is not actively maintained. ( Ib3778 )

رفع اشکال

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

Version 1.2.0-alpha01

10 مه 2023

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

نسخه 1.1

نسخه 1.1.2

20 سپتامبر 2023

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

رفع اشکال

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

نسخه 1.1.1

21 ژوئن 2023

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

رفع اشکال

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

نسخه 1.1.0

10 مه 2023

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

Major features of 1.1.0

New Material Design 3 components

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

Enhancements to existing Material Design 3 components.

Promoted experimental APIs to stable!

Please see this blog post for more details!

نسخه 1.1.0-rc01

19 آوریل 2023

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

تغییرات API

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

Version 1.1.0-beta02

5 آوریل 2023

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

تغییرات API

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

رفع اشکال

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

نسخه 1.1.0-beta01

22 مارس 2023

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

تغییرات API

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

رفع اشکال

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

Version 1.1.0-alpha08

8 مارس 2023

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

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

• Added support for BottomSheetScaffold and BottomSheetScaffoldState . ( I063d4 )

تغییرات API

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

رفع اشکال

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

Version 1.1.0-alpha07

22 فوریه 2023

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

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

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

تغییرات API

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

رفع اشکال

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

Version 1.1.0-alpha06

8 فوریه 2023

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

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

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

تغییرات API

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

نسخه 1.1.0-alpha05

26 ژانویه 2023

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

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

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

Dependency Updates

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

نسخه 1.1.0-alpha04

11 ژانویه 2023

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

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

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

تغییرات API

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

رفع اشکال

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

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

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

Version 1.1.0-alpha03

7 دسامبر 2022

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

تغییرات API

• Renamed consumedWindowInsets() to consumeWindowInsets() and withConsumedWindowInsets() to onConsumedWindowInsetsChanged() and made the Modifiers public. ( Ie44e1 )
• Add new default content padding for text button with icon to use. ( I8f662 )
• Added disabled colors for navigation bar and rail. ( Ia7892 , b/258867034 )
• 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 )

نسخه 1.1.0-alpha02

9 نوامبر 2022

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

تغییرات API

• awaitFirstDown and waitForUpOrCancellation now accept a PointerEventPass for greater flexibility (also fixes ExposedDropdownMenuBox showing a menu while scrolling).( I7579a , b/212091796 )
• 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 )

نسخه 1.1.0-alpha01

24 اکتبر 2022

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

رفع اشکال

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

نسخه 1.0

نسخه 1.0.1

9 نوامبر 2022

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

رفع اشکال

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

نسخه 1.0.0

24 اکتبر 2022

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

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

This is the first stable release of Compose Material 3!

Material Design 3 theming and Material You dynamic color

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

Material Design 3 components

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

Window Size Class

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

• Please see this blog post for more details!

نسخه 1.0.0-rc01

5 اکتبر 2022

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

تغییرات API

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

Version 1.0.0-beta03

21 سپتامبر 2022

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

تغییرات API

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

رفع اشکال

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

Version 1.0.0-beta02

7 سپتامبر 2022

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

تغییرات API

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

رفع اشکال

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

نسخه 1.0.0-beta01

24 آگوست 2022

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

مرجع API

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

تغییرات API

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

نسخه 1.0.0-alpha16

10 آگوست 2022

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

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

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

تغییرات API

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

نسخه 1.0.0-alpha15

27 جولای 2022

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

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

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

تغییرات API

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

رفع اشکال

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

نسخه 1.0.0-alpha14

29 ژوئن 2022

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

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

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

تغییرات API

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

رفع اشکال

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

Version 1.0.0-alpha13

1 ژوئن 2022

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

تغییرات API

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

Version 1.0.0-alpha12

18 مه 2022

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

رفع اشکال

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

نسخه 1.0.0-alpha11

11 مه 2022

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

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

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

نسخه 1.0.0-alpha10

20 آوریل 2022

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

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

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

نسخه 1.0.0-alpha09

6 آوریل 2022

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

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

• Added Material 3 Switch API ( I2c3ad )

تغییرات API

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

نسخه 1.0.0-alpha08

23 مارس 2022

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

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

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

تغییرات API

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

رفع اشکال

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

نسخه 1.0.0-alpha07

9 مارس 2022

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

تغییرات API

• Updates to Material 3 Surface API that brings back the overloaded functions for clickable Surfaces, as well as adding a function to support selectable and toggleable Surfaces. ( I4bf18 )
• LazyVerticalGrid 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 )

نسخه 1.0.0-alpha06

23 فوریه 2022

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

تغییرات API

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

رفع اشکال

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

نسخه 1.0.0-alpha05

9 فوریه 2022

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

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

Added Material Design 3 components

• منوی کشویی
  • DropdownMenu , DropdownMenuItem
• کارت ها
  • Card , OutlinedCard , ElevatedCard

تغییرات API

• Deprecated Surface function that takes an onClick callback. Clickable surfaces should be created with an InteractionSource and a Modifier.clickable() . ( I211c6 )
• Added pressed and focused elevation support for FAB. ( Ibb584 )
• Changed the Surface API to receive an InteractionSource which allows controlling its appearance in different states. ( Iafbc8 )

رفع اشکال

• Added missing tertiary colors in dynamic color schemes ( I456c4 , b/214588434 )

نسخه 1.0.0-alpha04

26 ژانویه 2022

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

تغییرات API

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

رفع اشکال

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

Version 1.0.0-alpha03

12 ژانویه 2022

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

رفع اشکال

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

Dependency Updates

• Now depends on Kotlin 1.6.10 .

نسخه 1.0.0-alpha02

1 دسامبر 2021

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

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

• Add support for checkbox and radiobutton.
• 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 )

نسخه 1.0.0-alpha01

27 اکتبر 2021

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

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

Material Design 3 theming and Material You dynamic color

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

Material Design 3 components

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

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