نوشتن مواد 3

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

ساختار

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.0"
    implementation "androidx.compose.material3:material3-window-size-class:1.3.0"
    implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha01"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

کاتلین

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

بازخورد

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

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

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

Compose Material3 Common Version 1.0

نسخه 1.0.0-alpha01

17 آوریل 2024

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

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

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

Compose Material3 Adaptive Navigation Suite نسخه 1.0

نسخه 1.0.0-alpha07

1 مه 2024

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

تغییرات API

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

رفع اشکال

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

نسخه 1.0.0-alpha06

17 آوریل 2024

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

تغییرات API

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

نسخه 1.0.0-alpha05

6 مارس 2024

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

تغییرات API

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

نسخه 1.0.0-alpha04

21 فوریه 2024

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

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

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

نسخه 1.0.0-alpha03

7 فوریه 2024

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

تغییرات API

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

نسخه 1.0.0-alpha02

13 دسامبر 2023

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

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

رفع اشکال

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

نسخه 1.0.0-alpha01

15 نوامبر 2023

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

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

Compose Material3 Adaptive Version 1.0

نسخه 1.0.0-alpha06

7 فوریه 2024

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

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

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

نسخه 1.0.0-alpha05

24 ژانویه 2024

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

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

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

نسخه 1.0.0-alpha04

10 ژانویه 2024

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

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

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

تغییرات API

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

رفع اشکال

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

نسخه 1.0.0-alpha03

13 دسامبر 2023

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

تغییرات API

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

نسخه 1.0.0-alpha02

29 نوامبر 2023

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

تغییرات API

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

رفع اشکال

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

نسخه 1.0.0-alpha01

15 نوامبر 2023

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

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

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

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

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

Compose Material3 نسخه 1.3

نسخه 1.3.0

4 سپتامبر 2024

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

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

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

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

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

نسخه 1.3.0-rc01

21 آگوست 2024

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

رفع اشکال

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

نسخه 1.3.0-beta05

24 جولای 2024

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

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

نسخه 1.3.0-beta04

26 ژوئن 2024

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

نسخه 1.3.0-beta03

12 ژوئن 2024

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

مشارکت خارجی

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

نسخه 1.3.0-beta02

29 مه 2024

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

تغییرات API

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

رفع اشکال

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

مشارکت خارجی

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

نسخه 1.3.0-beta01

14 مه 2024

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

تغییرات API

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

نسخه 1.3.0-alpha06

1 مه 2024

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

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

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

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

تغییرات API

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

رفع اشکال

  • اکنون لنگرهای کشوی کشوی پیمایش با عرض drawerContent مطابقت دارند. ( Ibc72f , b/245355396 )
  • لایه بالای OutlinedTextField برای برچسب اکنون اندازه فونت سیستم را به خود اختصاص می دهد. ( IDc781 )
  • محل بسته ثابت CalendarLocale . ( Ifa235 )
  • [بازگشت پیش‌بینی‌کننده] برای استفاده از منحنی درون‌یابی (0.1، 0.1، 0، 1) انیمیشن‌های پیش‌بینی‌کننده را به‌روزرسانی کنید ( I2591a )

نسخه 1.3.0-alpha05

17 آوریل 2024

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

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

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

تغییرات API

  • پیوندهای متنی علاوه بر استایل معمولی، گزینه استایل حالت فشرده را نیز دریافت کردند، شناور و فوکوس شدند ( I5f864 ، b/139312671 )
  • CarouselItemInfo به‌روزرسانی شد تا ماسکی را نشان دهد .
  • BasicTooltipState از API عمومی Material 3 حذف شد. عملکرد آن با TooltipState ترکیب می شود تا زمانی که BasicTooltip بنیاد تثبیت شود. ( Icda29 )
  • یک شی TextDefaults اضافه کرد که حاوی روش‌هایی برای ساخت LinkAnnotation و تجزیه رشته برچسب‌گذاری شده HTML است که MaterialTheme را روی پیوندها اعمال می‌کند ( I98532 , b/139312671 )
  • ExposedDropdownMenuBoxScope دیگر اجازه زیر کلاس ها را نمی دهد. منوهای کشویی در معرض اکنون دارای یک MenuAnchorType هستند که برای پشتیبانی بهتر a11y باید به menuAnchor منتقل شود. این باید به جای انتقال focusable به ExposedDropdownMenu استفاده شود که اکنون منسوخ شده است. menuAnchor یک پارامتر جدید برای کنترل وضعیت enabled دارد. ( I55ee6 , b/257209915 , b/308840226 )
  • رنگ حاشیه OutlinedButton در صورت غیرفعال بودن ثابت شد. اضافه بار ButtonDefaults.outlinedButtonBorder("enabled") که حالت فعال را می گیرد. ( Ie650b , b/318461363 )
  • یک کلاس CarouselItemInfo جدید اضافه کرد تا به مشتریان کمک کند اطلاعاتی درباره اندازه اقلام دریافت کنند. ( I9070c )
  • سازنده ColorScheme بدون ظروف سطحی اکنون منسوخ شده است. لطفاً به سازنده ای که شامل ظروف سطحی است مهاجرت کنید. ( I35c11 )
  • [نشان داده شده] TextFieldDefaults ContainerBox به Container تغییر نام داد. ( Ie8d3b )

