‫Compose Material 3

يمكنك إنشاء واجهات مستخدم Jetpack Compose باستخدام "مكوّنات التصميم المتعدد الأبعاد 3"، وهي التطور التالي للتصميم المتعدد الأبعاد. يتضمّن الإصدار 3 من Material تصميمات ومكوّنات محدّثة وميزات تخصيص Material You، مثل الألوان الديناميكية، وهو مصمّم ليكون متوافقًا مع النمط المرئي الجديد وواجهة مستخدم النظام في Android 12.
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫17 يونيو 2026 1.4.0 - - 1.5.0-alpha22

البنية

‫Compose هي مجموعة من سبعة معرّفات Maven Group ضمن androidx. تحتوي كل مجموعة على مجموعة فرعية مستهدَفة من الوظائف، ولكل منها مجموعة خاصة من ملاحظات الإصدار.

يوضّح هذا الجدول المجموعات ويتضمّن روابط لكل مجموعة من ملاحظات الإصدار.

مجموعةالوصف
compose.animationإنشاء رسوم متحركة في تطبيقات Jetpack Compose لإثراء تجربة المستخدم
compose.compilerتحويل دوال ‎ @Composable وتفعيل عمليات التحسين باستخدام مكوّن إضافي لمترجم Kotlin
compose.foundationكتابة تطبيقات Jetpack Compose باستخدام وحدات أساسية جاهزة للاستخدام وتوسيع نطاق الأساس لإنشاء أجزاء نظام التصميم الخاص بك
compose.materialإنشاء واجهات مستخدم Jetpack Compose باستخدام "مكوّنات التصميم المتعدد الأبعاد" الجاهزة للاستخدام هذه هي نقطة الدخول الأعلى مستوى في Compose، وهي مصمَّمة لتوفير مكوّنات تتطابق مع تلك الموضّحة في www.material.io.
compose.material3يمكنك إنشاء واجهات مستخدم Jetpack Compose باستخدام "مكوّنات التصميم المتعدد الأبعاد 3"، وهي التطور التالي للتصميم المتعدد الأبعاد. يتضمّن الإصدار 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.4.0"
    implementation "androidx.compose.material3:material3-window-size-class:1.4.0"
    implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.5.0-alpha22"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

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

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 هذه التعديلات.

الميزات الجديدة

مكوّنات غير مرتبطة بمظهر معيّن يمكن استخدامها لإنشاء مكوّنات التصميم المتعدد الأبعاد:

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 هذه التعديلات.

الميزات الجديدة

إصلاح الأخطاء

  • إصلاح مشكلة ملء مكوّن التنقّل للشاشة بالكامل عندما يحتوي السطح الجذر على 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:

‫Compose Material3 الإصدار 1.5

الإصدار ‎1.5.0-alpha22

‫17 يونيو 2026

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha22. يتضمّن الإصدار 1.5.0-alpha22 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة أداة جلب snapAnimationSpec عامة إلى TopAppBarDefaults لعرض مواصفات الحركة التلقائية. (Ic7b37، b/519193808)
  • إضافة أشكال إلى الطرق الداخلية والخاصة لواجهة برمجة التطبيقات TimePicker.kt (I9d09e، b/441573791)
  • إتاحة الأشكال في AnimatedPane (Ie7c60، b/470517507)
  • إصلاح تباين أزرار التبديل بين صباحًا ومساءً في TimePicker (Ifc0b7، b/339079853)
  • تغيير حالة واجهات برمجة التطبيقات Expressive FloatingToolbar من تجريبية إلى غير تجريبية (I5a4d8، b/497887216)
  • إزالة transformOriginState المتوقّف نهائيًا من DropdownMenuPopupPositionProvider (I0d5b0، b/505481611)
  • تم تعديل pinnedScrollBehavior وenterAlwaysScrollBehavior لقبول ScrollableState، ما يؤدي تلقائيًا إلى التعامل مع الحالات الحدّية، مثل التنسيقات المعكوسة والمحتوى الذي تم تمريره مسبقًا. تم إيقاف التحميل الزائد القديم نهائيًا. يمكنك نقل استخدامات isScrollingContentAtStart إلى عمليات التحميل الزائد الجديدة مع المَعلمة scrollableState. تمت ترقية الإصدار TopAppBarScrollBehavior وواجهات برمجة التطبيقات ذات الصلة إلى إصدار ثابت. (Ib83cf، b/519193808)
  • تم تعديل pinnedScrollBehavior وenterAlwaysScrollBehavior لقبول ScrollableState، ما يؤدي تلقائيًا إلى التعامل مع الحالات الحدّية، مثل التنسيقات المعكوسة والمحتوى الذي تم تمريره مسبقًا. تمت ترقية الإصدار TopAppBarScrollBehavior وواجهات برمجة التطبيقات ذات الصلة إلى إصدار ثابت. (Ieda4b، b/405129274)
  • تعديل DropdownMenuPositionProvider لإزالة MutableState من transformOrigin تصغير MenuAnchorPosition من واجهة محكمة الإغلاق إلى فئة واحدة يقدّم MenuAnchorPositionScope الذي يحتوي على معلومات يمكن استخدامها لإنشاء مرشّحين مخصّصين للمحورين x وy. (I21f2b، b/505481611)
  • ترقية واجهات برمجة التطبيقات ButtonGroup إلى إصدار ثابت إزالة واجهات برمجة التطبيقات التجريبية المتوقّفة نهائيًا والتي تم طرحها في الإصدار 1.5.0-alpha (Idaf96، b/497876828)

إصلاح الأخطاء

  • تم إصلاح خطأ لم يتم فيه التعامل بشكل صحيح مع الرسوم المتحركة لضغط ButtonGroup أو مساحات الحشو غير المتماثلة للأزرار أو اتجاهات التنسيق من اليمين إلى اليسار، وكان من الممكن أن يتعطّل مع IllegalArgumentException في بعض كثافات العرض. (I35074، b/516743181)
  • إصلاح آلية معالجة الأخطاء في وضع إدخال النص في TimePicker (If4541، b/405054265)

الإصدار ‎1.5.0-alpha21

‫3 يونيو 2026

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha21. يتضمّن الإصدار 1.5.0-alpha21 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • إضافة أشكال إلى واجهة برمجة التطبيقات الخاصة بمكوّن أداة اختيار الوقت (I57f28، b/441573791)
  • تمت إضافة compressionLimit إلى animateWidth التي تحدّد مساحة الحشو للعنصر المضغوط، ما يشير إلى الحد الأقصى لعملية الضغط التي يمكن أن يخضع لها العنصر. إيقاف واجهة برمجة التطبيقات animateWidth نهائيًا بدون المَعلمة compressionLimit (I4a725، b/418822334، b/403281052)
  • لم يعُد يتم إزالة عنصر BottomSheet وModalBottomSheet PartiallyExpanded الثابت آليًا استنادًا إلى شروط التنسيق. يمكن للمستخدمين الآن التحكّم في هذا الرابط الثابت بشكل صريح من خلال rememberBottomSheetState. يمكن تفعيل السلوك القديم لهذه المكوّنات من خلال إيقاف علامة الميزة isBottomSheetPartiallyExpandedDeterministicEnabled أو الاستفادة من الدالتَين المتوقّفتَين نهائيًا rememberModalBottomSheetState وrememberStandardBottomSheetState. تمت الآن إزالة isAnchoredDraggableComponentsAnchorRecoveryEnabled من علامات الميزات. (Ia4167، b/478210200، b/512076811)
  • إعادة طرح العلامة التجريبية لـ PullToRefreshDefaults.loadingIndicatorColor وPullToRefreshDefaults.loadingIndicatorContainerColor (Ib9d15، b/513225663)
  • تم تعديل مَعلمات SelectableChipColors لتصبح عامة (I559e0، b/512576750)
  • إضافة المَعلمة horizontalArrangement إلى MenuItems (Ie8088، b/497891817)
  • إعادة تصنيف وظيفة contentPaddingFor في "زر إعادة التحديد" على أنّها تجريبية (I07d3e، b/500355872)
  • تم تقديم roundedShape وtonalColors() في كل من TextFieldDefaults وOutlinedTextFieldDefaults، وهما الإعدادات المرئية للأسلوب التعبيري. (Id9185، b/448728288)
  • تم إيقاف النوع TextFieldLabelPosition.Attached نهائيًا، وتمت إضافة النوعَين الفرعيَين Inside وCutout، ما يتيح المزيد من التخصيص، مثل OutlinedTextField مع وضع التصنيف داخل الشكل. تم أيضًا إيقاف السمة OutlinedTextFieldDefaults.contentPadding() نهائيًا، وتمت إضافة السمتَين OutlinedTextFieldDefaults.contentPaddingWithLabel() وOutlinedTextFieldDefaults.contentPaddingWithoutLabel() لتوفير كلا موضعَي التصنيف. (I40f62، b/448728288)

إصلاح الأخطاء

  • تم إصلاح مشكلة متعلّقة بإمكانية الوصول في TimePicker، حيث كان يتم فقدان تركيز لوحة المفاتيح عند التبديل من الساعات إلى الدقائق على القرص. تحسين إمكانية الوصول إلى التركيز على لوحة المفاتيح (I7dd81، b/498361169)

