‫Compose Material 3

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

البنية

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

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

مجموعةالوصف
compose.animationإنشاء رسوم متحركة في تطبيقات Jetpack Compose لإثراء تجربة المستخدم
compose.compilerتحويل دوال ‎ @Composable وتفعيل عمليات التحسين باستخدام مكوّن إضافي لمترجم Kotlin
compose.foundationيمكنك كتابة تطبيقات Jetpack Compose باستخدام وحدات أساسية جاهزة للاستخدام وتوسيع نطاق الأساس لإنشاء أجزاء نظام التصميم الخاص بك.
compose.materialيمكنك إنشاء واجهات مستخدم Jetpack Compose باستخدام "مكوّنات Material Design" الجاهزة للاستخدام. هذه هي نقطة الدخول ذات المستوى الأعلى في Compose، وهي مصمَّمة لتوفير مكوّنات تتطابق مع تلك الموضّحة في www.material.io.
compose.material3يمكنك إنشاء واجهات مستخدم Jetpack Compose باستخدام "مكوّنات Material Design 3"، وهي التطوّر التالي في Material Design. يتضمّن الإصدار 3 من Material تصميمات ومكوّنات محدّثة وميزات تخصيص Material You، مثل الألوان الديناميكية، وهو مصمّم ليكون متوافقًا مع الأسلوب المرئي الجديد وواجهة مستخدم النظام في Android 12.
compose.runtimeالوحدات الأساسية لنموذج برمجة Compose وإدارة الحالة، ووقت التشغيل الأساسي الذي يستهدفه مكوّن Compose الإضافي للمترجم.
compose.uiالمكوّنات الأساسية لواجهة مستخدم Compose اللازمة للتفاعل مع الجهاز، بما في ذلك التنسيق والرسم والإدخال

تحديد الاعتماديات

لإضافة اعتمادية على Compose، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

رائع

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

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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-alpha07")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات البناء.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 1.0 من Compose Material3 Common

الإصدار 1.0.0-alpha01

‫17 أبريل 2024

تم إصدار androidx.compose.material3:material3-common:1.0.0-alpha01 وandroidx.compose.material3:material3-common-android:1.0.0-alpha01 وandroidx.compose.material3:material3-common-desktop:1.0.0-alpha01. يتضمّن الإصدار 1.0.0-alpha01 هذه التعديلات.

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

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

‫Compose Material3 Adaptive Navigation Suite الإصدار 1.0

الإصدار 1.0.0-alpha07

‫1 مايو 2024

تم إصدار androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07 وandroidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07 وandroidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07. يتضمّن الإصدار 1.0.0-alpha07 هذه التعديلات.

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

  • إيقاف التجريب لواجهات برمجة التطبيقات الخاصة بحزمة أدوات التنقّل (If62af)

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

  • استخدام هوامش داخلية للمحتوى تلقائيًا (50266df)

الإصدار 1.0.0-alpha06

‫17 أبريل 2024

تم إصدار androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06 وandroidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06 وandroidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06. يتضمّن الإصدار 1.0.0-alpha06 هذه التعديلات.

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

  • أضِف containerColor وcontentColor إلى NavigationSuiteScaffoldDefaults. (I64e3a، b/331993720)
  • إضافة الدالة itemColors إلى NavigationSuiteDefaults (Idf719، b/328480012)
  • تأكَّد من إغلاق NavigationSuiteScope بإحكام. (Iefa57)

الإصدار 1.0.0-alpha05

‫6 مارس 2024

تم إصدار androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05 وandroidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05 وandroidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05. يتضمّن الإصدار 1.0.0-alpha05 هذه التعديلات.

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

  • اجعل الدالة الإنشائية NavigationSuiteItemColors عامة. (Ica83a، b/324886877)

الإصدار 1.0.0-alpha04

‫21 فبراير 2024

تم إصدار androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04 وandroidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04 وandroidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04. يتضمّن الإصدار 1.0.0-alpha04 هذه التعديلات.

تحديثات الاعتماديات

  • عدِّل التبعيات المتكيّفة في Material3 لتتوافق مع مسارات الوحدات الجديدة. (Ibc421)
  • انتقِل إلى استخدام إصدار Window Manager من فئات أحجام النوافذ. (I3794d)

الإصدار 1.0.0-alpha03

‫7 فبراير 2024

تم إصدار androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03 وandroidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03 وandroidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03. يتضمّن الإصدار 1.0.0-alpha03 هذه التعديلات.

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

  • تعديل اسم الحزمة إلى navigationsuite بدلاً من navigation-suite (I7eff7)
  • تم تعديل مكوّنات Material3 التي تعرض MutableInteractionSource في واجهة برمجة التطبيقات لتصبح تعرض الآن MutableInteractionSource قابلاً للقيم الخالية، ويتم ضبط القيمة التلقائية على "قيمة فارغة". لا توجد تغييرات دلالية هنا: يعني تمرير قيمة فارغة أنّك لا تريد نقل 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 adaptive pane scaffold:

Compose Material3 الإصدار 1.5

الإصدار 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 الموسّع في حال عدم توفّر أي نقاط ربط أخرى. (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)

Compose Material3 الإصدار 1.4

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

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

لمزيد من المعلومات: 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)

مكوّنات جديدة في Material Design 3

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

الإصدار 1.4.0-alpha07

‫29 يناير 2025

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

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

  • تمت إضافة المزيد من المرونة في تخصيص مظهر مربّعات الاختيار باستخدام واجهة برمجة تطبيقات جديدة. توفّر واجهة برمجة التطبيقات هذه مَعلمات Stroke التي تتيح تحكّمًا أكبر في طريقة عرض علامة الاختيار ومخطّط مربّع الاختيار. (I65a88)
  • تمت إضافة واجهة برمجة التطبيقات TwoRowsTopAppBar، وهي بديل أكثر قابلية للتخصيص لشريطَي التطبيق المتوسط والكبير لإنشاء أشرطة تطبيق علوية تتضمّن صفَّين. يمكن للمطوّرين الآن التحكّم في محتوى العناوين والعناوين الفرعية في كلّ من الحالتَين المصغّرة والموسّعة، مع إمكانية تخصيص الارتفاعات لكل حالة. (I0be3c، b/306697446، b/229134133، b/268068946)

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

  • تمت إعادة تسمية أحد أشكال BottomAppBar التجريبية إلى FlexibleBottomAppBar، ما يتيح المزيد من التحكّم في ترتيب المحتوى وارتفاعه. (Iaa448)
  • تعديل تسمية الخصائص في الكائن التلقائي لمجموعة الأزرار لتصبح CapitalCase عدِّل اسم animateFraction ليكون أكثر دقةً في وصف السلوك الذي يمثّله. (I545cd)
  • إضافة عمليات تحميل زائدة للأزرار الشائعة التي تسمح بأشكال متحركة عند التفاعل بالضغط تمت إضافة أشكال الأزرار المخزّنة مؤقتًا. (I5ec20)
  • يمكنك الآن التحكّم في طريقة تفاعل FloatingToolbar مع زر الإجراء العائم عند التمرير من خلال توفير FloatingToolbarScrollBehavior. بالنسبة إلى أشرطة الأدوات الموضوعة على طول حافة مركزية (مثل أعلى أو أسفل المركز)، ننصحك باستخدام سلوك التمرير لإخفاء المكوّن بأكمله عند التمرير للحصول على مظهر أكثر أناقة. يمنع ذلك أيضًا ظهور الزر العائم خارج المركز، وهو ما قد يحدث عند استخدام العلامة expanded لتصغير الزر. (I33f67)
  • تعديل واجهات برمجة التطبيقات التجريبية TopAppBar لاستخدام Alignment.Horizontal بدلاً من TopAppBarTitleAlignment مخصّص عند ضبط محاذاة العنوان والعنوان الفرعي (I70ca2)
  • أصبحت SliderState#onValueChange متاحة للجميع الآن لمنح المستخدم المزيد من التحكّم (I104eb)
  • أضِف NavigationSuiteScaffoldState للسماح بتحريك مكوّن التنقّل. يجب أيضًا تقديم عمليات تحميل زائدة للدالتَين NavigationSuiteScaffold وNavigationSuiteScaffoldLayout تتضمّن مَعلمة حالة. (I6a8c9، b/328674235)

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

  • نقل الصفَّين IconButtonColors وIconToggleButtonColors من IconButtonDefaults.kt إلى IconButton.kt (I3c233)

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

  • أصبحت SliderState#isDragging متاحة للجميع. (I8458a)