رفع اشکال

  • اگر sheetSwipeEnabled نادرست باشد، BottomSheetScaffold دیگر از پیمایش تو در تو اسکرول نخواهد شد. ( I5e1c1 , b/306464779 )
  • برخی از حاشیه نویسی ExperimentalMaterial3Api OptIn در IconButtonSamples.kt حذف شد. ( I111d1 )

نسخه 1.3.0-alpha04

3 آوریل 2024

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

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

  • دو نسخه آزمایشی از Material3 Carousel اضافه شد - HorizontalMultiBrowseCarousel و HorizontalUncontainedCarousel ( I88d64 )
  • به روز شده Compose M3 Nav Drawer ( ModalDrawerSheet و DismissibleDrawerSheet ) برای پشتیبانی از Predictive Back در U+ به عنوان انتخاب ( Ie5b0b )
  • برای جلوگیری از ترکیب مجدد، یک API جدید در نماد اضافه کرد تا امکان عبور رنگ به صورت لامبدا را فراهم کند. ( I5b5a2 )
  • API های نوار برنامه برتر اکنون از ارتفاع های سفارشی برای بخش های ثابت و تاشو پشتیبانی می کنند. ( Ib8b0c , b/323403446 )

تغییرات API

  • API های نوار برنامه برتر اکنون از ارتفاع های سفارشی برای بخش های ثابت و تاشو پشتیبانی می کنند. مشکلی را برطرف کرد که باعث شد نوارهای بالای برنامه تک خطی بارها هنگام پیمایش محتوا دوباره ترکیب شوند. مشکلی که در آن MediumTopAppBar عناوین را در دستگاه‌هایی با تنظیمات فونت/نمایش بزرگ کوتاه می‌کرد، حل شد. ( Ib8b0c , b/323403446 , b/300953236 , b/286296147 , b/330410290 , b/308540676 )
  • SegmentedButton و APIهای مرتبط اکنون پایدار هستند ( I8a158 )
  • SwipeToDismissBox ، SwipeToDismissBoxDefaults ، SwipeToDismissBoxState و SwipeToDismissBoxValue اکنون پایدار علامت‌گذاری شده‌اند. ( I5f000 )
  • فهرست‌ها و APIهای DismissDirection و DismissValue منسوخ شده حذف شدند. ( I89ccd )
  • یک برچسب آزمایشی به شیء همراه CarouselState Carousel اضافه شد. ( I94154 )
  • LocalMinimumInteractiveComponentEnforcement منسوخ کنید و LocalMinimumInteractiveComponentSize برای جایگزینی آن معرفی کنید. ( I7a7ac )
  • سازنده SearchBarColors اکنون عمومی است. ( I769ca )
  • یک پارامتر gesturesEnabled به SwipeToDismissBox اضافه شد. ( Idc59f , b/324170119 )
  • APIهای فیلد نوشتاری که به‌عنوان منسوخ و آزمایشی علامت‌گذاری شدند حذف شدند. ( I1305f )

نسخه 1.3.0-alpha03

20 مارس 2024

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

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

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

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

  • پارامترهایی برای سفارشی کردن ExposedDropdownMenu اضافه شده است. به‌ویژه، اکنون منوها دارای یک پارامتر focusable هستند (پیش‌فرض true ) که هنگام کار با فیلدهای متنی قابل ویرایش باید روی false تنظیم شود. ( I4184c , b/323694447 , b/278609042 )

تغییرات API

  • پرچم ScaffoldSubcomposeInMeasureFix حذف شده است. ( Ie2a4b )
  • NavigationRailItemColors اکنون به عنوان @Immutable علامت گذاری شده است. ( If6112 , b/327660613 )
  • NavigationBarItemColors اکنون به‌عنوان @Immutable علامت‌گذاری شده است. ( I42a30 , b/298064514 )
  • ترتیب‌بندی مجدد پارامترها در Slider Track قابل تنظیم. ( I9f315 )
  • ExposedDropdownMenu اکنون با استفاده از Popup اجرا می شود. رفتار باید یکسان باشد به جز اینکه منوهای قابل فوکوس با فیلدهای متنی قابل ویرایش ممکن است هنگام تایپ روی صفحه کلید نادیده گرفته شوند.