المساهمة الخارجية

  • تحسين فيزياء إيماءة إغلاق BottomSheet لتوفير تجربة أكثر سلاسة (I21df5)

الإصدار ‎1.5.0-alpha20

‫19 مايو 2026

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha20. يتضمّن الإصدار 1.5.0-alpha20 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • إزالة وظيفة shouldUsePrecisionPointerComponentSizing (I882c3، b/498698039)
  • تم إصلاح مشكلة ظهور علامة الإقحام الخاصة بتلميح الأداة على الجانب الخطأ عند قلب تلميح الأداة بسبب حواف الشاشة. (Idc314، b/479224210)
  • تم طرح rememberBottomSheetState كواجهة برمجة تطبيقات موحّدة لحالة BottomSheet. تم إيقاف rememberModalBottomSheetState وrememberStandardBottomSheetState نهائيًا واستبدالهما بواجهة برمجة التطبيقات الموحّدة الجديدة. (I2724e، b/500005697)
  • إزالة واجهات برمجة التطبيقات التجريبية المتوقّفة WideNavigationRail (Iaadd6، b/497891040)
  • تغيير حالة واجهات برمجة التطبيقات من SplitButton إلى غير تجريبية (I4d395، b/497876691)
  • إيقاف واجهات برمجة التطبيقات DropdownMenuItem التي تتضمّن مَعلمات تم وضع علامة اختيار عليها وتحديدها وتحتوي على supportingText كدالة لامدا لاحقة تم نقل supportingText لتصبح مَعلمة بعد trailingIcon مباشرةً. (Icaf79، b/503047115)

إصلاح الأخطاء

  • تعديل معالج "إيماءة إظهار شاشة الرجوع" في "لائحة التنقل" للسماح بالرجوع أثناء فتح اللائحة بدلاً من السماح بذلك فقط عند فتحها بالكامل (I714ae، b/418556231)

الإصدار 1.5.0-alpha19

‫6 مايو 2026

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha19. يتضمّن الإصدار 1.5.0-alpha19 هذه التعديلات.

الميزات الجديدة

  • تتيح الآن الطباعة استخدام مجموعة خطوط تلقائية سيتم دمجها مع أنماط النصوص المتوفّرة إذا لم يتم ضبط مجموعة خطوط بشكل صريح. (I2e305، b/500356360)

تغييرات واجهة برمجة التطبيقات

  • تزيل supportingText كدالة lambda لاحقة لـ DropdownMenuItem. بدلاً من ذلك، ضَعها مباشرةً بعد trailingIcon. (I5694b، b/503047115)
  • ترقية ToggleButtons إلى الإصدار الثابت (I8a771، b/497876827)
  • الترويج لواجهات برمجة التطبيقات التي تتيح إنشاء قوائم طعام معبّرة أزِل DropdownMenuItem لأنّها واجهة برمجة تطبيقات تجريبية قديمة كانت جزءًا من الإصدار 1.5.0-alpha. (I1d556، b/497885285)
  • إيقاف واجهات برمجة التطبيقات الخاصة بقائمة FAB وزر FAB العائم من الإصدار التجريبي من Expressive (Ie509c وb/497892373)
  • الترويج لواجهات برمجة التطبيقات الخاصة بالأزرار التعبيرية إزالة واجهة برمجة التطبيقات التجريبية المتوقّفة نهائيًا SmallButtonContentPaddingالتي تم طرحها في الإصدار 1.5.0-alpha (Iee31e، b/497873833)
  • إعادة واجهات برمجة التطبيقات الخاصة بترتيب العناصر إلى الحالة التجريبية (I01492، b/489424245)
  • إضافة تحميل زائد آخر لمنشئ Typography (I8b3b3، b/500356360)
  • إعادة العروض الترويجية MaterialShapes وLoadingIndicator إلى الإصدار الثابت (I30e69، b/497876695، b/497877850)

إصلاح الأخطاء

  • تم إصلاح الخلل في تنفيذ شريط التمرير الذي كان يؤدي إلى تطبيق المساحة المتروكة من حلقات التركيز الداخلية على المسار والإبهام عندما لا يكون المكوِّن قيد التركيز. (I16315، b/506158497)
  • تم إصلاح مشكلة في ModalBottomSheet حيث تم تطبيق imePadding بدون شروط، ما منع التحكّم في سلوك محرر أسلوب الإدخال (IME) من خلال contentWindowInsets. (Ied801، b/289824811)
  • [FAB] إصلاح عُطل في Modifier.animateFloatingActionButton بسبب تقريب الكثافة من عدد صحيح إلى عدد عشري (I2d25f، b/489769219)
  • إصلاح مشكلة عدم إمكانية الخروج من أداة اختيار النطاق الزمني يؤدي الضغط على مفتاح التبويب إلى نقل التركيز داخل التواريخ وخارجها، بينما يؤدي الضغط على مفاتيح الأسهم إلى نقل التركيز بين التواريخ. (I7f3ea، b/498332749)
  • إعادة التغييرات التي تم إجراؤها على الأزرار المتوسطة والكبيرة في وضع مؤشر التحديد الدقيق، وحجم الرمز التلقائي في مربّع الحوار أيضًا في وضع مؤشر التحديد الدقيق (I58d8c وb/496938250 وb/500356640)
  • تم إصلاح مشكلة عدم إمكانية نقل تركيز لوحة المفاتيح إلى أداة اختيار التاريخ غير التفاعلية. تم أيضًا إصلاح ترتيب التركيز في زرَي الرفض والتأكيد الذي لا يتّبع ترتيبهما المرئي. (Ibbe2e، b/500454457)

الإصدار ‎1.5.0-alpha18

‫22 أبريل 2026

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha18. يتضمّن الإصدار 1.5.0-alpha18 هذه التعديلات.

الميزات الجديدة

  • إضافة عمليات تحميل زائدة FilterChip وElevatedFilterChip وInputChip مع تغيير الشكل أضِف أشكالًا ومسافات وألوانًا تلقائية جديدة لهذه التحميلات الزائدة. (I84717، b/442678355)
  • تضيف هذه السمة إمكانية استخدام حلقة التركيز الداخلية من خلال واجهة برمجة تطبيقات تتطلّب الموافقة، وذلك باستخدام السمة المحلية الجديدة LocalRippleThemeConfiguration. (I0551a، b/282184440)

تغييرات واجهة برمجة التطبيقات

  • تمت إعادة تسمية rememberWithGapSearchBarState إلى rememberSearchBarWithGapState. (I5f54b، b/498697243)
  • تمت ترقية واجهتَي برمجة التطبيقات RippleThemeConfiguration وLocalRippleThemeConfiguration إلى إصدار ثابت، ما يتيح إمكانية ضبط التموجات ليتم رسمها بمظهر حلقة التركيز الداخلية بدلاً من مؤشر التركيز المستند إلى مستوى الشفافية. تم إيقاف واجهات برمجة التطبيقات التي تستخدم واجهات برمجة التطبيقات الخاصة بإعدادات material-ripple نهائيًا. (Ide5d0، b/485893129)
  • الترويج لواجهات برمجة التطبيقات WavyProgressIndicator (Id72a3، b/497877853)
  • الترويج materialExpressTheme، expressiveLightColorScheme (I40eab، b/497876844)
  • تم نقل الدالة المركّبة BottomSheet إلى BottomSheet.kt (If7e33، b/500091309)
  • أضِف التعليق التوضيحي Material3ExpressiveApi الذي لا يتطلّب OptIn. (Ib9f2e، b/499994043)
  • تضيف هذه السمة DropdownMenuPopupPositionProviders إلى DropdownMenuPopup، ما يتيح للمطوّرين الآن ضبط موضع القائمة بالنسبة إلى عنصر الربط. يتيح ذلك إمكانية استخدام القوائم الفرعية ضمن "القوائم المنسدلة". يمكنك الآن إنشاء قوائم فرعية متتالية باستخدام مواضع جديدة مرتبطة بعناصر الربط. مرِّر خيارات تحديد المواضع الجديدة هذه إلى rememberDropdownMenuPopupPositionProvider لضبط القائمة. للحصول على عملية تنفيذ كاملة، يُرجى الرجوع إلى نموذج قائمة الكتالوج. (Ic1ace، b/476161294)

إصلاح الأخطاء

  • تعديل مكوّنات Material3 لتتوافق مع مؤشرات حلقة التركيز الداخلية (I88006 وb/498610244 وb/467984300 وb/498281359)
  • تم حلّ مشكلة في عيّنات TimePicker حيث تم نقل تركيز TalkBack، ما سمح بإدخال وقت غير صالح (I51690، b/498364606)

الإصدار ‎1.5.0-alpha17

‫8 أبريل 2026

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha17. يتضمّن الإصدار 1.5.0-alpha17 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تمت ترقية القناة TopAppBarScrollBehavior والطُرق المرتبطة بها إلى إصدار ثابت. لم تعُد واجهات برمجة التطبيقات هذه تتطلّب الموافقة على استخدام @ExperimentalMaterial3Api. (Ieb2d1، b/496918628)

الإصدار ‎1.5.0-alpha16