الإصدار 1.4.0-alpha06

‫15 يناير 2025

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

تغيير السلوك

  • تمت إضافة displayCutout إلى مجموعة الحواف الداخلية التي تأخذها مكونات Material في الاعتبار تلقائيًا، وذلك لتجنُّب تداخل المحتوى مع فتحة الشاشة. هذا تغيير في السلوك سيؤثّر في طريقة عمل المكوّنات التي تتوافق مع الحواف الداخلية حول فتحة شاشة العرض. ويشمل ذلك القيمة التلقائية للمَعلمة WindowInsets لمكوّنات Material 3 التي تتوافق مع الحواف الداخلية، وقيم WindowInsets المقدَّمة في عناصر Defaults للمكوّنات لكل من Material 2 وMaterial 3. إذا تسبّب هذا التغيير في سلوك غير مرغوب فيه، حدِّد المَعلمة WindowInsets يدويًا على أساس كل مكوّن على حدة. (I43ee9، b/362508045)

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

  • تعديلات على واجهة برمجة التطبيقات TopAppBar أعِد تسمية أشرطة التطبيقات العلوية المتوسطة والكبيرة باستخدام عنوان فرعي *FlexibleTopAppBar. تم توحيد أشكال الألوان في دالة TopAppBarDefault.topAppBarColors() واحدة، وتمت إضافة مَعلمة اللون subtitle ليتم تطبيقها على عنصر Composable للترجمة والشرح المقدَّم (I41b65)
  • إزالة واجهة برمجة التطبيقات WideNavigationRailArrangement واستخدام Arrangement.Vertical بدلاً منها (Id0341)
  • أضِف VerticalSlider @Composable جديدًا. (I2bfba)
  • أضِف مسارًا جديدًا @Composable يتيح تحديد زوايا مسار خارجي مخصّص ورموز المسار. (I436a4)
  • عدِّل واجهات برمجة التطبيقات الخاصة بشريط الأدوات العائم لاستخدام العنصر FloatingToolbarColors بدلاً من لون حاوية واحد. (I9a054)
  • إضافة تعليق توضيحي تجريبي جديد واستخدامه ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)
  • يأخذ Modifier.indicatorLine الآن شكلاً للحقل النصي من أجل التعامل مع الاقتصاص. (I8c5f3، b/380704151)
  • إعادة تسمية الدوال التجريبية FloatingAppBar إلى FloatingToolbar (I1dbf8)
  • تمت إضافة floatingToolbarVerticalNestedScroll جديد يمكن إرفاقه بحاوية قابلة للتمرير لتعديل حالة توسيع شريط الأدوات العائم استنادًا إلى حركة تمرير تتجاوز حدًا معيّنًا. (I6d65f)
  • نقدّم لك واجهة برمجة تطبيقات جديدة لإنشاء شريط أدوات عائم يتضمّن زرّ إجراء رئيسي (FAB). توفر واجهة برمجة التطبيقات خيارات تخصيص مرنة، ما يتيح لك ترتيب شريط الأدوات أفقيًا أو عموديًا ووضع زر الإجراء العائم في بداية شريط الأدوات أو نهايته. (I9e350)

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

  • تم إصلاح مشكلة في إمكانية الوصول إلى Snackbar كانت تؤدي إلى الإعلان عن نفسه عند إغلاقه عندما يكون TalkBack مفعّلاً. (/I9db53)

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

  • تم توحيد BasicTooltip في Foundation وBasicTooltip/Tooltip في Material3. (Ifc2e6)

الإصدار 1.4.0-alpha05

‫12 ديسمبر 2024

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

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

  • استبدال النوع في قيمة WideNavigationRailState.current/target لقيمة تعدادية من أجل تحسين إمكانية القراءة (I2d6ab)
  • تم إجراء تغيير على واجهة برمجة التطبيقات Shape من فئة البيانات إلى الفئة لتحقيق التوافق الثنائي.SplitButton (I53812)
  • تمت إضافة واجهة برمجة تطبيقات خاصة بتلميحات الأدوات تتضمّن المَعلمة onDismissRequest ليتمكّن المصنّعون من تحديد ما يحدث عندما ينقر المستخدم خارج تلميح الأداة. تم إيقاف واجهة برمجة التطبيقات القديمة التي لا تحتوي على هذه المَعلمة الجديدة. (I99aef)
  • تغيير اسم opticalCentering إلى horizontalCenterOptically جعل المعدِّل داخليًا استبدِل مَعلمة padding بالحدّ الأقصى لإزاحة البدء والانتهاء. (I0b904)
  • غيِّر WideNavigationRailState ليتضمّن القيمة الحالية/المستهدَفة، وأزِل التعدادات لصالح القيمة المنطقية. (Idfa29، b/356039090)
  • أضِف NavigationBarItemComponentOverride. (I3a06a)

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

  • إصلاح سلوكَي شريطَي التطبيق العلوي والسفلي لتغيير اللون بشكل موثوق عند التنقّل في المحتوى بالكامل (Idc4e8، b/293665988)
  • تعرض الآن دوال سلوك التمرير لأشرطة التطبيقات العلوية والسفلية سلوكًا محفوظًا لتحقيق أداء أفضل في عمليات إعادة الإنشاء. (I0fdbe، b/207957336)
  • يتم الآن تطبيق مَعلمة المعدِّل بعد المعدِّلات الداخلية، مثل سلوك السحب والدلالات، بدلاً من تطبيقها قبل ذلك. يؤثر ذلك في ترتيب تطبيق المعدِّلات. (I8d83f)
  • تظل البطاقة السفلية الموسّعة موسّعة عند تغيير الحجم. (I2870b، b/324934884)
  • توجيه علامات شريط الحالة وشريط التنقّل بشكل صحيح لخصائص النوافذ (Ie674d، b/362539765)
  • نقل مَعلمة المعدِّل إلى جذر هياكل التعليمات البرمجية، كما هو موضّح في المستندات يتوافق ذلك مع عملية التنفيذ في الإصدار M2. (I0235e، b/372311595)

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

  • دالة DatePickerDialog الشائعة (I7dced)

الإصدار 1.4.0-alpha04

‫13 نوفمبر 2024

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

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

  • إعادة تغييرات الألوان التي تم تقديمها في aosp/3212478 إلى iconButtonColors وiconToggleButtonColors وoutlinedIconButtonColors وoutlinedIconToggleButtonColors وoutlinedIconToggleButtonBorder تم نقل السلوك الذي تمّت إعادته الآن إلى مجموعة جديدة من الدوال باسم iconButtonVibrantColors وما إلى ذلك للتأكيد على ألوان التباين العالي التي يتم عرضها. (Iffd8d)

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

  • إضافة مكوّن VerticalDragHandle (I6c770)

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

  • تمّت إعادة تسمية DismissibleModalWideNavigationRailDefaults إلى ModalWideNavigationRailDefaults. (I8e877)
  • أضِف NavigationBarComponentOverrides. (I8a3f3)
  • أضِف NavigationRailComponentOverride. (I83e13)
  • إضافة WideNavigationRailState للتعامل مع تصغير/توسيع الشريط الجانبي، والسماح بإغلاق ModalWideNavigationRail وحذف DismissibleModalWideNavigationRail (I88568)
  • إضافة الإعدادات التلقائية للأحجام 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 في Scaffold لتجنُّب إعادة إنشاء محتوى النص الأساسي دائمًا عند تغيير contentPadding (I8c8e2، b/373904168)
  • تمت إعادة تسمية TextFieldLabelScope progress إلى labelMinimizedProgress
  • تمت إعادة تسمية TextFieldLabelPosition Default إلى Attached. تمت إزالة عناصر الواجهة. (If75c6)
  • تم إصلاح مشكلة في DatePicker في وضع الإدخال حيث يمكن أن تتسبب أخطاء التحقّق من الصحة في تغيير ارتفاع المكوّن. (I2e229، b/280462363)
  • اجعل شريط التمرير Material Slider يغيّر قيمته عند الضغط على مفاتيح التحكّم. (I1c442)

الإصدار 1.4.0-alpha02