رفع اشکال

  • نقش‌های خط پایه کانتینر سطحی و سطحی کمی تنظیم شده‌اند و رنگ بیشتری را در تم‌های روشن و تاریک ایجاد می‌کنند. ( I677a5 )
  • رنگ‌های Slider و ProgressIndicator به‌روزرسانی شدند تا از مشخصات جدید Non-Text Contrast پیروی کنند. ( I26807 )
  • برای اطمینان از کنتراست رنگ کافی، پوشش حالت فوکوس را 0.1f به روز کنید. ( I7ea77 )
  • تنظیمات کوچک برای پیش‌فرض رنگ سطح و پس‌زمینه در lightColorScheme و darkColorScheme . ( I9db52 )

نسخه 1.3.0-alpha02

6 مارس 2024

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

تغییرات API

  • ثابت کردن حالت های لغزنده دوباره. ساخت State.onValueChangeFinished دوباره یک val را به پایان رساند. بسته بندی روی onValueChangeFinished در rememberUpdatedState . ( I82ab2 , b/322269951 )
  • اجزای Navigation اکنون از نقش‌های SurfaceContainer جدید استفاده می‌کنند. اکنون DrawerDefaults ویژگی‌های standardContainerColor و modalContainerColor را ارائه می‌کند. DrawerDefaults.ModalDrawerElevation اکنون 0.dp است. ( I7fbac )
  • حذف @Stable از حالت های Slider از آنجایی که ما state.onValueChangeFinished را به var تغییر می دهیم. ( Ied34a , b/322269951 )
  • مشخصات انیمیشن ModalBottomSheet و StandardBottomSheet اکنون یک TweenSpec است که از یک انیمیشن بهار به روز شده است. با این کار مشکلی که در آن بیش از حد قابل مشاهده است حل می شود. سازندگان SheetState منسوخ شده بدون چگالی اکنون حذف شده اند. ( I7babc , b/285847707 )

رفع اشکال

  • انواع SurfaceContainer اکنون توسط کامپوننت ها استفاده می شود. اجزایی که به طور رسمی رنگ را با Surface و TonalElevation محاسبه می‌کنند، اکنون به‌طور پیش‌فرض از نقش‌های SurfaceContainer استفاده می‌کنند، که تحت تأثیر ارتفاع صدا قرار نمی‌گیرند. ( b/304584161 )
  • اشکال رفع شد که باعث شد رنگ محفظه انتخاب نشده و غیرفعال ElevatedFilterChip سیاه شود. ( I400e6 , b/322407043 )
  • وقتی پیشرفت 0 است نشانگر پیشرفت نامشخص را برطرف کنید ( Id6582 )
  • رفع مشکل Slider و RangeSlider در طرح RTL ( Iab0e1 )
  • افزودن SliderRangeTolerance برای محاسبه محدوده لغزنده زیرا گرد کردن شناور می تواند نادرست باشد. ( Ic918a , b/324934900 )
  • اطمینان حاصل کنید که DatePickerDialog دکمه های خود را هنگام قرار دادن DateRangePicker یا هنگام نمایش هر نوع انتخابگر تاریخ در صفحه های کوچک با فونت های بزرگتر نمایش می دهد. ( Ie4758 , b/325107799 , b/277768544 )
  • Menu اکنون از نقش SurfaceContainer برای رنگ ظرف استفاده می کند. MenuDefaults.TonalElevation اکنون 0.dp است. ( I135b7 )
  • TextField اکنون از نقش SurfaceContainerHighest برای رنگ ظرف استفاده می کند. ( I4dced )
  • تراشه های ارتقا یافته اکنون از نقش SurfaceContainerLow استفاده می کنند ( I7cd2f )
  • رنگ ظرف DatePicker اکنون SurfaceContainerHigh است. DatePickerDefaults.TonalElevation اکنون 0.dp است. ( Ida753 )
  • رنگ ظرف پایین برگه ها را به روز می کند و رنگ دسته را بکشید. ( I72a0a )
  • رنگ ظرف RichTooltip اکنون SurfaceContainer است. ( Ia8b45 )
  • رنگ ظرف SearchBar اکنون SurfaceContainerHighest است. SearchBarDefaults.TonalElevation اکنون 0.dp است. ( I88604 )
  • به‌روزرسانی‌ها آهنگ‌ها/آیکون‌های غیرفعال و انتخاب‌نشده را تغییر می‌دهند تا از نقش SurfaceContainerHighest رنگ استفاده کنند. ( I7687a )
  • رنگ ظرف AlertDialog اکنون SurfaceContainerHigh است. ( Ie0433 )
  • رنگ ظرف BottomAppBar اکنون SurfaceContainer است. رنگ TopAppBar onScroll اکنون SurfaceContainer است. ( I41630 )
  • رنگ ظرف ElevatedCard اکنون SurfaceContainerLow است. رنگ ظرف FilledCard از SurfaceContainerHighest . ( I35141 )
  • رنگ ظرف ElevatedButton اکنون SurfaceContainerLow است. FilledIconButton زمانی که انتخاب نشده باشد، اکنون یک رنگ محفظه SurfaceContainerHighest دارد. ( I792c9 )
  • رنگ ظرف TimePicker و نقش رنگ شماره گیری ساعت را به SurfaceContainerHighest به روز می کند. ( I43b93 )