‫25 مارس 2026

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha16. يتضمّن الإصدار 1.5.0-alpha16 هذه التعديلات.

الميزات الجديدة

  • الترويج لمنشئات Typography وسمات، تمت إضافة منشئ Typography يقبل قيمة FontFamily تلقائية يتم تطبيقها على جميع TextStyles في المقياس. (I3f6f1، b/236358112)
  • الترويج لواجهات برمجة التطبيقات التجريبية الخاصة بأشرطة التمرير لتصبح ثابتة (I5efb3، b/304811984)

تغييرات واجهة برمجة التطبيقات

  • تم تقديم علامة الميزة isAnchoredDraggableComponentsAnchorRecoveryEnabled للمكوّنات القابلة للسحب التي تواجه أخطاء هدف غامض. تشمل المكوّنات ModalBottomSheet وBottomSheetScaffold وSwipeToDismissBox وWideNavigationRail (I5b0e5 وb/487941042 وb/478210200 وb/477038695)
  • تمت إضافة الدالة التلقائية DropdownMenuItemTrailingLabel وحقول المسافات المتروكة المحسَّنة للمؤشر في واجهة المستخدم للقوائم المقسَّمة (I28977، b/485937388)
  • تمت إضافة مسافات بادئة للحوارات عندما تكون قيمة ComposeMaterial3Flags.isPrecisionPointerComponentSizingEnabled صحيحة، وتمت إضافة AlertDialogDefaults.IconSize للرمز. (Ib9652، b/485932651)
  • تم تحسين حسابات الحدّ الأدنى للحجم الداخلي في BasicTextField. تتحكّم ComposeFoundationFlags#isBasicTextFieldMinSizeOptimizationEnabled في هذه الإعدادات، ويمكنك إيقافها إذا أردت ذلك. (I70ade)
  • تم تعديل ترتيب المَعلمات في SearchBarDefaults.InputField للحفاظ على توافق رمز المصدر. (I20e3b، b/486964336)
  • إزالة واجهتَي برمجة التطبيقات المتوقّفتَين نهائيًا FilterChip وAssistChip اللتين تتضمّنان المَعلمة horizontalSpacing (Iec623، b/483762893)
  • تمت إعادة تسمية المَعلمة isAtTop في TopAppBarDefaults.pinnedScrollBehavior وTopAppBarDefaults.enterAlwaysScrollBehavior إلى isAtStart (If7323، b/405129274)

إصلاح الأخطاء

  • تتجاهل مكوّنات BottomSheet الآن MaterialTheme.motionScheme أثناء التمرير المتداخل وإيماءات السحب. (I5fe22، b/452071842، b/384959324)
  • تم إصلاح مشكلة تطبيق مساحة متروكة بين الرمز والتسمية عندما يحتوي العنصر على selectedLeadingIcon لا يتم عرضه حاليًا (Iba820)

الإصدار 1.5.0-alpha15

‫25 فبراير 2026

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha15. يتضمّن الإصدار 1.5.0-alpha15 هذه التعديلات.

الميزات الجديدة

تغييرات واجهة برمجة التطبيقات

  • تمت إعادة تصميم MaterialTheme لاستخدام CompositionLocal واحد لبيانات السمة. يمكن الآن الوصول إلى المتغيرات المحلية الخاصة بالتكوين من خلال MaterialTheme.LocalMaterialTheme.current أو currentValueOf(MaterialTheme.LocalMaterialTheme) في CompositionLocalAccessorScope (Idee2e، b/483676974)
  • تعديل الحشو التلقائي للمحتوى في زر النص التعبيري وفقًا للمواصفات الصحيحة إزالة الإيقاف النهائي لكلّ من TextButtonContentPadding وTextButtonWithIconContentPadding أيضًا (I67283)
  • إضافة مَعلمة لإيقاف معالج الرجوع من BottomSheet (Iff81e، b/483763626)
  • إزالة تصنيف "تجريبي" من مخطط حركة التخرّج (If822f، b/484003769)
  • تمت إضافة المَعلمتَين "مفعَّل" و"الحدّ الأدنى" إلى PullToRefreshBox في Material3. (I5610b، b/369044003)
  • استبدِل horizontalSpacing بـ horizontalArrangement في FilterChip وElevatedFilterChip. أضِف إعدادات horizontalArrangement التلقائية إلى FilterChipDefaults. (If3d6a، b/304853782)
  • تم تحسين KDoc لسلوكيات التمرير في TopAppBarDefaults من أجل توضيح كيفية الاستخدام بشكل أفضل مع المحتوى المعكوس والممرَّر مسبقًا. (I247dd، b/405129274)
  • استبدِل المَعلمة horizontalSpacing بالمَعلمة horizontalArrangmenet. أضِف إعدادات horizontalArrangement التلقائية إلى AssistChipDefaults. (I15cec، b/304853782)
  • إضافة دالة getter للسمة shouldUsePrecisionPointerComponentSizing (I234ce)
  • تمت إضافة عمليات تحميل زائدة إلى TopAppBarDefaults.enterAlwaysScrollBehavior وTopAppBarDefaults.pinnedScrollBehavior تقبل المَعلمة isAtTopState. يتيح ذلك رصد at top state مخصّص عند استخدام سلوكيات التمرير. (I785b9، b/405129274)
  • أضِف المَعلمتَين contentPadding وhorizontalArrangement إلى InputChip وElevatedInputChip. أضِف القيم التلقائية horizontalArrangement وcontentPadding إلى InputChipDefaults. (Iae39c، b/304853782)
  • تمت إضافة أحجام ومساحات بادئة دقيقة للمؤشر في "الأزرار" وإيقاف TextButtonContentPadding val القديمة نهائيًا. (I6d7b6، b/479879803)
  • تمت إضافة rememberWithGapSearchBarState لاستخدامها مع ExpandedDockedSearchBarWithGap. (Ia3361)

إصلاح الأخطاء

  • تم إصلاح المشكلة التي لا تظهر فيها الظلال للألواح المرتفعة (Ie6108، b/470517507)
  • عدِّل TextButtons لتضمين مواصفات صحيحة بشأن مساحات الحشو في Material 3. لإيقاف هذه الميزة والرجوع إلى السلوك القديم، يجب ضبط قيمة isTextButtonContentPaddingFixEnabled على "خطأ" في تطبيقك. (I66c8e)

الإصدار 1.5.0-alpha14

‫11 فبراير 2026

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha14. يتضمّن الإصدار 1.5.0-alpha14 هذه التعديلات.

الحل البديل

  • تمت إضافة isAnchoredDraggableComponentsStrictOffsetCheckEnabled. تتحكّم هذه العلامة في ما إذا كانت القضبان BottomSheetScaffold وModalBottomSheet وSwipeToDismissBox وWideNavigation تتطلّب بشكل صارم تهيئة الإزاحات الداخلية. عند إيقاف هذه الميزة، لن تضع المكوّنات محتواها إلى أن يتم ضبط الإزاحة. يمكن أن يساعد هذا الخيار في حلّ مؤقت لمشكلة تتسبّب في طرح هذه المكوّنات استثناءً بسبب عدم تهيئة الإزاحة. (I36870، b/477038695، b/478210200، b/471818801، b/475249572، b/475598146)

تغييرات واجهة برمجة التطبيقات

  • أضِف isTextButtonContentPaddingFixEnabled التي تجعل TextButton تتضمّن مواصفات صحيحة للحشو عند ضبط القيمة على "صحيح". (Ib986e)
  • تمت إضافة المَعلمة indicatorPadding إلى WideNavigationRailItem. (I3d5dc)
  • أضِف المَعلمتَين contentPadding وhorizontalArrangement إلى SuggestionChip وElevatedSuggestionChip. أضِف القيم التلقائية horizontalArrangement وContentPadding إلى SuggestionChipDefaults. إنشاء صف ChipArrangement (Ida874، b/304853782)
  • عدِّل عناصر القائمة القابلة للتحديد لتتضمّن مَعلمة للنص التكميلي. إيقاف واجهات برمجة التطبيقات السابقة التي لم تتضمّن مَعلمة النص الداعم أضِف أيضًا أحجام الرموز التلقائية المقترَحة للرموز الرئيسية والفرعية. (I89e4b، b/417731599)
  • تم تعديل تخطيط Snackbar لتحسين محاذاة النص المتعدد الأسطر. للحدّ من تعطُّل واجهة المستخدم، تم تقديم العلامة isSnackbarStylingFixEnabled للمساعدة في عملية نقل البيانات. يُرجى تفعيل هذه العلامة يدويًا في تطبيقك، وسيتم إزالتها في إصدار مستقبلي. (I37d63، b/322866101)
  • تم إصلاح خطأ في BottomSheetScaffold وModalBottomSheet وSwipeToDismissBox وWideNavigationRail حيث لم تتم إعادة احتساب نقاط الارتكاز في بعض الحالات. يتم إخفاء هذا الإصلاح خلف علامة ميزة، ComposeMaterial3Flags#isAnchoredDraggableComponentsInvalidationFixEnabled. (I9acb1، b/478210200)
  • أضِف مَعلمة مساحة متروكة للمحتوى إلى WideNavigationRail وModalWideNavigationRail لكي يمكن تخصيص المساحات المتروكة التلقائية. (I49106)