‫16 أكتوبر 2024

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

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

  • تعديلات على أدوات اختيار التاريخ لضمان استخدام اللغة نفسها في جميع أنحاء DatePicker وDateRangePicker عند ضبط اللغة مباشرةً من خلال DatePickerState أو DateRangePickerState يُرجى العِلم أنّه عند ضبط اللغات مباشرةً على الحالة، يعود إليك التأكّد من ترجمة نصوص العنوان والمانشيت وفقًا لذلك، لأنّه سيتم تطبيق النص التلقائي وفقًا للغة التلقائية للمنصة. (I37073، b/326490763، b/321657276)
  • تم الآن عرض SheetState.isAnimationRunning. (I9a3d7)
  • DatePickerColors الآن لها الأولوية بشكل صحيح على أي ألوان غير متوافقة تم تحديدها في أنماط نص أسلوب الخط في التصميم. يُرجى العِلم أيضًا أنّ هذا التعديل يغيّر موضع المَعلمة color في وظائف أداة اختيار التاريخ ويضيف المَعلمة contentColor لتخصيص ألوان نص العنوان والعنوان الرئيسي. (I30d03، b/347031394)
  • أعِد تسمية SplitButton إلى SplitButtonLayout وأزِل واجهات برمجة التطبيقات لخيارات اللون SplitButton، وسيتم تحقيق الخيارات من خلال إعادة استخدام خيارات الأزرار التي توفّرها SplitButtonDefaults. (I44c36)
  • تتضمّن السمة ModalBottomSheet الآن المَعلمة sheetGestureEnabled (I856cb، b/288211587)
  • تمت إعادة تسمية standardMotionScheme وexpressiveMotionScheme إلى "معياري" و"تعبيري". يمكن الآن الوصول إلى كلتا الدالتين من خلال العنصر المرافق MotionScheme عن طريق استدعاء MotionScheme.standard() وMotionScheme.expressive(). (Iceccf)
  • إضافة المَعلمة maxWidth إلى تلميحات الأدوات العادية والغنية ويتم ضبط القيمة التلقائية على مواصفات التصميم البالغة 200 وحدة بكسل مستقل الكثافة (dp) لتلميحات الأدوات العادية و320 وحدة بكسل مستقل الكثافة لتلميحات الأدوات المنسّقة. (I30ce9)

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

  • يعدّل العنصران DatePicker وDateRangePicker الآن الشهر المعروض بشكل صحيح عند ضبطهما من خلال displayedMonthMillis الخاص بحالتهما. (If9e47، b/333414302)
  • ينقل محتوى ModalBottomSheet الآن المحتوى بعيدًا عن شريط الحالة. (I5114c، b/321877275، b/336962418، b/342093067)
  • [ورقة في أسفل الشاشة] تغيير أولوية معاودة الاتصال إلى PRIORITY_DEFAULT للسماح بإغلاق لوحة مفاتيح IME أولاً (I447fb)
  • إصلاح الأعطال في DatePicker وDateRangePicker عند ضبط الحد الأدنى للسنة القابلة للاختيار على سنة مستقبلية (I78656، b/319395747)
  • تم إصلاح مشكلة في أداة اختيار التاريخ لتعديل واجهة المستخدم عند تطبيق نسخة معدَّلة من SelectableDates. (Iad59a، b/290135807، b/339898760)

الإصدار 1.4.0-alpha01

‫2 أكتوبر 2024

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

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

  • لم تعُد المكتبة تضيف تبعية إلى material-icons-core، لذا إذا كان مشروعك يعتمد على ذلك، عليك إضافة هذه التبعية بشكل صريح في ملفات build.gradle[.kts]. (I735ff، b/349894318)
  • يتغيّر لون التصنيف النشط في NavigationBarItem وNavigationRailItem من onSurface إلى secondary لتحسين سهولة الاستخدام وتباين الألوان وتحسين التماسك داخل النظام (Ibc297). للرجوع إلى السلوك السابق، انسخ الألوان التلقائية وغيِّر selectedTextColor إلى MaterialTheme.colorScheme.onSurface.
  • تستخدم مكوّنات Material 3 الآن MotionScheme الجديدة لتحديد الحركة. (Ie0f93)
  • تغييرات في حركة مؤشر التقدم الدائري غير المحدّد (I3c07e)
  • عدِّل OutlinedIconButtonColors وOutlinedIconToggleButtonColors للحصول على تباين أفضل في الألوان. (I2743d)
  • تم تعديل لون الحاوية والمحتوى لكل من FilledIconToggleButtonColors وFilledTonalIconToggleButtonColors. (Ic5d0f)
  • تم تعديل لون حدود OutlinedButton من outline إلى outlineVariant. (057f00)

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

  • تمت إضافة المَعلمة الاختيارية reverseLayout إلى الدالة enterAlwaysScrollBehavior في TopAppBar من أجل توفير دعم أفضل للمحتوى الذي تم ضبطه باستخدام reverseLayout. (I4e0e5)
  • تتيح SegmentedButton الآن استخدام وسيطة contentPadding. (I5ad91، b/358414376)
  • لم يعُد PullToRefreshState يتضمّن عملية تنفيذ تلقائية للسمة isAnimating (I6a593)
  • تمت إضافة عمليات تحميل زائدة جديدة للدالتين Material TextField وOutlinedTextField اللتين تستخدمان TextFieldState. تمت إضافة واجهات برمجة تطبيقات مربّعات الزخرفة المتوافقة مع TextFieldDecorator. (If13a1)
  • تمت إضافة مَعلمة للتحكّم في labelPosition حقل النص. يتيح استخدام alwaysMinimize نمط واجهة المستخدم لعرض تصنيف وعنصر نائب في حقل نصي في الوقت نفسه حتى عندما يكون الحقل غير مركّز عليه. (I1ef2c)
  • تمت إضافة المادتَين SecureTextField وOutlinedSecureTextField لحقول إدخال كلمة المرور. (I7e22d)
  • تمت إضافة نطاق إلى تصنيفات حقول النص للاستعلام عن تقدّم الحركة. (If5ec8)
  • إضافة دعم لـ MotionEvent.CLASSIFICATION_DEEP_PRESS في تلميحات الأدوات (I62e6a)
  • أصبح isAfternoon الخاص بـ "TimePickerState" الآن قيمة إضافية بدلاً من متغيّر في الواجهة، وتمت إعادة تسميته إلى isPm (I89a97)
  • تعديل فئة أسلوب الخط لتتوافق مع مقاييس الخطوط المميزة (Ifa13c)
  • تمت إضافة واجهة برمجة التطبيقات ModalWideNavigationRail وإعادة تسمية واجهات برمجة التطبيقات ModalExpandedNavigationRail إلى DismissibleModalWideNavigationRail. (Ic9118)
  • تم تعديل FloatingAppBarScrollBehavior لاحتساب screenOffset تلقائيًا وعدم طلب @Composable. (Idf349)
  • تعديلات على واجهة برمجة التطبيقات LoadingIndicator لإصلاح التسمية في العنصر التلقائي. تمت إضافة ثابت LoadingIndicatorElevation في PullToRefresh. (I1d72b)
  • تعديلات على واجهة برمجة التطبيقات LoadingIndicator لإصلاح التسمية في العنصر التلقائي. تمت إضافة ثابت LoadingIndicatorElevation في PullToRefresh. (I1d72b)
  • تمت إضافة المَعلمتَين amplitude وwaveSpeed إلى الصيغ غير المحدّدة من LinearWavyProgressIndicator وCircularWavyProgressIndicator. (I2a0c5)
  • إتاحة تغيير شكل زر التبديل بين الرمزين استنادًا إلى حالته عند الضغط عليه أو تحديده (Ibc781)
  • تعديل فئة أسلوب الخط لتتوافق مع مقاييس الخطوط المميزة (Ifa13c)
  • تتغيّر أشكال SplitButton بناءً على الحالة التلقائية أو حالة الضغط. تمت إزالة واجهة برمجة التطبيقات AnimatedTrailingButton لأنّ واجهة برمجة التطبيقات TrailingButton يمكنها تقديم عمليات التخصيص نفسها (I95066)
  • أضِف معدِّلاً لتحريك عملية إظهار وإخفاء الزرّ العائم، مثلاً عند تمرير المحتوى. (I8338d)
  • إضافة أشكال ومسافات مجموعة الأزرار المتصلة إلى ButtonGroupDefaults لاستخدامها في عيّنة (I68e30)
  • إضافة مساحة متروكة أفقية للزر الأخير في الزر المنقسم وتفعيل التوسيط المرئي المحسوب من اختلافات الزوايا في البداية والنهاية (I122e2)
  • نقدّم عنصر Material MotionScheme جديدًا للسماح بضبط مخطط لحركة المكوّن. يتم ضبط المخطط من خلال MaterialTheme. (Id50c2)

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

  • تطبيق فهرس التنقّل الصحيح للتركيز على العناصر الفرعية Scaffold القابلة للإنشاء الترتيب هو topBar وbottomBar والزر العائم والزر العائم والوجبة الخفيفة. (I5936b)
  • تم إصلاح مشكلة في DatePicker وDateRangePicker حيث لم تبدأ بعض عناصر التاريخ (مثل أسماء الأشهر) بحرف كبير في بعض اللغات والأنماط. (I1430f)
  • دمج رموز مكوّنات زر الإجراء الرئيسي (FAB) وقائمة زر الإجراء الرئيسي (تعديلات مرئية بسيطة على المساحات المتروكة والنص) (Ib57f3)
  • يظهر العنصر ModalBottomSheet الآن أولاً في ترتيب التنقّل الدلالي، يليه عنصر scrim. (I436f9، b/358594665)
  • إصلاح مشكلة عدم اختفاء شريط التطبيق السفلي بالكامل عند التمرير تحت زر التنقّل في وضع "من الحافة إلى الحافة" (I3ee21)