نسخه 1.3.0-alpha01

21 فوریه 2024

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

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

  • Compose M3 ModalBottomSheet را برای پشتیبانی از Predictive Back در U+ به‌روزرسانی کنید ( Iccf32 , b/281967264 , b/304850357 )
  • SearchBar Compose M3 به‌روزرسانی شده برای پشتیبانی از پیش‌بینی بازگشت در U+ ( I657f8 )
  • لغزنده به روز شده برای بهبود دسترسی با افزودن نشانگر شکاف و توقف. ( I3058e )
  • ProgressIndicator برای بهبود دسترسی با افزودن نشانگر شکاف و توقف به‌روزرسانی شد. ( I21451 )
  • افزودن یک کارت پیش‌فرض برای rich tooltip، API جدید rich tooltip اکنون به شما امکان می‌دهد تا با توجه به Anchor LayoutCoordinates ترسیم شود. ( Ifd42c )

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

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

تغییرات API

  • بازی سرگرم کننده drawStopIndicator اکنون عمومی است. ( I3f59f )
  • عملکرد فرمت DatePicker formatWithSkeleton را به عنوان داخلی علامت گذاری کنید ( Ic65dc )
  • اکنون DropdownMenu از رنگ، شکل، ارتفاع و حاشیه سفارشی پشتیبانی می کند. ( I8e981 , b/289554448 , b/301887035 , b/283654243 )
  • مؤلفه‌های Material3 که یک MutableInteractionSource در API خود نشان می‌دهند، به‌روزرسانی شده‌اند تا اکنون یک MutableInteractionSource قابل تهی را که پیش‌فرض آن null است، در معرض نمایش بگذارد. هیچ تغییر معنایی در اینجا وجود ندارد: عبور از null به این معنی است که شما نمی خواهید MutableInteractionSource را بالا ببرید و در صورت نیاز در داخل کامپوننت ایجاد می شود. تغییر به null به برخی از مؤلفه‌ها اجازه می‌دهد تا هرگز یک MutableInteractionSource تخصیص ندهند، و به سایر مؤلفه‌ها اجازه می‌دهد فقط در صورت نیاز، نمونه‌ای را ایجاد کنند، که عملکرد این مؤلفه‌ها را بهبود می‌بخشد. اگر از MutableInteractionSource که به این مؤلفه ها منتقل می کنید استفاده نمی کنید، توصیه می شود به جای آن، null را ارسال کنید. همچنین توصیه می شود که تغییرات مشابهی را در اجزای خود ایجاد کنید. ( I41abb , b/298048146 )
  • RippleConfiguration و LocalRippleConfiguration را اضافه می‌کند تا امکان سفارشی‌سازی امواج با استفاده از مقادیر ثابت در هر جزء / زیر درخت را فراهم کند. به عنوان مثال، برای تغییر رنگ کامپوننتی که کنترل آن را ندارید، یا غیرفعال کردن ریپل برای یک جزء. در بیشتر موارد باید از مقادیر پیش‌فرض استفاده شود: این APIها یک دریچه فرار برای سفارشی‌سازی اجزای جداگانه / درخت‌های فرعی محدود هستند. برای تغییرات گسترده‌تر و سیستم‌های طراحی سفارشی، در عوض باید ریپل خود را با استفاده از createRippleModifierNode بسازید. ( I7b5d6 , b/298048146 )
  • API ریپل جدید را در material3 اضافه می کند که جایگزین rememberRipple منسوخ شده است. همچنین یک CompositionLocal موقت، LocalUseFallbackRippleImplementation را اضافه می‌کند تا مؤلفه‌های material3 را به استفاده از APIهای منسوخ rememberRipple / RippleTheme برگرداند. این مورد در نسخه پایدار بعدی حذف می‌شود و فقط به عنوان کمکی موقت برای مهاجرت برای مواردی در نظر گرفته شده است که یک RippleTheme سفارشی ارائه می‌کنید. ( I34cbc , b/298048146 )

رفع اشکال

  • برای بهبود عملکرد، ترکیب فرعی در ModalBottomSheet حذف شد. مشکلی که در آن ModalBottomSheet ممکن بود در سناریوهای خاص در ترکیب با LookaheadScope خراب شود، برطرف شد. ( I2a198 )
  • برای بهبود عملکرد، ترکیب فرعی در BottomSheetScaffold حذف شد. مشکلی که در آن BottomSheetScaffold در سناریوهای خاص در ترکیب با LookaheadScope خراب می‌شد، برطرف شد. ( Ie6401 )
  • تراز نشان تنظیم شده است تا به مرکز محتوای لنگر نسبت به گوشه سمت راست بالا نزدیک‌تر باشد. ( I18a28 )
  • مشکل a11y را با DateRangePicker که در آن عنوان متن ماه-سال به عنوان قابل اجرا به کاربران صفحه‌خوان، دسترسی سوئیچ و دسترسی صوتی منتقل می‌شد، برطرف کنید. ( I2ac55 )
  • رفع اشکال سفارش پارامتر mediumTopAppBarColors . ( Ibe64a )