إصلاح الأخطاء

  • يؤدي ضبط BottomSheetScaffold sheetPeekHeight على 0 إلى إيقاف partiallyExpanded. يتم الاحتفاظ بعنصر الربط PartiallyExpanded في عملية التنسيق الأولى للسماح باحتساب التنسيق. (Ia33a4، b/465158677)
  • يفضّل SheetState#targetValue استخدام نقطة الارتكاز الحالية إذا كان الفارق الزمني الحالي صالحًا. يمنع ذلك تعديل قيمة initialValue على الفور. (Ied2c4، b/477279704)
  • إصلاح مشكلة عدم توسيط رمز WideNavigationRailItem عموديًا في حال تغيّر ارتفاع العنصر (Ib8c83)

الإصدار ‎1.5.0-alpha13

‫28 يناير 2026

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha13. يتضمّن الإصدار 1.5.0-alpha13 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة دعم لشريط البحث animationSpecForContentExpand وanimationSpecForContentCollapse. (I033a5)

إصلاح الأخطاء

  • تم إصلاح المشكلة المتمثّلة في أنّ محتوى SearchBar الموسّع لم يستخدم لونًا متوافقًا مع المظهر (I878e0، b/379441904).
  • تم إصلاح الخطأ الذي كان يتسبّب في استدعاء BottomSheetScaffold لوظيفة SheetState‏ confirmValueChange مع قيم غير صحيحة عند تمرير مقبض سحب إلى BottomSheetScaffold. يُرجى العِلم أنّه يجب استخدام confirmValueChange فقط لرفض تغييرات الحالة. استخدِم snapshotFlow لمراقبة تغييرات الحالة. (Ice9ee، b/465824174، b/477031833)

الإصدار 1.5.0-alpha12

‫14 يناير 2026

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha12. يتضمّن الإصدار 1.5.0-alpha12 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تعديل TopAppBarDefaults (enterAlways والسلوكيات المثبّتة) لتتوافق مع lazyListState وscrollState وreverseScrolling يحلّ ذلك مشاكل اتجاه التنسيق ويتعامل بشكل صحيح مع المحتوى الذي تمّت إزاحته في البداية. (I9d5c2، b/262234750)
  • أضِف المَعلمتَين contentPadding وhorizontalSpacing إلى AssistChip وElevatedAssistChip. أضِف القيم التلقائية HorizontalSpacing وContentPadding إلى AssistChipDefaults. (I2ac90، b/304853782)
  • لم يعُد يتم تصنيف واجهات برمجة التطبيقات DatePicker التي تستخدم فئات Java Time على أنّها تجريبية. (I5039c، b/457537971)

إصلاح الأخطاء

  • إصلاح عُطل في تنسيق التاريخ على الإصدار 23 من واجهة برمجة التطبيقات (I67a94، b/452713222)DatePicker
  • تم إصلاح خطأ في المحاذاة المرئية في عيّنة المؤشر المتحرّك الأنيق عند استخدامه مع صفوف علامات التبويب التي يمكن الانتقال للأسفل أو للأعلى فيها. (Iae0f3، b/466790304)
  • تم إصلاح مشكلة عدم استخدام أداة اختيار صباحًا/مساءً في TimePicker لنمط النص المحدّد بمواصفات التصميم المتعدد الأبعاد. (Ie908a، b/469788786)
  • تم إصلاح عُطل في HorizontalFloatingToolbar كان يمكن أن يحدث في الوضع الأفقي عند عرض لوحة المفاتيح على الشاشة. (Ia13c1، b/466692323)
  • تم إصلاح مشكلة تداخل عنوان TopAppBar مع actions عند عدم توفير navigationIcon. تم الآن حصر العنوان بشكل صحيح في المساحة المتاحة له. (I2ba97، b/428697836)
  • إتاحة التوافق مع اللغات من اليمين إلى اليسار باستخدام عناصر ربط لتوسيع اللوحة (I0770b، b/467775639)

الإصدار 1.5.0-alpha11

‫17 ديسمبر 2025

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha11. يتضمّن الإصدار 1.5.0-alpha11 هذه التعديلات.

الميزات الجديدة

  • تمت إضافة ExpandedFullScreenContainedSearchBar. (Ie472d،b/454658635)
  • تمت إضافة إمكانية إنشاء لوحات عرض دوّارة متعددة نسب العرض إلى الارتفاع باستخدام الشبكات الكسولة. (I2b109، b/462137656)
  • تتوفّر الآن عناصر قائمة تعبيرية في Material، ما يتيح التفاعلات والأنماط المقسَّمة. تمت إضافة حقول ألوان إضافية إلى ListItemColors. (I54057، b/441569230)
  • أصبحت واجهات برمجة التطبيقات الخاصة بلوحتي العرض الدوّارتين للتصفّح المتعدّد والممتدة خارج الحاوية ثابتة الآن. (I7a558، b/401537465)
  • أضِف المَعلمتَين contentPadding وhorizontalSpacing إلى FilterChip وElevatedFilterChip. أضِف القيم التلقائية HorizontalSpacing وContentPadding إلى FilterChipDefaults. (Iec6e3، b/455596578)

إصلاح الأخطاء

  • يؤدي ضبط BottomSheetScaffold sheetPeekHeight على 0 إلى إيقاف partiallyExpanded. (I52dc9، b/465158677)

الإصدار ‎1.5.0-alpha10

‫3 ديسمبر 2025

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha10. يتضمّن الإصدار 1.5.0-alpha10 هذه التعديلات.

الميزات الجديدة

  • تمت إضافة لوحة عرض دوّارة متعددة الجوانب (I15247، b/411232854)

تغييرات واجهة برمجة التطبيقات

  • تتوفّر الآن علامة الميزة isCheckboxStylingFixEnabled من خلال العنصر ComposeMaterial3Flags. (I97baf، b/457504316)
  • تم نقل المَعلمة disabledCheckmarkColor في CheckboxColors إلى نهاية قائمة المَعلمات لضمان التوافق الثنائي. (I734d8، b/457504316)

إصلاح الأخطاء

  • إعادة جميع مفاتيح الأسهم التي تغيّر قيم شريط التمرير لإصلاح مشكلة عدم القدرة على التركيز على عناصر أخرى في أجهزة معيّنة لا تتضمّن مفتاح Tab (I154dd، b/460912699)

الإصدار ‎1.5.0-alpha09

‫19 نوفمبر 2025

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha09. يتضمّن الإصدار 1.5.0-alpha09 هذه التعديلات.

الميزات الجديدة

  • إضافة تعديلات معبّرة على القائمة ويشمل ذلك عنصر قائمة جديدًا يمكن تبديله، وعنصر قائمة يمكن تحديده، ومجموعات قائمة، وقائمة منبثقة. يتضمّن أيضًا قيمًا تلقائية جديدة للقائمة التعبيرية في MenuDefaults. (I5cdd4، b/417731597، b/448646125، b/448646896، b/448646891)
  • توفّر Modifier.minimumInteractiveComponentSize الآن AlignmentLines: MinimumInteractiveTopAlignmentLine وMinimumInteractiveLeftAlignmentLine جديدَين ومتاحَين للجميع. تشير هذه الخطوط إلى الحواف المرئية لأحد المكوّنات قبل إضافة مساحة إضافية لاستيفاء الحد الأدنى من متطلبات ناحية اللمس المستهدَفة. (I7f485، b/458124197)
  • تمت إضافة ExpandedDockedSearchBarWithGap. (Idb7f8)

تغييرات واجهة برمجة التطبيقات

  • إضافة عمليات تحقّق لتفعيل تغيير حجم مكوّن المؤشر الدقيق (I8108d)
  • إضافة Modifier.align إلى ButtonGroupScope (I03890، b/416590906)
  • إزالة واجهات برمجة التطبيقات التجريبية ModalBottomSheet المتوقّفة نهائيًا والتي تم تضمينها في إصدار ثابت واحد على الأقل (Ifbe1d، b/449757604)
  • إضافة ButtonGroup جديدة مع المَعلمة verticalAlignment (I23a37، b/416590906)
  • تمت إزالة واجهات برمجة التطبيقات التجريبية المخفية المتوقّفة نهائيًا والتي تم تضمينها في إصدار ثابت واحد على الأقل. (I4f68d، b/449754465، b/449749933، b/401311419، b/449749928، b/449756019)

إصلاح الأخطاء

  • إضافة تلميح إلى زر القائمة المنسدلة التلقائي في شريط الأدوات العائم (Ife952، b/422781172)
  • إصلاح مشكلة اقتصاص مؤشر WideNavigationRail عند ضبطه على عرض أكبر من خلال حجم تصنيف أكبر (I9d740، b/444728723)
  • تعديل الأزرار اللاحقة لزر التقسيم من أجل توسيط الرمز بصريًا استنادًا إلى الشكل المحدّد حتى في وضع الكتابة من اليمين إلى اليسار (Icab82)

الإصدار ‎1.5.0-alpha08