‫Compose Material3 الإصدار 1.3

الإصدار 1.3.2

‫9 أبريل 2025

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

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

  • تعمل السمة ListItem على تصحيح عملية احتساب الارتفاع الداخلي، وتوفّر الآن المساحة المناسبة في Layout.
  • إزالة المساحة الزائدة حول التصنيف NavigationBarItem، مع المحاذاة بشكل صحيح وفقًا للمواصفات
  • يصحّح تخطيط TabRow في وضع العرض من اليمين إلى اليسار.

الإصدار 1.3.1

‫30 أكتوبر 2024

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

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

  • يعدّل العنصران DatePicker وDateRangePicker الآن الشهر المعروض بشكل صحيح عند ضبطهما من خلال displayedMonthMillis الخاص بحالتهما. (If9e47، b/333414302)
  • إصلاح الأعطال في DatePicker وDateRangePicker عند ضبط الحد الأدنى للسنة القابلة للاختيار على سنة مستقبلية (I78656، b/319395747)
  • تم إصلاح مشكلة في أداة اختيار التاريخ لتعديل واجهة المستخدم عند تطبيق نسخة معدَّلة من SelectableDates. (Iad59a، b/290135807، b/339898760)
  • تغيير أولوية معاودة الاتصال المستخدَمة في الأوراق السفلية إلى PRIORITY_DEFAULT للسماح للوحة مفاتيح IME بإغلاقها أولاً (I447fb)

الإصدار 1.3.0

‫4 سبتمبر 2024

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

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

الميزات الرئيسية في الإصدار 1.3.0