نسخه 1.2

نسخه 1.2.1

6 مارس 2024

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

رفع اشکال

  • حالت های Slider را دوباره پایدار کنید. ساخت State.onValueChangeFinished دوباره یک val را به پایان رساند. بسته بندی روی onValueChangeFinished در rememberUpdatedState . ( Ie8fd0 , b/322269951 )
  • حذف @Stable از حالت های Slider از آنجایی که ما state.onValueChangeFinished را به var تغییر می دهیم. ( I82ba1 , b/322269951 )
  • رنگ های سفارشی NavigationBar را برای کپی کردن از پیش فرض رفع کنید. ( 80a779 , b/326894020 )
  • رگرسیون را در ExposedDropdownMenu برطرف کنید تا دوباره قابل فوکوس شود ( 3fcec1 , b/323694447 )
  • رفع مشکل حافظه پنهان رنگ دکمه ( 3e5bbc b/327371655 )

نسخه 1.2.0

7 فوریه 2024

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

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

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

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

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

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

APIهای آزمایشی را به پایداری ارتقا داد!

بهبود عملکرد

نسخه 1.2.0-rc01

24 ژانویه 2024

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

رفع اشکال

  • رفع اشکال سفارش پارامتر mediumTopAppBarColors . ( Ibe64a )
  • یک اشکال معرفی شده در 1.2.0-beta02 در CardDefaults.cardColors که contentColor بر اساس مقدار پارامتر 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 به یک آلفا (0.38f) از LocalContentColor به جای contentColor مشخص‌شده توسط کاربر اختصاص می‌دهد. راه حل این است که صریحاً 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 . RichTooltipStateImpl و PlainTooltipStateImpl برای ایالات پیش فرض اضافه شد. اضافه شده remember*State برای به دست آوردن این کشورهای اجرا شده. حذف TooltipSync به نفع یک TooltipDefault.GlobalMutatorMutex . ( i7813d )
  • DatePickerColors را به روز کرد تا گزینه های سفارشی سازی اضافی را برای رنگ های تقسیم کننده ، ناوبری و زمینه های ورودی متنی شامل رنگ های مختلف قرار دهد. ( i1a685 ، b/274626815 )
  • DatePickerState و DateRangePickerState اکنون رابط های عمومی با پیاده سازی های پیش فرض هستند که می توانند توسط rememberDatePickerState و rememberDateRangePickerState . ( i71c52 )
  • dateValidator از DatePicker و DateRangePicker حذف کرده و یک رابط SelectableDates معرفی کرد که می تواند در حالت تنظیم شود تا کنترل کند کدام تاریخ یا سالها در UI قابل انتخاب است. ( IC2FC6 )
  • TimePicker که از API پایدار حذف شده است ، تغییرات بیشتری در API ایالتی ( I3F39A ) پیش بینی می شود
  • ModalBottomSheet فقط به Android منتقل شد. ModalBottomSheet برای استفاده از دسک تاپ توصیه نمی شود و عملکرد به طور فعال حفظ نمی شود. ( IB3778 )

رفع اشکال

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

نسخه 1.2.0-alpha01

10 مه 2023

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

نسخه 1.1

نسخه 1.1.2

20 سپتامبر 2023

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

رفع اشکال

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

نسخه 1.1.1

21 ژوئن 2023

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

رفع اشکال

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

نسخه 1.1.0

10 مه 2023

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

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

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

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

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

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

نسخه 1.1.0-RC01

19 آوریل 2023

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

API تغییر می کند

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

نسخه 1.1.0-beta02

5 آوریل 2023

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

API تغییر می کند

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

رفع اشکال

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

نسخه 1.1.0-beta01

22 مارس 2023

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

API تغییر می کند

  • اضافه کردن نوع چیدمان پارامتری به TimePicker Composable. بسته به پیکربندی صفحه ، از طرح های مختلف استفاده می کند ( IA0E16 )
  • SearchBarDefaults به عنوان آزمایشی مشخص شده است. ( i65561 )
  • Elevation Shadow Elevation به BottomSheetScaffold ( I94E0F )
  • پشتیبانی اضافه شده برای نمایش Date Pickers بدون قسمت Header. API تغییر می کند تا هنگام ایجاد یک انتخاب کننده تاریخ ، یک تیتر تهی را منتقل کند. اکنون می توانید به منظور نمایش یک انتخاب کننده بدون سر ، از عنوان ، عنوان ، عنوان و showToggleMode = false عبور کنید. ( id3f3a ، b/266132421 ، b/267194809 )