‫5 نوفمبر 2025

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha08. يتضمّن الإصدار 1.5.0-alpha08 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة السمتَين hourInput وminuteInput إلى واجهة TimePickerState. تهدف هذه الخصائص إلى الاحتفاظ بالمدخلات الأولية غير الصالحة من المستخدم. ستبقى خصائص الساعة والدقيقة الحالية وتمثّل آخر وقت صالح معروف. (I09d74، b/394612017)

إصلاح الأخطاء

  • تم إصلاح الخطأ الذي كان يتسبّب في عدم إمكانية استخدام ميزة "التبديل" مع ReusableContent بدون تحريك العناصر. (I61093، b/455909150)

الإصدار 1.5.0-alpha07

‫22 أكتوبر 2025

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha07. يتضمّن الإصدار 1.5.0-alpha07 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تحسين SearchBar.InputField باستخدام المَعلمة keyboardOptions، ما يتيح إدخال نص محسّن من خلال تحديد خيارات لوحة المفاتيح، والمَعلمة lineLimits التي تتيح تحديد التمرير السريع لتغليف النص (Id08a4، b/416991049)

إصلاح الأخطاء

  • تم إصلاح خطأ في "شريط التمرير" حيث لم يتم إرسال تفاعلات الضغط عند لمس الشاشة. يضمن هذا التغيير إرسال PressInteraction.Press على الفور عند awaitFirstDown، ما يوفّر ملاحظات مرئية فورية. (If9e25، b/308501482)
  • تم إصلاح مشكلة عدم تغيير اتجاه علامة الإقحام Tooltip عند التمرير. يؤدي TooltipBox الآن إلى إعادة إنشاء التركيب كلما تم تبديل جوانب النافذة المنبثقة الخاصة بتلميح الأداة، ما يضمن تعديل اتجاه علامة الإقحام بشكل صحيح. (I5ad1e، b/438875827)

الإصدار ‎1.5.0-alpha06

‫8 أكتوبر 2025

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha06. يتضمّن الإصدار 1.5.0-alpha06 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة ألوان تم التمرير عليها لـ AppBarWithSearch. بالإضافة إلى ذلك، أصبح لون حاوية حقل إدخال شريط البحث شفافًا تلقائيًا. يبقى لون الحاوية التلقائي لشريط البحث نفسه بدون تغيير. (I4fe32)
  • تمت إضافة دالة مركّبة تلقائية لمؤشر تجاوز السعة إلى FloatingToolbar. (I6a6f8، b/415833723)
  • عدِّل isExpanded إلى isShowing لواجهات برمجة تطبيقات القوائم في مجموعة الأزرار. (I86309، b/412419514)
  • تم تعديل initialIsExpanded إلى initialIsShowing وإضافة دالة مركّبة تلقائيًا لعرض مؤشر تجاوز السعة في ButtonGroupDefaults. (I6e67c، b/412419514)
  • إزالة ميزة السحب لتغيير الحجم من مساحة واجهة برمجة التطبيقات العامة (Ic85ba وb/437953743 وb/442636084)

إصلاح الأخطاء

  • إصلاح ترتيب التركيز في التنقّل باستخدام لوحة المفاتيح، وإصلاحه أيضًا للغات التي تُكتب من اليمين إلى اليسار (Ibba27، b/422220597)
  • إصلاح التنقّل باستخدام لوحة المفاتيح في شبكة اختيار السنة في أداة اختيار التاريخ (I02363، b/422425720، b/446814683)
  • تم إصلاح التنقّل باستخدام لوحة المفاتيح في شبكة اختيار التاريخ في أدوات اختيار التاريخ. (I594ef، b/422220597، b/422223115)
  • تم إصلاح مشكلة تلقّي شريط الأدوات خارج الشاشة لتركيز لوحة المفاتيح. (I01a73، b/422786812)
  • تم إصلاح مشكلة التنقّل باستخدام لوحة المفاتيح في RangeSlider و"شريط التمرير". (Ib6bcf، b/424845268، b/422942624)

الإصدار ‎1.5.0-alpha04

‫10 سبتمبر 2025

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha04. يتضمّن الإصدار 1.5.0-alpha04 هذه التعديلات.

الميزات الجديدة

  • تمت إضافة Text عمليات تحميل زائد قابلة للإنشاء تقبل تعبير لامدا ColorProducer يتيح تغييرات فعّالة في الألوان بدون تشغيل إعادة إنشاء كاملة. (I9ff25، b/407055128)

تغييرات واجهة برمجة التطبيقات

  • أعِد تسمية Scrim() إلى LevitatedPaneScrim() وأخفِ خصائص الفئتين Levitated وReflowed. (I090e1، b/427953101)
  • إخفاء واجهة برمجة التطبيقات calculatePosture() على أنّها داخلية (Ie7227، b/424442112)
  • عرض PaneScaffoldHorizontalOrder كواجهة برمجة تطبيقات عامة محكمة الإغلاق (Ia4ebe)
  • تصنيف واجهات برمجة التطبيقات المتعلّقة بحجم النافذة ووضعيتها على أنّها تجريبية (I4ee96)

إصلاح الأخطاء

  • تم إصلاح ترتيب التنقّل باستخدام لوحة المفاتيح لكي ينتقل التركيز من زر الإجراء العائم إلى العنصر الأول في الأعلى. (Icaaa1، b/422762939)
  • تحسين إمكانية الوصول إلى لوحة المفاتيح في "لوحة التنقّل": لم يعُد من الممكن التركيز على اللوحة عند إغلاقها، ويمكن إغلاقها من خلال مفتاح Esc، ويتلقّى محتواها التركيز عند فتحها. (Idb995، b/422793544، b/422793651، b/422797424)
  • تستجيب خلفية شاشة الساعة في أداة اختيار الوقت الآن للتنقل باستخدام لوحة المفاتيح أو إدخال البيانات من خلالها. (I9d5d9، b/425710631)
  • استخدام نقطة إرساء أولية جديدة عند تغيير قائمة نقاط إرساء توسيع اللوحة (I91cd1، b/438829477)

الإصدار ‎1.5.0-alpha03

‫27 أغسطس 2025

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha03. يتضمّن الإصدار 1.5.0-alpha03 هذه التعديلات.

تغيير السلوك

  • تم تعديل حجم مربّع الاختيار وألوان المؤشر لتتوافق مع المواصفات. لتقليل تعطُّل واجهة المستخدم، تمت إضافة العلامة isCheckboxStylingFixEnabled للمساعدة في عملية نقل البيانات. يُرجى تفعيلها يدويًا في تطبيقاتك. ستتم إزالة هذه العلامة نهائيًا في إصدار مستقبلي. (I5bcd3، b/304300693)

تغييرات واجهة برمجة التطبيقات

  • تمّت إضافة المَعلمة contentPadding إلى TopAppBar (Ia5fea)
  • إضافة عملية إلغاء للمكوّن في إطار مجموعة أدوات التنقّل (I85312)

إصلاح الأخطاء

  • تم الآن تطبيق المَعلمة containerColor في TimePickerDialog بشكلٍ صحيح، ما يتيح تخصيص لون خلفية مربّع الحوار. (I47f89، b/403183883)
  • لم يعُد شريط التنقّل في النافذة المنبثقة يفقد التركيز عند تصغيره، وأصبح الآن يُغلق عند الضغط على مفتاح ESC. (4255257)
  • توفّر Snackbar الآن ترتيبًا صحيحًا لتركيز لوحة المفاتيح على زرَّي الإجراء والإغلاق، كما يتيح زر الإغلاق أيضًا عرض تلميح أداة. (11fa13d)

الإصدار ‎1.5.0-alpha02

‫13 أغسطس 2025

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha02. يتضمّن الإصدار 1.5.0-alpha02 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • في PullToRefreshDefaults، أعدنا تسمية shape إلى indicatorShape وcontainerColor إلى indicatorContainerColor وأضفنا indicatorMaxDistance لاستخدام المؤشر. (Ib6cbe)
  • إزالة علامة الإيقاف النهائي من PullToRefreshDefaults.indicatorColor (Iaaee2)
  • تمت إضافة AppBarWithSearch بدلاً من TopSearchBar، وهي تتيح استخدام رموز التنقّل/الإجراءات. (I213a5)

إصلاح الأخطاء

  • تم إصلاح الخطأ الذي يؤدي إلى تعديل إزاحة الدرج بشكل غير صحيح عند الضغط على زر الرجوع. (I85624، b/427778135)
  • يتم الآن الرجوع إلى targetValue ثابت إذا لم تكن هناك نقاط ارتساء أخرى.SwipeToDismissBox يتم الآن استخدام BottomSheetScaffold كخيار احتياطي لـ targetValue من النوع Expanded في حال عدم توفّر أي نقاط ربط أخرى. (I73d5e، b/428856426)
  • تم إصلاح المساحة المتروكة للأزرار في AlertDialog عند ترتيبها عموديًا. (Ia2118)
  • [FAB] إصلاح الخطأ الذي يجعل الزر العائم قابلًا للنقر حتى بعد أن تخفيه Modifier.animateFloatingActionButton (I8ea6c، b/430336834)
  • [شريط التمرير] تم إصلاح التنقّل باستخدام لوحة المفاتيح في شريط التمرير (I3a405)

الإصدار ‎1.5.0-alpha01