مكوّنات جديدة في Material Design 3

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

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

  • تم تعديل الأدوار الأساسية لكل من "السطح" و"حاوية السطح" قليلاً، ما يوفّر المزيد من التدرّج اللوني في المظهرين الفاتح والداكن. (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

مكوّنات جديدة في Material Design 3

تحسينات على مكوّنات Material Design 3 الحالية

تمت ترقية واجهات برمجة التطبيقات التجريبية إلى إصدار ثابت

تحسينات على الأداء

الإصدار 1.2.0-rc01

‫24 يناير 2024

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

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

  • تم إصلاح خطأ ترتيب المَعلمات mediumTopAppBarColors. (Ibe64a)
  • تم إصلاح خطأ تم تقديمه في 1.2.0-beta02 في CardDefaults.cardColors ولم يتم تعديل contentColor استنادًا إلى قيمة المَعلمة containerColor. (Iee041، b/319671246)
  • تم إصلاح خطأ في disabledContentColor تم تقديمه في 1.2.0-beta02 وإضافة تحسين بسيط. (I6dda1، b/318428829)

الإصدار 1.2.0-beta02

‫10 يناير 2024

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

خطأ معروف

  • سيؤدي خطأ في IconButtonColors تلقائيًا إلى تعيين disabledContentColor إلى قيمة ألفا (0.38f) تبلغ LocalContentColor بدلاً من contentColor التي يحددها المستخدم. الحلّ البديل هو ضبط disabledContentColor بشكلٍ صريح. سيتم حلّ هذه المشكلة في الإصدار التالي.

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

  • إضافة إمكانية تفعيل علامات الإقحام الخاصة بتلميحات الأدوات لواجهات Plain Tooltip API. (Ibf767)
  • تمت إعادة تسمية SwipeToDismissState وrememberSwipeToDismiss وSwipeToDismissValue لتتضمّن _SwipeToDismissBox_. (I68d6d)

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

  • تم إصلاح قيمة مساحة الحشو في نهاية ListItem لتتوافق مع المواصفات. (Ibd68b، b/305342674)
  • تم الآن ربط لون المخطط التفصيلي للبطاقة ذات المخطط التفصيلي بشكل صحيح بالسمة OutlineVariant. (I75480، b/310979715)
  • تستند ميزة "الألوان الديناميكية" الآن إلى أدوار الألوان المحدّدة في النظام. يؤدي ذلك إلى تحسين التباين للمحتوى الذي يسهل الوصول إليه، كما أنّه يربط اللون الديناميكي بمواصفات Material بشكل أوثق. (I1de96)
  • تم إصلاح مشكلة التعامل مع زر ModalBottomSheet في نظام التشغيل Android T/13 والإصدارات الأحدث عند استخدام android:enableOnBackInvokedCallback="true". (I728dc، b/306196110)

الإصدار 1.2.0-beta01

‫13 كانون الأول (ديسمبر) 2023

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

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

  • وضع علامة "تجريبي" على TabIndicatorScope (I45c88)
  • إزالة واجهات برمجة التطبيقات التجريبية المتوقّفة للأدوات المنبثقة (I438cb)
  • تغيير عمليات التحميل الزائد الجديدة في TabRow لعدم استخدام التركيبات الفرعية يؤدي ذلك إلى طريقة مختلفة لإنشاء مؤشرات TabRow باستخدام المعدِّلات المخصّصة المقدَّمة. (Ife741)
  • إيقاف واجهتَي برمجة التطبيقات DismissDirection وDismissValue نهائيًا تم دمجها في SwipeToDismissValue، وتشير قيمه إلى كل من موضع SwipeToDismissBox واتجاهه. تم الآن وضع علامة FloatRange على DismissState.progress، ويبلغ سعره بين 0.0 و1.0. تمت الآن إزالة الدالتَين المتوقّفتَين DismissState Saver وConstructor. تمت إعادة تصنيف المكوّن SwipeToDismiss وكائن الحالة والقيم التلقائية على أنّها تجريبية. (Ib54f2)

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

  • مؤشر PullToRefresh التلقائي هو الآن رأس سهم مفتوح بدلاً من مثلث مصمت. (I67be3)

الإصدار 1.2.0-alpha12

‫29 نوفمبر 2023

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

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

  • يأخذ RangeSlider الآن نطاق Kotlin (على سبيل المثال، 0f..1f) بدلاً من فئة قيمة FloatRange مخصّصة. يستخدم SnapFlingBehavior.kt الآن أيضًا نطاق Kotlin. (I025cb)
  • وضع العلامة @Stable على دوال إنشاء أدوات التعديل في Mark Modifier (Ib109f)

الإصدار 1.2.0-alpha11

‫15 تشرين الثاني (نوفمبر) 2023

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

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

  • تنفِّذ هذه الفئة PullToRefreshContainer وPullToRefreshState، اللتين توفّران معًا عملية سحب لإعادة التحميل في Material3. (I16456، b/261760718)

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

  • ضَع علامة "تجريبي" على SwipeToDismissBox وDismissDirection وDismissValue. (I517b0)
  • تمّت إعادة تسمية SwipeToDismiss إلى SwipeToDismissBox. أعِد تسمية background إلى backgroundContent وdismissContent إلى 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 للسماح لزر الإجراء العائم بتراكب شريط التطبيق السفلي في الهيكل بدلاً من تثبيته فوقه. (Iecb47)
  • تمت إضافة مكوّن Label بسيط يستند إلى BasicTooltipBox ولن يتم إغلاقه عند النقر خارج حدود التصنيف. (I821f9)

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

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

الإصدار 1.2.0-alpha07

‫6 سبتمبر 2023

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

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

  • تمت إضافة ميزة "انعكاس الرموز تلقائيًا" في الإصدار compose material 1.6.0-alpha05. يُرجى الاطّلاع على ملاحظات الإصدار لمعرفة تفاصيل حول هذه الميزة.

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

  • SliderState تنفّذ DraggableState (I9b116)
  • تغيير الشكل ليكون مَعلمة مطلوبة أعِد تسمية position إلى index في دالة مساعِد الأشكال. (I34941)
  • تعدّل DatePicker formatWithSkeleton لتضمين خريطة تُستخدَم كذاكرة تخزين مؤقت لتحسين الأداء. (I3195f)
  • تمت إضافة BasicTooltipBox إلى compose.foundation وتعديل PlainTooltipBox وRichTooltipBox لاستخدام TooltipBox مع عناصر PlainTooltip وRichTooltip الجديدة القابلة للإنشاء. (I79e1d)

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

  • تعرض السمتان dynamicLightColorScheme وdynamicDarkColorScheme الآن ألوانًا ذات تشبّع أعلى للأدوار السطحية وsurfaceContainer. (I5e901)
  • تم إصلاح المشكلة التي كانت تتسبب في محاولة بعض المكوّنات التي تستخدم Subcomposition (مثل BottomSheetScaffold) داخل Scaffold داخل LookaheadScope قراءة حجمها في وقت مبكر جدًا. (I297b4 وI871f1 وb/295536718)

الإصدار 1.2.0-alpha06

‫23 أغسطس 2023

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

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

  • تم إصلاح عملية احتساب DropdownMenu في offset، بحيث تعتمد إزاحات x فقط على اتجاه التنسيق المحلي، ولن يتم عكس إزاحات y عندما تكون القائمة بالقرب من أسفل الشاشة. (Iccc74، b/294103942)
  • تم إصلاح عملية احتساب DropdownMenu في offset، بحيث تعتمد إزاحات x فقط على اتجاه التنسيق المحلي، ولن يتم عكس إزاحات y عندما تكون القائمة بالقرب من أسفل الشاشة. (Ib87a2، b/294103942)

الإصدار 1.2.0-alpha05

‫9 أغسطس 2023

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

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

  • تعديلات على مربّع الاختيار وألوان TriStateCheckbox لا يؤثّر CheckboxDefaults.colors() disabledUncheckedColor الآن إلا في حدود مربّع الاختيار. تتطلّب الحالات الخاصة التي تستدعي ضبط لون المربّع الداخلي عند إيقافه وإلغاء تحديده إنشاء مثيل مخصّص من CheckboxColors مع قيم الألوان المطلوبة. (I77d17، b/291943198)

الإصدار 1.2.0-alpha04

‫26 يوليو 2023

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

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

  • واجهة برمجة التطبيقات التجريبية لأزرار التقسيم (Ifc8fb)
  • تتضمّن الفواصل الآن مَعلمة للتحكّم في الاتجاه من أجل توفير فواصل عمودية. (I4c899، b/288438593)

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

  • نحن بصدد نقل التبعية في الكثافة إلى مستوى المكوّن. ينطبق ذلك على المكوّنات التالية: SwipeToDismiss والمكوّنات المستندة إلى جداول البيانات. يُرجى استخدام التحميل الزائد الجديد المتوفّر حيث تكون الكثافة مَعلمة. (I1846e)
  • تعليقات توضيحية إضافية لتحديد المدخلات المسموح بها للعناصر القابلة للإنشاء (Ief234)
  • أضِف مَعلمة رمز إلى الزرّ المقسَّم، وقسِّم الدلالات بحيث يمكن تحديد الأزرار المقسَّمة لتنفيذ التحديد الفردي، ويمكن تبديلها لتنفيذ التحديد المتعدّد، باستخدام SelectableSegmentedButtonRow وToggelableSegmentedButtonRow على التوالي. (I38740)
  • تمت إعادة تسمية الفاصل إلى HorizontalDivider. تمت إضافة وظيفة VerticalDivider. (I5975c)
  • تغيير استخدام ClosedFloatingPointRange إلى FloatRange الأخف وزنًا في واجهات برمجة تطبيقات Material3 التجريبية لتقليل التحويل التلقائي بين أنواع البيانات الأساسية وأنواع الأغلفة (I4aab5)
  • تمت إضافة محاذاة "البدء" الجديدة إلى FabPosition (Ib7aea، b/170592777)

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

  • ModalBottomSheet تحترم اتجاه التنسيق المحلي. (Ib4f44، b/285628622)

الإصدار 1.2.0-alpha03

‫21 حزيران (يونيو) 2023

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

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

  • أصبحت includeFontPadding الآن false تلقائيًا في تصميم Material 3. تم أيضًا تغيير نمط ارتفاع السطر التلقائي إلى Trim.None وAlignment.Center، وتمت إضافة lineHeight صريح (بالوحدات المستقلة عن الكثافة) إلى TextStyle في Typography. راجِع مستندات واجهة برمجة التطبيقات إذا أردت تخصيص هذه القيم، واطّلِع على مشاركة المدونة للحصول على شرح مفصّل لهذه التغييرات. (I6266f، Icabc3)

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

  • تمت إضافة تحميل زائد للدالة RangeSlider وهو إصدار ذو حالة من المكوّن. تم إنشاء RangeSliderState يحتوي على جميع المعلومات الخاصة بالمسار النشط الحالي، وقياسات مكوّنات RangeSlider، ومنطق السحب والإيماءات. (I8c270)
  • يتيح شريط البحث الآن استخدام الظلال من خلال المَعلمة shadowElevation التي تمت إضافتها حديثًا. (Ia5369، b/271040353)
  • يتيح ColorScheme الآن أدوارًا جديدة في SurfaceContainer.
  • يمكن الآن إيقاف تراكب الارتفاع النغمي للسطح باستخدام LocalTonalElevationEnabled composition local. (Ic203c، b/277774590)

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

  • افتح دوال إنشاء ألوان المكوّنات. (I8c4a6)
  • إضافة مَعلمة قابلة للتركيز إلى كلتا واجهتَي برمجة التطبيقات الخاصةَين بتلميحات الأدوات، حتى يتمكّن المطوّرون من السماح لتلميح الأداة باستهلاك أحداث اللمس أو عدم السماح بذلك. يُرجى العلم أنّ ذلك قد يؤدي إلى إيقاف التنقّل التلقائي في التركيز على عناصر تسهيل الاستخدام. (Ie32d8)
  • تم تحسين إمكانية الوصول لتعزيز الأداء وعمليات تخصيص الذاكرة. (Iede48)
  • عرض DefaultSizeClasses وإنشاء StandardSizeClasses لـ WindowSizeClasses (I91838)
  • تغيير WindowWidth/HeightSizeClass إلى فئات القيم العائمة (Ie686e)

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

  • تراعي المَعلمة contentWindowInsets في Scaffold الآن هوامش النافذة المستخدَمة. يُرجى العِلم أنّ سلوك مساحة العرض المتروكة حول المحتوى استنادًا إلى topBar وbottomBar يظلّ بدون تغيير عند توفير هاتين المَعلمتَين. (I08b73، b/264601542)
  • أصلِح محاذاة شريط التطبيق العلوي في المنتصف لضمان عدم عرض عنوان طويل فوق رموز الإجراءات أو رمز التنقّل. (I4369f، b/236994621)
  • تفرض مواضع علامات التبويب الآن حدًا أدنى لعرض المحتوى يبلغ 24 وحدة بكسل مستقلة عن الكثافة. يوفر ذلك هدفًا قابلاً للنقر يسهل الوصول إليه لمؤشرات علامات التبويب. (Id8861)
  • تتوافق لوحات الألوان الديناميكية من dynamicLightColorScheme وdynamicDarkColorScheme الآن مع أدوار مساحات العرض الجديدة. (I1252e)
  • تعديل محاذاة إشعار الشارة لكي لا يتم اقتطاعه عند التعارض مع الجد الأكبر (Idf75a)

الإصدار 1.2.0-alpha02

‫24 مايو 2023

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

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

  • أضِف مَعلمة حواف النافذة إلى ModalBottomSheet.
    • يمكن الآن رسم حاجب ModalBottomSheet خلف شريط الحالة مع ضبط windowInsets على صفر
    • تم تعديل وظيفة ModalBottomSheet التلقائية للبقاء خارج أشرطة النظام، بما في ذلك شريط التنقّل
    • يتم توفير معالجة مساحة العرض الداخلية لشريط الحالة من خلال مقبض السحب في وضع "من الحافة إلى الحافة".
    • تتضمّن BottomSheetDefaults حواف النوافذ الخاصة بـ BottomSheetWindow. (I31200، b/274872542، b/272973615، b/272334475، b/268432129، b/275849044، b/275486106، b/268433162)
  • إيقاف Indicator نهائيًا وإضافة Primary/SecondaryIndicator لتتوافق مع مواصفات M3 يتطابق PrimaryIndicator مع عرض محتوى علامة التبويب، بينما يمتد SecondaryIndicator على كامل العرض المتاح. SecondaryIndicator هي نفسها Indicator التي تم إيقافها نهائيًا، ويمكن استخدامها كبديل مباشر لها. (I27604)
  • تمت إضافة خيار لتمرير ScrollState عند إنشاء DropdownMenu أو ExposedDropdownMenu للتحكّم في حالة التمرير العمودي لعناصر القائمة المعروضة. (Ia0734، b/185304441)
  • تمت إضافة تحميل زائد للدالة Slider وهو إصدار ذو حالة من المكوّن. تم إنشاء SliderState يحتوي على جميع المعلومات الخاصة بالمسار النشط الحالي، وقياسات مكوّنات Slider، ومنطق السحب والإيماءات. (I124a5)
  • إعادة تسمية السمة "الدلالات" isContainer إلى isTraversalGroup (I121f6)
  • تمّت إضافة TextStyle.merge(...) محسَّن مع قائمة المَعلمات الكاملة. (Iad234، b/246961787)
  • تم إنشاء واجهات عامة لـ "TooltipState" و"RichTooltipState" و"PlainTooltipState". تمت إضافة RichTooltipStateImpl وPlainTooltipStateImpl للحالات التلقائية. تمت إضافة وظائف remember*State للحصول على هذه الحالات التي تم تنفيذها. تمت إزالة TooltipSync واستخدام TooltipDefault.GlobalMutatorMutex بدلاً منه. (I7813d)
  • تم تعديل DatePickerColors لتضمين خيارات تخصيص إضافية لألوان فاصل أداة اختيار التاريخ وعناصر التنقّل وحقول إدخال النص. (I1a685، b/274626815)
  • DatePickerState وDateRangePickerState هما الآن واجهتان عامّتان مع عمليات تنفيذ تلقائية يمكن استردادها من خلال rememberDatePickerState وrememberDateRangePickerState. (I71c52)
  • تمت إزالة dateValidator من DatePicker وDateRangePicker وتم تقديم واجهة SelectableDates يمكن ضبطها على الحالة للتحكّم في التواريخ أو السنوات التي يمكن اختيارها في واجهة المستخدم. (Ic2fc6)
  • تمت إزالة TimePicker من واجهة برمجة التطبيقات الثابتة، ومن المتوقّع إجراء المزيد من التغييرات في واجهة برمجة التطبيقات الخاصة بالحالة (I3f39a)
  • تم نقل ModalBottomSheet إلى Android فقط. لا ننصح باستخدام ModalBottomSheet على أجهزة الكمبيوتر، ولا تتم صيانة هذه الوظيفة بشكل نشط. (Ib3778)

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

  • تم إصلاح مشكلة عدم ظهور إجراء الإغلاق AlertDialog أسفل إجراء التأكيد عندما يتم ترتيب الإجراءات فوق بعضها البعض لتناسب عرض مربّع الحوار. يعمل هذا الإصلاح على مواءمة التنفيذ مع مواصفات Material Design. (I029de، b/235454277)
  • تم إصلاح الخطأ في ListItem الذي كان يستخدم مساحة متروكة غير صحيحة للعناصر المكوّنة من ثلاثة أسطر. (I6e235)
  • يمكن الآن عرض لوحة مفاتيح IME في ModalBottomSheet (Idc508، b/262140644، b/268380384، b/272483584)

الإصدار 1.2.0-alpha01

‫10 مايو 2023

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

الإصدار 1.1

الإصدار 1.1.2

‫20 سبتمبر 2023

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

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

  • تم إصلاح مشكلة تمرير المعدِّل بشكل غير صحيح إلى عنصرين قابلين للإنشاء. (b/282761472)
  • تم إصلاح مشكلة عرض TimePickerState لساعات غير صحيحة عند تهيئته بـ 23 ساعة. (b/278242122)
  • تم إصلاح حالة التبديل الأولية للتحقّق من صحة الوقت عند الظهر والدقيقة. (b/269768197 وb/282790635)
  • تم إصلاح الخطأ الذي كان يتسبّب في عرض قيمة غير صحيحة في state.hour عند الساعة 11 مساءً. (b/282761472 وb/278242122)

الإصدار 1.1.1

‫21 حزيران (يونيو) 2023

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

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

  • تضيف هذه الطريقة طلبًا إلى ModalBottomSheet بدون المَعلمة windowInset لتحقيق التوافق الثنائي. (Ib7959)
  • أضِف مَعلمة حواف النافذة إلى ModalBottomSheet.
    • يمكن الآن رسم حاجب ModalBottomSheet خلف شريط الحالة مع ضبط windowInsets على صفر
    • تم تعديل وظيفة ModalBottomSheet التلقائية للبقاء خارج أشرطة النظام، بما في ذلك شريط التنقّل
    • يتم توفير معالجة مساحة العرض الداخلية لشريط الحالة من خلال مقبض السحب في وضع "من الحافة إلى الحافة".
    • تتضمّن BottomSheetDefaults حواف النوافذ الخاصة بـ BottomSheetWindow. (I31200، b/274872542، b/272973615، b/272334475، b/268432129، b/275849044، b/275486106، b/268433162)

الإصدار 1.1.0

‫10 مايو 2023

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

الميزات الرئيسية في الإصدار 1.1.0

مكوّنات جديدة في Material Design 3

تحسينات على مكوّنات Material Design 3 الحالية

تمت ترقية واجهات برمجة التطبيقات التجريبية إلى إصدار ثابت

يُرجى الاطّلاع على منشور المدوّنة هذا لمزيد من التفاصيل.

الإصدار 1.1.0-rc01

‫19 أبريل 2023

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

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

  • تمت إزالة TimePicker من واجهة برمجة التطبيقات الثابتة، ومن المتوقّع إجراء المزيد من التغييرات في واجهة برمجة التطبيقات الخاصة بالحالة (I3f39a)
  • تم نقل ModalBottomSheet إلى Android فقط. لا ننصح باستخدام ModalBottomSheet على أجهزة الكمبيوتر، ولا تتم صيانة هذه الوظيفة بشكل نشط. (Ib3778)

الإصدار 1.1.0-beta02

‫5 أبريل 2023

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

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

  • تتضمّن SheetState الآن المَعلمة الاختيارية skipHiddenState
  • تتضمّن rememberStandardBottomSheetState الآن المَعلمة الاختيارية skipHiddenState
  • يتضمّن BottomSheetScaffold الآن مرساة مخفية محدّدة، ولكنّها غير مفعّلة تلقائيًا.
  • تم تعديل مستند SheetState.requireOffset
  • تمت إعادة تسمية BottomSheetDefaults.MinimizedShape إلى BottomSheetDefaults.HiddenShape (I839f4، b/273870234)

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

  • لا تبدّل وجه الساعة من الساعة إلى الدقيقة عندما تكون ميزة "استكشاف باللمس" مفعّلة. (I717d0)
  • تم الآن دمج دلالات مقبض السحب ModalBottomSheet وBottomSheetScaffold. (I05afb)
  • لم يعُد المعدِّل BottomSheetScaffold والمعلمتَين containerColor وcontentColor يؤثران إلا في المحتوى. (I992cb)
  • تتيح BottomSheetScaffold nestedScroll الآن إمكانية التنقّل السريع في محتوى الورقة. (I992cb)

الإصدار 1.1.0-beta01

‫22 مارس 2023

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

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

  • أضِف مَعلمة نوع التنسيق إلى العنصر القابل للإنشاء TimePicker. يسمح هذا الخيار باستخدام تنسيقات مختلفة، وذلك حسب إعدادات الشاشة (Ia0e16).
  • تم وضع علامة "تجريبي" على SearchBarDefaults. (I65561)
  • تمت إضافة ارتفاع الظل إلى BottomSheetScaffold (I94e0f)
  • تمت إضافة إمكانية عرض أدوات اختيار التاريخ بدون جزء العنوان. تغييرات في واجهة برمجة التطبيقات للسماح بتمرير عنوان فارغ عند إنشاء أداة اختيار التاريخ يمكنك الآن تمرير عنوان فارغ وعنوان وshowToggleMode = false لعرض أداة اختيار بدون رأس. (Id3f3a، b/266132421، b/267194809)

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

  • تزيل أشرطة البحث الآن التركيز تلقائيًا عند إيقافها. (I22a7c، b/261444487)
  • تم تعديل DateRangePicker للسماح باختيار نطاق يتضمّن التاريخ نفسه للبدء والانتهاء. (I16529، b/272882497)
  • تعمل حقول النص الآن على تحديد موضع عناصر النص بشكلٍ صحيح عندما يكون حجم الخط أصغر من المتوقّع. قد يؤدي ذلك إلى تغيير بعض وحدات البكسل في تطبيقاتك استنادًا إلى إعدادات الخط والبرنامج النصي. (I8b8d0)
  • أصبحت الإجراءات الدلالية في البطاقة السفلية تتضمّن تصنيفات. (I277b0)

الإصدار 1.1.0-alpha08

‫8 مارس 2023

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

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

  • تمت إضافة إمكانية استخدام BottomSheetScaffold وBottomSheetScaffoldState. (I063d4)

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

  • تمت إضافة وظيفة إلى DatePickerState وDateRangePickerState للسماح بتحديد التواريخ بعد الإنشاء الأولي للحالة، بالإضافة إلى إعادة ضبط الاختيارات من خلال ضبط الطوابع الزمنية على قيمة فارغة. يجب توخّي الحذر عند ضبط التواريخ يدويًا، وستعرض الدالة setSelection الجديدة استثناءً في حال عدم استيفاء تاريخ مقدَّم لشرط مسبق (راجِع المستندات). (Ifa645، b/268609314، b/270427389)
  • أعِد تسمية Collapsed SheetValue إلى PartiallyExpanded لعرض السلوك في هذه الحالة بشكل أكثر دقة ومرونة. (Ia1491)
  • تم تعديل أسماء المَعلمات ListItem إلى _content بدلاً من _text. أصبحت دوال الحصول على القيم التلقائية ReadOnlyComposables عند الاقتضاء. (I69a25)
  • إيقاف واجهات برمجة تطبيقات Surface التفاعلية التجريبية (I90d59، b/261561812)

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

  • تم إصلاح مشكلة احتساب حالة ModalBottomSheetHalfExpanded بشكل غير صحيح وظهور الورقة على أنّها عائمة. (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 الآن على الإصدار 2.5.1 من Lifecycle. (I05ab0، b/258038814)

الإصدار 1.1.0-alpha02

‫9 نوفمبر 2022

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

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

  • يقبل الآن كل من awaitFirstDown وwaitForUpOrCancellation PointerEventPass لتوفير مرونة أكبر (ويحلّ أيضًا مشكلة ExposedDropdownMenuBox التي تعرض قائمة أثناء التمرير).(I7579a، b/212091796)
  • تمت إضافة المَعلمة minLines إلى النص في Material وMaterial3، وTextField وOutlinedTextField، ما يتيح ضبط الحد الأدنى لارتفاع المكوّن من حيث عدد الأسطر (I4af1d)
  • إيقاف الدالة TopAppBarDefaults smallTopAppBarColors نهائيًا واستخدام الدالة الجديدة topAppBarColors بدلاً منها عند إنشاء TopAppBar (Ie6cb9)
  • تمت إضافة المَعلمة minLines إلى BasicText وBasicTextField. تتيح هذه السمة ضبط الحد الأدنى لارتفاع العناصر القابلة للإنشاء هذه من حيث عدد الأسطر (I24294، b/122476634).

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

  • يمكنك قص محتوى IconButton وIconToggleBotton في Material3 ليناسب شكل طبقة الحالة للعنصر (مثل الشكل الدائري). (I9da8f)
  • تعديل شريطَي التطبيق العلويَّين المتوسط والكبير في Material3 لتطبيق لون الخلفية نفسه على كامل مساحتهما، والسماح بتجاوز الألوان التلقائية باستخدام قيم ألوان شفافة (I67659، b/249688556، b/250838918)

الإصدار 1.1.0-alpha01

‫24 أكتوبر 2022

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

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

  • إصلاحات لشريط التطبيق العلوي عند تطبيق العنوان باستخدام TextStyle وBrush (If667e)

الإصدار 1.0

الإصدار 1.0.1

‫9 نوفمبر 2022

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

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

  • تعديل شريطَي التطبيق العلويَّين المتوسط والكبير في Material3 لتطبيق لون الخلفية نفسه على كامل مساحتهما، والسماح بتجاوز الألوان التلقائية باستخدام قيم ألوان شفافة (I67659، b/249688556، b/250838918)

الإصدار 1.0.0

‫24 أكتوبر 2022

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

الميزات الرئيسية في الإصدار 1.0.0

هذا هو الإصدار الثابت الأول من Compose Material 3.

تحديد نسق Material Design 3 والألوان الديناميكية في Material You

مكوّنات Material Design 3

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

  • ‫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 لتوفير حالة قابلة للتحديد وفقًا لمواصفات Material Design توفير دعم إضافي في ألوان FilterChip للحالة المحدّدة غير المفعّلة (I55244، b/235792432)
  • إضافة زر إجراء عائم تلقائي BottomAppBar (Ida4c8)
  • تمت إضافة ColorScheme.surfaceColorAtElevation (Id41af)
  • أصبحت الواجهات في مكتبات Compose يتم إنشاؤها باستخدام طرق الواجهة التلقائية في الإصدار jdk8 (I5bcf1).
  • تتضمّن الفئتان WindowWidthSizeClass وWindowHeightSizeClass الآن واجهة Comparable، لذا يمكن مقارنتهما باستخدام عوامل التشغيل (< و<= و>= و>) وواجهات برمجة التطبيقات الأخرى. (I747d0)

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

  • تعديل عيّنة الشارة لتقديم وصف أكثر فائدة للمحتوى (I10b9d)
  • تضيف هذه السمة خيارًا لاستخدام حجم خط النظام في أداة اختيار المظهر في كتالوج Material 3. (I10605)
  • تتم إضافة نموذج رمز برمجي لشارات ومؤشرات مستوى تقدّم غير محدّدة. (I8fbe0)

الإصدار 1.0.0-alpha13

‫1 يونيو 2022

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

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

  • يتيح الحفاظ على موضع شريط التطبيق العلوي عند تغيير الإعدادات. (I10459، b/216160958)

الإصدار 1.0.0-alpha12

‫18 مايو 2022

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

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

  • يمكن الآن أن يكون عرض الحاوية الرئيسية لشريط التمرير 0. (b/231707291)

الإصدار 1.0.0-alpha11

‫11 مايو 2022

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

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

  • تمت إضافة RangeSlider إلى Material 3 (I18e38)
  • إضافة دعم AssistChip وInputChip في Material3 (I0d25a)
  • إضافة دعم FilterChip وSuggestionChip في Material3 (I9fdf3)

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

  • تمت إعادة تسمية الدالة القابلة للإنشاء TextFieldDefaults.BorderStroke التي ترسم ضربة حدودية في OutlinedTextField إلى TextFieldDefaults.BorderBox. (I5f295)
  • التبديل بين التغييرات المرئية في m3 (Iab30e)
  • السماح بتمرير الألوان إلى أزرار الرموز العادية (Ia2445)

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

  • إضافة فحص lint إلى material3/Scaffold للتأكّد من استخدام الحشو الداخلي (I72293، b/226951418)

الإصدار 1.0.0-alpha10

‫20 أبريل 2022

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

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

  • ‫material3-window-size-class هي مكتبة جديدة توفّر الدعم لفئات أحجام النوافذ، وهي مجموعة من نقاط توقّف إطار العرض المحدّدة التي يمكنك استخدامها لتصميم وتطوير واختبار تخطيطات التطبيقات القابلة لتغيير الحجم. يمكنك استخدام calculateWindowSizeClass لاسترداد مثيل لفئة حجم النافذة، ويمكنك استخدام هذا المثيل لتحديد طريقة ظهور واجهة المستخدم، مثل عرض شريط تنقّل جانبي بدلاً من شريط التنقّل السفلي لأحجام النوافذ الأكبر. لمزيد من المعلومات وأمثلة على الاستخدام، يُرجى الاطّلاع على مستندات مرجع واجهة برمجة التطبيقات الخاصة بـ WindowSizeClass. لمزيد من المعلومات حول تعريفات فئات أحجام النوافذ، اطّلِع على الإرشادات المتاحة للجميع بشأن إتاحة أحجام الشاشات المختلفة.

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

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

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

  • تعديلات على IconButton القياسي ليتوافق مع مواصفات Material3‏ (I09eab)
  • نقل ارتفاع الشريط العلوي لـ 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 ونظام Shape الفرعي. (I37426)
  • تمت إضافة مَعلمة موسّعة إلى ExtendedFloatingActionButton للتحكّم في ما إذا كان زر الإجراء العائم موسّعًا أو مصغّرًا، مع إضافة رسوم متحركة بين كل حالة. تمت إضافة تحميل زائد لزر الإجراء العائم الموسّع من أجل أزرار الإجراء العائم الموسّعة التي تتضمّن نصًا لاحقًا لأزرار الإجراء العائم الموسّعة بدون رمز. (Iba7f1)

الإصدار 1.0.0-alpha08

‫23 مارس 2022

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

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

  • تمت إضافة دعم لحقول النص في Material 3. (I795cc، b/199377790)

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

  • إضافة فاصل تلقائي للقائمة (I01374)
  • تمت إضافة مَعلمة اللون surfaceTint إلى الفئة ColorScheme. (I2f558)

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

  • إصلاح الخطأ في الزر Material3 لقراءة قيمة نمط النص التلقائي من MaterialTheme (Ie62fc)

الإصدار 1.0.0-alpha07

‫9 مارس 2022

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

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

  • تعديلات على واجهة برمجة التطبيقات Surface في Material 3 تعيد الدوال المحمّلة بشكل زائد إلى مساحات العرض القابلة للنقر، بالإضافة إلى إضافة دالة تتيح مساحات العرض القابلة للتحديد والتبديل. (I4bf18)
  • أصبح الإصداران LazyVerticalGrid وLazyHorizontalGrid ثابتَين الآن. (I307c0)
  • تم نقل LazyVerticalGrid/LazyHorizontalGrid وجميع واجهات برمجة التطبيقات ذات الصلة إلى الحزمة الفرعية ‎ .grid. يُرجى تعديل عمليات الاستيراد من androidx.compose.foundation.lazy إلى androidx.compose.foundation.lazy.grid. (I2d446)
  • تمت إعادة التغيير السابق الذي كان يعتمد فقط على View في WindowInsetsControllerCompat، وأصبح مطلوبًا مرة أخرى توفُّر Window، وهو مطلوب لإدارة بعض علامات Window. تم إيقاف ViewCompat.getWindowInsetsController نهائيًا واستبداله بـ WindowCompat.getInsetsController للتأكّد من استخدام Window الصحيح (على سبيل المثال، إذا كان العرض في مربّع حوار). (I660ae، b/219572936)
  • تمت إضافة واجهة برمجة تطبيقات جديدة LazyVerticalGrid لتحديد أحجام المحاور المتقاطعة (I17723)

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

  • تعديلات على Card API لمواكبة التغييرات في Surface API (I3c8b9)

الإصدار 1.0.0-alpha06

‫23 فبراير 2022

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

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

  • تمت إضافة NavigationDrawerItem التي تمثّل وجهة واحدة ضمن الأدراج (Ic396f، b/218286829)
  • تمت إضافة PermanentNavigationDrawer وDismissibleNavigationDrawer كواجهتَي برمجة تطبيقات تجريبيتين. هذه هي أدراج التنقّل المناسبة تمامًا للأجهزة ذات الشاشات الكبيرة. (I5f8ab، b/218286829)
  • إضافة إمكانية استخدام شريط التطبيق السفلي بتصميم Material 3 (Ic432a)
  • تمت إعادة تسمية NavigationDrawer إلى ModalNavigationDrawer (I1807d، b/218286829)
  • تمت إضافة فئة وأدوات تحكّم في شريط التمرير Material 3 (I1ccee)
  • تمت إضافة تنفيذ علامة التبويب، راجِع المستندات لمعرفة كيفية الاستخدام النموذجي (Ie0146)

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

  • تم إصلاح مشكلة كانت تؤدي إلى اختيار قارئ الشاشة TalkBack للتنقل الخطي لعنوان فارغ في شريط التطبيق العلوي. (Id4690)
  • تمّت إضافة "IconSize" إلى "FloatingActionButtonDefaults". (Ia71cf)
  • تم إصلاح الخطأ الذي كان يؤدي إلى إخفاء أزرار AlertDialog عند إضافة نص طويل يتضمّن LazyColumn. (Ib2cc9، b/216663029)

الإصدار 1.0.0-alpha05

‫9 فبراير 2022

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

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

إضافة مكوّنات Material Design 3

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

  • الدالة Surface المتوقّفة نهائيًا والتي تستخدم onClick callback. يجب إنشاء المساحات القابلة للنقر باستخدام InteractionSource وModifier.clickable(). (I211c6)
  • تمت إضافة إمكانية استخدام الارتفاع عند الضغط على زر الإجراء العائم أو التركيز عليه. (Ibb584)
  • تم تغيير واجهة برمجة التطبيقات Surface لتلقّي InteractionSource، ما يتيح التحكّم في مظهرها في حالات مختلفة. (Iafbc8)

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

  • تمت إضافة الألوان الثلاثية الناقصة في أنظمة الألوان الديناميكية (I456c4، b/214588434)

الإصدار 1.0.0-alpha04

‫26 يناير 2022

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

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

  • تمت إضافة NonRestartableComposable إلى الطرق التي تم تحميلها بشكل زائد من الطرق الحالية بدون منطق معقّد. يقلّل ذلك من عمليات التحقّق من التخزين المؤقت التي ينشئها المترجم البرمجي (equals) لجميع المَعلمات التي تتكرّر في الدالة الداخلية التي يتم استدعاؤها. (I90490)
  • تمت إضافة فاصل Material 3. (Ica5fc)
  • ضَع علامة على مربّع الاختيار وزر الاختيار باستخدام تعليق توضيحي لواجهة برمجة تطبيقات تجريبية. (Ie44bb)
  • تمت إضافة دعم لمؤشرات التقدّم في Material 3. (Iff232، b/205023841)

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

  • تعديل لون حاوية TextButton's غير مفعَّلة ليكون شفافًا (I6b248، b/213339737)

الإصدار 1.0.0-alpha03

‫12 يناير 2022

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

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

  • أضِف LocalIndication إلى MaterialTheme في Material 3. (I7ce4e)
  • إصلاح نصف قطر الزاوية الذي يتم تطبيقه على مربّعات الاختيار (I38b03 وb/175198975 وb/202309440)

تحديثات الاعتماديات

  • يعتمد الآن على Kotlin 1.6.10.

الإصدار 1.0.0-alpha02

‫1 كانون الأول (ديسمبر) 2021

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

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

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

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

  • إزالة الدرج من هيكل Material 3 (I04f51)
  • تضيف هذه السمة إمكانية استخدام Checkbox في Material 3. (Id5542)
  • تضيف هذه السمة إمكانية استخدام RadioButton في Material 3. (I20334)

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

  • تقليل نصف قطر التموج IconButton من 40dp إلى 20dp (I68bbe، b/206674345)
  • تم تغيير المسار السريع لسلسلة المنافذ Text من compose.material (I30b03)
  • تم إصلاح المشكلة، ولكن تم ترميز الزر بشكل ثابت ليكون مفعّلاً دائمًا. (Iea832، b/205335456)

الإصدار 1.0.0-alpha01

‫27 أكتوبر 2021

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

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

تحديد نسق Material Design 3 والألوان الديناميكية في Material You

مكوّنات Material Design 3

لمزيد من المعلومات، اطّلِع على قسم Material Design 3 وMaterial You في دليل "استخدام السمات في Material Design في Compose".