رفع اشکال

  • میله های جستجو اکنون به طور خودکار تمرکز را هنگام انجام غیرفعال روشن می کنند. ( i22a7c ، b/261444487 )
  • DateRangePicker را به روز کرد تا امکان انتخاب با همان تاریخ را برای شروع و پایان خود انتخاب کند. ( i16529 ، b/272882497 )
  • فیلدهای متنی اکنون به درستی عناصر متنی خود را در شرایطی که اندازه قلم از آنچه انتظار می رود کوچکتر باشد ، قرار می دهند. این ممکن است منجر به تغییر چند پیکسل در برنامه های شما بر اساس تنظیمات قلم و اسکریپت شود. ( i8b8d0 )
  • اقدامات معنایی ورق پایین اکنون برچسب هایی دارد. ( I277B0 )

نسخه 1.1.0-alpha08

8 مارس 2023

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

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

  • پشتیبانی اضافه شده برای BottomSheetScaffold و BottomSheetScaffoldState . ( I063D4 )

API تغییر می کند

  • قابلیت های اضافه شده به DatePickerState و DateRangePickerState برای اجازه تنظیم تاریخ پس از ایجاد اولیه دولت و همچنین تنظیم مجدد انتخاب ها با تنظیم زمان های تهی. تنظیم تاریخ ها به صورت دستی باید با احتیاط انجام شود ، و عملکرد جدید setSelection در صورت عدم موفقیت یک تاریخ ارائه شده ، یک استثنا را به وجود می آورد (به مستندات مراجعه کنید). ( IFA645 ، B/268609314 ، B/270427389 )
  • تغییر نام SheetValue به PartiallyExpanded برای نشان دادن رفتار دقیق تر و انعطاف پذیر در این حالت ، تغییر نام داد. ( IA1491 )
  • به روز شده نام پارامتر ListItem به جای _text به _content. گیرنده های پیش فرض در حال حاضر در صورت لزوم ReadOnlyComposables هستند. ( i69a25 )
  • API های سطح تعاملی فارغ التحصیل از آزمایش. ( i90d59 ، b/261561812 )

رفع اشکال

  • مسئله ای را برطرف کرد که در آن حالت HalfExpanded ModalBottomSheet به طور نادرست محاسبه شد و به نظر می رسد که این برگه شناور است. ( i45e84 ، b/268411386 )
  • اضافه کردن بررسی confirmValueChange به شیر آب برای ModalBottomSheet . ( i2311a ، b/270425759 )
  • اقدامات BottomSheet معنایی را برای کشیدن دسته حرکت دهید. ( i158ba )
  • ModalBottomSheet اکنون دستورات را روی پرتاب ، دکمه پشتی تمرکز می کند. ( i4d2ab )
  • ModalBottomSheet onDismissRequest هم اکنون در هنگام حرکت پیمایش تو در تو نیز اداره می شود. ( i655c5 ، b/268433166 )

نسخه 1.1.0-alpha07

22 فوریه 2023

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

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

  • یک ترکیب ورودی را اضافه کنید که با rememberTimePickerState() کار کند ، مشخصات M3 را برای ورودی زمان ( IA4FAB ) دنبال می کند
  • برای انتخاب طیف وسیعی از تاریخ ، یک API DateRangePicker Material 3 اضافه کرد. ( i7a6c3 ، b/267194809 )
  • برای انتخاب دامنه تاریخ از طریق API DateRangePicker یک پشتیبانی از حالت ورودی 3 ماده اضافه شده است. ( IFDBC4 )
  • رنگ های زمینه متن اکنون به شخصی سازی اجازه می دهند:
    • قسمت ورودی و رنگهای متن نگهدارنده بر اساس حالت تمرکز و خطا. پارامتر textColor به unfocusedTextColor تغییر نام داده است ، و placeholderColor به unfocusedPlaceholderColor تغییر نام داده است.
    • رنگ کانتینر برای فیلدهای متن پر شده بر اساس حالت خطا با errorContainerColor Param جدید.
  • منوی کشویی در معرض رنگهای متن زمینه با پارامترهایی برای پشتیبانی از پیشوند جدید و پسوند API به روز شده است. ( i9c8b4 ، b/254284181 ، b/264766350 )

API تغییر می کند

  • بازگرداندن برخی از نسخه های API کشویی و از بین بردن اضافه بار کشویی اضافی که توسط کشویی آزمایشی جدید با انگشت شست و آهنگ های سفارشی پوشانده شده است. ارتقاء RangeSlider برای پایدار بودن. ( IE8FBD )
  • در عملکردهای ارتفاع تراشه به defaultElevation به elevation تغییر نام داد. ( I0F872 )
  • API های زمینه 3 متنی مواد زیر دیگر آزمایشی نیستند: TextField ، OutlinedTextField ، textFieldWithLabelPadding ، textFieldWithoutLabelPadding ، outlinedTextFieldPadding . ( IEB5C0 ، B/261561819 )
  • TimePickers is24Hour از تنظیمات سیستم استفاده می کند ( I18856 )
  • حاشیه نویسی تجربی را از API های داربست حذف کرد. ( IBB51E ، B/261565765 ، B/261436953 )