‫30 يوليو 2025

تم طرح androidx.compose.material3:material3-*:1.5.0-alpha01. يتضمّن الإصدار 1.5.0-alpha01 هذه التعديلات.

الميزات الجديدة

  • إضافة المزيد من موفّري المواضع لتلميحات الأدوات، ما يتيح للمطوّرين الآن التحكّم في ما إذا كانت تلميحات الأدوات موضوعة أعلى أو أسفل أو يسار أو يمين العنصر الأساسي أضِف واجهة برمجة تطبيقات تقبل شكلاً للعلامات، حتى يمكن توفير المزيد من الأشكال المخصّصة. (Ie513c)

تغييرات واجهة برمجة التطبيقات

  • أصبحت الآن طرق TextFieldColors لحساب ألوان المكوّنات استنادًا إلى الحالة متاحة للجميع. (I03165)
  • تمت إزالة التعليق التوضيحي "تعليق" من معاودة الاتصال onDismiss. (Ie3166)
  • تم تعديل DatePickerState.getDisplayedMonth(): YearMonth? وDateRangePickerState.getDisplayedMonth(): YearMonth? لعرض قيمة غير قابلة للتصغير. (Ice09c، b/427952972)
  • أزِل ModalWideNavigationRailDefaults، وانقل محتواه إلى WideNavigationRailDefaults، وأعِد تسمية الأسماء ذات الصلة بالشكل. (Ic5e61)
  • يجب أن يكون مستوى وظائف WideNavigationRailItem"الألوان" و"النسخ المتوقّف نهائيًا" هو Hidden. (Id7e82)
  • تغيير مستوى واجهات برمجة التطبيقات WideNavigationRail المتوقّفة نهائيًا إلى "تحذير" وجعلها تجريبية (I89085)

إصلاح الأخطاء

  • يضمن هذا الخيار أنّ DatePicker يلتزم باللغة الخاصة به عند تنسيق الأرقام. في السابق، إذا تم ضبط DatePicker على لغة عربية، كان بإمكانه عرض الأرقام اللاتينية بشكل غير صحيح إذا كانت اللغة المستخدَمة في نظام الجهاز تستخدم نظام ترقيم مختلفًا. (Iccf76، b/432616196)
  • تم حلّ مشكلة LinearProgressIndicator التي لم تعرض مؤشر الإيقاف بشكلٍ صحيح في التنسيقات من اليمين إلى اليسار. (I0734c)
  • يمتد الآن فاصل PrimaryScrollableTabRow وSecondaryScrollableTabRow إلى حجم الشاشة الكامل، حتى عندما لا يمتد محتوى علامة التبويب إلى نهاية الشاشة. (Ic1e9c، b/261741384)

الإصدار 1.4 من Compose Material3

الإصدار 1.4.0

‫24 سبتمبر 2025

تم طرح androidx.compose.material3:material3-*:1.4.0. يتضمّن الإصدار 1.4.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.3.0:

إشعارات تغييرات المكتبة

لم يعُد يُنصح باستخدام مكتبة androidx.compose.material.icons لعرض Material Icons في Compose، لأنّ Material Symbols هي الطريقة الجديدة. توقّفنا عن نشر تحديثات لهذه المكتبة وتمت إزالتها من أحدث إصدار من مكتبة Material 3، ولكن لا يزال بإمكانك الرجوع إليها يدويًا إذا لم تتمكّن من نقل البيانات بعد.

بدلاً من ذلك، ننصحك بتنزيل ملف XML للرسومات المتجهة القابلة للرسم من علامة التبويب Android في https://fonts.google.com/icons للوصول إلى أحدث الرموز المصمّمة: Material Symbols.

لماذا لم نعد نقترح المكتبة؟ تم استبدال مكتبة الرموز ("Material Icons") بالشكل الأحدث من Material Symbols، وقد تبيّن لنا أنّ المكتبة يمكن أن تزيد بشكل كبير من وقت إنشاء تطبيقاتك لأنّها تتضمّن جميع الرموز المختلفة التي قد لا تكون مطلوبة.

لمزيد من المعلومات: https://developer.android.com/develop/ui/compose/graphics/images/material

التغييرات في السلوك

  • لم تعُد هذه المكتبة تضيف الاعتمادية إلى material-icons-core، لذا إذا كان مشروعك يعتمد على ذلك، عليك إضافة هذه الاعتمادية بشكل صريح في ملفات build.gradle[.kts]. (I735ff، b/349894318)

  • يتغيّر لون التصنيف النشط في NavigationBarItem وNavigationRailItem من onSurface إلى ثانوي لتحسين سهولة الاستخدام والتباين اللوني وتحسين التماسك داخل النظام (Ibc297). للرجوع إلى السلوك السابق، انسخ الألوان التلقائية وغيِّر selectedTextColor إلى MaterialTheme.colorScheme.onSurface.

  • تستخدم مكوّنات Material 3 الآن MotionScheme الجديدة لتحديد الحركة. (Ie0f93)

  • تغييرات في حركة مؤشر التقدّم الدائري غير المحدّد (I3c07e)

مكوّنات جديدة في التصميم المتعدد الأبعاد 3

تحسينات على عناصر التصميم المتعدد الأبعاد 3 الحالية

  • يتوافق النص الآن مع autoSize
  • تمت إضافة أدوات تزيين Material 3 إلى BasicTextField2
  • تمت إضافة واجهة برمجة تطبيقات TimePickerDialog يمكن استخدامها في TimePicker أو TimeInput أو للحصول على إصدار قابل للتبديل.
  • واجهات برمجة تطبيقات جديدة لشريط البحث:
    • أصبحت أشرطة البحث المصغّرة و "طرق العرض" الموسّعة للبحث عناصر قابلة للإنشاء منفصلة:
    • يمثّل SearchBar شريط بحث في الحالة المصغّرة.
    • يمثّل الرمز ExpandedFullScreenSearchBar والرمز ExpandedDockedSearchBar شريط البحث في حالته الموسّعة. يتم فتحها في نافذة جديدة.
    • SearchBarState للتحكّم في حالة شريط البحث
  • تمت ترقية واجهات برمجة التطبيقات التجريبية إلى إصدار ثابت.
  • أضفنا تحسينات على الأداء

الإصدار 1.4.0-rc01

‫10 سبتمبر 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-rc01. يتضمّن الإصدار 1.4.0-rc01 هذه التعديلات.

الإصدار 1.4.0-beta03

‫27 أغسطس 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-beta03. يتضمّن الإصدار 1.4.0-beta03 هذه التعديلات.

الإصدار 1.4.0-beta02

‫13 أغسطس 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-beta02. يتضمّن الإصدار 1.4.0-beta02 هذه التعديلات.

التغييرات في الاعتمادية

تغييرات واجهة برمجة التطبيقات

  • في PullToRefreshDefaults، أعدنا تسمية shape إلى indicatorShape وcontainerColor إلى indicatorContainerColor وأضفنا indicatorMaxDistance لاستخدام المؤشر. (Ib6cbe)
  • إزالة علامة الإيقاف النهائي من PullToRefreshDefaults.indicatorColor (Iaaee2)
  • تمت ترقية BasicAlertDialogOverrideScope عن طريق الخطأ إلى الإصدار الثابت وإزالة التعليق التوضيحي التجريبي في aosp/3701846. وضع علامة على أنّه داخلي سيظل إصدارًا تجريبيًا متاحًا للجميع في الإصدار 1.5.0-alpha (I9182a)

إصلاح الأخطاء

  • تم إصلاح الخطأ الذي يؤدي إلى تعديل إزاحة الدرج بشكل غير صحيح عند الضغط على زر الرجوع. (I85624، b/427778135)

الإصدار 1.4.0-beta01

‫30 يوليو 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-beta01. يتضمّن الإصدار 1.4.0-beta01 هذه التعديلات.

التغييرات التي قد تؤدي إلى أعطال

  • تمت إزالة جميع واجهات برمجة التطبيقات المتاحة للجميع والمصنّفة باستخدام ExperimentalMaterial3ExpressiveApi أو ExperimentalMaterial3ComponentOverrideApi، يُرجى التبديل إلى 1.5.0-alpha لمواصلة الاستفادة من هذه الميزات. (Ie4ae0)
  • يُرجى العلم أنّه سيتم إعادة تسمية واجهات برمجة التطبيقات pullToRefresh الثابتة التالية في الإصدار التالي. (Ib6cbe)

الميزات الجديدة

  • تتيح Tooltip الآن تخصيص شكل علامة الإقحام وموضعها (أعلى أو أسفل أو يمين أو يسار العنصر الثابت). (Ie513c)

تغييرات واجهة برمجة التطبيقات

  • تمت إزالة التعليق التوضيحي "تعليق" من معاودة الاتصال onDismiss. (Ie3166)
  • تم تعديل DatePickerState.getDisplayedMonth(): YearMonth? وDateRangePickerState.getDisplayedMonth(): YearMonth? لعرض قيمة غير قابلة للتصغير. (Ice09c، b/427952972)
  • أزِل ModalWideNavigationRailDefaults، وانقل محتواه إلى WideNavigationRailDefaults، وأعِد تسمية الأسماء ذات الصلة بالشكل. (Ic5e61)

