Compose Material 3
androidx.compose.material3
(الاطّلاع على مستندات مرجع واجهة برمجة التطبيقات لجميع حِزم Compose)
آخر الأخبار | الإصدار الثابت | إصدار محتمل | الإصدار التجريبي | الإصدار الأوّلي |
---|---|---|---|---|
2 يوليو 2025 | 1.3.2 | - | - | 1.4.0-alpha17 |
البنية
Compose هي مجموعة من سبعة معرّفات لمجموعات Maven ضمن androidx
. تحتوي كل مجموعة على مجموعة فرعية مستهدَفة من الوظائف، ولكل منها مجموعة خاصة من ملاحظات الإصدار.
يوضّح هذا الجدول المجموعات ويتضمّن روابط لكل مجموعة من ملاحظات الإصدار.
مجموعة | الوصف |
---|---|
compose.animation | إنشاء رسوم متحركة في تطبيقات Jetpack Compose لإثراء تجربة المستخدم |
compose.compiler | تحويل دوال @Composable وتفعيل عمليات التحسين باستخدام مكوّن إضافي لمترجم Kotlin |
compose.foundation | يمكنك كتابة تطبيقات Jetpack Compose باستخدام وحدات أساسية جاهزة للاستخدام وتوسيع نطاق الأساس لإنشاء عناصر نظام التصميم الخاص بك. |
compose.material | يمكنك إنشاء واجهات مستخدم Jetpack Compose باستخدام "مكوّنات Material Design" الجاهزة للاستخدام. هذه هي نقطة الدخول الأعلى مستوى في Compose، وهي مصمَّمة لتوفير مكوّنات تتطابق مع تلك الموضّحة في www.material.io. |
compose.material3 | يمكنك إنشاء واجهات مستخدم Jetpack Compose باستخدام "مكوّنات Material Design 3"، وهي التطوّر التالي في Material Design. يتضمّن الإصدار 3 من Material تصميمات ومكوّنات محدّثة وميزات تخصيص Material You، مثل الألوان الديناميكية، وهو مصمّم ليكون متوافقًا مع الأسلوب المرئي الجديد وواجهة مستخدم النظام في Android 12. |
compose.runtime | الوحدات الأساسية لنموذج برمجة Compose وإدارة الحالة، ووقت التشغيل الأساسي الذي يستهدفه مكوّن Compose الإضافي للمترجم. |
compose.ui | المكوّنات الأساسية لواجهة مستخدم Compose اللازمة للتفاعل مع الجهاز، بما في ذلك التنسيق والرسم والإدخال |
تعريف التبعيات
لإضافة تبعية على Compose، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.
أضِف التبعيات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle
لتطبيقك أو وحدتك:
رائع
dependencies { implementation "androidx.compose.material3:material3:1.3.2" implementation "androidx.compose.material3:material3-window-size-class:1.3.2" implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha17" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material3:material3:1.3.2") implementation("androidx.compose.material3:material3-window-size-class:1.3.2") implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha17") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
لمزيد من المعلومات حول العناصر التابعة، يُرجى الاطّلاع على إضافة عناصر تابعة للإنشاء.
الملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.
يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.
الإصدار 1.0 من Compose Material3 Common
الإصدار 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 على عمليات الدمج هذه.
الميزات الجديدة
مكوّنات بدون مظهر يمكن استخدامها لإنشاء مكوّنات Material Design:
- لوحة الألوان المتناغمة
- الرمز
- حجم مساحة اللمس
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 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- إزالة صفة التجريبية عن واجهات برمجة التطبيقات الخاصة بحزمة أدوات التنقّل (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 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- أضِف
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 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- اجعل الدالة الإنشائية
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 على عمليات الإيداع هذه.
تحديثات التبعيات
- عدِّل التبعيات المتكيّفة في 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 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- تعديل اسم الحزمة إلى navigationsuite بدلاً من navigation-suite (I7eff7)
- تم تعديل مكوّنات Material3 التي تعرض
MutableInteractionSource
في واجهة برمجة التطبيقات لتتيح الآن عرضMutableInteractionSource
قابلة للقيم الخالية، وتكون القيمة التلقائية هي null. لا توجد تغييرات دلالية هنا: يعني تمرير قيمة فارغة أنّك لا تريد نقلMutableInteractionSource
إلى الأعلى، وسيتم إنشاؤه داخل المكوّن إذا لزم الأمر. يسمح التغيير إلى قيمة فارغة لبعض المكوّنات بعدم تخصيصMutableInteractionSource
مطلقًا، ويسمح لمكوّنات أخرى بإنشاء مثيل فقط عند الحاجة، ما يحسّن الأداء في جميع هذه المكوّنات. إذا كنت لا تستخدمMutableInteractionSource
الذي تمرّره إلى هذه المكوّنات، ننصحك بتمرير قيمة فارغة بدلاً من ذلك. يُنصح أيضًا بإجراء تغييرات مماثلة في مكوّناتك. (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 على عمليات الإيداع هذه.
الميزات الجديدة
- إضافة قيمة "بلا"
NavigationSuiteType
(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 على عمليات الدمج التالية.
الميزات الجديدة
الإصدار 1.0 من 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 على عمليات الإيداع هذه.
الميزات الجديدة
- تمت إضافة خيارات سلوك إضافية للتنقل للخلف باستخدام الزر
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 على عمليات الإيداع هذه.
الميزات الجديدة
- إتاحة استخدام سجلّ التنقّل في عملية إنشاء بنية التطبيق وحساب القيم (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 على عمليات الإيداع هذه.
الميزات الجديدة
- تمت إضافة إمكانية عرض المحتوى من الحافة إلى الحافة في هياكل الألواح (I1b462)
تغييرات واجهة برمجة التطبيقات
- نقل خصائص حدود المفصلة في Posture إلى قائمة بمعلومات المفصلة (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 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- تغيير أدوار "الإنشاء السريع" إلى أسماء مستعارة لـ
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 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- فصل واجهات برمجة تطبيقات التنقّل عن واجهات برمجة تطبيقات التصميم المتكيّف (Ic4045)
- إزالة الصف
GutterSize
(I785b3)
إصلاح الأخطاء
- عدم تبديل اللوحات الثابتة عند عدم استخدام
AnimatedPane
(d88f181)
الإصدار 1.0.0-alpha01
15 تشرين الثاني (نوفمبر) 2023
تم طرح androidx.compose.material3:material3-adaptive:1.0.0-alpha01
. يحتوي الإصدار 1.0.0-alpha01 على عمليات الدمج التالية.
الميزات الجديدة
واجهات برمجة التطبيقات المتكيّفة مع الظروف في Material3:
واجهات برمجة التطبيقات لتوجيهات Material3 adaptive pane scaffold:
واجهات برمجة تطبيقات Material3 adaptive pane scaffold:
- واجهات برمجة التطبيقات الأساسية الخاصة بهيكل اللوحة
Compose Material3 الإصدار 1.4
الإصدار 1.4.0-alpha17
2 يوليو 2025
تم طرح androidx.compose.material3:material3-*:1.4.0-alpha17
. يحتوي الإصدار 1.4.0-alpha17 على عمليات الدمج هذه.
الميزات الجديدة
- تعديل الحركة لمجموعة الأزرار بحيث يتم تحريكها إلى% 75 من الحركة عند النقر عليها بدلاً من الضغط عليها (593942a، b/423596967)
إصلاح الأخطاء
- تم إصلاح مشكلة كان يمكن أن يتجاوز فيها عنصر في لوحة العرض الدوّارة حجم العنصر الكبير في بعض الحالات أثناء عمليات حساب التنسيق، ما يؤدي إلى قطع الأداة بأكملها. (I1c3d7، b/397489534)
- تم إصلاح مشكلة الانتقال إلى ما بعد
beforeContentPadding
عند تمرير لوحات العرض الدوّارة التي تتضمّن إزاحة متداخلة في البداية والنهاية. (c3d5f3a, b/420618979) - تعديل السلوك المفعَّل لـ
SwipeToDismiss
لمراقبة الحالة المستقرة بدلاً من الحالة الحالية تعيد هذه السمة السلوك الحالي الذي يتم فيه إيقاف سلوك العنصر الثابت فقط عندما يكون العنصر في حالة تم تجاهلها. (3844e07، b/425006844) - يمكن الآن فتح القائمة المنبثقة الخاصة بـ
ExposedDropdownMenu
من خلال إدخال البيانات باستخدام لوحة المفاتيح. تم أيضًا إصلاح المشكلة التي كانت تمنع الوصول إلى القائمة من خلال لوحة المفاتيح للخيارات القابلة للتعديل. (46ead03)
الإصدار 1.4.0-alpha16
18 يونيو 2025
تم طرح androidx.compose.material3:material3-*:1.4.0-alpha16
. يحتوي الإصدار 1.4.0-alpha16 على عمليات الدمج هذه.
الميزات الجديدة
- تمت إضافة مكوّن منصة عرض بعناصر متغيّرة في منتصف الصفحة (I6f6d3)
تغييرات واجهة برمجة التطبيقات
- تنفيذ عمليات إلغاء شريط الأدوات العمودي في XR (Ia1604)
- تمت إضافة دوال التمرير الآلي إلى
CarouselState
(I12f8e) - إضافة
ComponentOverride
إلىModalWideNavigationRail
(I4f440) - إضافة
ComponentOverride
إلىWideNavigationRail
(I6354f) - إنشاء
ComponentOverride
لـHorizontalFloatingToolbar
(I51116) - إنشاء
ComponentOverride
لـShortNavigationBar
(I30e24) - تم وضع علامة "متوقّف نهائيًا" على مراجع
SwipeToDismissBoxState
إلىconfirmValueChange
. بدلاً من ذلك، على المستخدمين الاستفادة من معاودة الاتصالSwipeToDismissBox
لواجهة برمجة التطبيقاتonDismissed
. (Iee780) - تمت إضافة المَعلمة userScrollEnabled إلى عناصر Carousel القابلة للإنشاء. (I1d4d2)
- يمكن الآن مراقبة
currentItem
في لوحة العرض الدوّارة منCarouselState
. (Ie87e9)
إصلاح الأخطاء
- تم إصلاح المشكلة المتمثّلة في عدم تطبيق الظل بشكلٍ صحيح على شكل عشوائي في زر الإجراء العائم تم تمريره إلى
FloatingToolbar
. (Icdcc9، b/423336922) - تستخدم جميع "اللوحات الدوّارة" الآن الدور الدلالي "لوحة دوّارة" تلقائيًا. (I7af12)
- تم إصلاح مشكلة عدم صحة حركة الإبهام عند تعديل حالة شريط التمرير من خلال
LaunchedEffect
(Id9f31، b/302774166)
الإصدار 1.4.0-alpha15
20 مايو 2025
تم طرح androidx.compose.material3:material3-*:1.4.0-alpha15
. يحتوي الإصدار 1.4.0-alpha15 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة
MotionTheme.LocalMotionScheme
، وهي مقطوعة موسيقية محلية. يتيح ذلك الوصول إلى نظام الحركة في المظهر منCompositionLocalConsumerModifierNodes
باستخدامcurrentValueOf(MotionTheme.LocalMotionScheme)
. (I014b1) - تم الآن إيقاف الدالة الإنشائية
ColorScheme
بدون أدوار الألوان الثابتة نهائيًا. يُرجى الانتقال إلى أداة إنشاء تتضمّن أدوارًا ثابتة. (Iad0ee) - يتوافق مكوّن M3 Text الآن مع
TextAutoSize
. (I7f524) - إضافة واجهة برمجة تطبيقات لإنشاء أشكال مختلفة من حجم الزرّ المنقسم وإضافة عيّنات (Ice30b)
إصلاح الأخطاء
- تم إصلاح المشكلة المتمثّلة في تحديد موضع
Snackbar
وFloatingActionButton
بشكل غير صحيح عند تفعيل وضع "من الحافة إلى الحافة". تطبِّق أداة الإنشاء الآن عمليات إزاحة أفقية على هذه المكوّنات بشكل صحيح. (Ib7c30، b/244400727) - إصلاح حركة
BottomSheet
من التوسيع الكامل إلى التوسيع الجزئي يستخدمBottomSheet
الآن التأثير السريعMotionScheme
عند الإخفاء أو التصغير، والتأثير المكاني التلقائي عند التوسيع. (Ifa46f، b/416063171) - تم وضع علامة مخفي على الدالة الإنشائية
ColorScheme
بدون أدوار حاوية السطح ولم يعُد يُنصح باستخدامها. (Ia7237) - تمت إزالة شرط
CircularWavyProgressIndicator
Size.minDimension > 0
الذي كان يؤدي إلى حدوث استثناء، وذلك لإتاحة المزيد من المرونة. (Ic9418، b/377531195) - تتضمّن الروابط التشعّبية في
Text(AnnotatedString)
الآن تنسيق Material تلقائيًا. (I78288 وb/339843816) - تم إصلاح مشكلة كانت تتسبّب في تخزين الدالة
toShape()
فيRoundedPolygon
مسارًا مؤقتًا، ما يؤدي إلى حدوث مشكلة عند إجراء عدة طلباتcreateOutline
بأحجام مختلفة. (I4026d)
الإصدار 1.4.0-alpha14
7 مايو 2025
تم طرح androidx.compose.material3:material3-*:1.4.0-alpha14
. يحتوي الإصدار 1.4.0-alpha14 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة عنصر
AppBarColumn
جديد قابل للإنشاء يعمل بالطريقة نفسها التي يعمل بها العنصرAppBarRow
ولكن للمحتوى المعروض في عمود. (Iaf6bd) - تمت إضافة الحد الأقصى للعناصر إلى
AppBarRow
، وهذا ضروري لتنفيذ مواصفات المواد بشكل صحيح لأشرطة التطبيقات العلوية. (I92ce4) - تمت إضافة طريقة في
TooltipScope
للحصول علىlayoutCoordinates
الخاص بعنصر التثبيت. إيقاف الطريقةdrawCaret
نهائيًا لأنّ بإمكان المطوّرين استخدام هذه الطريقة الجديدة للحصول على حدود العنصر الثابتlayoutCoordinates
وإنشاء شكل مناسب يحتوي على علامة إقحام. (Ia2e12، b/329470609) - تمت إضافة دعم
java.time
لأدوات اختيار التاريخ: تم تقديم عمليات تحميل زائدةrememberDatePickerState/rememberDateRangePickerState
تقبل عناصر java.time (مثلLocalDate
الأولية وYearMonth
). تمت أيضًا إضافة دوال إضافية إلى عناصر الحالة للحصول على القيم أو ضبطها باستخدام أنواع مثلLocalDate
وYearMonth
. تتطلّب هذه الميزة المستوى 26 من واجهة برمجة التطبيقات أو الإصدارات الأحدث أو إزالة التشفير. (I70f29، b/266202516، b/281859606) - إضافة عنصر
CenteredTrack
قابل للإنشاء يتيح استخدام شريط تمرير مع مسار يبدأ من المنتصف (I5b1d6)
إصلاح الأخطاء
- تم تحسين أداء مؤشرات التقدم المتموجة: يتم الآن تحميل الأنواع الخطية أسرع بنسبة% 8.5 تقريبًا مع تقليل عمليات التخصيص بنسبة% 11 تقريبًا، بينما تشهد الأنواع الدائرية زيادة كبيرة في السرعة بنسبة% 47 تقريبًا وتقليل عمليات التخصيص بنسبة% 39 تقريبًا. (I595d8)
الإصدار 1.4.0-alpha13
23 أبريل 2025
تم طرح androidx.compose.material3:material3-*:1.4.0-alpha13
. يحتوي الإصدار 1.4.0-alpha13 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- تمت إعادة طرح
isAppearanceLightStatusBars
وisAppearanceLightNavigationBars
فيModalBottomSheetProperties
كمَعلمات خاصة بنظام التشغيل Android فقط. (Id4bc0) - أضِف عنصر
AppBarRow
قابلاً للإنشاء، ويتعامل مع تجاوز عدد العناصر التي يمكن أن تتسع خارج حدوده. (I742bd) - عدِّل واجهتَي برمجة التطبيقات
DatePicker
وDateRangePicker
لطلب التركيز عند التبديل إلى وضع إدخال التاريخ. لقد استبدلنا المَعلمة المنطقيةrequestFocus
بالمَعلمة الاختياريةfocusRequester
التي تأخذFocusRequester
. (I14b69) - إزالة أداة التعديل ومصدر التفاعل من العناصر التلقائية القابلة للنقر والتبديل يمكنك بدلاً من ذلك استخدامها كإحدى تفاصيل التنفيذ. (I95ed6)
- تم تعديل
ButtonGroup
ليتم عرضه في قائمة منسدلة عندما يكون هناك عدد كبير جدًا من الأزرار لا يمكن عرضه على الشاشة. (I7b88b)
إصلاح الأخطاء
- تستهلك ورقة البيانات السفلية الآن الحواف العلوية عندما تكون أصغر من الإزاحة الحالية. يتيح ذلك للمستخدمين تقديم هوامش علوية لسلوك العرض الموسّع. يتضمّن
BottomSheetDefaults.windowInsets
الآنWindowInsets.safeDrawing.Top
. (I0ab67، b/321877275، b/336962418، b/342093067) - تم تفعيل صور متحركة للدخول/الخروج (تتلاشى/تنزلق) لرموز/صور الأفاتار الرئيسية والرموز اللاحقة في Chip عند إضافتها أو إزالتها. يفيد ذلك بشكل أساسي الشرائح القابلة للتحديد (الفلتر، الإدخال)، ولكنّه ينطبق بشكل عام. (I9af21)
- إصلاح السلوك المعطَّل لشريط التمرير من اليمين إلى اليسار الناتج عن
LookaheadScope
(Ieb152، b/408118041) - إصلاح عُطل
AppBar
في أسفل الشاشة المرتبط بالتمرير مع إخفاء واجهة مستخدم النظام (Ic6140، b/405996228)
الإصدار 1.4.0-alpha12
9 أبريل 2025
تم طرح androidx.compose.material3:material3-*:1.4.0-alpha12
. يحتوي الإصدار 1.4.0-alpha12 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- تمت إزالة المَعلمات الخاصة بنظام التشغيل Android من
ModalBottomSheetProperties
(Iab97f وb/362539765) - إضافة وظائف التحميل الزائد لإعدادات حجم مقبض السحب التلقائية (I0ed0d)
- إضافة الدالتَين
NavigationSuiteScaffold
وNavigationSuiteScaffoldLayout
الجديدتَين لتوفير أنواع تنسيقات جديدة وإتاحة محتوى اختياري للإجراء الأساسي (Ib262a، b/353144478) - إيقاف
Modifier.weight
نهائيًا مع مَعلمة التعبئة فيButtonGroup
إضافة نسخة بدون تعبئة (Id32bb) - تتم إعادة تسمية الإعدادات التلقائية لمكوّن
xSmall-
وxLarge-
IconButton لتوضيحextra
. (Ib6e0f) - إضافة وظائف جديدة
NavigationSuite
وNavigationSuiteItem
وNavigationSuiteColors
لتوفير أنواع تنسيقات جديدة (I203d6) - إضافة الدالتَين الجديدتَين
NavigationSuiteTypes
وnavigationSuiteType
اللتَين تتضمّنان خيارات التنسيق هذه (If68f9)
إصلاح الأخطاء
- تعيّن
ColorScheme.contentColorFor
الآنsurfaceDim
إلىonSurface
. (I8891a) - تم تعديل عملية تنفيذ
DateInputTextField
لمعالجة مشكلة عدم عرض التاريخ الذي تم ضبطه آليًا في حقل الإدخال. (I6c8d1، b/401143451) - تم إصلاح ترتيب التركيز في TalkBack لشريط التنقّل وشريط التنقّل العريض (I6cf6f، b/407048224)
الإصدار 1.4.0-alpha11
26 مارس 2025
تم طرح androidx.compose.material3:material3-*:1.4.0-alpha11
. يحتوي الإصدار 1.4.0-alpha11 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- تعديل طريقة كتابة الأحرف الكبيرة والصغيرة لخصائص العناصر القابلة للإنشاء في الكائنات التلقائية للزر وزر التبديل أضِف طرقًا في
ToggleButtonDefaults
وButtonDefaults
لتحديد الحشو والأشكال وحجم الرمز والمسافة بين الرموز ونمط النص حسب ارتفاع الحاوية. (Iea69e) - تمت إزالة الدوال والثوابت التجريبية المتوقّفة نهائيًا من
FloatingToolbar
. (I8f339) - تتشارك الآن مكوّنات الارتفاع واجهة مشتركة، كما أنّها تتضمّن أدوات إنشاء وخصائص عامة. (Ibb172)
- إضافة المعدِّل
animateWidth
فيButtonGroupScope
الذي يجب استخدامه مع العناصر الفرعية لمجموعة الأزرار لتحريك العناصر الفرعية بشكل صحيح (Ia3bb6)
إصلاح الأخطاء
- تم إصلاح مساحة الحشو في شريط الأدوات العائم لضمان التوازن المرئي أثناء التصغير، وتم تحسين المرونة للمحتوى الأكبر. (I06c00)
الإصدار 1.4.0-alpha10
12 مارس 2025
تم طرح androidx.compose.material3:material3-*:1.4.0-alpha10
. يحتوي الإصدار 1.4.0-alpha10 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- تم إيقاف
TabRowDefaults.tabIndicatorOffset
نهائيًا واستبداله بـTabIndicatorScope.tabIndicatorOffset
. (Ib36b3) - إصلاح خطأ إملائي في مساحة الحشو الصغيرة للمحتوى في الإعدادات التلقائية للأزرار (I19bfe)
- تم إيقاف الإجراءين
TabRow
وScrollableTabRow
نهائيًا واستبدالهما بالمتغيرَين الأساسي والثانوي لكل منهما. أصبحت صفوف علامات التبويب الأساسية والثانوية أكثر فعالية ودقةً وفقًا للمواصفات. (I918e2) - تمت إضافة
rememberSliderState
وrememberRangeSliderState
. (I8e384) - تمت إضافة
shouldAutoSnap
إلىSliderState
للتحكّم في آلية المحاذاة التلقائية، وقد يكون إيقافها مفيدًا للرسوم المتحركة المخصّصة. (I07745) - أصبح الحدّ الأدنى لعرض علامة التبويب في صف علامات التبويب القابل للتمرير مَعلمة. لم تعُد أشكال الصفوف في علامات التبويب الأساسية والثانوية تجريبية. (If6f15، b/226665301)
- تمت إتاحة الفئة
ExitAlwaysFloatingToolbarScrollBehavior
بشكل علني، ما يسمح بإنشاءها بدون تركيب. (Ibf31c)
الإصدار 1.4.0-alpha09
26 فبراير 2025
تم طرح androidx.compose.material3:material3-*:1.4.0-alpha09
. يحتوي الإصدار 1.4.0-alpha09 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- إعادة تسمية حقول إعدادات
DragHandle
في الحالة التلقائية، وفصل حالتي الضغط والسحب، وإتاحة الأحجام التلقائية للجميع (I787b9) - تعديلات على واجهة برمجة التطبيقات
TowRowsTopAppBar
تمت إزالة مَعلمة lambdaexpanded
وإضافة مَعلمات منفصلة للارتفاعات الموسّعة والمصغّرة. (Idd677، b/306697446، b/229134133، b/268068946)
إصلاح الأخطاء
- تتّبع أشرطة التطبيقات السفلية الآن خدمة "استكشاف اللمس" (مثل
TalkBack
) وإبقائها مرئية عندما تكون الخدمة مفعّلة. (I4b34d)
الإصدار 1.4.0-alpha08
12 فبراير 2025
تم طرح androidx.compose.material3:material3-*:1.4.0-alpha08
. يحتوي الإصدار 1.4.0-alpha08 على عمليات الدمج هذه.
الميزات الجديدة
تمت إضافة واجهة برمجة تطبيقات
TimePickerDialog
يمكن استخدامها فيTimePicker
أوTimeInput
أو للحصول على إصدار قابل للتبديل. (Id2d83)واجهات برمجة التطبيقات الجديدة لشريط البحث:
- أصبحت أشرطة البحث المصغّرة و "طرق العرض" الموسّعة للبحث عناصر قابلة للإنشاء منفصلة.
- يمثّل
SearchBar
شريط بحث في الحالة المصغّرة. - يمثّل
ExpandedFullScreenSearchBar
وExpandedDockedSearchBar
شريط البحث في الحالة الموسّعة. يتم فتحها في نافذة جديدة. SearchBarState
للتحكّم في حالة شريط البحثTopSearchBar
لإضافة معالجة الحواف الداخلية وسلوك التمرير- إضافة حمولة زائدة جديدة إلى
InputField
تستخدمSearchBarState
(Ie0723 وb/261496232 وb/283311462 وb/350916229 وb/352872248)
تغييرات واجهة برمجة التطبيقات
- إتاحة تغيير شكل زوايا أزرار الرموز عند الضغط عليها (I21843)
- لم تعُد واجهات برمجة التطبيقات الخاصة بمربّع/عنصر تزيين حقل النص تجريبية. (I31d95)
- تمت إضافة عيّنات وقيم تلقائية لخيارات المنتج المرتبطة في
ButtonGroup
. (I5c8ce) - اجعل مَعلمة الحالة هي الأخيرة في
NavigationSuiteScaffold
وNavigationSuiteScaffoldLayout
. (I9cc7b)
إصلاح الأخطاء
- تمت إضافة إجراءات مخصّصة لتسهيل الاستخدام إلى
FloatingToolbars
، ما يتيح لخدمات تسهيل الاستخدام الآن توسيع جميع خياراتFloatingToolbar
أو تصغيرها. يطبّق الإصدار المزود بزر الإجراء العائم هذا التنسيق على الزر، بينما يطبّقه الإصدار غير المزود بزر الإجراء العائم على المحتوى الرئيسي. (I26420) - سيتم الآن تفعيل خدمة استكشاف الشاشة باللمس (مثل
FloatingToolbars
TalkBack) وإبقاء شريط الأدوات موسّعًا ومرئيًا عندما تكون الخدمة مفعّلة. (I02172) - تم إصلاح عُطل في مؤشّري التقدّم والتحميل في حال تم تمرير
Float.NaN
كتقدّم. (I4fa96، b/352364576)
الإصدار 1.4.0-alpha07
29 يناير 2025
تم طرح androidx.compose.material3:material3-*:1.4.0-alpha07
. يحتوي الإصدار 1.4.0-alpha07 على عمليات الإيداع هذه.
الميزات الجديدة
- تمت إضافة المزيد من المرونة في تخصيص مظهر مربّعات الاختيار باستخدام واجهة برمجة تطبيقات جديدة. توفّر واجهة برمجة التطبيقات هذه مَعلمات Stroke تتيح التحكّم بشكل أكبر في طريقة عرض علامة الاختيار ومخطّط مربّع الاختيار. (I65a88)
- تمت إضافة واجهة برمجة التطبيقات
TwoRowsTopAppBar
، وهي بديل أكثر قابلية للتخصيص لشريطَي التطبيق المتوسط والكبير لإنشاء أشرطة تطبيق علوية تتضمّن صفَّين. يمكن للمطوّرين الآن التحكّم في محتوى العناوين والعناوين الفرعية في كلّ من الحالتَين المصغّرة والموسّعة، مع إمكانية تخصيص الارتفاع لكل حالة. (I0be3c، b/306697446، b/229134133، b/268068946)
تغييرات واجهة برمجة التطبيقات
- تمت إعادة تسمية أحد أشكال
BottomAppBar
التجريبية إلىFlexibleBottomAppBar
، ما يتيح المزيد من التحكّم في ترتيب المحتوى وارتفاعه. (Iaa448) - تعديل تسمية الخصائص في الكائن التلقائي "مجموعة الأزرار" لتصبح
CapitalCase
عدِّل اسمanimateFraction
ليكون أكثر دقةً في وصف السلوك الذي يمثّله. (I545cd) - إضافة عمليات تحميل زائدة للأزرار الشائعة التي تسمح بأشكال متحركة عند التفاعل بالضغط تمت إضافة أشكال الأزرار المخزّنة مؤقتًا. (I5ec20)
- يمكنك الآن التحكّم في طريقة تفاعل
FloatingToolbar
مع زر الإجراء العائم عند التمرير من خلال توفيرFloatingToolbarScrollBehavior
. بالنسبة إلى أشرطة الأدوات الموضوعة على طول حافة مركزية (مثل أعلى أو أسفل المركز)، ننصحك باستخدام سلوك التمرير لإخفاء المكوّن بأكمله عند التمرير للحصول على مظهر أكثر ترتيبًا. يمنع ذلك أيضًا ظهور الزر العائم خارج المركز، وهو ما قد يحدث عند استخدام العلامةexpanded
لتصغير الزر. (I33f67) - تعديل واجهات برمجة التطبيقات التجريبية
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 على عمليات الدمج هذه.
تغيير السلوك
- تمت إضافة
displayCutout
إلى مجموعة الحواف الداخلية التي تأخذها مكونات Material في الاعتبار تلقائيًا، وذلك لتجنُّب تداخل المحتوى مع فتحة الشاشة. هذا تغيير في السلوك سيؤثّر في طريقة عمل المكوّنات التي تتوافق مع الحواف الداخلية حول فتحة الشاشة. ويشمل ذلك القيمة التلقائية للمَعلمةWindowInsets
لمكوّنات Material 3 التي تتوافق مع الحواف الداخلية، وقيمWindowInsets
المقدَّمة في عناصر Defaults للمكوّنات لكل من Material 2 وMaterial 3. إذا تسبّب هذا التغيير في سلوك غير مرغوب فيه، حدِّد المَعلمةWindowInsets
يدويًا على أساس كل مكوّن. (I43ee9، b/362508045)
تغييرات واجهة برمجة التطبيقات
- تعديلات على واجهة برمجة التطبيقات
TopAppBar
أعِد تسمية أشرطة التطبيقات العلوية المتوسطة والكبيرة باستخدام عنوان فرعي*FlexibleTopAppBar
. تم توحيد أشكال الألوان المختلفة في دالةTopAppBarDefault.topAppBarColors()
واحدة، وتمت إضافة مَعلمة اللونsubtitle
ليتم تطبيقها على عنصر Composable للترجمة والشرح المقدَّم (I41b65) - إزالة واجهة برمجة التطبيقات
WideNavigationRailArrangement
واستخدامArrangement.Vertical
بدلاً منها (Id0341) - أضِف
VerticalSlider @Composable
جديدًا. (I2bfba) - أضِف مسارًا جديدًا
@Composable
يتيح تحديد زوايا المسار الخارجية المخصّصة ورموز المسار. (I436a4) - عدِّل واجهات برمجة التطبيقات الخاصة بشريط الأدوات العائم لاستخدام العنصر
FloatingToolbarColors
بدلاً من لون حاوية واحد. (I9a054) - إضافة تعليق توضيحي تجريبي جديد واستخدامه
ExperimentalMaterial3ComponentOverrideApi
(Ia1eaf) - تتخذ السمة
Modifier.indicatorLine
الآن شكلاً للحقل النصي من أجل التعامل مع الاقتصاص. (I8c5f3، b/380704151) - إعادة تسمية الدوال التجريبية
FloatingAppBar
لتصبحFloatingToolbar
(I1dbf8) - تمت إضافة
floatingToolbarVerticalNestedScroll
يمكن إرفاقه بحاوية قابلة للتمرير لتعديل حالة توسيع شريط الأدوات العائم استنادًا إلى حركة تمرير تتجاوز حدًا معيّنًا. (I6d65f) - نقدّم لك واجهة برمجة تطبيقات جديدة لإنشاء شريط أدوات عائم يتضمّن زر إجراء عائمًا (FAB). توفّر واجهة برمجة التطبيقات خيارات تخصيص مرنة، ما يتيح لك ترتيب شريط الأدوات أفقيًا أو عموديًا ووضع زر الإجراء العائم في بداية شريط الأدوات أو نهايته. (I9e350)
إصلاح الأخطاء
- تم إصلاح مشكلة في إمكانية الوصول إلى Snackbar كانت تؤدي إلى الإعلان عن نفسه عند إغلاقه عندما يكون
TalkBack
مفعّلاً. (/I9db53)
المساهمة الخارجية
- تم توحيد
BasicTooltip
في Foundation وBasicTooltip/Tooltip
في Material3. (Ifc2e6)
الإصدار 1.4.0-alpha05
12 ديسمبر 2024
تم طرح androidx.compose.material3:material3-*:1.4.0-alpha05
. يحتوي الإصدار 1.4.0-alpha05 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- استبدال النوع في قيمة
WideNavigationRailState.current/target
بقيمة enum لتسهيل القراءة (I2d6ab) - تم إجراء تغيير على واجهة برمجة التطبيقات Shape من فئة البيانات إلى الفئة لتحقيق التوافق الثنائي
SplitButton
. (I53812) - تمت إضافة واجهة برمجة تطبيقات خاصة بتلميحات الأدوات تتضمّن المَعلمة
onDismissRequest
ليتمكّن المصمّمون من تحديد ما يحدث عندما ينقر المستخدم خارج تلميح الأداة. تم إيقاف واجهة برمجة التطبيقات القديمة التي لا تحتوي على هذه المَعلمة الجديدة. (I99aef) - تغيير اسم
opticalCentering
إلىhorizontalCenterOptically
جعل المعدِّل داخليًا استبدِل مَعلمة padding بالحدّ الأقصى لإزاحة البدء والانتهاء. (I0b904) - غيِّر
WideNavigationRailState
ليتضمّن القيمة الحالية/المستهدَفة، وأزِل التعدادات لصالح القيمة المنطقية. (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 على عمليات الدمج هذه.
التغييرات في السلوك
- إعادة تغييرات الألوان التي تم تقديمها في aosp/3212478 إلى
iconButtonColors
وiconToggleButtonColors
وoutlinedIconButtonColors
وoutlinedIconToggleButtonColors
وoutlinedIconToggleButtonBorder
تم نقل السلوك الذي تم إرجاعه الآن إلى مجموعة جديدة من الدوال باسمiconButtonVibrantColors
وما إلى ذلك للتأكيد على ألوان التباين العالي التي يتم عرضها. (Iffd8d)
الميزات الجديدة
- إضافة مكوّن
VerticalDragHandle
(I6c770)
تغييرات واجهة برمجة التطبيقات
- أعِد تسمية
DismissibleModalWideNavigationRailDefaults
إلىModalWideNavigationRailDefaults
. (I8e877) - أضِف
NavigationBarComponentOverrides
. (I8a3f3) - أضِف
NavigationRailComponentOverride
. (I83e13) - إضافة
WideNavigationRailState
للتعامل مع تصغير/توسيع الشريط الجانبي، والسماح بإغلاقModalWideNavigationRail
وحذفDismissibleModalWideNavigationRail
(I88568) - إضافة أحجام تلقائية صغيرة جدًا ومتوسطة وكبيرة وكبيرة جدًا إلى الإعدادات التلقائية لزر التبديل (Ie95d1)
- إضافة أحجام تلقائية صغيرة جدًا ومتوسطة وكبيرة وكبيرة جدًا إلى الإعدادات التلقائية للأزرار (If8b6d)
إصلاح الأخطاء
- تم تعديل لون الرمز اللاحق لشريحة الفلتر من "أساسي" إلى
OnSurfaceContainer
، وفقًا للمواصفات. تم تعديل جميع ألوان مخطط الشريحة من "مخطط" إلى "مخطط متغير"، وفقًا للمواصفات. (I68bd4)
الإصدار 1.4.0-alpha03
30 أكتوبر 2024
تم طرح androidx.compose.material3:material3-*:1.4.0-alpha03
. يحتوي الإصدار 1.4.0-alpha03 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- تم إيقاف طريقة وضع تصميم
SheetState
التي تتضمّن الكثافة نهائيًا لصالح حدود الموضع والسرعة. (Ifd16e) - تمت إضافة
rememberTooltipPositionProvider
يتضمّن منطقًا معدَّلاً لتحديد المواقع الجغرافية. تم إيقافrememberPlainTooltipPositionProvider
وrememberRichTooltipPositionProvider
نهائيًا. (Ie66e2) - تتيح لك
ModalBottomSheetProperties
الإضافية تخصيص ألوان شريط الحالة وشريط التنقّل. يتم تعديل هذه العناصر تلقائيًا استنادًا إلى لون المحتوى بدلاً من حالة المظهر الداكن في النظام. (Ib874e، b/362539765) - تم تحسين تجربة الإدخال في أدوات اختيار التاريخ: عند تفعيل وضع الإدخال، سيتم التركيز على حقل نص التاريخ لإدخال النص على الفور. يضيف التغيير المَعلمة
requestFocus
إلىDatePicker
وDateRangePicker
. يمكنك منع التركيز من خلال تمريرfalse
. (I12d09، b/286399710، b/340102743) - تخزين الإعدادات التلقائية للشكل مؤقتًا في عنصر الشكل ضبط الأشكال التلقائية
@Composable
لزر التبديل يتم تصغير الأشكال إلى شكل واحد تلقائيًا لأنّ خيارات التصميم تشير إلى ملف الرمز المميز نفسه. (Iaa014)
إصلاح الأخطاء
- تحسين سلوك
contentPadding
لتجنُّب إعادة إنشاء محتوى النص الأساسي دائمًا عند تغييرcontentPadding
(I8c8e2، b/373904168) - تمت إعادة تسمية
TextFieldLabelScope
progress
إلىlabelMinimizedProgress
- تمت إعادة تسمية
TextFieldLabelPosition
Default
إلىAttached
. تمت إزالة عناصر الواجهة. (If75c6) - تم إصلاح مشكلة في
DatePicker
في وضع الإدخال حيث يمكن أن تتسبب أخطاء التحقّق من الصحة في تغيير ارتفاع المكوّن. (I2e229، b/280462363) - اجعل شريط التمرير Material Slider يغيّر قيمته عند الضغط على مفاتيح التحكّم. (I1c442)
الإصدار 1.4.0-alpha02
16 أكتوبر 2024
تم طرح androidx.compose.material3:material3-*:1.4.0-alpha02
. يحتوي الإصدار 1.4.0-alpha02 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- تعديلات على أدوات اختيار التاريخ لضمان استخدام اللغة نفسها في جميع أنحاء
DatePicker
وDateRangePicker
عند ضبط اللغة مباشرةً من خلالDatePickerState
أوDateRangePickerState
. يُرجى العِلم أنّه عند ضبط اللغات مباشرةً على الحالة، يعود إليك التأكّد من ترجمة نصوص العنوان والمانشيت وفقًا لذلك، لأنّه سيتم تطبيق النص التلقائي وفقًا للغة التلقائية للمنصة. (I37073، b/326490763، b/321657276) - تم الآن عرض
SheetState.isAnimationRunning
. (I9a3d7) DatePickerColors
الآن لها الأولوية بشكل صحيح على أي ألوان غير متوافقة تم تحديدها في أنماط نص أسلوب الخط في التصميم. يُرجى العِلم أيضًا أنّ هذا التعديل يغيّر موضع المَعلمةcolor
في وظائف أداة اختيار التاريخ ويضيف المَعلمةcontentColor
لتخصيص ألوان نص العنوان والرأس. (I30d03، b/347031394)- أعِد تسمية
SplitButton
إلىSplitButtonLayout
وأزِل واجهات برمجة التطبيقات لخيارات اللونSplitButton
، وسيتم تحقيق الخيارات من خلال إعادة استخدام خيارات الأزرار التي يوفّرهاSplitButtonDefaults
. (I44c36) - تتضمّن السمة
ModalBottomSheet
الآن المَعلمةsheetGestureEnabled
(I856cb، b/288211587) - تمت إعادة تسمية
standardMotionScheme
وexpressiveMotionScheme
إلى "عادي" و"معبّر". يمكن الآن الوصول إلى كلتا الدالتين من خلال العنصر المصاحبMotionScheme
عن طريق استدعاءMotionScheme.standard()
وMotionScheme.expressive()
. (Iceccf) - إضافة المَعلمة
maxWidth
إلى تلميحات الأدوات العادية والغنية ويكون الإعداد التلقائي هو مواصفات التصميم التي تبلغ 200 وحدة بكسل مستقل الكثافة (dp) لتلميحات الأدوات العادية و320 وحدة بكسل مستقل الكثافة لتلميحات الأدوات المنسّقة. (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 على عمليات الدمج هذه.
التغييرات في السلوك
- لم تعُد المكتبة تضيف تبعية إلى
material-icons-core
، لذا إذا كان مشروعك يعتمد على ذلك، عليك إضافة هذه التبعية بشكل صريح في ملفاتbuild.gradle[.kts]
. (I735ff، b/349894318) - يتغيّر لون التصنيف النشط في
NavigationBarItem
وNavigationRailItem
منonSurface
إلىsecondary
لتحسين سهولة الاستخدام وتباين الألوان وتحسين التماسك داخل النظام (Ibc297). للعودة إلى السلوك السابق، انسخ الألوان التلقائية وغيِّرselectedTextColor
إلىMaterialTheme.colorScheme.onSurface
. - تستخدم مكوّنات Material 3 الآن
MotionScheme
الجديدة لتحديد الحركة. (Ie0f93) - تغييرات في حركة مؤشر التقدّم الدائري غير المحدّد (I3c07e)
- عدِّل
OutlinedIconButtonColors
وOutlinedIconToggleButtonColors
للحصول على تباين أفضل في الألوان. (I2743d) - تم تعديل لون الحاوية والمحتوى لكل من
FilledIconToggleButtonColors
وFilledTonalIconToggleButtonColors
. (Ic5d0f) - تم تعديل لون حدود
OutlinedButton
منoutline
إلىoutlineVariant
. (057f00)
تغييرات واجهة برمجة التطبيقات
- تمت إضافة المَعلمة الاختيارية
reverseLayout
إلى الدالةenterAlwaysScrollBehavior
فيTopAppBar
من أجل توفير دعم أفضل للمحتوى الذي تم ضبطه باستخدامreverseLayout
. (I4e0e5) - يتيح
SegmentedButton
الآن استخدام وسيطةcontentPadding
. (I5ad91، b/358414376) - لم يعُد
PullToRefreshState
يتضمّن عملية تنفيذ تلقائية للسمةisAnimating
(I6a593) - تمت إضافة عمليات تحميل زائدة جديدة للدالتين Material
TextField
وOutlinedTextField
اللتين تستخدمانTextFieldState
. تمت إضافة واجهات برمجة تطبيقات مربّعات الزخرفة المتوافقة معTextFieldDecorator
. (If13a1) - تمت إضافة مَعلمة للتحكّم في
labelPosition
حقل النص. يتيح استخدامalwaysMinimize
نمط واجهة المستخدم لعرض تصنيف وعنصر نائب في حقل نصي في الوقت نفسه حتى عندما يكون الحقل غير مركّز. (I1ef2c) - تمت إضافة المادتَين
SecureTextField
وOutlinedSecureTextField
لحقول إدخال كلمة المرور. (I7e22d) - تمت إضافة نطاق إلى تصنيفات حقول النص للاستعلام عن تقدّم الحركة. (If5ec8)
- تضيف هذه السمة إمكانية استخدام
MotionEvent.CLASSIFICATION_DEEP_PRESS
في تلميحات الأدوات. (I62e6a) - أصبح
isAfternoon
الخاص بـ "TimePickerState
" الآن قيمة إضافية بدلاً من متغيّر في الواجهة، وتمت إعادة تسميته إلىisPm
(I89a97) - تعديل فئة أسلوب الخط لتتوافق مع مقاييس الخطوط المميزة (Ifa13c)
- تمت إضافة واجهة برمجة التطبيقات
ModalWideNavigationRail
وإعادة تسمية واجهات برمجة التطبيقاتModalExpandedNavigationRail
إلىDismissibleModalWideNavigationRail
. (Ic9118) - تم تعديل
FloatingAppBarScrollBehavior
لاحتسابscreenOffset
تلقائيًا وعدم طلب@Composable
. (Idf349) - تعديلات على واجهة برمجة التطبيقات
LoadingIndicator
لإصلاح التسمية في العنصر التلقائي. تمت إضافة ثابتLoadingIndicatorElevation
فيPullToRefresh
. (I1d72b) - تعديلات على واجهة برمجة التطبيقات
LoadingIndicator
لإصلاح التسمية في العنصر التلقائي. تمت إضافة ثابتLoadingIndicatorElevation
فيPullToRefresh
. (I1d72b) - تمت إضافة المَعلمتَين
amplitude
وwaveSpeed
إلى الصيغ غير المحدّدة منLinearWavyProgressIndicator
وCircularWavyProgressIndicator
. (I2a0c5) - إتاحة تغيير شكل زر التبديل الخاص بالرمز استنادًا إلى حالته المضغوطة أو المحدّدة (Ibc781)
- تعديل فئة أسلوب الخط لتتوافق مع مقاييس الخطوط المميزة (Ifa13c)
- تتغيّر أشكال
SplitButton
استنادًا إلى الحالة التلقائية أو حالة الضغط. تمت إزالة واجهة برمجة التطبيقاتAnimatedTrailingButton
لأنّ واجهة برمجة التطبيقاتTrailingButton
يمكنها تقديم عمليات التخصيص نفسها (I95066) - أضِف أداة تعديل لتحريك عملية إظهار وإخفاء الزرّ العائم، مثلاً عند تمرير المحتوى. (I8338d)
- إضافة أشكال ومسافات مجموعة الأزرار المتصلة إلى
ButtonGroupDefaults
لاستخدامها في عيّنة (I68e30) - إضافة مساحة متروكة أفقية للزر الأخير وتفعيل التوسيط المرئي المحسوب من اختلافات الزوايا في البداية والنهاية (I122e2)
- نقدّم عنصر Material
MotionScheme
جديدًا للسماح بضبط مخطط لحركة المكوّن. يتم ضبط المخطط من خلالMaterialTheme
. (Id50c2)
إصلاح الأخطاء
- تطبيق فهرس التنقّل الصحيح للتركيز على العناصر الفرعية
Scaffold
القابلة للإنشاء الترتيب هوtopBar
وbottomBar
والزر العائم والقائمة المنسدلة وشريط المعلومات. (I5936b) - تم إصلاح مشكلة في
DatePicker
وDateRangePicker
حيث لم تبدأ بعض عناصر التاريخ (مثل أسماء الأشهر) بحرف كبير في بعض اللغات والأنماط. (I1430f) - دمج رموز مكوّنات زر الإجراء الرئيسي (FAB) وقائمة زر الإجراء الرئيسي (تعديلات مرئية بسيطة على المساحات المتروكة والنص) (Ib57f3)
- يظهر العنصر
ModalBottomSheet
الآن أولاً في ترتيب التنقّل الدلالي، يليه عنصر scrim. (I436f9، b/358594665) - إصلاح مشكلة عدم اختفاء شريط التطبيق السفلي بالكامل عند التمرير تحت زر التنقّل في وضع "من الحافة إلى الحافة" (I3ee21)
Compose Material3 الإصدار 1.3
الإصدار 1.3.2
9 أبريل 2025
تم طرح androidx.compose.material3:material3-*:1.3.2
. يحتوي الإصدار 1.3.2 على عمليات الدمج هذه.
إصلاح الأخطاء
- تعمل السمة
ListItem
على تصحيح عملية احتساب الارتفاع الداخلي، وتوفّر الآن المساحة المناسبة في Layout. - إزالة المساحة الزائدة حول التصنيف
NavigationBarItem
، مع المحاذاة بشكل صحيح وفقًا للمواصفات - يصحّح تخطيط
TabRow
في وضع "من اليمين إلى اليسار".
الإصدار 1.3.1
30 أكتوبر 2024
تم طرح androidx.compose.material3:material3-*:1.3.1
. يحتوي الإصدار 1.3.1 على عمليات الدمج هذه.
إصلاح الأخطاء
- تعمل الآن
DatePicker
وDateRangePicker
بشكل صحيح على تعديل الشهر المعروض عند ضبطهما من خلالdisplayedMonthMillis
الخاص بحالتهما. (If9e47، b/333414302) - تم إصلاح الأعطال في
DatePicker
وDateRangePicker
عندما يتم ضبط الحد الأدنى للسنة القابلة للاختيار على سنة مستقبلية. (I78656، b/319395747) - تم إصلاح مشكلة في أداة اختيار التاريخ لتعديل واجهة المستخدم عند تطبيق مثيل
SelectableDates
معدَّل. (Iad59a وb/290135807 وb/339898760) - تغيير أولوية معاودة الاتصال المستخدَمة في الأوراق السفلية إلى
PRIORITY_DEFAULT
للسماح للوحة مفاتيح IME بإغلاقها أولاً (I447fb)
الإصدار 1.3.0
4 سبتمبر 2024
تم طرح androidx.compose.material3:material3-*:1.3.0
. يحتوي الإصدار 1.3.0 على عمليات الدمج هذه.
التغييرات المهمة منذ الإصدار 1.2.0
الميزات الرئيسية في الإصدار 1.3.0
مكوّنات جديدة في Material Design 3
- لوحة العرض الدوّارة
HorizontalMultiBrowseCarousel
وHorizontalUncontainedCarousel
تحسينات على مكونات Material Design 3 الحالية
- [
ModalBottomSheet
] يتيح الآن استخدام ميزة "الرجوع التوقّعي" على الإصدارات U+ (Iccf32 وb/281967264 وb/304850357) - يتيح الإصدار [
SearchBar
] الآن استخدام إيماءة إظهار شاشة الرجوع على الإصدار U+ (I657f8) - تتيح "لائحة التنقّل" (
ModalDrawerSheet
وDismissibleDrawerSheet
) الآن ميزة "الرجوع التوقّعي" على U+ كخيار متاح (Ie5b0b) - يتيح
DropdownMenu
الآن تخصيص اللون والشكل والارتفاع والحدود. (I8e981،b/289554448، b/301887035، b/283654243) - تم تعديل شريط التمرير لتحسين إمكانية الوصول إليه من خلال إضافة فجوة ومؤشر إيقاف. (I3058e)
- تم تعديل
ProgressIndicator
لتحسين إمكانية الوصول من خلال إضافة مؤشر الفجوة والإيقاف. (I21451) - تمت إضافة علامة إقحام تلقائية لتلميح الأدوات المنسّق، مع إتاحة رسم علامة إقحام مخصّصة عند توفير عنصر الربط
LayoutCoordinates
. (Ifd42c) التغييرات التي قد تؤدي إلى أعطال - واجهات برمجة التطبيقات الجديدة للسحب لأسفل من أجل التحديث:
- تم تبسيط
PullToRefreshState
لاستخدام القيم الكسرية بدلاً من وحدات Dp. - يتحكّم المستخدم في حالة
isRefreshing
بدلاً منPullToRefreshState
. - تم فصل عملية الربط بالتمرير المتداخل عن
PullToRefreshState
. تتم معالجة هذه الطلبات من خلالPullToRefreshBox
أوModifier.pullToRefresh
الجديدَين. - هذا التحديث هو تغيير غير متوافق مع واجهات برمجة التطبيقات التجريبية السابقة. (I0adeb، b/314496282، b/317177684، b/323787138، b/324573502، b/317177683) تغييرات مرئية غير متوافقة مع الإصدارات السابقة
- تم تبسيط
- عدِّل تراكب حالة التركيز إلى 0.1f لضمان تباين الألوان بشكلٍ كافٍ. (I7ea77)
- تعديلات بسيطة على الإعدادات التلقائية للون السطح والخلفية في
lightColorScheme
وdarkColorScheme
(I9db52) - تم تعديل ألوان شريط التمرير و
ProgressIndicator
لتتوافق مع مواصفات تباين العناصر غير النصية الجديدة. (I26807) - تستخدم المكوّنات الآن
SurfaceContainer
صيغ. المكوّنات التي كانت تحسب اللون رسميًا باستخدامSurface
وTonalElevation
تستخدم الآن أدوارSurfaceContainer
تلقائيًا، وهي لا تتأثر بالارتفاع النغمي. (b/304584161) - تم تعديل الأدوار الأساسية لكل من "السطح" و"حاوية السطح" قليلاً، ما يوفّر المزيد من التدرّج اللوني في المظهرين الفاتح والداكن. (I677a5)
- تمت ترقية واجهات برمجة التطبيقات التجريبية إلى إصدار ثابت.
- أضفنا تحسينات على الأداء
الإصدار 1.3.0-rc01
21 أغسطس 2024
تم طرح androidx.compose.material3:material3-*:1.3.0-rc01
. يحتوي الإصدار 1.3.0-rc01 على عمليات الإيداع هذه.
إصلاح الأخطاء
- يظهر العنصر
ModalBottomSheet
الآن أولاً في ترتيب التنقّل الدلالي، يليه عنصر scrim. (I436f9، b/358594665)
الإصدار 1.3.0-beta05
24 يوليو 2024
تم طرح androidx.compose.material3:material3-*:1.3.0-beta05
. يحتوي الإصدار 1.3.0-beta05 على عمليات الإيداع هذه.
- تم إصلاح المشكلة المتمثّلة في عدم توفّر محتوى
BottomSheet
أو اقتصاصه على الإصدارَين N وO من نظام التشغيل Android (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 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- تتيح
Modifier.pullToRefreshIndicator
إمكانية الارتفاع، وتعديل واجهات برمجة التطبيقات "السحب لإعادة التحميل" لتفعيلها كقيمة منطقية بدلاً من تعبير لامدا. إتاحة محاذاة المحتوى فيPullToRefreshBox
(I75679) - تحويل
TooltipScope
إلى واجهة محكمة الإغلاق وإنشاء عملية تنفيذ داخلية لاستخدامها فيTooltipBox
وLabel (I3833e) - تمت إضافة معدِّلَين جديدَين إلى
CarouselItemScope
-maskClip
وmaskBorder
- لتسهيل إضافة شكل وحدود إلى أي عنصر في لوحة العرض الدوّارة (Id67a1) TimePickerState
هي الآن واجهة وتسمح بضبط الوقت (I88546)- تم تعديل واجهة برمجة التطبيقات الخاصة بتصميم الروابط: تم نقل
TextLinkStyles
إلىTextStyle
وإزالةTextDefaults
من المواد. (I5477b)
إصلاح الأخطاء
- تتجاوب رموز شريط الحالة وشريط التنقّل في
ModalBottomSheet
الآن مع حالة المظهر الداكن. (Ie1fe7، b/338342149) - تمت إضافة دلالات إغلاق ورقة البيانات إلى
ModalBottomSheet
scrim. (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 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- استخدام
DpSize
بدلاً منCaretProperties
جارٍ إزالةCaretProperties
. أعِد تسميةCaretScope
إلىTooltipScope
. (Id9a76) - تم تعديل واجهة برمجة التطبيقات للحصول على روابط متوافقة مع مظهر Material في النص. على وجه التحديد، تمت إزالة الطرق من
TextDefaults
لإنشاءLinkAnnotations
ذات سمات معيّنة وتحليل HTML باستخدام روابط ذات سمات معيّنة. بدلاً من ذلك، تمت إضافة فئةTextLinkStyles
تتيح تصميم الروابط كمعلَمة في العنصر Text القابل للإنشاء. (I31b93)
الإصدار 1.3.0-alpha06
1 مايو 2024
تم طرح androidx.compose.material3:material3-*:1.3.0-alpha06
. يحتوي الإصدار 1.3.0-alpha06 على عمليات الدمج هذه.
التغييرات التي قد تؤدي إلى أعطال
واجهات برمجة التطبيقات الجديدة للسحب للأسفل من أجل إعادة التحميل:
- تم تبسيط
PullToRefreshState
لاستخدام القيم الكسرية بدلاً من وحدات Dp. - يتحكّم المستخدم في حالة
isRefreshing
بدلاً منPullToRefreshState
. - تم فصل عملية الربط بالتمرير المتداخل عن
PullToRefreshState
. تتم معالجة هذه الطلبات من خلالPullToRefreshBox
أوModifier.pullToRefresh
الجديدَين. - هذا التحديث هو تغيير غير متوافق مع واجهات برمجة التطبيقات التجريبية السابقة. (I0adeb، b/314496282، b/317177684، b/323787138، b/324573502، b/317177683)
- تم تبسيط
تغييرات واجهة برمجة التطبيقات
- تمت إزالة
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) - تمت إضافة دالة lambda
drawTick
إلى واجهة برمجة التطبيقات العامة لتخصيص العلامات إذا لزم الأمر (I0c048)
تغييرات واجهة برمجة التطبيقات
- تمت إضافة خيار نمط حالة الضغط إلى الروابط النصية بالإضافة إلى النمط العادي ونمط التمرير والتركيز (I5f864، b/139312671)
- تم تعديل
CarouselItemInfo
لعرض Rect للقناع الذي يتم قص العنصر به (I785d8) - تمت إزالة
BasicTooltipState
من واجهة برمجة التطبيقات العامة Material 3. يتم دمج وظائفه معTooltipState
إلى أن يتم تثبيتBasicTooltip
في Foundation. (Icda29) - تمت إضافة عنصر
TextDefaults
يحتوي على طرق لإنشاءLinkAnnotation
وتحليل السلسلة التي تحمل علامات HTML والتي تطبّقMaterialTheme
على الروابط (I98532، b/139312671) - لم يعُد
ExposedDropdownMenuBoxScope
يسمح بالفئات الفرعية. تحتوي القوائم المنسدلة المكشوفة الآن علىMenuAnchorType
يجب تمريرها إلى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)
إصلاح الأخطاء
- لن يتم بعد ذلك تمرير
BottomSheetScaffold
من التمرير المتداخل إذا كانت قيمةsheetSwipeEnabled
هي "خطأ". (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 على عمليات الدمج هذه.
الميزات الجديدة
- تمت إضافة إصدارَين تجريبيَين من لوحة العرض الدوّارة Material3، وهما
HorizontalMultiBrowseCarousel
وHorizontalUncontainedCarousel
(I88d64) - تم تعديل "لوحة التنقّل" في Compose M3 (
ModalDrawerSheet
وDismissibleDrawerSheet
) لتتيح استخدام ميزة "الرجوع التوقّعي" في الإصدارات U+ كخيار متاح (Ie5b0b) - تمت إضافة واجهة برمجة تطبيقات جديدة في Icon للسماح بتمرير درجة اللون كدالة lambda لتجنُّب إعادة الإنشاء. (I5b5a2)
- تتيح واجهات برمجة التطبيقات الخاصة بشريط التطبيق العلوي الآن استخدام ارتفاعات مخصّصة لكل من الأقسام الثابتة والقابلة للتصغير. (Ib8b0c، b/323403446)
تغييرات واجهة برمجة التطبيقات
- تتيح واجهات برمجة التطبيقات الخاصة بشريط التطبيق العلوي الآن استخدام ارتفاعات مخصّصة لكل من الأقسام الثابتة والقابلة للتصغير. تم إصلاح مشكلة كانت تؤدي إلى إعادة إنشاء أشرطة التطبيق العلوية ذات السطر الواحد عدة مرات عند التنقّل في المحتوى. تم حلّ مشكلة
MediumTopAppBar
التي تؤدي إلى اقتطاع العناوين على الأجهزة التي تتضمّن إعدادات كبيرة للخط/العرض. (Ib8b0c، b/323403446، b/300953236، b/286296147، b/330410290، b/308540676) - أصبحت
SegmentedButton
وواجهات برمجة التطبيقات المرتبطة بها ثابتة الآن (I8a158) - تم الآن وضع علامة "إصدار ثابت" على
SwipeToDismissBox
وSwipeToDismissBoxDefaults
وSwipeToDismissBoxState
وSwipeToDismissBoxValue
. (I5f000) - تمت إزالة قيم التعداد وواجهات برمجة التطبيقات المتوقفة
DismissDirection
وDismissValue
. (I89ccd) - تمت إضافة علامة تجريبية إلى الكائن المرافق
CarouselState
الخاص بـ "منصّة العرض الدوّارة". (I94154) - تم إيقاف
LocalMinimumInteractiveComponentEnforcement
نهائيًا وطرحLocalMinimumInteractiveComponentSize
كبديل له. (I7a7ac) - أصبحت طريقة وضع تصميم
SearchBarColors
متاحة للجميع الآن. (I769ca) - تمت إضافة المَعلمة
gesturesEnabled
إلىSwipeToDismissBox
. (Idc59f، b/324170119) - تمت إزالة واجهات برمجة التطبيقات لحقول النص التي تم تصنيفها على أنّها متوقّفة نهائيًا وتجريبية. (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)
تغييرات واجهة برمجة التطبيقات
- تمت إزالة العلامة
ScaffoldSubcomposeInMeasureFix
. (Ie2a4b) - تم الآن وضع علامة
@Immutable
علىNavigationRailItemColors
. (If6112، b/327660613) - تم الآن وضع علامة
@Immutable
علىNavigationBarItemColors
. (I42a30، b/298064514) - إعادة ترتيب المَعلمات في دالة Slider Track القابلة للإنشاء (I9f315)
- تم الآن تنفيذ
ExposedDropdownMenu
باستخدامPopup
. يجب أن يكون السلوك هو نفسه باستثناء القوائم القابلة للتركيز التي تحتوي على حقول نصية قابلة للتعديل والتي يمكن إغلاقها عند الكتابة على لوحة المفاتيح.
إصلاح الأخطاء
- تم تعديل الأدوار الأساسية لكل من "السطح" و"حاوية السطح" قليلاً، ما يوفّر المزيد من التدرّج اللوني في المظهرين الفاتح والداكن. (I677a5)
- تم تعديل ألوان شريط التمرير و
ProgressIndicator
لتتوافق مع مواصفات تباين العناصر غير النصية الجديدة. (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 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- إعادة استقرار حالات شريط التمرير إعادة
State.onValueChangeFinished
إلى حالة صالحة تضمين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
في التنسيق من اليمين إلى اليسار (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 على عمليات الإيداع هذه.
الميزات الجديدة
- تعديل Compose M3
ModalBottomSheet
ليتوافق مع ميزة "الرجوع التوقّعي" على الإصدار U والإصدارات الأحدث (Iccf32 وb/281967264 وb/304850357) - تعديل Compose M3
SearchBar
لإتاحة إيماءة "الرجوع التوقّعي" على U+ (I657f8) - تم تعديل شريط التمرير لتحسين إمكانية الوصول إليه من خلال إضافة فجوة ومؤشر إيقاف. (I3058e)
- تم تعديل
ProgressIndicator
لتحسين إمكانية الوصول من خلال إضافة مؤشر الفجوة والإيقاف. (I21451) - إضافة علامة إقحام تلقائية إلى تلميح الأدوات المنسّق، وتتيح واجهة برمجة التطبيقات الجديدة لتلميحات الأدوات المنسّقة الآن رسم علامة إقحام مخصّصة بالنظر إلى العنصر الأساسي
LayoutCoordinates
. (Ifd42c)
التغييرات في السلوك
- تم نقل مكونات Material لاستخدام واجهات برمجة التطبيقات الجديدة الخاصة بالتموج، ولم تعُد تستعلم عن
RippleTheme
.
تغييرات واجهة برمجة التطبيقات
- أصبحت ميزة
drawStopIndicator
متاحة للجميع. (I3f59f) - وضع علامة على الدالة
DatePicker
formatWithSkeleton
للإشارة إلى أنّها داخلية (Ic65dc) - يتيح
DropdownMenu
الآن تخصيص اللون والشكل والارتفاع والحدود. (I8e981، b/289554448، b/301887035، b/283654243) - تم تعديل مكوّنات Material3 التي تعرض
MutableInteractionSource
في واجهة برمجة التطبيقات لتصبح تعرض الآنMutableInteractionSource
قابلاً للقيم الخالية، ويتم ضبط القيمة التلقائية علىnull
. لا توجد تغييرات دلالية هنا: يعني تمرير قيمة فارغة أنّك لا تريد نقلMutableInteractionSource
إلى الأعلى، وسيتم إنشاؤه داخل المكوّن إذا لزم الأمر. يسمح التغيير إلى قيمة فارغة لبعض المكوّنات بعدم تخصيصMutableInteractionSource
مطلقًا، ويسمح لمكوّنات أخرى بإنشاء مثيل فقط عند الحاجة، ما يحسّن الأداء في جميع هذه المكوّنات. إذا كنت لا تستخدمMutableInteractionSource
الذي تمرّره إلى هذه المكوّنات، ننصحك بتمرير قيمة فارغة بدلاً من ذلك. يُنصح أيضًا بإجراء تغييرات مماثلة في مكوّناتك. (I41abb، b/298048146) - تضيف هذه السمة
RippleConfiguration
وLocalRippleConfiguration
للسماح بتخصيص التموجات على مستوى كل مكوّن أو شجرة فرعية باستخدام قيم ثابتة. على سبيل المثال، لتغيير لون أحد المكوّنات التي لا تتحكّم فيها، أو لإيقاف تأثير التموّج لأحد المكوّنات. في معظم الحالات، يجب استخدام القيم التلقائية: تشكّل واجهات برمجة التطبيقات هذه مخرجًا للتحكّم في تخصيص المكوّنات الفردية أو الأجزاء الفرعية المحدودة. بالنسبة إلى التغييرات الأوسع وأنظمة التصميم المخصّصة، عليك بدلاً من ذلك إنشاء تموج خاص بك باستخدامcreateRippleModifierNode
. (I7b5d6، b/298048146) - تضيف هذه السمة واجهة برمجة تطبيقات جديدة لتأثير التموّج في Material3 تحلّ محل السمة
rememberRipple
التي تم إيقافها نهائيًا. تضيف أيضًاCompositionLocal
وLocalUseFallbackRippleImplementation
مؤقتًا لإعادة ضبط مكوّنات Material3 لاستخدام واجهات برمجة التطبيقاتrememberRipple
/RippleTheme
المتوقّفة نهائيًا. ستتم إزالة هذه السمة في الإصدار الثابت التالي، وهي تهدف فقط إلى تقديم مساعدة مؤقتة في عملية نقل البيانات في الحالات التي تقدّم فيهاRippleTheme
مخصّصة. (I34cbc، b/298048146)
إصلاح الأخطاء
- تمت إزالة التركيبة الفرعية داخل
ModalBottomSheet
لتحسين الأداء. تم إصلاح مشكلة قد تؤدي إلى تعطُّلModalBottomSheet
في سيناريوهات معيّنة عند استخدامها معLookaheadScope
. (I2a198) - تمت إزالة التركيبة الفرعية داخل
BottomSheetScaffold
لتحسين الأداء. تم إصلاح مشكلة تعطُّلBottomSheetScaffold
في سيناريوهات معيّنة عند استخدامه معLookaheadScope
. (Ie6401) - تم تعديل محاذاة الشارة لتكون أقرب إلى وسط المحتوى الثابت بالنسبة إلى أعلى يسار الشاشة. (I18a28)
- تم إصلاح مشكلة متعلّقة بإمكانية الوصول في
DateRangePicker
، حيث تم نقل عنوان نص "الشهر والسنة" على أنّه قابل للتنفيذ لمستخدمي برامج قراءة الشاشة و"الوصول عبر مفتاح تحكّم" و"الوصول الصوتي". (I2ac55) - تم إصلاح خطأ ترتيب المَعلمات
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) - إزالة
@Stable
من حالاتSlider
لأنّنا سنغيّرstate.onValueChangeFinished
إلىvar
(I82ba1، b/322269951) - إصلاح ألوان
NavigationBar
المخصّصة لنسخها من الألوان التلقائية (80a779، b/326894020) - إصلاح مشكلة تراجع في
ExposedDropdownMenu
لجعلها قابلة للتركيز مرة أخرى (3fcec1، b/323694447) - إصلاح مشكلة التخزين المؤقت للون زرّ الإصلاح (3e5bbcb/327371655)
الإصدار 1.2.0
7 فبراير 2024
تم طرح androidx.compose.material3:material3-*:1.2.0
. يتضمّن الإصدار 1.2.0 عمليات الإيداع هذه.
مشكلة معروفة
- تم طرح خطأ في عرض التوافق بين View وCompose في الإصدار
PrimaryTabRow
كجزء من تغيير يهدف إلى تحسين الأداء. الحل البديل هو استخدامTabRow
معTabRowDefaults.PrimaryIndicator
التغييرات المهمة منذ الإصدار 1.1.0
مكوّنات جديدة في Material Design 3
- السحب للأسفل لإعادة التحميل
- الزر المقسَّم
تحسينات على مكوّنات Material Design 3 الحالية
- شريط التطبيق السفلي (محاذاة من اليمين إلى اليسار، إخفاء تلقائي عند التمرير)
- تعديل مرئي على علامات التبويب
- شارة (تعديل المحاذاة)
تمت ترقية واجهات برمجة التطبيقات التجريبية إلى إصدار ثابت
تحسينات على الأداء
- يُرجى الاطّلاع على منشور المدونة هذا لمزيد من التفاصيل.
الإصدار 1.2.0-rc01
24 يناير 2024
تم طرح androidx.compose.material3:material3-*:1.2.0-rc01
. يحتوي الإصدار 1.2.0-rc01 على عمليات الإيداع هذه.
إصلاح الأخطاء
- تم إصلاح خطأ ترتيب المَعلمات
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
بشكلٍ صريح. سيتم حلّ هذه المشكلة في الإصدار التالي.
تغييرات واجهة برمجة التطبيقات
- إضافة إمكانية تفعيل علامات الإقحام في تلميحات الأدوات لواجهات Plain
Tooltip
API. (Ibf767) - تمت إعادة تسمية
SwipeToDismissState
وrememberSwipeToDismiss
وSwipeToDismissValue
لتتضمّن_SwipeToDismissBox_
. (I68d6d)
إصلاح الأخطاء
- تم إصلاح قيمة المساحة المتروكة في نهاية
ListItem
لتتوافق مع المواصفات. (Ibd68b، b/305342674) - تم الآن ربط لون المخطط التفصيلي للبطاقة ذات المخطط التفصيلي بشكل صحيح بالسمة
OutlineVariant
. (I75480، b/310979715) - تستند ميزة "الألوان الديناميكية" الآن إلى أدوار الألوان المحدّدة في النظام. يؤدي ذلك إلى تحسين التباين للمحتوى الذي يسهل الوصول إليه، كما أنّه يربط الألوان الديناميكية بمواصفات Material بشكل أوثق. (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 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- وضع علامة "تجريبي" على
TabIndicatorScope
(I45c88) - إزالة واجهات برمجة التطبيقات التجريبية المتوقّفة نهائيًا الخاصة بتلميحات الأدوات (I438cb)
- تغيير عمليات التحميل الزائد الجديدة في
TabRow
لعدم استخدام التركيبات الفرعية يؤدي ذلك إلى طريقة مختلفة لإنشاء مؤشراتTabRow
باستخدام المعدِّلات المخصّصة المقدَّمة. (Ife741) - إيقاف واجهتَي برمجة التطبيقات
DismissDirection
وDismissValue
نهائيًا تم دمجها فيSwipeToDismissValue
، وتشير قيمه إلى موضع واتجاهSwipeToDismissBox
. تم الآن وضع علامةFloatRange
علىDismissState.progress
، ويبلغ سعره بين0.0
و1.0
. تمت الآن إزالة الفئتين المتوقّفتَينDismissState
Saver وConstructor. تمت إعادة تصنيف العنصرSwipeToDismiss
وكائن الحالة والقيم التلقائية على أنّها تجريبية. (Ib54f2)
إصلاح الأخطاء
- مؤشر
PullToRefresh
التلقائي هو الآن رأس سهم مفتوح بدلاً من مثلث مصمت. (I67be3)
الإصدار 1.2.0-alpha12
29 نوفمبر 2023
تم طرح androidx.compose.material3:material3-*:1.2.0-alpha12
. يحتوي الإصدار 1.2.0-alpha12 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- تتلقّى الدالة
RangeSlider
الآن نطاق Kotlin (مثل0f..1f
) بدلاً من فئة قيمةFloatRange
مخصّصة. يستخدمSnapFlingBehavior.kt
الآن أيضًا نطاق Kotlin. (I025cb) - وضع علامة
@Stable
على دوال المصنع الخاصة بـ Mark Modifier. (Ib109f)
الإصدار 1.2.0-alpha11
15 تشرين الثاني (نوفمبر) 2023
تم طرح androidx.compose.material3:material3-*:1.2.0-alpha11
. يحتوي الإصدار 1.2.0-alpha11 على عمليات الإيداع هذه.
الميزات الجديدة
- تنفّذ هذه الفئة
PullToRefreshContainer
وPullToRefreshState
، اللتين توفّران معًا عملية سحب لإعادة التحميل في Material3. (I16456، b/261760718)
تغييرات واجهة برمجة التطبيقات
- ضَع علامة "تجريبي" على
SwipeToDismissBox
وDismissDirection
وDismissValue
. (I517b0) - أعِد تسمية
SwipeToDismiss
إلىSwipeToDismissBox
. أعِد تسميةbackground
إلىbackgroundContent
وdismissContent
إلى دالة lambdacontent
اللاحقة. (I7f4d3) - اجعل الدالة الإنشائية لكل من
ChipElevation
وSelectableChipElevation
متاحة للجميع. (Ie0c48، b/308432421) - جارٍ إضافة
ModalBottomSheetProperties
. جارٍ نقلsecurePolicy
إلىModalBottomSheetProperties
. جارٍ إضافة "isFocusable
" و"shouldDismissOnBackPress
" إلى "ModalBottomSheetProperties
" تساعد قيمتا boolean الجديدتان في تحديد كيفية تعامل ورقة IME مع ورقة modal السفلية. (Iea56f، b/278216859) - تم تعديل حالتَي
RangeSlider
وSlider
لإزالةinitialOnValueChange
، وهي البادئات الأولية، ومستندات kdoc المناسبة. (I57d30) - إيقاف الفئة
ChipBorder
واستدعاءات الدوال المرتبطة بها نهائيًا، وننصح باستخدامBorderStroke
مباشرةً بدلاً من ذلك. (I89cc2) - أصبحت واجهات برمجة التطبيقات الخاصة بأداة Foundation Tooltip الآن
@ExperimentalFoundationApi
. (I30b0b) - لم يعُد
TabRow
وScrollableTabRow
متوقفَين نهائيًا. تم تصنيف الصيغتين "الأساسية" و"الثانوية" الجديدتين على أنّهما تجريبيتان. (I0def6) - تستخدم شرائح الفلترة والإدخال الآن
BorderStroke
مباشرةً. (I07a8d) - يستخدم
SegmentedButton
الآنBorderStroke
مباشرةً. (I89b9b) - تمت إعادة تسمية الدالة العامة
AlertDialog
إلىBasicAlertDialog
، وإيقاف الدالة السابقة نهائيًا. (Idbe52) - إعادة تسمية واجهات برمجة التطبيقات
SwipeToDismiss
إلىSwipeDismiss
، وترقية واجهات برمجة التطبيقات الجديدةSwipeDismiss
إلى إصدار ثابت (I14cbe) - إضافة
tonalElevation
وshadowElevation
إلى واجهات برمجة التطبيقات الخاصة بتلميحات الأدوات بالإضافة إلى ذلك، سيتم نقل واجهات برمجة التطبيقاتTooltipBox
وPlainTooltip
وRichTooltip
إلى الحالة التجريبية مجددًا بعد أن تم إصدارها عن طريق الخطأ كإصدارات ثابتة. (If0f66، b/293939035) - ترقية واجهات برمجة التطبيقات التجريبية للشرائح إلى إصدار ثابت (Iea2c3)
- تمت إزالة التعليق التوضيحي
@ExperimentalMaterial3Api
من البطاقات القابلة للنقر في Material3. (I88dbf)
إصلاح الأخطاء
- تم إصلاح مشكلة كانت تؤدي إلى تعطُّل
SwipeToDismiss
في سيناريوهات معيّنة تتضمّن تنسيقات Lookahead وLazy متداخلة. (Ica8d1، b/297226562)
الإصدار 1.2.0-alpha10
18 أكتوبر 2023
تم طرح androidx.compose.material3:material3-*:1.2.0-alpha10
. يحتوي الإصدار 1.2.0-alpha10 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- ترقية
Badge
وBadgedBox
إلى إصدار ثابت (I67f16، b/261565132) - إضافة
securePolicy
كمَعلمة إلىModalBottomSheet
، ليتمكّن المستخدمون من تحديد سلوكWindowManager.LayoutParams.FLAG_SECURE
(Icdac8، b/296250262) - تمت إضافة عمليات تحميل زائدة جديدة للدالتين
LinearProgressIndicator
وCircularProgressIndicator
التي تستخدمprogress
كدالة lambda. ويجب أن تكون هذه الإصدارات أكثر فعالية من الإصدارات السابقة. (I824e6، b/295616656) - تعيد هذه الدالة تسمية
StandardSizeClasses
إلىAllSizeClasses
. (I8cb07) - الجمع بين دوال حساب فئات حجم النافذة (Iad935)
إصلاح الأخطاء
- تم إصلاح عُطل
DatePicker
عند النقر بسرعة على أزرار أسهم التنقّل عندما يكون الشهر المعروض على حافة النطاق المسموح به من السنوات. (I46f36، b/290954897، b/297002119) - [شريط التنقّل/شريط التطبيقات] إتاحة لون شفاف للمؤشر (Ie0a9b، b/267289987)
الإصدار 1.2.0-alpha09
4 أكتوبر 2023
تم طرح androidx.compose.material3:material3-*:1.2.0-alpha09
. يحتوي الإصدار 1.2.0-alpha09 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- تم نقل
ModalNavigationDrawer
وDismissibleNavigationDrawer
لاستخدام واجهات برمجة التطبيقات الجديدةAnchoredDraggable
. تم استبدالanimateTo
فيDrawerState
بطريقتَي الفتح والإغلاق، ويتم الآن عرض الإزاحة كقيمة عددية ذات فاصلة عشرية بدلاً من كائن حالة. يمكنك الوصول إلى الإزاحة مباشرةً من خلالcurrentOffset
. (I0a72c) - تمت إضافة دوال غير قابلة للإنشاء لإنشاء
DatePickerState
وDateRangePickerState
مباشرةً. يمكن استخدام هذه الدوال كبديل للدالتَين ComposablerememberDatePickerState
وrememberDateRangePickerState
عند الحاجة. (I70326، b/291524052) - يتضمّن النوعان "ثابت" و"قابل للتمرير" في
TabRows
الآن صيغًا أساسية وثانوية. يتم ربط هذه القيم بشكل صحيح بسلوك الألوان والمؤشرات على النحو المحدّد في Material3. - تعرض الآن
PrimaryScrollableTabRow
وSecondaryScrollableTabRow
حالة التمرير. (Iec8f5، b/260572337) - إضافة المَعلمة
sheetMaxWidth
الجديدة التي يمكن للمطوّرين ضبطها لتحديد الحدّ الأقصى للعرض الذي ستمتدّ عليه الورقة يمكن تمرير Dp.Unspecified للمعلمة إذا كنت تريد ورقة تمتد على كامل عرض الشاشة. (Ifb7c9، b/266697696) - إعادة إضافة واجهتَي برمجة التطبيقات
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
غير قابلة للتغيير، ما يجعل تعديل الألوان الفردية أقل فعالية، ولكنّه يجعل الاستخدام الأكثر شيوعًا للألوان أكثر فعالية. ويعود سبب هذا التغيير إلى أنّ معظم التطبيقات لن يكون لديها تحديث الألوان الفردية كحالة استخدام رئيسية. لا يزال ذلك ممكنًا، ولكن سيتم إعادة إنشاء المزيد من العناصر مقارنةً بالسابق، ما سيؤدي إلى تقليل عدد عمليات الاشتراك في الحالة بشكل كبير في جميع رموز Material البرمجية، وسيؤثر ذلك في تكلفة عملية التهيئة ووقت التشغيل لحالات الاستخدام الأكثر شيوعًا. (Ic447d، b/297212873) - لم يعُد "الارتفاع اللوني" يتحرّك في حالات التفاعل المختلفة ليتوافق مع المواصفات. (Icdd12)
تغييرات واجهة برمجة التطبيقات
- تمت إضافة
BottomAppBar
جديد يأخذBottomAppBarScrollBehavior
كمَعلمة لإخفائه تلقائيًا عند الانتقال إلى محتوى آخر. تمت أيضًا إضافةFabPosition.EndOverlay
للسماح لزر الإجراء العائم بتراكب شريط التطبيق السفلي في البنية الأساسية بدلاً من تثبيته فوقه. (Iecb47) - تمت إضافة مكوّن Label بسيط يستند إلى
BasicTooltipBox
ولن يتم إغلاقه عند النقر خارج حدود التصنيف. (I821f9)
إصلاح الأخطاء
- تمت إزالة استخدام
rememberSaveable
للتلميحات. (Icc131، b/299500338) - تمت إضافة علامة مؤقتة للتحكّم في ما إذا كان يجب أن تقيس أداة Scaffold عناصرها الثانوية أثناء القياس أو أثناء التنسيق. سيتم قياس هذا المقياس تلقائيًا. إذا كنت تواجه مشاكل في السلوك الجديد، يُرجى إبلاغنا عن المشكلة. (I0b354)
- تم إصلاح مشكلة عدم ظهور الإعلانات الثابتة الأفقية من "الحافة إلى الحافة" في
BottomSheet
من خلال استخدام القياس الصحيح لعرض شاشة الجهاز. (I1df0c، b/299058752) - تم إصلاح الخطأ الذي لم يتم فيه استدعاء
ModalBottomSheet
إلىonDismissedRequest
عند إغلاقه من خلال التمرير سريعًا للأسفل على الورقة. (Idfdd8)
الإصدار 1.2.0-alpha07
6 سبتمبر 2023
تم طرح androidx.compose.material3:material3-*:1.2.0-alpha07
. يحتوي الإصدار 1.2.0-alpha07 على عمليات الإيداع هذه.
الميزات الجديدة
- تمت إضافة ميزة "انعكاس الرموز تلقائيًا" في الإصدار
compose material 1.6.0-alpha05
. يُرجى الاطّلاع على ملاحظات الإصدار لمعرفة تفاصيل حول هذه الميزة.
تغييرات واجهة برمجة التطبيقات
-
SliderState
تنفّذDraggableState
(I9b116) - تغيير الشكل ليكون مَعلمة مطلوبة أعِد تسمية
position
إلىindex
في دالة مساعِدة للأشكال. (I34941) - تعدِّل
DatePicker
formatWithSkeleton
لتضمين خريطة تُستخدَم كذاكرة تخزين مؤقت لتحسين الأداء. (I3195f) - تمت إضافة
BasicTooltipBox
إلىcompose.foundation
وتعديلPlainTooltipBox
وRichTooltipBox
لاستخدامTooltipBox
مع عناصرPlainTooltip
وRichTooltip
الجديدة القابلة للإنشاء. (I79e1d)
إصلاح الأخطاء
- تعرض الدالتان
dynamicLightColorScheme
وdynamicDarkColorScheme
الآن ألوانًا ذات تشبّع أعلى لأدوار الخلفية وsurfaceContainer
. (I5e901) - تم إصلاح المشكلة التي كانت تتسبب في محاولة بعض المكوّنات التي تستخدم Subcomposition (مثل
BottomSheetScaffold
) داخل Scaffold داخلLookaheadScope
قراءة حجمها في وقت مبكر جدًا. (I297b4، I871f1، b/295536718)
الإصدار 1.2.0-alpha06
23 أغسطس 2023
تم طرح androidx.compose.material3:material3-*:1.2.0-alpha06
. يحتوي الإصدار 1.2.0-alpha06 على عمليات الإيداع هذه.
إصلاح الأخطاء
- تم إصلاح عملية احتساب
DropdownMenu
فيoffset
، وبالتالي تعتمد إزاحات x فقط على اتجاه التنسيق المحلي، ولن يتم عكس إزاحات y عندما تكون القائمة بالقرب من أسفل الشاشة. (Iccc74، b/294103942) - تم إصلاح عملية احتساب
DropdownMenu
فيoffset
، وبالتالي تعتمد إزاحات x فقط على اتجاه التنسيق المحلي، ولن يتم عكس إزاحات y عندما تكون القائمة بالقرب من أسفل الشاشة. (Ib87a2، b/294103942)
الإصدار 1.2.0-alpha05
9 أغسطس 2023
تم طرح androidx.compose.material3:material3-*:1.2.0-alpha05
. يحتوي الإصدار 1.2.0-alpha05 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- تعديلات على مربّع الاختيار وألوان
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 على عمليات الإيداع هذه.
الميزات الجديدة
- واجهة برمجة التطبيقات التجريبية لأزرار التقسيم (Ifc8fb)
- تتضمّن الفواصل الآن مَعلمة للتحكّم في الاتجاه من أجل توفير فواصل عمودية. (I4c899، b/288438593)
تغييرات واجهة برمجة التطبيقات
- سننقل الاعتماد على الكثافة إلى مستوى المكوّن. ينطبق ذلك على المكوّنات التالية:
SwipeToDismiss
والمكوّنات المستندة إلى جداول البيانات. يُرجى استخدام التحميل الزائد الجديد الذي يتم فيه توفير الكثافة كمَعلمة. (I1846e) - تعليقات توضيحية إضافية لتحديد الإدخالات المسموح بها للعناصر القابلة للإنشاء (Ief234)
- أضِف مَعلمة رمز إلى الزرّ المقسَّم، وقسِّم الدلالات بحيث يمكن تحديد الأزرار المقسَّمة لتنفيذ خيار تحديد واحد، ويمكن تبديلها لتنفيذ خيار تحديد عدّة خيارات، باستخدام
SelectableSegmentedButtonRow
وToggelableSegmentedButtonRow
على التوالي. (I38740) - تمت إعادة تسمية الفاصل إلى
HorizontalDivider
. تمت إضافة وظيفةVerticalDivider
. (I5975c) - تغيير استخدام
ClosedFloatingPointRange
إلىFloatRange
الأخف وزنًا في واجهات برمجة تطبيقات Material3 التجريبية لتقليل التحويل التلقائي بين أنواع البيانات الأساسية وأنواع الأغلفة (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
الآنfalse
تلقائيًا في تصميم Material 3. تم أيضًا تغيير نمط ارتفاع السطر التلقائي إلىTrim.None
وAlignment.Center
، وتمت إضافةlineHeight
(بالوحدات المستقلة عن الكثافة) الصريحة إلىTextStyle
فيTypography
. راجِع مستندات واجهة برمجة التطبيقات إذا أردت تخصيص هذه القيم، واطّلِع على مشاركة المدونة للحصول على شرح مفصّل لهذه التغييرات. (I6266f وIcabc3)
الميزات الجديدة
- تمت إضافة تحميل زائد للدالة
RangeSlider
وهو إصدار ذو حالة من المكوّن. تم إنشاءRangeSliderState
يحتوي على جميع المعلومات الخاصة بالمسار النشط الحالي، وقياسات مكوّناتRangeSlider
، ومنطق السحب والإيماءات. (I8c270) - يتيح شريط البحث الآن استخدام الظلال من خلال المَعلمة
shadowElevation
التي تمت إضافتها حديثًا. (Ia5369، b/271040353) - يتيح
ColorScheme
الآن أدوارًا جديدة فيSurfaceContainer
. - يمكن الآن إيقاف تراكب الارتفاع النغمي للسطح باستخدام
LocalTonalElevationEnabled
composition local. (Ic203c، b/277774590)
تغييرات واجهة برمجة التطبيقات
- افتح أدوات إنشاء ألوان المكوّنات. (I8c4a6)
- إضافة مَعلمة قابلة للتركيز إلى كلتا واجهتَي برمجة التطبيقات الخاصةَين بتلميحات الأدوات، حتى يتمكّن المطوّرون من السماح لتلميح الأداة باستهلاك أحداث اللمس أو عدم السماح بذلك. يُرجى توخّي الحذر لأنّ ذلك قد يؤدي إلى إيقاف التنقّل التلقائي في التركيز على عناصر تسهيل الاستخدام. (Ie32d8)
- تم تحسين إمكانية الوصول لتعزيز الأداء وعمليات تخصيص الذاكرة. (Iede48)
- عرض
DefaultSizeClasses
وإنشاءStandardSizeClasses
لـWindowSizeClasses
(I91838) - تغيير
WindowWidth/HeightSizeClass
إلى فئات القيم العائمة (Ie686e)
إصلاح الأخطاء
- تراعي المَعلمة
contentWindowInsets
في Scaffold الآن هوامش النافذة المستخدَمة. يُرجى العِلم أنّ سلوك مساحة العرض المتروكة حول المحتوى استنادًا إلىtopBar
وbottomBar
يظلّ بدون تغيير عند توفير هاتين المَعلمتَين. (I08b73، b/264601542) - أصلِح محاذاة شريط التطبيق العلوي في المنتصف للتأكّد من أنّ العنوان الطويل لا يظهر فوق رموز الإجراءات أو رمز التنقّل. (I4369f، b/236994621)
- تفرض مواضع علامات التبويب الآن حدًا أدنى لعرض المحتوى يبلغ 24 وحدة بكسل مستقلة عن الكثافة. يوفر ذلك هدفًا قابلاً للمس يسهل الوصول إليه لمؤشرات علامات التبويب. (Id8861)
- تتوافق لوحات الألوان الديناميكية من
dynamicLightColorScheme
وdynamicDarkColorScheme
الآن مع أدوار مساحة العرض الجديدة. (I1252e) - تعديل محاذاة إشعار الشارة لكي لا يتم اقتطاعه عند التعارض مع الجد الأكبر (Idf75a)
الإصدار 1.2.0-alpha02
24 مايو 2023
تم طرح androidx.compose.material3:material3-*:1.2.0-alpha02
. يحتوي الإصدار 1.2.0-alpha02 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- إضافة مَعلمة هوامش النافذة إلى
ModalBottomSheet
- يمكن الآن رسم طبقة تعتيم
ModalBottomSheet
خلف شريط الحالة مع ضبطwindowInsets
على صفر - تم تعديل وظيفة
ModalBottomSheet
التلقائية للبقاء خارج أشرطة النظام، بما في ذلك شريط التنقّل - يتم توفير معالجة مساحة العرض الداخلية لشريط الحالة من خلال مقبض السحب في وضع "من الحافة إلى الحافة".
- تتضمّن
BottomSheetDefaults
حواف النوافذ لـBottomSheetWindow
. (I31200، b/274872542، b/272973615، b/272334475، b/268432129، b/275849044، b/275486106، b/268433162)
- يمكن الآن رسم طبقة تعتيم
- إيقاف
Indicator
نهائيًا وإضافةPrimary
/SecondaryIndicator
لتتوافق مع مواصفات M3 يتطابقPrimaryIndicator
مع عرض محتوى علامة التبويب، بينما يمتدSecondaryIndicator
على كامل العرض المتاح.SecondaryIndicator
هي نفسهاIndicator
التي تم إيقافها نهائيًا، ويمكن استخدامها كبديل مباشر لها. (I27604) - تمت إضافة خيار لتمرير
ScrollState
عند إنشاءDropdownMenu
أوExposedDropdownMenu
للتحكّم في حالة التمرير العمودي لعناصر القائمة المعروضة. (Ia0734، b/185304441) - تمت إضافة تحميل زائد للدالة
Slider
وهو إصدار ذو حالة من المكوّن. تم إنشاءSliderState
يحتوي على جميع المعلومات الخاصة بالمسار النشط الحالي، وقياسات مكوّناتSlider
، ومنطق السحب والإيماءات. (I124a5) - إعادة تسمية السمة "الدلالات"
isContainer
إلىisTraversalGroup
(I121f6) - تمّت إضافة
TextStyle.merge(...)
محسَّن مع قائمة المَعلمات الكاملة. (Iad234، b/246961787) - تم إنشاء واجهات عامة لـ
TooltipState
وRichTooltipState
وPlainTooltipState
. تمت إضافةRichTooltipStateImpl
وPlainTooltipStateImpl
للحالات التلقائية. تمت إضافة وظائفremember*State
للحصول على هذه الحالات التي تم تنفيذها. تمت إزالةTooltipSync
واستخدامTooltipDefault.GlobalMutatorMutex
بدلاً منها. (I7813d) - تم تعديل
DatePickerColors
لتضمين خيارات تخصيص إضافية لألوان فاصل أداة اختيار التاريخ وعناصر التنقّل وحقول إدخال النص. (I1a685، b/274626815) DatePickerState
وDateRangePickerState
هما الآن واجهتان عامّتان تتضمّنان عمليات تنفيذ تلقائية يمكن استرجاعها من خلالrememberDatePickerState
وrememberDateRangePickerState
. (I71c52)- تمت إزالة
dateValidator
منDatePicker
وDateRangePicker
وتم تقديم واجهةSelectableDates
يمكن ضبطها على الحالة للتحكّم في التواريخ أو السنوات التي يمكن تحديدها في واجهة المستخدم. (Ic2fc6) - تمت إزالة
TimePicker
من واجهة برمجة التطبيقات الثابتة، ومن المتوقّع إجراء المزيد من التغييرات في واجهة برمجة التطبيقات الخاصة بالحالة (I3f39a) - تم نقل
ModalBottomSheet
إلى Android فقط. لا ننصح باستخدامModalBottomSheet
على أجهزة الكمبيوتر، ولن تتم صيانة هذه الوظيفة بشكل نشط. (Ib3778)
إصلاح الأخطاء
- تم إصلاح مشكلة عدم ظهور إجراء الإغلاق
AlertDialog
أسفل إجراء التأكيد عندما يتم ترتيب الإجراءات فوق بعضها البعض لتناسب عرض مربّع الحوار. يعمل هذا الإصلاح على مواءمة التنفيذ مع مواصفات Material Design. (I029de، b/235454277) - تم إصلاح الخطأ في
ListItem
الذي كان يستخدم مساحة متروكة غير صحيحة للعناصر المكوّنة من ثلاثة أسطر. (I6e235) - يمكن الآن عرض لوحة مفاتيح IME في
ModalBottomSheet
(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 مساءً. (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
لتحقيق التوافق الثنائي. (Ib7959) - إضافة مَعلمة هوامش النافذة إلى
ModalBottomSheet
- يمكن الآن رسم طبقة تعتيم
ModalBottomSheet
خلف شريط الحالة مع ضبطwindowInsets
على صفر - تم تعديل وظيفة
ModalBottomSheet
التلقائية للبقاء خارج أشرطة النظام، بما في ذلك شريط التنقّل - يتم توفير معالجة مساحة العرض الداخلية لشريط الحالة من خلال مقبض السحب في وضع "من الحافة إلى الحافة".
- تتضمّن
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
مكوّنات جديدة في Material Design 3
تحسينات على مكوّنات Material Design 3 الحالية
تمت ترقية واجهات برمجة التطبيقات التجريبية إلى إصدار ثابت
يُرجى الاطّلاع على منشور المدوّنة هذا لمزيد من التفاصيل.
الإصدار 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 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- تمت إزالة
TimePicker
من واجهة برمجة التطبيقات الثابتة، ومن المتوقّع إجراء المزيد من التغييرات في واجهة برمجة التطبيقات الخاصة بالحالة (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 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- تتضمّن
SheetState
الآن المَعلمة الاختياريةskipHiddenState
- تتضمّن
rememberStandardBottomSheetState
الآن المَعلمة الاختياريةskipHiddenState
- يتضمّن
BottomSheetScaffold
الآن رابطًا مخفيًا محدّدًا، على الرغم من أنّه غير مفعّل تلقائيًا. - تم تعديل مستند
SheetState.requireOffset
- تمت إعادة تسمية
BottomSheetDefaults.MinimizedShape
إلىBottomSheetDefaults.HiddenShape
(I839f4، b/273870234)
إصلاح الأخطاء
- لا تبدّل وجه الساعة من الساعة إلى الدقيقة عندما تكون ميزة "استكشاف باللمس" مفعَّلة. (I717d0)
- تم الآن دمج دلالات مقبض السحب
ModalBottomSheet
وBottomSheetScaffold
. (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 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- أضِف مَعلمة نوع التنسيق إلى العنصر القابل للإنشاء
TimePicker
. يسمح هذا الإعداد باستخدام تنسيقات مختلفة، استنادًا إلى إعدادات الشاشة (Ia0e16). - تم وضع علامة "تجريبي" على
SearchBarDefaults
. (I65561) - تمت إضافة ارتفاع الظل إلى
BottomSheetScaffold
(I94e0f) - تمت إضافة إمكانية عرض أدوات اختيار التاريخ بدون جزء العنوان. تغييرات في واجهة برمجة التطبيقات للسماح بتمرير عنوان فارغ عند إنشاء أداة اختيار التاريخ يمكنك الآن تمرير عنوان فارغ وعنوان و
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)
تغييرات واجهة برمجة التطبيقات
- تمت إضافة وظيفة إلى
DatePickerState
وDateRangePickerState
للسماح بتحديد التواريخ بعد الإنشاء الأولي للحالة، بالإضافة إلى إعادة ضبط الاختيارات من خلال ضبط الطوابع الزمنية على قيمة فارغة. يجب توخّي الحذر عند ضبط التواريخ يدويًا، وستعرض الدالةsetSelection
الجديدة استثناءً في حال عدم استيفاء تاريخ مقدَّم لشرط مسبق (راجِع المستندات). (Ifa645 وb/268609314 وb/270427389) - أعِد تسمية Collapsed
SheetValue
إلىPartiallyExpanded
لعرض السلوك في هذه الحالة بشكل أكثر دقة ومرونة. (Ia1491) - تم تعديل أسماء المَعلمات
ListItem
إلى _content بدلاً من _text. أصبحت دوال الحصول على القيم التلقائيةReadOnlyComposables
حيثما كان ذلك منطبقًا. (I69a25) - إيقاف ميزة "واجهات برمجة تطبيقات Surface التفاعلية" التجريبية (I90d59، b/261561812)
إصلاح الأخطاء
- تم إصلاح المشكلة المتمثّلة في احتساب حالة
ModalBottomSheet
بشكل غير صحيح وظهور الورقة على أنّها عائمة.HalfExpanded
(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 على عمليات الإيداع هذه.
الميزات الجديدة
- أضِف عنصر Time Input قابل للإنشاء يعمل مع
rememberTimePickerState()
، ويتّبع مواصفات M3 لإدخال الوقت (Ia4fab) - تمت إضافة واجهة برمجة تطبيقات
DateRangePicker
Material 3 لاختيار نطاق من التواريخ. (I7a6c3، b/267194809) - تمت إضافة إمكانية استخدام وضع الإدخال Material 3 لاختيار النطاقات الزمنية من خلال واجهة برمجة التطبيقات
DateRangePicker
. (Ifdbc4) - تتيح ألوان حقول النص الآن تخصيص ما يلي:
- ألوان حقل الإدخال ونص العنصر النائب استنادًا إلى حالة التركيز وحالة الخطأ تمت إعادة تسمية المَعلمة
textColor
إلىunfocusedTextColor
، كما تمت إعادة تسميةplaceholderColor
إلىunfocusedPlaceholderColor
. - لون الحاوية لحقول النص المملوءة استنادًا إلى حالة الخطأ باستخدام المَعلمة
errorContainerColor
الجديدة
- ألوان حقل الإدخال ونص العنصر النائب استنادًا إلى حالة التركيز وحالة الخطأ تمت إعادة تسمية المَعلمة
- تم تعديل ألوان حقل النص في القائمة المنسدلة المكشوفة باستخدام مَعلمات لتتوافق مع واجهة برمجة التطبيقات الجديدة الخاصة بالبادئة واللاحقة. (I9c8b4، b/254284181، b/264766350)
تغييرات واجهة برمجة التطبيقات
- التراجع عن بعض إصدارات Slider API وإزالة عمليات التحميل الزائد المتكرّرة في Slider التي يغطيها Slider التجريبي الجديد مع شريط تمرير وإبهام مخصّصَين الترويج لـ
RangeSlider
ليكون مستقرًا (Ie8fbd) - تمت إعادة تسمية
defaultElevation
إلىelevation
في دوال مستوى ارتفاع الشريحة. (I0f872) - لم تعُد واجهات برمجة التطبيقات التالية لحقول النص في Material 3 تجريبية:
TextField
وOutlinedTextField
وtextFieldWithLabelPadding
وtextFieldWithoutLabelPadding
وoutlinedTextFieldPadding
. (Ieb5c0، b/261561819) TimePickers
is24Hour
تستخدم إعدادات النظام (I18856)- تمت إزالة التعليق التوضيحي التجريبي من واجهات برمجة التطبيقات الخاصة بإنشاء الرموز. (Ibb51e وb/261565765 وb/261436953)
إصلاح الأخطاء
- أصبح الشكل التلقائي
ModalBottomSheet
هوSheetDefaults.ExpandedShape
دائمًا. (I0dfca) - تحسينات على تسهيل الاستخدام في Material 3
DatePicker
وDateRangePicker
(I5087e) - تم إصلاح الخطأ الذي يتم فيه نشر قيد الحد الأقصى للارتفاع وقد يؤدي إلى تعطُّل التطبيق. (I30d8c)
- إزالة الأدوار الدلالية من المساحات القابلة للنقر والتحديد، وتعديل المكوّنات التي كانت تستخدمها لضبط الأدوار باستخدام modifier.semantics (I793d9)
الإصدار 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
لعرض أداة اختيار الوقت وفقًا لمواصفات Material 3، ويتم استخدامها معTimePickerState
وطريقة الاستخدام السهلrememberTimePickerState
(I71910) - أصبح إدخال التاريخ الآن وضع عرض في
DatePicker
. تمت إضافة إمكانية التبديل بين وضعَي "أداة اختيار التاريخ" و"إدخال التاريخ". (Ieeff7) - تمت إضافة واجهة برمجة التطبيقات لـ
RichTextTooltips
. (I58ef3) - تنفيذ البطاقة السفلية المقيِّدة في Material 3، بما في ذلك
ModalBottomSheet
وModalBottomSheetDefaults
يقدّم هذا الإصدار أيضًاSheetState
وrememberSheetState
اللذين يمكن استخدامهما لمكوّنات ورقة الملصقات المستقبلية. (I0853a، b/244189383)
تغييرات واجهة برمجة التطبيقات
- تثبيت واجهة برمجة التطبيقات
showSnackbar
(I195c2، b/261424370) - تثبيت واجهات برمجة التطبيقات لشريحة المساعدة وشريحة الاقتراحات (Ibb67b وb/261424370)
- ترقية واجهات برمجة التطبيقات
ListItem
وListItemDefaults
وListItemColors
إلى إصدار غير تجريبي (I7e7fa وb/261438882) - ترقية الإصدارات
SliderPositions
وSliderDefaults.Thumb
وSliderDefaults.Track
إلى إصدارات ثابتة وإضافة واجهتَي برمجة التطبيقاتSlider
وRangeSlider
غير التجريبيتين اللتين تتضمّنان صورًا مصغّرة ومسارات مخصّصة سيتم أيضًا إيقاف واجهتَي برمجة التطبيقات السابقتَينSlider
وRangeSlider
نهائيًا. (Ie5ea6، b/261566890) - تمت إتاحة
Modifier.tooltipAnchor()
للجميع، ما يتيح للمطوّرين تمريرها إلى العنصر الأساسي للإشارة إلى أنّه يجب عرض تلميح عند الضغط مع الاستمرار. تم تعديل واجهة برمجة التطبيقاتPlainTooltipBox
لكي لا تكونTooltipState
قابلة للقيم الخالية، وأصبحت تتضمّن قيمة تلقائية. (Ie2fb7) - تم وضع علامة
@Composable
علىProgressIndicatorDefaults.circularTrackColor
لضمان الاتساق. (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
.
تحديثات التبعيات
- يعتمد كل من
Compose UI
وCompose Material
الآن على Lifecycle 2.6.0.
الإصدار 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 على عمليات الإيداع هذه.
الميزات الجديدة
DatePicker
API الأوّلي لاختيار تاريخ واحد من خلال واجهة مستخدم التقويم لا تزال هذه الواجهة تخضع لتغييرات. (I722b9)- تمت إضافة إمكانية استخدام تلميحات الأدوات العادية من خلال
PlainTooltipBox
. (I0cdfb) - شريط البحث (Iad128)
SwipeToDismiss
(I458a8، b/242889540)
تغييرات واجهة برمجة التطبيقات
- تمت إضافة السمة الدلالية
IsContainer
على "المنصات". سيتم استخدام هذه السمة في تغيير لاحق يحدّد ترتيب الانتقال استنادًا إلى المعنى الدلالي للعناصر، مثل المساحات. (I63379) - وضع علامة "ثابتة" على واجهات برمجة التطبيقات ذات الصلة بلوحة التنقّل (Iab01e، b/261439597)
- تمت إضافة مَعلمة لون المسار لمؤشرات التقدم الدائرية، ومَعلمة غطاء نهاية الخط لكلّ من مؤشرات التقدم الدائرية والخطية. (Ie668c، b/216325962، b/222964817)
- المزيد من إمكانية قبول القيمة الخالية لأنواع الإرجاع للدوال المتوقفة نهائيًا والمخفية (Ibf7b0)
- أضِف
Modifier.minimumInteractiveComponentSize
. يمكن استخدامها لحجز مساحة لا تقلّ عن 48 بكسل مستقل الكثافة (dp) لتوضيح التفاعلات باللمس إذا كان قياس العنصر أصغر. (I33f58، b/258495559) - تمت إضافة واجهة برمجة تطبيقات تجريبية للعنصر القابل للإنشاء
AlertDialog
الذي يتضمّن مساحة عرض للمحتوى. (Iec4a2)
إصلاح الأخطاء
- تم الآن ربط مستوى التقدّم في مؤشرات التقدّم بالنطاق المتوقّع بشكل صحيح. (I8a7eb، b/262262727)
مشكلة معروفة
- عند التحديث من
androidx.compose.foundation:1.4.0-alpha03
إلىandroidx.compose.foundation:1.4.0-alpha04
، قد يظهر لك الخطأjava.lang.NoSuchFieldError
. هنا تم الإبلاغ عن المشكلة في الأصل. تم إرسال إصلاح، وسيتوفّر في تحديث Compose التالي. كحلّ بديل، يمكنك تحديث مكتبتَيandroidx.compose.material
وandroidx.compose.material3
إلى أحدث إصدار(1.1.0-alpha04) أو الرجوع إلى الإصدار 1.4.0-alpha03 منandroidx.compose.foundation
.
الإصدار 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 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- تمت إعادة تسمية
consumedWindowInsets()
إلىconsumeWindowInsets()
وwithConsumedWindowInsets()
إلىonConsumedWindowInsetsChanged()
، وأصبحت "المعدّلات" متاحة للجميع. (Ie44e1) - إضافة مساحة جديدة تلقائية لترك مسافة بين المحتوى وزر النص مع الرمز المراد استخدامه (I8f662)
- تمت إضافة ألوان غير متاحة لشريط التنقّل وشريط التطبيقات. (Ia7892، b/258867034)
- تمت إضافة Modifier API للاستعلام عن معلومات التمرير الخاصة بالعناصر الرئيسية. (I2ba9d، b/203141462)
- يُستخدَم في
Clickable
لتأخير تفاعلات الضغط بشكل صحيح، عندما يمكن أن تصبح الإيماءات أحداث تمرير. - تم إصلاح المشكلة المتمثلة في عدم تأخير
Clickables
التموجات بشكلٍ صحيح عند استخدامها داخلScrollable ViewGroup
. - تم تعديل الأدراج وأوراق البيانات لتأخير الضغطات بشكل صحيح في حال إمكانية تحوّل الإيماءات إلى أحداث تمرير.
تحديثات التبعيات
- يعتمد كل من
Compose UI
وCompose Material
الآن على الإصدار 2.5.1 من Lifecycle. (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 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- يقبل الآن كل من
awaitFirstDown
وwaitForUpOrCancellation
PointerEventPass
لتوفير مرونة أكبر (ويحلّ أيضًا مشكلة عرضExposedDropdownMenuBox
لقائمة أثناء التمرير).(I7579a، b/212091796) - تمت إضافة المَعلمة
minLines
إلى النص في Material وMaterial3، وTextField
وOutlinedTextField
، ما يتيح ضبط الحد الأدنى لارتفاع المكوّن من حيث عدد الأسطر (I4af1d) - إيقاف الدالة
TopAppBarDefaults smallTopAppBarColors
نهائيًا واستخدام الدالة الجديدةtopAppBarColors
بدلاً منها عند إنشاءTopAppBar
(Ie6cb9) - تمت إضافة المَعلمة
minLines
إلىBasicText
وBasicTextField
. تتيح هذه السمة ضبط الحد الأدنى لارتفاع العناصر القابلة للإنشاء هذه من حيث عدد الأسطر (I24294، b/122476634).
إصلاح الأخطاء
- يمكنك قص محتوى
IconButton
وIconToggleBotton
في Material3 ليناسب شكل طبقة الحالة للعنصر (مثل الشكل الدائري). (I9da8f) - تعديل أشرطة التطبيقات العلوية المتوسطة والكبيرة في Material3 لتطبيق لون الخلفية نفسه على كامل مساحتها، والسماح بتجاوز الألوان التلقائية باستخدام قيم ألوان شفافة (I67659، b/249688556، b/250838918)
الإصدار 1.1.0-alpha01
24 أكتوبر 2022
تم طرح androidx.compose.material3:material3:1.1.0-alpha01
وandroidx.compose.material3:material3-window-size-class:1.1.0-alpha01
. يحتوي الإصدار 1.1.0-alpha01 على عمليات الإيداع هذه.
إصلاح الأخطاء
- إصلاحات لشريط التطبيق العلوي عند تطبيق العنوان باستخدام TextStyle وBrush (If667e)
الإصدار 1.0
الإصدار 1.0.1
9 نوفمبر 2022
تم طرح androidx.compose.material3:material3:1.0.1
وandroidx.compose.material3:material3-window-size-class:1.0.1
. يحتوي الإصدار 1.0.1 على عمليات الإيداع هذه.
إصلاح الأخطاء
- تعديل أشرطة التطبيقات العلوية المتوسطة والكبيرة في Material3 لتطبيق لون الخلفية نفسه على كامل مساحتها، والسماح بتجاوز الألوان التلقائية باستخدام قيم ألوان شفافة (I67659، b/249688556، b/250838918)
الإصدار 1.0.0
24 أكتوبر 2022
تم طرح androidx.compose.material3:material3:1.0.0
وandroidx.compose.material3:material3-window-size-class:1.0.0
. يتضمّن الإصدار 1.0.0 عمليات الدمج هذه.
الميزات الرئيسية في الإصدار 1.0.0
هذا هو الإصدار الثابت الأول من Compose Material 3.
تحديد نسق Material Design 3 والألوان الديناميكية في Material You
مكوّنات Material Design 3
- الشارة
- شريط التطبيق السفلي
- الأزرار
- زر الإجراء الرئيسي وزر الإجراء الرئيسي الموسّع
- البطاقات
- مربّع الاختيار
- الرقائق
- مربّعات الحوار
- الفاصل
- القائمة المنسدلة
- القائمة
- شريط التنقّل
- لائحة التنقّل
- شريط التنقّل
- مؤشر مستوى التقدّم
- زر الاختيار
- شريط التمرير
- مفتاح التبديل
- علامات التبويب
- حقول النص
- شريط التطبيق العلوي
- الرمز
- نص
- Surface
- التصميم
- لون المحتوى
فئة حجم النافذة
material3-window-size-class
هي مكتبة جديدة توفّر الدعم لفئات أحجام النوافذ، وهي مجموعة من نقاط توقّف إطار العرض المحدّدة مسبقًا لتصميم وتطوير واختبار تخطيطات التطبيقات القابلة لتغيير الحجم. يمكنك استخدامcalculateWindowSizeClass
لاسترداد مثيل لفئة حجم النافذة، ويمكنك استخدام هذا المثيل لتحديد طريقة ظهور واجهة المستخدم، مثل عرض شريط تنقّل جانبي بدلاً من شريط تنقّل سفلي لأحجام النوافذ الأكبر. لمزيد من المعلومات وأمثلة الاستخدام، يُرجى الاطّلاع على مستندات مرجع واجهة برمجة التطبيقات الخاصة بـWindowSizeClass
.يُرجى الاطّلاع على منشور المدوّنة هذا لمزيد من التفاصيل.
الإصدار 1.0.0-rc01
5 أكتوبر 2022
تم طرح androidx.compose.material3:material3:1.0.0-rc01
وandroidx.compose.material3:material3-window-size-class:1.0.0-rc01
. يحتوي الإصدار 1.0.0-rc01 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة مَعلمة للخانة من أجل إتاحة واجهة برمجة التطبيقات الخاصة بحقل النص إلى النص (Iaac0d، b/227146125)
الإصدار 1.0.0-beta03
21 سبتمبر 2022
تم طرح androidx.compose.material3:material3:1.0.0-beta03
وandroidx.compose.material3:material3-window-size-class:1.0.0-beta03
. يحتوي الإصدار 1.0.0-beta03 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- تعرض السمة
ExposedDropdownMenuDefaults
الآن قيمة مساحة متروكة لعناصر القائمة. (I34ee1) - يتضمّن
ExposedDropdownMenuBoxScope
الآن المعدِّلModifier.menuAnchor()
الذي يجب تمريره إلى حقل النص لضمان سلوك تسهيل الاستخدام السليم. (I27fa3) - إضافة طريقتَين محمّلتَين بشكل زائد إلى واجهة برمجة التطبيقات الحالية الخاصة بشريط التمرير للسماح للمستخدمين بتمرير صورة مصغّرة أو مسار لتعبئة شريط التمرير (I21c00)
إصلاح الأخطاء
- تم تعديل عملية ربط ألوان المظهر الداكن لعنصر On Error Container إلى درجة اللون 90 (Ic5612)
- تم إصلاح مشكلة عدم إمكانية ضبط خلفية شفافة لأشرطة التطبيقات العلوية الصغيرة في Material 3. (I645e2، b/245575782)
الإصدار 1.0.0-beta02
7 أيلول (سبتمبر) 2022
تم طرح androidx.compose.material3:material3:1.0.0-beta02
وandroidx.compose.material3:material3-window-size-class:1.0.0-beta02
. يحتوي الإصدار 1.0.0-beta02 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- لم تعُد عمليات إدراج المكوّنات التلقائية في مكوّنات m3 في الإصدار beta01 تراعي عمليات إدراج IME.
- يحتوي مكوّن Material3 Scaffold الآن على المَعلمة
contentWindowInsets
، ما يتيح تحديد مقدار الهوامش الداخلية التي يجب التعامل معها في موضع المحتوى. (Icf11a، b/243713323) - إيقاف الدالة التجريبية
SmallTopAppBar
في Material 3 وإتاحة الدالة المكافئةTopAppBar
يُرجى نقل استخدامك إلى الإصدار الجديد. (I74404، b/226918634) - تضيف هذه السمة إمكانية التحكّم في سلوكَي "التحريك السريع" و"المحاذاة" لشريط التطبيق العلوي. (I15c81)
- تزيل هذه السمة startIndent من Divider، وتنقل اللون إلى المَعلمة الأخيرة. (If7be2)
إصلاح الأخطاء
- يجب أن تعرّف مربّعات الحوار عن نفسها لمستخدمي TalkBack من خلال الإعلان عن كلمة "مربّع حوار" عند عرضها. (I857ef)
الإصدار 1.0.0-beta01
24 أغسطس 2022
تم طرح androidx.compose.material3:material3:1.0.0-beta01
وandroidx.compose.material3:material3-window-size-class:1.0.0-beta01
. يحتوي الإصدار 1.0.0-beta01 على عمليات الإيداع هذه.
مرجع واجهة برمجة التطبيقات
للاطّلاع على أحدث ميزات تغيير المظهر والمكوّنات وغيرها من العناصر القابلة للإنشاء المتوفّرة، يمكنك الاطّلاع على نظرة عامة على مرجع واجهة برمجة التطبيقات Compose Material 3.
تغييرات واجهة برمجة التطبيقات
- تم تعديل شريط التطبيق العلوي في Material 3 ليتم تثبيته في حالة مصغّرة بالكامل أو موسّعة بالكامل. تم أيضًا تعديل دالة السلوك
TopAppBarDefaults
لتصبح عناصر قابلة للإنشاء وتوفير قيم تلقائية لحالة شريط التطبيق العلوي ومواصفات الحركة. (I642b3) - تم تعديل تواقيع مكوّن زر الإجراء العائم لتتطابق مع واجهة برمجة التطبيقات الخاصة بالسطح (I3afaa)
- تمت إضافة إمكانية استخدام الحواف الداخلية المضمّنة في "شريط التطبيق العلوي" و"الأدراج" و"شريط التنقّل" و"الشريط الجانبي". عند استخدام هذه المكوّنات بشكل منفصل أو مع Scaffold، ستتعامل تلقائيًا مع الحواف الداخلية للمطوّرين. ملاحظة: لا يضيف هذا التغيير معالجة تلقائية لرموز شريط الحالة وشفافية شريطَي الحالة والتنقّل. يُرجى مواصلة إجراء ذلك يدويًا لضمان الحصول على أفضل تجربة من الحافة إلى الحافة. (I7e4e6، b/183161866)
- تم تعديل الإعدادات التلقائية للمكوّنات لتقليل مساحة واجهة برمجة التطبيقات من أجل توفير مرونة وتحسينات في الأداء في المستقبل. (I31820)
- إعادة ترتيب مَعلمات شريحة الفلتر وورقة لوحة التنقّل للحفاظ على الاتساق داخل واجهة برمجة التطبيقات (I45d0b)
- تمت إزالة
startIndent
من "الفاصل" ونقل اللون ليكون المَعلمة الأخيرة.(If7be2)
الإصدار 1.0.0-alpha16
10 أغسطس 2022
تم طرح androidx.compose.material3:material3:1.0.0-alpha16
وandroidx.compose.material3:material3-window-size-class:1.0.0-alpha16
. يحتوي الإصدار 1.0.0-alpha16 على عمليات الإيداع هذه.
الميزات الجديدة
- إتاحة تحديد عرض مخصّص للوحة التنقّل (Ia7f10)
تغييرات واجهة برمجة التطبيقات
- إعادة ترتيب مَعلمات علامة التبويب وعلامة التبويب الرئيسية للحفاظ على التناسق داخل واجهة برمجة التطبيقات (Ie2637)
- تم وضع علامة
BadgeDefaults
على أنّه تجريبي. (I98ef3) - إزالة وظيفة درج التنقّل التي تم إيقافها نهائيًا (I4f2db)
- إعادة ترتيب مَعلمات شريط التمرير في Material 3 للحفاظ على الاتساق داخل واجهة برمجة التطبيقات (I0aee7)
- إعادة ترتيب المَعلمتَين
NavigationBar
وNavigationRail
للحفاظ على الاتّساق داخل واجهة برمجة التطبيقات (I51cda) - إعادة ترتيب المَعلمات في Material 3 للحفاظ على الاتساق في جميع أنحاء واجهة برمجة التطبيقات (If4ae1)
- إعادة ترتيب مَعلمات شريط التمرير في Material 3 للحفاظ على الاتساق داخل واجهة برمجة التطبيقات (I62673)
- تمت إعادة تسمية مَعلمة الرموز إلى الإجراءات لتكون متوافقة مع شريط التطبيق العلوي (Id75be)
- ضَع العلامة "تجريبي" على
Badge
وBadgedBox
لأنّ محاذاة العنصر الثابت لا تزال قيد التغيير. (I1712e، b/236524516) - تغيير التعليقات التوضيحية
@ExperimentalMaterial3Api
في أشكال زر الرمز إلى@OptIn
(I070b5) - تم فصل محتوى لوحة التنقّل إلى عنصر قابل للإنشاء خاص به لإتاحة تحديد عرض مخصّص له. (Ia7f10)
- إزالة
Divider
منMenuDefaults
وTabDefaults
(I4e33c)
الإصدار 1.0.0-alpha15
27 يوليو 2022
تم طرح androidx.compose.material3:material3:1.0.0-alpha15
وandroidx.compose.material3:material3-window-size-class:1.0.0-alpha15
. يحتوي الإصدار 1.0.0-alpha15 على عمليات الإيداع هذه.
الميزات الجديدة
- السماح بسحب شريط التطبيق العلوي من الشريط نفسه (I65c00، b/205873416)
تغييرات واجهة برمجة التطبيقات
- تعديلات على واجهتَي برمجة التطبيقات
FilterChip
وElevatedFilterChip
لإزالة الخانةselectedIcon
وتشجيع إعادة استخدامleadingIcon
لعرض الحالة المحدّدة (Ie5dc2) - أضِف أدوار ألوان مختلفة للطبقة الشفافة والمخطط التفصيلي. (Id6d54)
- إصلاح اصطلاحات التسمية للإعدادات التلقائية القابلة للإنشاء (I62b27)
- وضع علامة "تجريبي" على
ListItemDefaults
وListItemColors
(I1f3ec) - تغييرات على واجهة برمجة التطبيقات الخاصة بشريط التطبيق العلوي لتعكس بشكل أفضل معنى خصائص الحالة. ضَع أيضًا علامة على واجهة برمجة التطبيقات الخاصة بشريط التطبيقات العلوي للإشارة إلى أنّها تجريبية. (Ic0ad8)
- تمت إضافة ألوان تحديد النص إلى
TextFieldColors
لتسهيل العثور عليها. (Iba1b8) - إضافة
ButtonDefault.ButtonWithIconContentPadding
لاستخدامه مع الأزرار التي تحتوي على رمز (I2bf9c) - تم وضع علامة "تجريبي" على حقول النص للسماح بمزيد من المرونة في التغييرات المستقبلية على واجهة برمجة التطبيقات. (I127b5)
- تمت إزالة التعليق التوضيحي
@ExperimentalMaterial3Api
من الدالةCheckbox
. (I5eefc) - تمت إزالة التعليق التوضيحي
@ExperimentalMaterial3Api
من الدالةRadioButton
. (I17e2a) - تمت إزالة التعليق التوضيحي
@ExperimentalMaterial3Api
من البطاقات غير التفاعلية. (I9bd49) - تعديل مختلف الكائنات التلقائية للمكوّنات لتضمين الألوان والأشكال وما إلى ذلك (I96e11)
إصلاح الأخطاء
- تمت إزالة الرموز اللاحقة غير العاملة من عيّنات شرائح الإدخال لتجنُّب إرباك المستخدم في تطبيق الكتالوج. (I9846a)
الإصدار 1.0.0-alpha14
29 يونيو 2022
تم طرح androidx.compose.material3:material3:1.0.0-alpha14
وandroidx.compose.material3:material3-window-size-class:1.0.0-alpha14
. يحتوي الإصدار 1.0.0-alpha14 على عمليات الإيداع التالية.
الميزات الجديدة
- تمت إضافة تنفيذ قائمة M3، راجِع المستندات لمعرفة كيفية الاستخدام النموذجي (Id7a20)
تغييرات واجهة برمجة التطبيقات
- تغيير اسم المَعلمة من "القيم" إلى "القيمة" في
RangeSlider
(I3b79a) - تغييرات في واجهة برمجة التطبيقات على تنفيذ
InputChip
لتوفير حالة قابلة للتحديد وفقًا لمواصفات Material Design دعم إضافي في ألوانFilterChip
للحالة المحدّدة غير المفعّلة (I55244، b/235792432) - إضافة زر إجراء عائم تلقائي
BottomAppBar
(Ida4c8) - تمت إضافة
ColorScheme.surfaceColorAtElevation
(Id41af) - يتم الآن إنشاء الواجهات في مكتبات Compose باستخدام طرق الواجهة التلقائية في الإصدار 8 من حزمة تطوير البرامج (JDK) (I5bcf1).
- تتضمّن الفئتان
WindowWidthSizeClass
وWindowHeightSizeClass
الآن واجهة Comparable، لذا يمكن مقارنتهما باستخدام عوامل التشغيل (< و<= و>= و>) وواجهات برمجة التطبيقات الأخرى. (I747d0)
إصلاح الأخطاء
- تعديل عيّنة الشارة لتقديم وصف أكثر دلالة للمحتوى (I10b9d)
- تضيف هذه السمة خيارًا لاستخدام حجم خط النظام في أداة اختيار المظهر في كتالوج Material 3. (I10605)
- تمت إضافة نموذج رمز لشارات ومؤشرات مستوى التقدّم غير المحدّد. (I8fbe0)
الإصدار 1.0.0-alpha13
1 يونيو 2022
تم طرح androidx.compose.material3:material3:1.0.0-alpha13
وandroidx.compose.material3:material3-window-size-class:1.0.0-alpha13
. يحتوي الإصدار 1.0.0-alpha13 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- يتيح الحفاظ على موضع شريط التطبيق العلوي عند تغيير الإعدادات. (I10459، b/216160958)
الإصدار 1.0.0-alpha12
18 مايو 2022
تم طرح androidx.compose.material3:material3:1.0.0-alpha12
وandroidx.compose.material3:material3-window-size-class:1.0.0-alpha12
. يحتوي الإصدار 1.0.0-alpha12 على عمليات الإيداع هذه.
إصلاح الأخطاء
- يمكن الآن أن يكون عرض الحاوية الرئيسية لشريط التمرير 0. (b/231707291)
الإصدار 1.0.0-alpha11
11 مايو 2022
تم طرح androidx.compose.material3:material3:1.0.0-alpha11
وandroidx.compose.material3:material3-window-size-class:1.0.0-alpha11
. يحتوي الإصدار 1.0.0-alpha11 على عمليات الإيداع هذه.
الميزات الجديدة
- تمت إضافة
RangeSlider
إلى Material 3 (I18e38) - إضافة دعم
AssistChip
وInputChip
في Material3 (I0d25a) - إضافة دعم
FilterChip
وSuggestionChip
في Material3 (I9fdf3)
تغييرات واجهة برمجة التطبيقات
- تمت إعادة تسمية العنصر القابل للإنشاء
TextFieldDefaults.BorderStroke
الذي يرسم ضربة حدودية فيOutlinedTextField
إلىTextFieldDefaults.BorderBox
. (I5f295) - التبديل بين التغييرات المرئية في m3 (Iab30e)
- السماح بتمرير الألوان إلى أزرار الرموز العادية (Ia2445)
إصلاح الأخطاء
- إضافة فحص lint إلى material3/Scaffold للتأكّد من استخدام الحشو الداخلي (I72293، b/226951418)
الإصدار 1.0.0-alpha10
20 أبريل 2022
تم طرح androidx.compose.material3:material3:1.0.0-alpha10
وandroidx.compose.material3:material3-window-size-class:1.0.0-alpha10
. يحتوي الإصدار 1.0.0-alpha10 على عمليات الإيداع هذه.
الميزات الجديدة
-
material3-window-size-class
هي مكتبة جديدة توفّر الدعم لفئات أحجام النوافذ، وهي مجموعة من نقاط توقّف إطار العرض المحدّدة مسبقًا لتصميم وتطوير واختبار تخطيطات التطبيقات القابلة لتغيير الحجم. يمكنك استخدامcalculateWindowSizeClass
لاسترداد مثيل لفئة حجم النافذة، ويمكنك استخدام هذا المثيل لتحديد طريقة ظهور واجهة المستخدم، مثل عرض شريط تنقّل جانبي بدلاً من شريط تنقّل سفلي لأحجام النوافذ الأكبر. لمزيد من المعلومات وأمثلة على الاستخدام، يُرجى الاطّلاع على المستندات المرجعية لواجهة برمجة التطبيقات الخاصة بـWindowSizeClass
. لمزيد من المعلومات حول تعريفات فئات أحجام النوافذ، يمكنك الاطّلاع على الإرشادات المتاحة للجميع بشأن إتاحة أحجام الشاشات المختلفة.
تغييرات واجهة برمجة التطبيقات
- تضيف هذه السمة مستوى الارتفاع التلقائي لزر الإجراء العائم (FAB) في
BottomAppBar
، وتزيل تعبير lambda اللاحق منBottomAppBar
مع زر الإجراء العائم. (I92c47) - تضيف هذه السمة
FilledIconButton
وFilledTonalIconButton
وOutlinedIconButton
من Material3. (Ib2bda) - تعديل واجهة برمجة التطبيقات الخاصة بشريط الإشعارات المؤقتة في Material 3 لقبول قيم الألوان للإجراء الاختياري وإجراء الإغلاق (Ibe4b4)
- تم إيقاف ميزة الاستهلاك الجزئي (النزول أو الموضع) نهائيًا في
PointerInputChange
. يمكنك استخدامconsume()
لاستهلاك التغيير بالكامل. يمكنك استخدامisConsumed
لتحديد ما إذا كان مستخدم آخر قد استهلك التغيير من قبل أم لا. - تنشئ الدالة
PointerInputChange::copy()
الآن نسخة سطحية دائمًا. وهذا يعني أنّه سيتم استهلاك نُسخPointerInputChange
بعد استهلاك إحدى النُسخ. إذا أردت إنشاءPointerInputChange
غير مرتبط، استخدِم الدالة الإنشائية بدلاً من ذلك. (Ie6be4، b/225669674) - تغييرات على Cards API لتلقّي ألوان الحاوية والمحتوى من خلال واجهة
CardColors
، ولإتاحة حالة غير مفعّلة للبطاقات القابلة للنقر (I927df) - تمت إعادة تسمية المَعلمة
backgroundColor
إلىcontainerColor
في حقول النص في Material 3 لتحسين الاتساق مع المكوّنات الأخرى. (I6fbd9)
إصلاح الأخطاء
- تعديلات على
IconButton
العادي ليتوافق مع مواصفات Material3 (I09eab) - نقل ارتفاع الشريط العلوي لـ Scaffold في Material3 إلى مساحة الحشو التي تم تمريرها إلى المحتوى، ما يسمح بعرض المحتوى أسفل شريط التطبيق العلوي في حال تم تجاهل
PaddingValues
، قد يتم حجب المحتوى بواسطة الشريط العلوي. (I83cbc، b/217776202)
الإصدار 1.0.0-alpha09
6 أبريل 2022
تم طرح androidx.compose.material3:material3:1.0.0-alpha09
. يحتوي الإصدار 1.0.0-alpha09 على عمليات الإيداع هذه.
الميزات الجديدة
- تمت إضافة واجهة برمجة تطبيقات مفتاح تحكّم Material 3 (I2c3ad)
تغييرات واجهة برمجة التطبيقات
- تمت إضافة إمكانية استخدام القوائم المنسدلة مع حقول النص (المعروفة أيضًا باسم "القوائم المنسدلة المكشوفة" أو "مربّعات التحرير والسرد"). (I1b832)
- تمت إضافة مَعلمة الشكل إلى MaterialTheme ونظام Shape الفرعي. (I37426)
- تمت إضافة مَعلمة موسّعة إلى
ExtendedFloatingActionButton
للتحكّم في ما إذا كان زر الإجراء العائم موسّعًا أو مصغّرًا، مع إضافة رسوم متحركة بين كل حالة. تمت إضافة تحميل زائد لزر الإجراء العائم الموسّع من أجل أزرار الإجراء العائم الموسّعة التي تتضمّن نصًا لاحقًا لأزرار الإجراء العائم الموسّعة بدون رمز. (Iba7f1)
الإصدار 1.0.0-alpha08
23 مارس 2022
تم طرح androidx.compose.material3:material3:1.0.0-alpha08
. يحتوي الإصدار 1.0.0-alpha08 على عمليات الإيداع هذه.
الميزات الجديدة
- تمت إضافة دعم لحقول النص في Material 3. (I795cc، b/199377790)
تغييرات واجهة برمجة التطبيقات
- إضافة فاصل تلقائي للقائمة (I01374)
- تمت إضافة مَعلمة اللون
surfaceTint
إلى الفئةColorScheme
. (I2f558)
إصلاح الأخطاء
- إصلاح الخطأ في الزر Material3 لقراءة قيمة نمط النص التلقائي من MaterialTheme (Ie62fc)
الإصدار 1.0.0-alpha07
9 مارس 2022
تم طرح androidx.compose.material3:material3:1.0.0-alpha07
. يحتوي الإصدار 1.0.0-alpha07 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- تعديلات على واجهة برمجة التطبيقات Surface في Material 3 تعيد الوظائف المحمّلة بشكل زائد إلى مساحات العرض القابلة للنقر، بالإضافة إلى إضافة وظيفة تتيح إمكانية اختيار مساحات العرض وتفعيلها أو إيقافها. (I4bf18)
- أصبح الإصداران
LazyVerticalGrid
وLazyHorizontalGrid
مستقرَّين الآن. (I307c0) - تم نقل
LazyVerticalGrid/LazyHorizontalGrid
وجميع واجهات برمجة التطبيقات ذات الصلة إلى الحزمة الفرعية .grid. يُرجى تعديل عمليات الاستيراد من androidx.compose.foundation.lazy إلى androidx.compose.foundation.lazy.grid. (I2d446) - تمت إعادة التغيير السابق الذي كان يعتمد فقط على View في
WindowInsetsControllerCompat
، وأصبح من الضروري توفُّر Window مرة أخرى، وهو أمر مطلوب لإدارة بعض علامات Window. تم إيقافViewCompat.getWindowInsetsController
نهائيًا واستبداله بـWindowCompat.getInsetsController
للتأكّد من استخدام Window الصحيح (على سبيل المثال، إذا كان العرض في مربّع حوار). (I660ae، b/219572936) - تمت إضافة واجهة برمجة تطبيقات جديدة
LazyVerticalGrid
لتحديد أحجام المحاور المتقاطعة (I17723)
إصلاح الأخطاء
- تعديلات على Card API لمواكبة التغييرات في Surface API (I3c8b9)
الإصدار 1.0.0-alpha06
23 فبراير 2022
تم طرح androidx.compose.material3:material3:1.0.0-alpha06
. يحتوي الإصدار 1.0.0-alpha06 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة
NavigationDrawerItem
التي تمثّل وجهة واحدة ضمن أدراج التطبيق (Ic396f، b/218286829) - تمت إضافة
PermanentNavigationDrawer
وDismissibleNavigationDrawer
كواجهتَي برمجة تطبيقات تجريبيتين. هذه هي أدراج التنقّل المناسبة تمامًا للأجهزة ذات الشاشات الكبيرة. (I5f8ab، b/218286829) - إضافة إمكانية استخدام شريط التطبيق السفلي بتصميم Material 3 (Ic432a)
- تمت إعادة تسمية
NavigationDrawer
إلىModalNavigationDrawer
(I1807d، b/218286829) - تمت إضافة فئة وأرمزة شريط التمرير Material 3 (I1ccee)
- تمت إضافة تنفيذ علامة التبويب، راجِع المستندات لمعرفة كيفية الاستخدام (Ie0146)
إصلاح الأخطاء
- تم إصلاح مشكلة كانت تؤدي إلى اختيار قارئ الشاشة
TalkBack
للتنقل الخطي لعنوان فارغ في شريط التطبيق العلوي. (Id4690) - تمّت إضافة "
IconSize
" إلى "FloatingActionButtonDefaults
". (Ia71cf) - تم إصلاح الخطأ الذي كان يؤدي إلى إخفاء أزرار
AlertDialog
عند إضافة نص طويل يتضمّنLazyColumn
. (Ib2cc9، b/216663029)
الإصدار 1.0.0-alpha05
9 فبراير 2022
تم طرح androidx.compose.material3:material3:1.0.0-alpha05
. يحتوي الإصدار 1.0.0-alpha05 على عمليات الإيداع هذه.
الميزات الجديدة
تمت إضافة مكوّنات Material Design 3
- قائمة منسدلة
- البطاقات
تغييرات واجهة برمجة التطبيقات
- الدالة
Surface
المتوقّفة نهائيًا والتي تستخدم onClick callback. يجب إنشاء المساحات القابلة للنقر باستخدامInteractionSource
وModifier.clickable()
. (I211c6) - تمت إضافة إمكانية استخدام الارتفاع عند الضغط على زر الإجراء العائم أو التركيز عليه. (Ibb584)
- تم تغيير واجهة برمجة التطبيقات
Surface
لتلقّي InteractionSource، ما يتيح التحكّم في مظهرها في حالات مختلفة. (Iafbc8)
إصلاح الأخطاء
- تمت إضافة الألوان الثلاثية الناقصة في أنظمة الألوان الديناميكية (I456c4، b/214588434)
الإصدار 1.0.0-alpha04
26 يناير 2022
تم طرح androidx.compose.material3:material3:1.0.0-alpha04
. يحتوي الإصدار 1.0.0-alpha04 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة
NonRestartableComposable
إلى الطرق التي تم تحميلها بشكل زائد من الطرق الحالية بدون منطق معقّد. يقلّل ذلك من عمليات التحقّق من التخزين المؤقت التي ينشئها المترجم (equals) لجميع المَعلمات التي تتكرّر في الدالة الداخلية التي يتم استدعاؤها. (I90490) - تمت إضافة فاصل Material 3. (Ica5fc)
- ضَع علامة على مربّع الاختيار وزر الاختيار باستخدام تعليق توضيحي لواجهة برمجة تطبيقات تجريبية. (Ie44bb)
- تمت إضافة دعم لمؤشرات التقدّم في Material 3. (Iff232، b/205023841)
إصلاح الأخطاء
- تعديل لون حاوية
TextButton's
غير مفعّلة ليكون شفافًا (I6b248، b/213339737)
الإصدار 1.0.0-alpha03
12 يناير 2022
تم طرح androidx.compose.material3:material3:1.0.0-alpha03
. يحتوي الإصدار 1.0.0-alpha03 على عمليات الإيداع هذه.
إصلاح الأخطاء
- أضِف
LocalIndication
إلىMaterialTheme
في Material 3. (I7ce4e) - إصلاح نصف قطر الزاوية الذي يتم تطبيقه على مربّعات الاختيار (I38b03 وb/175198975 وb/202309440)
تحديثات التبعيات
- يعتمد الآن على Kotlin
1.6.10
.
الإصدار 1.0.0-alpha02
1 كانون الأول (ديسمبر) 2021
تم طرح androidx.compose.material3:material3:1.0.0-alpha02
. يحتوي الإصدار 1.0.0-alpha02 على عمليات الإيداع هذه.
الميزات الجديدة
- إضافة دعم لمربّع الاختيار وزر الاختيار
- تم تعديلها لتكون متوافقة مع Kotlin
1.6.0
تغييرات واجهة برمجة التطبيقات
- إزالة الدرج من هيكل Material 3 (I04f51)
- تضيف هذه السمة إمكانية استخدام
Checkbox
Material 3. (Id5542) - تضيف هذه السمة إمكانية استخدام
RadioButton
Material 3. (I20334)
إصلاح الأخطاء
- تقليل نصف قطر التموج
IconButton
من 40dp إلى 20dp (I68bbe، b/206674345) - تم تغيير المسار السريع لسلسلة المنافذ
Text
منcompose.material
(I30b03) - تم إصلاح المشكلة، ولكن تم ترميز الزر بشكل ثابت ليكون مفعّلاً دائمًا. (Iea832، b/205335456)
الإصدار 1.0.0-alpha01
27 أكتوبر 2021
تم طرح androidx.compose.material3:material3:1.0.0-alpha01
. يحتوي الإصدار 1.0.0-alpha01 على عمليات الدمج التالية.
الميزات الجديدة
تحديد نسق Material Design 3 والألوان الديناميكية في Material You
مكوّنات Material Design 3
- الأزرار
- زر الإجراء الرئيسي وزر الإجراء الرئيسي الموسّع
- مربّعات الحوار
- شريط التنقّل
- لائحة التنقّل
- شريط التنقّل
- شريط التطبيق العلوي
- الشارة
- الرمز
- نص
- Surface
- التصميم
- لون المحتوى
لمزيد من المعلومات، يُرجى الاطّلاع على قسم Material Design 3 وMaterial You في دليل "استخدام السمات في Material Design في Compose".