رفع اشکال

  • شکل پیش فرض ModalBottomSheet اکنون همیشه SheetDefaults.ExpandedShape است. ( i0dfca )
  • پیشرفت های دسترسی برای مواد 3 DatePicker و DateRangePicker . ( I5087E )
  • رفع اشکال در جایی که محدودیت حداکثر ارتفاع پخش شده و ممکن است خراب شود. ( i30d8c )
  • نقش های معنایی حذف شده از سطوح قابل کلیک و قابل انتخاب ، اجزای به روز شده که از آنها برای تنظیم نقش ها با استفاده از اصلاح کننده استفاده می کردند.

نسخه 1.1.0-alpha06

8 فوریه 2023

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

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

  • زمینه های متن اکنون از پیشوند و پسوند متن پشتیبانی می کنند ( IA8578 ، b/179884561 )
  • یک تابع TimePicker اضافه کرد تا یک انتخاب کننده زمان را rememberTimePickerState دنبال مشخصات TimePickerState
  • ورودی تاریخ اکنون یک حالت نمایش در DatePicker است. پشتیبانی اضافه شده برای تعویض بین حالت های ورودی و تاریخ ورودی تاریخ. ( ieeff7 )
  • API اضافه شده برای RichTextTooltips . ( i58ef3 )
  • اجرای ورق پایین معین برای مواد 3 ، از جمله ModalBottomSheet و ModalBottomSheetDefaults . همچنین SheetState و rememberSheetState که می تواند برای اجزای ورق آینده استفاده شود. ( i0853a ، b/244189383 )

API تغییر می کند

  • Stablize the API showSnackbar ( i195c2 ، b/261424370 )
  • stablize API ها را برای تراشه کمک و تراشه پیشنهاد ( IBB67B ، B/261424370 )
  • ListItem ، ListItemDefaults و ListItemColors API را به غیر تجربی ارتقا می بخشد ( I7E7FA ، B/26143882 )
  • ارتقاء SliderPositions ، SliderDefaults.Thumb ، و SliderDefaults.Track به پایدار و اضافه کردن API های Slider و RangeSlider غیر تجربی که حاوی شست و پیست سفارشی هستند. همچنین API های Slider و RangeSlider قبلی را کاهش می دهد. ( IE5EA6 ، B/261566890 )
  • made Modifier.tooltipAnchor() عمومی ، بنابراین Devs می تواند آن را به لنگر منتقل کند تا نشان دهد یک ابزار ابزار باید در مطبوعات طولانی نمایش داده شود. API به روز شده PlainTooltipBox API دیگر باعث ایجاد Nullable TooltipState نمی شود و اکنون پیش فرض دارد. ( IE2FB7 )
  • ProgressIndicatorDefaults.circularTrackColor برای سازگاری @Composable مشخص شده است. ( id29cc )
  • املاک بازسازی شده LocalMinimuTouchTargetEnforcement و آن را به عنوان مستهلک و تغییر مسیر به LocalMinimumInteractiveComponentEnforcement علامت گذاری کنید. ( i60DD5 )

نسخه 1.1.0-alpha05

26 ژانویه 2023

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

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

  • DatePickerDialog و پشتیبانی دسترسی
  • انگشت شست و آهنگ سفارشی اضافه شده به RangeSlider .

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

نسخه 1.1.0-alpha04

11 ژانویه 2023

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

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

  • API DatePicker اولیه برای انتخاب یک تاریخ از طریق UI تقویم. این API هنوز در حال تغییر است. ( i722b9 )
  • پشتیبانی اضافه شده برای وسایل ابزار ساده از طریق PlainTooltipBox . ( i0cdfb )
  • نوار جستجو ( IAD128 )
  • SwipeToDismiss ( i458a8 ، b/242889540 )

API تغییر می کند

  • اضافه شده در دارایی IsContainer در سطوح. این خاصیت در تغییر بعدی مورد استفاده قرار می گیرد که بر اساس معنی معنایی عناصری مانند سطوح ، ترتیب گذر را تعیین می کند. ( i63379 )
  • API های مربوط به کشو ناوبری را به عنوان پایدار علامت گذاری کنید. ( IAB01E ، B/261439597 )
  • یک پارامتر رنگ آهنگ برای شاخص های پیشرفت دایره ای و یک پارامتر درپوش سکته مغزی برای شاخص های پیشرفت دایره ای و خطی اضافه شده است. ( IE668C ، B/216325962 ، B/222964817 )
  • تهی بیشتر از نوع بازگشت عملکردهای مخفی مستهجن ( IBF7B0 )
  • اضافه کردن Modifier.minimumInteractiveComponentSize . minimuminteractiveecomponentize. اگر عنصر کوچکتر اندازه گیری می شود ، می توان حداقل برای رزرو حداقل 48.dp در اندازه برای تفسیر تعامل لمسی استفاده کرد. ( i33f58 ، b/258495559 )
  • API تجربی اضافه شده برای ترکیب AlertDialog که دارای شکاف محتوا است. ( IEC4A2 )