إصلاح الأخطاء

  • يضمن هذا الخيار أنّ DatePicker يلتزم باللغة الخاصة به عند تنسيق الأرقام. في السابق، إذا تم ضبط DatePicker على لغة عربية، كان بإمكانه عرض الأرقام اللاتينية بشكل غير صحيح إذا كانت اللغة المستخدَمة في نظام الجهاز تستخدم نظام ترقيم مختلفًا. (Iccf76، b/432616196)
  • تم حلّ مشكلة LinearProgressIndicator التي لم تعرض مؤشر الإيقاف بشكلٍ صحيح في التنسيقات من اليمين إلى اليسار. (I0734c)
  • يمتد الآن فاصل PrimaryScrollableTabRow وSecondaryScrollableTabRow إلى حجم الشاشة الكامل، حتى عندما لا يمتد محتوى علامة التبويب إلى نهاية الشاشة. (Ic1e9c، b/261741384)

الإصدار 1.4.0-alpha18

‫16 يوليو 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-alpha18. يتضمّن الإصدار 1.4.0-alpha18 هذه التعديلات.

الميزات الجديدة

  • توفّر السمة ModalBottomSheetProperties الآن خيار إيقاف dismissRequest من خلال النقر على خلفية شبه شفافة. (I8e715)
  • إضافة دعم trackCornerSize إلى مسار RangeSlider (Iec529)

تغييرات واجهة برمجة التطبيقات

  • تم جعل railExpanded مَعلمة مطلوبة لـ WideNavigationRailItem، وتمت إضافة modalContentColor لـ WideNavigationRailColors ونقل WideNavigationRailDefaults.modalContainerShape إلى ModalWideNavigationRailDefaults.containerShape. (Id60c5)
  • نقل مَعلمة دالة الألوان الجديدة في WideNavigationRail لتكون الأخيرة، وإيقاف الدالة القديمة نهائيًا (Iac7f7)
  • أصبحت السمة PullToRefresh الآن واجهة برمجة تطبيقات ثابتة (I18537)
  • تعديلات على واجهة برمجة التطبيقات DatePickers أزلنا تاريخ الانتهاء التلقائي الفارغ لـ DateRangePicker وأصبح من الضروري إدخاله. وضّحنا أيضًا استخدام تمثيل التاريخ في منتصف الليل بالتوقيت العالمي المتفق عليه في مستندات واجهة برمجة التطبيقات، وصنّفنا أحدث دوال الجلب والضبط التي تستخدم واجهات برمجة تطبيقات java.time على أنّها تجريبية في الوقت الحالي. (I121b3، b/427952972)
  • تغيير حالة واجهة برمجة التطبيقات التي تتضمّن المَعلمة tint: ColorProducer إلى غير تجريبية (Ia0133)
  • تمت إزالة التعليقات التوضيحية التجريبية من DatePicker وDateRangePicker والحالات والفئات والأنواع المتوافقة معها. (I0e4e0، b/391848485)
  • تم تغيير القيمة التلقائية القابلة للتركيز إلى "خطأ" لإصلاح مشكلة التركيز في تسهيل الاستخدام، وتمت إضافة المَعلمة hasAction إلى TooltipBox. (I62998)
  • إيقاف واجهات برمجة التطبيقات التجريبية WideNavigationRail وShortNavigationBar وNavigationItem (I3ca3c)
  • إزالة التعليقات التوضيحية @ExperimentalMaterial3Api من بعض وظائف شريط التطبيق العلوي والفئات والعناصر المتوافقة (I0a9b7)

الإصدار ‎1.4.0-alpha17

‫2 يوليو 2022

تم طرح 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 API 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 تمت إزالة مَعلمة lambda expanded وإضافة مَعلمات منفصلة للارتفاعات الموسّعة والمصغّرة. (Idd677، b/306697446، b/229134133، b/268068946)

إصلاح الأخطاء

  • تلتزم أشرطة التطبيقات السفلية الآن بخدمة "استكشاف الشاشة باللمس" (مثل TalkBack) وتُبقيها مرئية عندما تكون الخدمة مفعّلة. (I4b34d)

الإصدار 1.4.0-alpha08

‫12 فبراير 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-alpha08. يتضمّن الإصدار 1.4.0-alpha08 هذه التعديلات.

الميزات الجديدة

  • تمت إضافة واجهة برمجة تطبيقات 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 أو تصغيرها. يطبّق الإصدار المزود بزر الإجراء الرئيسي (FAB) هذا الإعداد على الزر، بينما يطبّقه الإصدار غير المزود بزر الإجراء الرئيسي (FAB) على المحتوى الرئيسي. (I26420)
  • تلتزم FloatingToolbars الآن بخدمة استكشاف الشاشة باللمس (مثل TalkBack) وتُبقي شريط الأدوات موسّعًا ومرئيًا عندما تكون الخدمة مفعّلة. (I02172)
  • تم إصلاح عُطل في مؤشري التقدّم والتحميل في حال تم تمرير Float.NaN كتقدّم. (I4fa96، b/352364576)

الإصدار 1.4.0-alpha07

‫29 يناير 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-alpha07. يتضمّن الإصدار 1.4.0-alpha07 هذه التعديلات.

الميزات الجديدة

  • تمت إضافة المزيد من المرونة في تخصيص مظهر مربّعات الاختيار باستخدام واجهة برمجة تطبيقات جديدة. توفّر واجهة برمجة التطبيقات هذه مَعلمات 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) مرفقًا. توفر واجهة برمجة التطبيقات خيارات تخصيص مرنة، ما يتيح لك ترتيب شريط الأدوات أفقيًا أو عموديًا ووضع زر الإجراء الرئيسي (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)
  • SplitButton تغيير واجهة برمجة التطبيقات Shape من فئة البيانات إلى الفئة لتحقيق التوافق الثنائي (I53812)
  • تمت إضافة واجهة برمجة تطبيقات خاصة بتلميحات الأدوات تتضمّن المَعلمة onDismissRequest ليتمكّن المصمّمون من تحديد ما يحدث عندما ينقر المستخدم خارج تلميح الأداة. تم إيقاف واجهة برمجة التطبيقات القديمة التي لا تحتوي على هذه المَعلمة الجديدة. (I99aef)
  • تغيير اسم opticalCentering إلى horizontalCenterOptically جعل المعدِّل داخليًا استبدِل مَعلمة المساحة المتروكة بالحدّ الأقصى لإزاحة البدء والانتهاء. (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)
  • إضافة الإعدادات التلقائية للأحجام xSmall وmedium وlarge وxLarge إلى الإعدادات التلقائية لزر التبديل (Ie95d1)
  • أضِف الإعدادات التلقائية للأحجام xSmall وmedium وlarge وxLarge إلى الإعدادات التلقائية للأزرار. (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)
  • [Bottom Sheet] تغيير أولوية معاودة الاتصال إلى 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)
  • تمت إضافة عمليات تحميل زائدة جديدة للرمزين 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 وزر الإجراء الرئيسي (FAB) والمحتوى وشريط إعلام منبثق. (I5936b)
  • تم إصلاح مشكلة في DatePicker وDateRangePicker حيث لم تبدأ بعض عناصر التاريخ (مثل أسماء الأشهر) بحرف كبير في بعض اللغات والإعدادات المحلية وبعض تنسيقات الهياكل. (I1430f)
  • دمج رموز مكوّنات زر الإجراء الرئيسي (FAB) وقائمة زر الإجراء الرئيسي (FAB) (تعديلات مرئية بسيطة على المساحات المتروكة والنص) (Ib57f3)
  • يظهر العنصر ModalBottomSheet الآن أولاً في ترتيب التنقّل الدلالي، يليه عنصر scrim. (I436f9، b/358594665)
  • إصلاح مشكلة عدم اختفاء شريط التطبيق السفلي بالكامل عند التمرير تحت زر التنقّل في وضع "من الحافة إلى الحافة" (I3ee21)

الإصدار 1.3 من Compose Material3

الإصدار 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

مكوّنات جديدة في التصميم المتعدد الأبعاد 3

  • منصّة العرض الدوّارة
  • يتوافق [ModalBottomSheet] الآن مع ميزة "الرجوع التوقّعي" على الإصدارات الأحدث من Android (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)
  • تم تعديل الأدوار الأساسية لكل من Surface وSurface container قليلاً، ما يوفّر المزيد من التدرّج اللوني في المظهرين الفاتح والداكن. (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 هي false. (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. يجب أن يكون السلوك هو نفسه باستثناء القوائم القابلة للتركيز التي تحتوي على حقول نصية قابلة للتعديل والتي يمكن إغلاقها عند الكتابة على لوحة المفاتيح.

إصلاح الأخطاء

  • تم تعديل الأدوار الأساسية لكل من Surface وSurface container قليلاً، ما يوفّر المزيد من التدرّج اللوني في المظهرين الفاتح والداكن. (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)
  • وضع علامة على الدالة DatePickerformatWithSkeleton للإشارة إلى أنّها داخلية (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 مؤقتًا لإعادة استخدام واجهات برمجة التطبيقات rememberRipple / RippleTheme المتوقّفة نهائيًا في مكوّنات Material3. ستتم إزالة هذا الخيار في الإصدار الثابت التالي، وهو يهدف فقط إلى تقديم مساعدة مؤقتة في عملية نقل البيانات في الحالات التي تقدّم فيها 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

مكوّنات جديدة في التصميم المتعدد الأبعاد 3

تحسينات على مكوّنات التصميم المتعدد الأبعاد 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 الرجوع على الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث عند استخدام 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. (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 إلى content lambda اللاحقة. (I7f4d3)
  • اجعل الدالة الإنشائية لكل من ChipElevation وSelectableChipElevation متاحة للجميع. (Ie0c48، b/308432421)
  • جارٍ إضافة ModalBottomSheetProperties. جارٍ نقل securePolicy إلى ModalBottomSheetProperties جارٍ إضافة isFocusable وshouldDismissOnBackPress إلى ModalBottomSheetProperties تساعد قيمتا boolean الجديدتان في تحديد كيفية تعامل ورقة البيانات السفلية المشروطة مع أحداث IME. (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 مباشرةً. يمكن استخدام هذه الدوال كبديل للدالتَين المركّبتَين rememberDatePickerState و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 للسماح لزر الإجراء الرئيسي (FAB) بتراكب شريط التطبيق السفلي في البنية الأساسية بدلاً من تثبيته فوقه. (Iecb47)
  • تمت إضافة مكوّن "تصنيف" بسيط يستند إلى BasicTooltipBox ولا يتم إغلاقه عند النقر خارج حدود التصنيف. (I821f9)

إصلاح الأخطاء

  • تمت إزالة استخدام rememberSaveable لتلميحات الأدوات. (Icc131، b/299500338)
  • تم تقديم علامة مؤقتة للتحكّم في ما إذا كان يجب أن تقيس أداة Scaffold عناصرها الثانوية أثناء القياس أو أثناء التنسيق. سيتم قياس هذا الإجراء تلقائيًا. إذا كنت تواجه مشاكل في السلوك الجديد، يُرجى إبلاغنا بها. (I0b354)
  • تم إصلاح مشكلة "من الحافة إلى الحافة" الأفقية الثابتة في BottomSheet من خلال استخدام القياس الصحيح لعرض شاشة الجهاز. (I1df0c، b/299058752)
  • تم إصلاح الخطأ الذي لم يتم فيه استدعاء ModalBottomSheet إلى onDismissedRequest عند إغلاقه من خلال التمرير سريعًا للأسفل على الورقة. (Idfdd8)

الإصدار 1.2.0-alpha07

‫6 سبتمبر 2023

تم طرح androidx.compose.material3:material3-*:1.2.0-alpha07. يتضمّن الإصدار 1.2.0-alpha07 هذه التعديلات.

الميزات الجديدة

  • تمت إضافة ميزة "المحاذاة التلقائية للرموز" في الإصدار 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 أسفل إجراء التأكيد عندما تتراكب الإجراءات فوق بعضها البعض لتناسب عرض مربّع الحوار. يعمل هذا الإصلاح على مواءمة التنفيذ مع مواصفات "التصميم المتعدد الأبعاد". (I029de، b/235454277)
  • تم إصلاح الخطأ في ListItem الذي كان يستخدم مساحة متروكة غير صحيحة لعناصر من ثلاثة أسطر. (I6e235)
  • يمكن الآن عرض لوحة مفاتيح IME (Idc508، b/262140644، b/268380384، b/272483584)ModalBottomSheet

الإصدار 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

مكوّنات جديدة في التصميم المتعدد الأبعاد 3

تحسينات على مكوّنات التصميم المتعدد الأبعاد 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 لاختيار تاريخ واحد من خلال واجهة مستخدم تقويم لا تزال هذه الواجهة تخضع للتغييرات. (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 الآن على Lifecycle 2.5.1. (I05ab0، b/258038814)

الإصدار ‎1.1.0-alpha02

‫9 نوفمبر 2022

تم طرح androidx.compose.material3:material3:1.1.0-alpha02 وandroidx.compose.material3:material3-window-size-class:1.1.0-alpha02. يتضمّن الإصدار 1.1.0-alpha02 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • يقبل الآن كل من 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.

تخصيص المظهر في "التصميم المتعدد الأبعاد 3" والألوان الديناميكية في Material You

مكوّنات التصميم المتعدد الأبعاد 3

فئة حجم النافذة

  • ‫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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • لم تعُد عمليات إدراج المكوّنات التلقائية في مكوّنات Material 3 في الإصدار التجريبي 01 تأخذ في الاعتبار عمليات إدراج محرر أسلوب الإدخال (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 لإتاحة حالة قابلة للتحديد وفقًا لمواصفات التصميم المتعدد الأبعاد. إتاحة دعم إضافي في ألوان 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، وتزيل لامدا اللاحقة من BottomAppBar مع زر الإجراء العائم. (I92c47)
  • تضيف هذه السمة FilledIconButton وFilledTonalIconButton وOutlinedIconButton من Material3. (Ib2bda)
  • تعديل واجهة برمجة التطبيقات الخاصة بـ Material 3 Snackbar لقبول قيم الألوان للإجراء الاختياري وإجراء الرفض (Ibe4b4)
  • تم إيقاف ميزة الاستهلاك الجزئي (التنزيل أو الموضع) نهائيًا في PointerInputChange. يمكنك استخدام consume() لاستهلاك التغيير بالكامل. يمكنك استخدام isConsumed لتحديد ما إذا كان مستخدم آخر قد استهلك التغيير من قبل أم لا.
  • تنشئ الدالة PointerInputChange::copy() الآن نسخة سطحية دائمًا. وهذا يعني أنّه سيتم استخدام نُسخ PointerInputChange بعد استخدام إحدى النُسخ. إذا أردت إنشاء PointerInputChange غير مرتبط، استخدِم الدالة الإنشائية بدلاً من ذلك. (Ie6be4، b/225669674)
  • تغييرات على Cards API لتلقّي ألوان الحاوية والمحتوى من خلال واجهة CardColors، ولإتاحة حالة غير مفعّلة للبطاقات القابلة للنقر (I927df)
  • تمت إعادة تسمية المَعلمة backgroundColor إلى containerColor في حقول النص Material 3 لتحسين الاتساق مع المكوّنات الأخرى. (I6fbd9)

إصلاح الأخطاء

  • تعديلات على IconButton العادي لمواءمته مع مواصفات Material3‏ (I09eab)
  • نقل ارتفاع الشريط العلوي لـ Material3 Scaffold إلى المساحة المتروكة التي تم تمريرها إلى المحتوى، ما يسمح بعرض المحتوى أسفل شريط التطبيق العلوي في حال تم تجاهل PaddingValues، قد يتم حجب المحتوى بواسطة الشريط العلوي. (I83cbc، b/217776202)

الإصدار ‎1.0.0-alpha09

‫6 أبريل 2022

تم طرح androidx.compose.material3:material3:1.0.0-alpha09. يتضمّن الإصدار 1.0.0-alpha09 هذه التعديلات.

الميزات الجديدة

  • تمت إضافة واجهة برمجة تطبيقات Material 3 Switch (I2c3ad)

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة إمكانية استخدام القوائم المنسدلة مع حقول النص (المعروفة أيضًا باسم "القوائم المنسدلة المكشوفة" أو "مربّعات التحرير والسرد"). (I1b832)
  • تمت إضافة مَعلمة الشكل إلى MaterialTheme ونظام الشكل الفرعي. (I37426)
  • تمت إضافة مَعلمة موسّعة إلى ExtendedFloatingActionButton للتحكّم في ما إذا كان سيتم توسيع زر الإجراء الرئيسي (FAB) أو تصغيره، مع إضافة رسوم متحركة بين كل حالة. تمت إضافة تحميل زائد لزر الإجراء العائم الموسّع من أجل أزرار الإجراء العائم الموسّعة التي تتضمّن نصًا لاحقًا لأزرار الإجراء العائم الموسّعة بدون رمز. (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 هذه التعديلات.

الميزات الجديدة

تمت إضافة مكوّنات التصميم المتعدد الأبعاد 3

تغييرات واجهة برمجة التطبيقات

  • الدالة Surface المتوقّفة نهائيًا والتي تستخدم onClick callback. يجب إنشاء المساحات القابلة للنقر باستخدام InteractionSource وModifier.clickable(). (I211c6)
  • تمت إضافة دعم الارتفاع عند الضغط على زر الإجراء الرئيسي (FAB) أو التركيز عليه. (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 هذه التعديلات.

الميزات الجديدة

  • إضافة إمكانية استخدام مربّع الاختيار وزر الاختيار
  • تم تعديلها لتكون متوافقة مع الإصدار 1.6.0 من Kotlin

تغييرات واجهة برمجة التطبيقات

  • إزالة الدرج من بنية 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 هذه التعديلات.

الميزات الجديدة

تخصيص المظهر في "التصميم المتعدد الأبعاد 3" والألوان الديناميكية في Material You

مكوّنات التصميم المتعدد الأبعاد 3

لمزيد من المعلومات، يُرجى الاطّلاع على قسم Material Design 3 وMaterial You في دليل "تخصيص التصميم المتعدد الأبعاد في Compose".