رفع اشکال

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

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

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

نسخه 1.1.0-alpha03

7 دسامبر 2022

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

API تغییر می کند

  • تغییر نام داده شده به consumedWindowInsets() به consumeWindowInsets() و withConsumedWindowInsets() به onConsumedWindowInsetsChanged() نام داد و اصلاح کننده ها را عمومی کرد. ( IE44E1 )
  • اضافه کردن محتوای پیش فرض جدید برای دکمه متن با نماد برای استفاده. ( i8f662 )
  • رنگهای معلول اضافه شده برای نوار ناوبری و راه آهن. ( ia7892 ، b/258867034 )
  • یک API اصلاح کننده برای پرس و جو از اطلاعات پیمایش اجداد اضافه کرد. ( i2ba9d ، b/203141462 )
  • هنگامی که حرکات می توانند به حوادث پیمایش تبدیل شوند ، در Clickable برای تأخیر در تعامل مطبوعات استفاده می شود.
  • در صورت استفاده در داخل یک Scrollable ViewGroup Clickables به طور صحیح به تأخیر نمی افتد.
  • کشورها و برگه های به روز شده برای تأخیر صحیح مطبوعات در صورت بروز حرکات می توانند به حوادث پیمایش تبدیل شوند.

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

  • Compose UI و Compose Material به چرخه عمر 2.5.1 بستگی دارد. ( i05ab0 ، b/258038814 )

نسخه 1.1.0-alpha02

9 نوامبر 2022

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

API تغییر می کند

  • awaitFirstDown و waitForUpOrCancellation اکنون برای انعطاف پذیری بیشتر یک PointerEventPass می پذیرید (همچنین در معرض ExposedDropdownMenuBox را نشان می دهد که منو را هنگام پیمایش نشان می دهد). ( i7579a ، b/212091796 )
  • Added minLines parameter into material and material3 Text, TextField and OutlinedTextField which allows setting the minimum height of the component in terms of number of lines ( I4af1d )
  • Deprecate the TopAppBarDefaults smallTopAppBarColors function in favor of a new topAppBarColors function that should be used when creating a TopAppBar . ( Ie6cb9 )
  • Added minLines parameter to the BasicText and BasicTextField . It allows to set the minimum height of these composables in terms of number of lines ( I24294 , b/122476634 )

رفع اشکال

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

Version 1.1.0-alpha01

24 اکتبر 2022

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

رفع اشکال

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

نسخه 1.0

Version 1.0.1

9 نوامبر 2022

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

رفع اشکال

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

نسخه 1.0.0

24 اکتبر 2022

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

Major features of 1.0.0

This is the first stable release of Compose Material 3!

Material Design 3 theming and Material You dynamic color

Material Design 3 components

Window Size Class

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

  • Please see this blog post for more details!

Version 1.0.0-rc01

5 اکتبر 2022

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

API Changes

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 Changes

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

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

رفع اشکال

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

Version 1.0.0-beta01

24 آگوست 2022

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

مرجع API

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

API Changes

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

Version 1.0.0-alpha16

10 آگوست 2022

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

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

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

API Changes

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

Version 1.0.0-alpha15

27 جولای 2022

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

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

API Changes

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

رفع اشکال

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

Version 1.0.0-alpha14

29 ژوئن 2022

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

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

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

API Changes

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

رفع اشکال

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

Version 1.0.0-alpha13

1 ژوئن 2022

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

API Changes

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

Version 1.0.0-alpha12

18 مه 2022

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

رفع اشکال

Version 1.0.0-alpha11

11 مه 2022

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

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

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

API Changes

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

رفع اشکال

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

Version 1.0.0-alpha10

20 آوریل 2022

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

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

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

API Changes

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

رفع اشکال

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

Version 1.0.0-alpha09

6 آوریل 2022

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

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

  • Added Material 3 Switch API ( I2c3ad )

API Changes

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

Version 1.0.0-alpha08

23 مارس 2022

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

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

API Changes

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

رفع اشکال

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

Version 1.0.0-alpha07

9 مارس 2022

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

API Changes

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

رفع اشکال

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

Version 1.0.0-alpha06

23 فوریه 2022

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

API Changes

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

رفع اشکال

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

Version 1.0.0-alpha05

9 فوریه 2022

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

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

Added Material Design 3 components

API Changes

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

رفع اشکال

Version 1.0.0-alpha04

26 ژانویه 2022

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

API Changes

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

رفع اشکال

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

Version 1.0.0-alpha03

12 ژانویه 2022

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

رفع اشکال

Dependency Updates

  • Now depends on Kotlin 1.6.10 .

Version 1.0.0-alpha02

1 دسامبر 2021

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

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

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

API Changes

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

رفع اشکال

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

Version 1.0.0-alpha01

27 اکتبر 2021

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

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

Material Design 3 theming and Material You dynamic color

Material Design 3 components

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