Compose Material 3

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

البنية

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

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

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

تعريف التبعيات

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

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

رائع

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

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

الملاحظات

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

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

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

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

الإصدار 1.0.0-alpha01

‫17 أبريل 2024

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

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

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

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

الإصدار 1.0.0-alpha07

‫1 مايو 2024

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

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

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

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

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

الإصدار 1.0.0-alpha06

‫17 أبريل 2024

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

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

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

الإصدار 1.0.0-alpha05

‫6 مارس 2024

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

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

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

الإصدار 1.0.0-alpha04

‫21 فبراير 2024

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

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

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

الإصدار 1.0.0-alpha03

‫7 فبراير 2024

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

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

  • تعديل اسم الحزمة إلى navigationsuite بدلاً من navigation-suite (I7eff7)
  • تم تعديل مكوّنات Material3 التي تعرض MutableInteractionSource في واجهة برمجة التطبيقات لتتيح الآن عرض MutableInteractionSource قابلة للقيم الخالية، وتكون القيمة التلقائية هي null. لا توجد تغييرات دلالية هنا: يعني تمرير قيمة فارغة أنّك لا تريد نقل MutableInteractionSource إلى أعلى، وسيتم إنشاؤه داخل المكوّن إذا لزم الأمر. يسمح التغيير إلى قيمة فارغة لبعض المكوّنات بعدم تخصيص MutableInteractionSource مطلقًا، ويسمح لمكوّنات أخرى بإنشاء مثيل فقط عند الحاجة، ما يحسّن الأداء في جميع هذه المكوّنات. إذا كنت لا تستخدم MutableInteractionSource الذي تمرّره إلى هذه المكوّنات، ننصحك بتمرير قيمة فارغة بدلاً من ذلك. يُنصح أيضًا بإجراء تغييرات مماثلة في مكوّناتك. (I41abb، b/298048146)

الإصدار 1.0.0-alpha02

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

تم إصدار androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02 وandroidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02 وandroidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02. يحتوي الإصدار 1.0.0-alpha02 على عمليات الإيداع هذه.

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

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

  • إصلاح مشكلة ملء مكوّن التنقّل للشاشة بالكامل عندما يحتوي السطح الجذر على 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-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)
  • تعود SwipeToDismissBox الآن إلى targetValue ثابتة إذا لم تكن هناك أي عناصر ثابتة أخرى. يتم الآن الرجوع إلى 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-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 يوليو 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-alpha17. يحتوي الإصدار 1.4.0-alpha17 على عمليات الدمج هذه.

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

  • تعديل الحركة لمجموعة الأزرار بحيث يتم تحريكها إلى% 75 من الحركة عند النقر عليها بدلاً من الضغط عليها (593942a، b/423596967)

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

  • تم إصلاح مشكلة كان يمكن أن يتجاوز فيها عنصر في لوحة العرض الدوّارة حجم العنصر الكبير في بعض الحالات أثناء عمليات حساب التنسيق، ما يؤدي إلى قطع الأداة بأكملها. (I1c3d7، b/397489534)
  • تم إصلاح مشكلة الانتقال إلى ما بعد beforeContentPadding عند تمرير لوحات العرض الدوّارة التي تتضمّن إزاحة متداخلة في البداية والنهاية. (c3d5f3a, b/420618979)
  • تعديل السلوك المفعَّل لـ SwipeToDismiss لمراقبة الحالة المستقرة بدلاً من الحالة الحالية تعيد هذه السمة السلوك الحالي الذي يتم فيه إيقاف سلوك العنصر الثابت فقط عندما يستقر المكوّن في حالة تم تجاهلها. (3844e07، b/425006844)
  • يمكن الآن فتح القائمة المنبثقة الخاصة بـ ExposedDropdownMenu من خلال إدخال البيانات باستخدام لوحة المفاتيح. تم أيضًا إصلاح المشكلة التي كانت تمنع الوصول إلى القائمة من خلال لوحة المفاتيح في خيار المنتج القابل للتعديل. (46ead03)

الإصدار 1.4.0-alpha16

‫18 يونيو 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-alpha16. يحتوي الإصدار 1.4.0-alpha16 على عمليات الدمج هذه.

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

  • تمت إضافة مكوّن منصة عرض بعناصر متغيّرة في منتصف الصفحة (I6f6d3)

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

  • تنفيذ عمليات إلغاء شريط الأدوات العمودي في XR (Ia1604)
  • تمت إضافة دوال التمرير الآلي إلى CarouselState (I12f8e)
  • إضافة ComponentOverride إلى ModalWideNavigationRail (I4f440)
  • إضافة ComponentOverride إلى WideNavigationRail (I6354f)
  • إنشاء ComponentOverride لـ HorizontalFloatingToolbar (I51116)
  • إنشاء ComponentOverride لـ ShortNavigationBar (I30e24)
  • تم وضع علامة "متوقّف نهائيًا" على مراجع SwipeToDismissBoxState إلى confirmValueChange. بدلاً من ذلك، على المستخدمين الاستفادة من معاودة الاتصال SwipeToDismissBox لواجهة برمجة التطبيقات onDismissed. (Iee780)
  • تمت إضافة المَعلمة userScrollEnabled إلى عناصر Carousel القابلة للإنشاء. (I1d4d2)
  • يمكن الآن مراقبة currentItem في لوحة العرض الدوّارة من CarouselState. (Ie87e9)

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

  • تم إصلاح المشكلة المتمثّلة في عدم تطبيق الظل بشكلٍ صحيح على شكل عشوائي في زر الإجراء العائم تم تمريره إلى FloatingToolbar. (Icdcc9، b/423336922)
  • تستخدم جميع "اللوحات الدوّارة" الآن الدور الدلالي "لوحة دوّارة" تلقائيًا. (I7af12)
  • تم إصلاح مشكلة عدم صحة حركة الإبهام عند تعديل حالة شريط التمرير من خلال LaunchedEffect (Id9f31، b/302774166)

الإصدار 1.4.0-alpha15

‫20 مايو 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-alpha15. يحتوي الإصدار 1.4.0-alpha15 على عمليات الدمج هذه.

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

  • تمت إضافة MotionTheme.LocalMotionScheme، وهي مقطوعة موسيقية محلية. يتيح ذلك الوصول إلى نظام الحركة في المظهر من CompositionLocalConsumerModifierNodes باستخدام currentValueOf(MotionTheme.LocalMotionScheme). (I014b1)
  • تم الآن إيقاف الدالة الإنشائية ColorScheme بدون أدوار الألوان الثابتة نهائيًا. يُرجى الانتقال إلى أداة إنشاء تتضمّن أدوارًا ثابتة. (Iad0ee)
  • يتوافق مكوّن M3 Text الآن مع TextAutoSize. (I7f524)
  • إضافة واجهة برمجة تطبيقات لإنشاء أشكال مختلفة من حجم الزرّ المنقسم وإضافة عيّنات (Ice30b)

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

  • تم إصلاح المشكلة المتمثّلة في تحديد موضع Snackbar وFloatingActionButton بشكل غير صحيح عند تفعيل وضع "من الحافة إلى الحافة". تطبِّق أداة الإنشاء الآن عمليات إزاحة أفقية على هذه المكوّنات بشكل صحيح. (Ib7c30، b/244400727)
  • إصلاح حركة BottomSheet من التوسيع الكامل إلى التوسيع الجزئي يستخدم BottomSheet الآن التأثير السريع MotionScheme عند الإخفاء أو التصغير، والتأثير المكاني التلقائي عند التوسيع. (Ifa46f، b/416063171)
  • تم وضع علامة مخفي على الدالة الإنشائية ColorScheme بدون أدوار حاوية السطح ولم يعُد يُنصح باستخدامها. (Ia7237)
  • تمت إزالة شرط CircularWavyProgressIndicator Size.minDimension > 0 الذي كان يؤدي إلى حدوث استثناء، وذلك لإتاحة المزيد من المرونة. (Ic9418، b/377531195)
  • تتضمّن الروابط التشعّبية في Text(AnnotatedString) الآن تنسيق Material تلقائيًا. (I78288 وb/339843816)
  • تم إصلاح مشكلة كانت تتسبّب في تخزين الدالة toShape() في RoundedPolygon مسارًا مؤقتًا، ما يؤدي إلى حدوث مشكلة عند إجراء عدة طلبات createOutline بأحجام مختلفة. (I4026d)

الإصدار 1.4.0-alpha14

‫7 مايو 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-alpha14. يحتوي الإصدار 1.4.0-alpha14 على عمليات الدمج هذه.

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

  • تمت إضافة عنصر AppBarColumn جديد قابل للإنشاء يعمل بالطريقة نفسها التي يعمل بها العنصر AppBarRow ولكن للمحتوى المعروض في عمود. (Iaf6bd)
  • تمت إضافة الحد الأقصى للعناصر إلى AppBarRow، وهذا ضروري لتنفيذ مواصفات المواد بشكل صحيح لأشرطة التطبيقات العلوية. (I92ce4)
  • تمت إضافة طريقة في TooltipScope للحصول على layoutCoordinates الخاص بعنصر التثبيت. إيقاف الطريقة drawCaret نهائيًا لأنّ بإمكان المطوّرين استخدام هذه الطريقة الجديدة للحصول على حدود العنصر الثابت layoutCoordinates وإنشاء شكل مناسب يحتوي على علامة إقحام. (Ia2e12، b/329470609)
  • تمت إضافة دعم java.time لأدوات اختيار التاريخ: تم تقديم عمليات تحميل زائدة rememberDatePickerState/rememberDateRangePickerState تقبل عناصر java.time (مثل LocalDate الأولية وYearMonth). تمت أيضًا إضافة دوال إضافية إلى عناصر الحالة للحصول على القيم أو ضبطها باستخدام أنواع مثل LocalDate وYearMonth. تتطلّب هذه الميزة المستوى 26 من واجهة برمجة التطبيقات أو الإصدارات الأحدث أو إزالة التشفير. (I70f29، b/266202516، b/281859606)
  • إضافة عنصر CenteredTrack قابل للإنشاء يتيح استخدام شريط تمرير مع مسار يبدأ من المنتصف (I5b1d6)

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

  • تم تحسين أداء مؤشرات التقدّم المتموّجة: أصبحت الأنواع الخطية يتم تحميلها الآن أسرع بنسبة% 8.5 تقريبًا مع تقليل عمليات التخصيص بنسبة% 11 تقريبًا، بينما شهدت الأنواع الدائرية تحسّنًا كبيرًا في السرعة بنسبة% 47 تقريبًا وانخفاضًا في عمليات التخصيص بنسبة% 39 تقريبًا. (I595d8)

الإصدار 1.4.0-alpha13

‫23 أبريل 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-alpha13. يحتوي الإصدار 1.4.0-alpha13 على عمليات الدمج هذه.

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

  • تمت إعادة طرح isAppearanceLightStatusBars وisAppearanceLightNavigationBars في ModalBottomSheetProperties كمَعلمات خاصة بنظام التشغيل Android فقط. (Id4bc0)
  • أضِف عنصر AppBarRow قابلاً للإنشاء، ويتعامل مع تجاوز عدد العناصر التي يمكن أن تتسع خارج حدوده. (I742bd)
  • عدِّل واجهتَي برمجة التطبيقات DatePicker وDateRangePicker لطلب التركيز عند التبديل إلى وضع إدخال التاريخ. لقد استبدلنا المَعلمة المنطقية requestFocus بالمَعلمة الاختيارية focusRequester التي تأخذ FocusRequester. (I14b69)
  • إزالة أداة التعديل ومصدر التفاعل من العناصر التلقائية القابلة للنقر والتبديل يمكنك بدلاً من ذلك استخدامها كإحدى تفاصيل التنفيذ. (I95ed6)
  • تم تعديل ButtonGroup ليتم عرضه في قائمة منسدلة عندما يكون هناك عدد كبير جدًا من الأزرار لا يمكن عرضه على الشاشة. (I7b88b)

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

  • تستهلك ورقة البيانات السفلية الآن الحواف العلوية عندما تكون أصغر من الإزاحة الحالية. يتيح ذلك للمستخدمين تقديم هوامش علوية لسلوك العرض الموسّع. يتضمّن BottomSheetDefaults.windowInsets الآن WindowInsets.safeDrawing.Top. (I0ab67، b/321877275، b/336962418، b/342093067)
  • تم تفعيل صور متحركة للدخول/الخروج (تتلاشى/تنزلق) لرموز/صور الأفاتار الرئيسية والرموز اللاحقة في Chip عند إضافتها أو إزالتها. يفيد ذلك بشكل أساسي الشرائح القابلة للتحديد (الفلتر، الإدخال)، ولكنّه ينطبق بشكل عام. (I9af21)
  • إصلاح السلوك المعطَّل لشريط التمرير من اليمين إلى اليسار الناتج عن LookaheadScope (Ieb152، b/408118041)
  • إصلاح عُطل AppBar في أسفل الشاشة المرتبط بالتمرير مع إخفاء واجهة مستخدم النظام (Ic6140، b/405996228)

الإصدار 1.4.0-alpha12

‫9 أبريل 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-alpha12. يحتوي الإصدار 1.4.0-alpha12 على عمليات الدمج هذه.

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

  • تمت إزالة المَعلمات الخاصة بنظام التشغيل Android من ModalBottomSheetProperties (Iab97f وb/362539765)
  • إضافة وظائف التحميل الزائد لإعدادات حجم مقبض السحب التلقائية (I0ed0d)
  • إضافة الدالتَين NavigationSuiteScaffold وNavigationSuiteScaffoldLayout الجديدتَين لتوفير أنواع تنسيقات جديدة وإتاحة محتوى اختياري للإجراء الأساسي (Ib262a، b/353144478)
  • إيقاف Modifier.weight نهائيًا مع مَعلمة التعبئة في ButtonGroup إضافة نسخة بدون تعبئة (Id32bb)
  • تتم إعادة تسمية الإعدادات التلقائية لمكوّن xSmall- وxLarge- IconButton لتوضيح extra. (Ib6e0f)
  • إضافة وظائف جديدة NavigationSuite وNavigationSuiteItem وNavigationSuiteColors لتوفير أنواع تنسيقات جديدة (I203d6)
  • إضافة الدالتَين الجديدتَين NavigationSuiteTypes وnavigationSuiteType اللتَين تتضمّنان خيارات التنسيق هذه (If68f9)

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

  • تعيّن ColorScheme.contentColorFor الآن surfaceDim إلى onSurface. (I8891a)
  • تم تعديل عملية تنفيذ DateInputTextField لمعالجة مشكلة عدم عرض التاريخ الذي تم ضبطه آليًا في حقل الإدخال. (I6c8d1، b/401143451)
  • تم إصلاح ترتيب التركيز في TalkBack لشريط التنقّل وشريط التنقّل العريض (I6cf6f، b/407048224)

الإصدار 1.4.0-alpha11

‫26 مارس 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-alpha11. يحتوي الإصدار 1.4.0-alpha11 على عمليات الدمج هذه.

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

  • تعديل طريقة كتابة الأحرف الكبيرة والصغيرة لخصائص العناصر القابلة للإنشاء في الكائنات التلقائية للزر وزر التبديل أضِف طرقًا في ToggleButtonDefaults وButtonDefaults لتحديد الحشو والأشكال وحجم الرمز والمسافة بين الرموز ونمط النص للمحتوى المقترَح استنادًا إلى ارتفاع الحاوية. (Iea69e)
  • تمت إزالة الدوال والثوابت التجريبية المتوقّفة نهائيًا من FloatingToolbar. (I8f339)
  • تتشارك الآن مكوّنات الارتفاع واجهة مشتركة، كما أنّها تتضمّن أدوات إنشاء وخصائص عامة. (Ibb172)
  • إضافة المعدِّل animateWidth في ButtonGroupScope الذي يجب استخدامه مع العناصر الفرعية لمجموعة الأزرار لتحريك العناصر الفرعية بشكل صحيح (Ia3bb6)

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

  • تم إصلاح مساحة الحشو في شريط الأدوات العائم لضمان التوازن المرئي أثناء التصغير، وتم تحسين المرونة للمحتوى الأكبر. (I06c00)

الإصدار 1.4.0-alpha10

‫12 مارس 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-alpha10. يحتوي الإصدار 1.4.0-alpha10 على عمليات الدمج هذه.

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

  • تم إيقاف TabRowDefaults.tabIndicatorOffset نهائيًا واستبداله بـ TabIndicatorScope.tabIndicatorOffset. (Ib36b3)
  • إصلاح خطأ إملائي في مساحة الحشو الصغيرة للمحتوى في الإعدادات التلقائية للأزرار (I19bfe)
  • تم إيقاف الإجراءين TabRow وScrollableTabRow نهائيًا واستبدالهما بالمتغيرَين الأساسي والثانوي لكل منهما. أصبحت صفوف علامات التبويب الأساسية والثانوية أكثر فعالية ودقةً وفقًا للمواصفات. (I918e2)
  • تمّت إضافة rememberSliderState وrememberRangeSliderState. (I8e384)
  • تمت إضافة shouldAutoSnap إلى SliderState للتحكّم في آلية المحاذاة التلقائية، وقد يكون إيقافها مفيدًا للرسوم المتحركة المخصّصة. (I07745)
  • أصبح الحدّ الأدنى لعرض علامة التبويب في صف علامات التبويب القابل للتمرير مَعلمة. لم تعُد أشكال الصفوف في علامات التبويب الأساسية والثانوية تجريبية. (If6f15، b/226665301)
  • تمت إتاحة الفئة ExitAlwaysFloatingToolbarScrollBehavior بشكل علني، ما يسمح بإنشاءها بدون تركيب. (Ibf31c)

الإصدار 1.4.0-alpha09

‫26 فبراير 2025

تم طرح androidx.compose.material3:material3-*:1.4.0-alpha09. يحتوي الإصدار 1.4.0-alpha09 على عمليات الدمج هذه.

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

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

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

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

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

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

الإصدار 1.4.0-alpha04

‫13 نوفمبر 2024

تم طرح androidx.compose.material3:material3-*:1.4.0-alpha04. يحتوي الإصدار 1.4.0-alpha04 على عمليات الدمج هذه.

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

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

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

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

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

  • أعِد تسمية DismissibleModalWideNavigationRailDefaults إلى ModalWideNavigationRailDefaults. (I8e877)
  • أضِف NavigationBarComponentOverrides. (I8a3f3)
  • أضِف NavigationRailComponentOverride. (I83e13)
  • إضافة WideNavigationRailState للتعامل مع تصغير/توسيع الشريط الجانبي، والسماح بإغلاق ModalWideNavigationRail وحذف DismissibleModalWideNavigationRail (I88568)
  • إضافة الإعدادات التلقائية للأحجام xSmall ومتوسط وكبير وxLarge إلى الإعدادات التلقائية لزر التبديل (Ie95d1)
  • إضافة الإعدادات التلقائية للأحجام xSmall والمتوسط والكبير وxLarge إلى الإعدادات التلقائية للأزرار (If8b6d)

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

  • تم تعديل لون الرمز اللاحق لشريحة الفلتر من "أساسي" إلى OnSurfaceContainer، وفقًا للمواصفات. تم تعديل جميع ألوان مخطط الشريحة من "مخطط" إلى "مخطط متغير"، وفقًا للمواصفات. (I68bd4)

الإصدار 1.4.0-alpha03

‫30 أكتوبر 2024

تم طرح androidx.compose.material3:material3-*:1.4.0-alpha03. يحتوي الإصدار 1.4.0-alpha03 على عمليات الدمج هذه.

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

  • تم إيقاف طريقة وضع تصميم SheetState التي تتضمّن الكثافة نهائيًا لصالح حدود الموضع والسرعة. (Ifd16e)
  • تمت إضافة rememberTooltipPositionProvider يتضمّن منطقًا معدَّلاً لتحديد المواقع. تم إيقاف rememberPlainTooltipPositionProvider وrememberRichTooltipPositionProvider نهائيًا. (Ie66e2)
  • تتيح لك ModalBottomSheetProperties الإضافية تخصيص ألوان شريط الحالة وشريط التنقّل. يتم تعديل هذه العناصر تلقائيًا استنادًا إلى لون المحتوى بدلاً من حالة المظهر الداكن في النظام. (Ib874e، b/362539765)
  • تم تحسين تجربة الإدخال في أدوات اختيار التاريخ: عند تفعيل وضع الإدخال، سيتم التركيز على حقل نص التاريخ لإدخال النص على الفور. يضيف التغيير المَعلمة requestFocus إلى DatePicker وDateRangePicker. يمكنك منع التركيز من خلال تمرير false. (I12d09، b/286399710، b/340102743)
  • تخزين الإعدادات التلقائية للشكل مؤقتًا في عنصر الشكل ضبط الأشكال التلقائية @Composable لزر التبديل يتم تصغير الأشكال إلى شكل واحد تلقائيًا لأنّ خيارات التصميم تشير إلى ملف الرمز المميز نفسه. (Iaa014)

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

  • تحسين سلوك contentPadding لتجنُّب إعادة إنشاء محتوى النص الأساسي دائمًا عند تغيير contentPadding (I8c8e2، b/373904168)
  • تمت إعادة تسمية TextFieldLabelScope progress إلى labelMinimizedProgress
  • تمت إعادة تسمية TextFieldLabelPosition Default إلى Attached. تمت إزالة عناصر الواجهة. (If75c6)
  • تم إصلاح مشكلة في DatePicker في وضع الإدخال حيث يمكن أن تتسبب أخطاء التحقّق من الصحة في تغيير ارتفاع المكوّن. (I2e229، b/280462363)
  • اجعل شريط التمرير Material Slider يغيّر قيمته عند الضغط على مفاتيح التحكّم. (I1c442)

الإصدار 1.4.0-alpha02

‫16 أكتوبر 2024

تم طرح androidx.compose.material3:material3-*:1.4.0-alpha02. يحتوي الإصدار 1.4.0-alpha02 على عمليات الدمج هذه.

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

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

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

  • تعمل الآن DatePicker وDateRangePicker بشكل صحيح على تعديل الشهر المعروض عند ضبطهما من خلال displayedMonthMillis الخاص بحالتهما. (If9e47، b/333414302)
  • ينقل محتوى ModalBottomSheet الآن المحتوى بعيدًا عن شريط الحالة. (I5114c، b/321877275، b/336962418، b/342093067)
  • [ورقة في أسفل الشاشة] تغيير أولوية معاودة الاتصال إلى 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] يتيح الآن استخدام ميزة "الرجوع التوقّعي" على الإصدارات U+ (Iccf32 وb/281967264 وb/304850357)
  • يتيح الإصدار [SearchBar] الآن استخدام إيماءة إظهار شاشة الرجوع على الإصدار U+‎ (I657f8)
  • تتيح "لائحة التنقّل" (ModalDrawerSheet وDismissibleDrawerSheet) الآن ميزة "الرجوع التوقّعي" على U+‎ كخيار متاح (Ie5b0b)
  • يتيح DropdownMenu الآن تخصيص اللون والشكل والارتفاع والحدود. (I8e981،b/289554448، b/301887035، b/283654243)
  • تم تعديل شريط التمرير لتحسين إمكانية الوصول إليه من خلال إضافة فجوة ومؤشر إيقاف. (I3058e)
  • تم تعديل ProgressIndicator لتحسين إمكانية الوصول من خلال إضافة مؤشر الفجوة والإيقاف. (I21451)
  • تمت إضافة علامة إقحام تلقائية لتلميح الأدوات المنسّق، مع إتاحة رسم علامة إقحام مخصّصة عند توفير عنصر الربط LayoutCoordinates. (Ifd42c) التغييرات التي قد تؤدي إلى أعطال
  • واجهات برمجة التطبيقات الجديدة للسحب لأسفل من أجل التحديث:
    • تم تبسيط PullToRefreshState لاستخدام القيم الكسرية بدلاً من وحدات Dp.
    • يتحكّم المستخدم في حالة isRefreshing بدلاً من PullToRefreshState.
    • تم فصل عملية الربط بالتمرير المتداخل عن PullToRefreshState. تتم معالجة هذه الطلبات من خلال PullToRefreshBox أو Modifier.pullToRefresh الجديدَين.
    • هذا التحديث هو تغيير غير متوافق مع واجهات برمجة التطبيقات التجريبية السابقة. (I0adeb، b/314496282، b/317177684، b/323787138، b/324573502، b/317177683) تغييرات مرئية غير متوافقة مع الإصدارات السابقة
  • عدِّل تراكب حالة التركيز إلى 0.1f لضمان تباين الألوان بشكلٍ كافٍ. (I7ea77)
  • تعديلات بسيطة على الإعدادات التلقائية للون السطح والخلفية في lightColorScheme وdarkColorScheme (I9db52)
  • تم تعديل ألوان شريط التمرير وProgressIndicator لتتوافق مع مواصفات تباين العناصر غير النصية الجديدة. (I26807)
  • تستخدم المكوّنات الآن SurfaceContainer صيغ. المكوّنات التي كانت تحسب اللون رسميًا باستخدام Surface وTonalElevation تستخدم الآن أدوار SurfaceContainer تلقائيًا، وهي لا تتأثر بالارتفاع النغمي. (b/304584161)
  • تم تعديل الأدوار الأساسية لكل من "السطح" و"حاوية السطح" قليلاً، ما يوفّر المزيد من التدرّج اللوني في المظهرين الفاتح والداكن. (I677a5)
  • تمت ترقية واجهات برمجة التطبيقات التجريبية إلى إصدار ثابت.
  • أضفنا تحسينات على الأداء

الإصدار 1.3.0-rc01

‫21 أغسطس 2024

تم طرح androidx.compose.material3:material3-*:1.3.0-rc01. يحتوي الإصدار 1.3.0-rc01 على عمليات الإيداع هذه.

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

  • يظهر العنصر ModalBottomSheet الآن أولاً في ترتيب التنقّل الدلالي، يليه عنصر scrim. (I436f9، b/358594665)

الإصدار 1.3.0-beta05

‫24 يوليو 2024

تم طرح androidx.compose.material3:material3-*:1.3.0-beta05. يحتوي الإصدار 1.3.0-beta05 على عمليات الإيداع هذه.

  • تم إصلاح المشكلة المتمثّلة في عدم توفّر محتوى BottomSheet أو اقتصاصه على الإصدارَين N وO من نظام التشغيل Android (a10a2d)
  • تمت زيادة حدود دلالات شريط التمرير لكي يعرض TalkBack مؤشرات التركيز حول الإبهامين بشكل صحيح. (0b5a1d)

الإصدار 1.3.0-beta04

‫26 يونيو 2024

تم طرح androidx.compose.material3:material3-*:1.3.0-beta04. يحتوي الإصدار 1.3.0-beta04 على عمليات الإيداع هذه.

الإصدار 1.3.0-beta03

‫12 يونيو 2024

تم طرح androidx.compose.material3:material3-*:1.3.0-beta03. يحتوي الإصدار 1.3.0-beta03 على عمليات الدمج هذه.

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

  • إتاحة androidx.compose.material3.DropdownMenu من مجموعة المصادر الشائعة (If62c0)

الإصدار 1.3.0-beta02

‫29 مايو 2024

تم طرح androidx.compose.material3:material3-*:1.3.0-beta02. يحتوي الإصدار 1.3.0-beta02 على عمليات الدمج هذه.

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

  • تتيح Modifier.pullToRefreshIndicator إمكانية الارتفاع، وتعديل واجهات برمجة التطبيقات "السحب لإعادة التحميل" لتفعيلها كقيمة منطقية بدلاً من تعبير لامدا. إتاحة محاذاة المحتوى في PullToRefreshBox (I75679)
  • تحويل TooltipScope إلى واجهة محكمة الإغلاق وإنشاء عملية تنفيذ داخلية لاستخدامها في TooltipBox وLabel (I3833e)
  • تمت إضافة معدِّلَين جديدَين إلى CarouselItemScope - maskClip وmaskBorder - لتسهيل إضافة شكل وحدود إلى أي عنصر في لوحة العرض الدوّارة (Id67a1)
  • TimePickerState هي الآن واجهة وتسمح بضبط الوقت (I88546)
  • تم تعديل واجهة برمجة التطبيقات الخاصة بتصميم الروابط: تم نقل TextLinkStyles إلى TextStyle وإزالة TextDefaults من المواد. (I5477b)

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

  • تتجاوب رموز شريط الحالة وشريط التنقّل في ModalBottomSheet الآن مع حالة المظهر الداكن. (Ie1fe7، b/338342149)
  • تمت إضافة دلالات إغلاق ورقة البيانات إلى ModalBottomSheet scrim. (0e61cb,b/328801864)

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

  • إتاحة androidx.compose.material3.AlertDialog من مجموعة المصادر الشائعة (Ia33f5)
  • إتاحة ModalBottomSheet من مجموعة رموز المصدر المشتركة (Id7cc7)

الإصدار 1.3.0-beta01

‫14 مايو 2024

تم طرح androidx.compose.material3:material3-*:1.3.0-beta01. يحتوي الإصدار 1.3.0-beta01 على عمليات الإيداع هذه.

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

  • استخدام DpSize بدلاً من CaretProperties جارٍ إزالة CaretProperties. أعِد تسمية CaretScope إلى TooltipScope. (Id9a76)
  • تم تعديل واجهة برمجة التطبيقات للحصول على روابط متوافقة مع مظهر Material في النص. على وجه التحديد، تمت إزالة الطرق من TextDefaults لإنشاء LinkAnnotations ذات سمات معيّنة وتحليل HTML باستخدام روابط ذات سمات معيّنة. بدلاً من ذلك، تمت إضافة فئة TextLinkStyles تتيح تصميم الروابط كمعلَمة في العنصر Text القابل للإنشاء. (I31b93)

الإصدار 1.3.0-alpha06

‫1 مايو 2024

تم طرح androidx.compose.material3:material3-*:1.3.0-alpha06. يحتوي الإصدار 1.3.0-alpha06 على عمليات الدمج هذه.

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

  • واجهات برمجة التطبيقات الجديدة للسحب للأسفل من أجل إعادة التحميل:

    • تم تبسيط PullToRefreshState لاستخدام القيم الكسرية بدلاً من وحدات Dp.
    • يتحكّم المستخدم في حالة isRefreshing بدلاً من PullToRefreshState.
    • تم فصل عملية الربط بالتمرير المتداخل عن PullToRefreshState. تتم معالجة هذه الطلبات من خلال PullToRefreshBox أو Modifier.pullToRefresh الجديدَين.
    • هذا التحديث هو تغيير غير متوافق مع واجهات برمجة التطبيقات التجريبية السابقة. (I0adeb، b/314496282، b/317177684، b/323787138، b/324573502، b/317177683)

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

  • تمت إزالة RippleConfiguration#isEnabled، وأصبح LocalRippleConfiguration قابلاً للقيم الخالية. لإيقاف تموّج، بدلاً من تقديم RippleConfiguration مع isEnabled = false، قدِّم null إلى LocalRippleConfiguration. (I22725)
  • تعمل ModalBottomSheet على رسم طبقة تعتيم فوق شريط الحالة بشكل أكثر دقةً عند تفعيل وضع "من الحافة إلى الحافة". يمكن الآن أن يستهلك محتوى ورقة البيانات السفلية المشروطة حواف النافذة، ما يتيح عرض المحتوى فوق شريط التنقّل. تمت إعادة تسمية المَعلمة ModalBottomSheet windowInsets إلى contentWindowInsets لتحديد مكان تطبيق الحواف الداخلية، ولم تعُد هذه الحواف مرتبطة بمنطق النافذة. تم تغيير نوع contentWindowInsets إلى دالة تعرض WindowInsets، وذلك للسماح بحلّها في نافذتها الجديدة. (I39630 وb/274872542 وb/300280229 وb/290893168)
  • يستخدم المكوّنان PrimaryScrollableTabRow وSecondaryScrollableTabRow الآن تخطيطًا مخصّصًا بدلاً من التكوين الفرعي، ما من شأنه أن يحسّن الأداء. (I991e0)
  • تمت إضافة خيار نمط حالة الضغط إلى روابط النصوص، بالإضافة إلى النمط العادي ونمطَي التمرير والتركيز. حصلت كل طريقة من طرق TextDefaults على وسيط pressedStyle لدعم ذلك. (Ic473f، b/139312671)

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

  • تتطابق الآن نقاط الارتكاز الخاصة بسحب لوحة التنقّل مع عرض drawerContent. (Ibc72f، b/245355396)
  • تراعي الآن مساحة الحشو في أعلى التصنيف OutlinedTextField حجم خط النظام. (Idc781)
  • تم تحديد موقع ثابت للحزمة CalendarLocale. (Ifa235)
  • [الرجوع التنبؤي] تعديل الصور المتحركة لإيماءة الرجوع التنبؤي لاستخدام منحنى الاستيفاء (0.1, 0.1, 0, 1) (I2591a)

الإصدار 1.3.0-alpha05

‫17 أبريل 2024

تم طرح androidx.compose.material3:material3-*:1.3.0-alpha05. يحتوي الإصدار 1.3.0-alpha05 على عمليات الدمج هذه.

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

  • يتضمّن SearchBar وDockedSearchBar عمليات تحميل زائدة جديدة تأخذ مَعلمة حقل نصي. يتيح ذلك تنسيق حقل النص بشكل منفصل عن بقية شريط البحث، بالإضافة إلى إدخال حقول نص مخصّصة. تم إتاحة حقل النص في التنفيذ الحالي باسم SearchBarDefaults.InputField. (I50c73 وb/275074248 وb/278773336 وb/326627700)
  • تمت إضافة دالة lambda drawTick إلى واجهة برمجة التطبيقات العامة لتخصيص العلامات إذا لزم الأمر (I0c048)

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

  • تمت إضافة خيار ضبط نمط حالة الضغط على الروابط النصية، بالإضافة إلى النمط العادي ونمطَي التمرير والتركيز (I5f864، b/139312671)
  • تم تعديل CarouselItemInfo لعرض Rect للقناع الذي يتم قص العنصر به (I785d8)
  • تمت إزالة BasicTooltipState من واجهة برمجة التطبيقات العامة Material 3. يتم دمج وظائفه مع TooltipState إلى أن يتم تثبيت BasicTooltip في Foundation. (Icda29)
  • تمت إضافة عنصر TextDefaults يحتوي على طرق لإنشاء LinkAnnotation وتحليل السلسلة التي تحمل علامات HTML والتي تطبّق MaterialTheme على الروابط (I98532، b/139312671)
  • لم يعُد ExposedDropdownMenuBoxScope يسمح بالفئات الفرعية. تحتوي القوائم المنسدلة المكشوفة الآن على MenuAnchorType يجب تمريرها إلى menuAnchor لتوفير إمكانية وصول أفضل. يجب استخدام هذه السمة بدلاً من تمرير focusable إلى ExposedDropdownMenu، لأنّ هذه الطريقة أصبحت متوقّفة نهائيًا. تتضمّن menuAnchor مَعلمة جديدة للتحكّم في حالة enabled. (I55ee6، b/257209915، b/308840226)
  • تم إصلاح لون حدود OutlinedButton عند إيقافها. تمت إضافة حمولة زائدة للدالة ButtonDefaults.outlinedButtonBorder("enabled") تأخذ حالة التفعيل. (Ie650b، b/318461363)
  • تمت إضافة فئة CarouselItemInfo جديدة لمساعدة العملاء في الحصول على معلومات حول أحجام العناصر. (I9070c)
  • تم الآن إيقاف الدالة الإنشائية ColorScheme بدون حاويات العناصر الظاهرية نهائيًا. يُرجى الانتقال إلى أداة الإنشاء التي تتضمّن حاويات العرض. (I35c11)
  • [مخطّط]تمت إعادة تسمية TextFieldDefaults ContainerBox إلى Container. (Ie8d3b)

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

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

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

  • تمت إزالة التركيبة الفرعية داخل ModalBottomSheet لتحسين الأداء. تم إصلاح مشكلة قد تؤدي إلى تعطُّل ModalBottomSheet في سيناريوهات معيّنة عند استخدامها مع LookaheadScope. (I2a198)
  • تمت إزالة التركيبة الفرعية داخل BottomSheetScaffold لتحسين الأداء. تم إصلاح مشكلة تعطُّل BottomSheetScaffold في سيناريوهات معيّنة عند استخدامه مع LookaheadScope. (Ie6401)
  • تم تعديل محاذاة الشارة لتكون أقرب إلى وسط المحتوى الثابت بالنسبة إلى أعلى يسار الشاشة. (I18a28)
  • تم إصلاح مشكلة متعلّقة بإمكانية الوصول في DateRangePicker، حيث تم نقل عنوان نص "الشهر والسنة" على أنّه قابل للتنفيذ لمستخدمي برامج قراءة الشاشة و"الوصول عبر مفتاح تحكّم" و"الوصول الصوتي". (I2ac55)
  • تم إصلاح خطأ ترتيب المَعلمات mediumTopAppBarColors. (Ibe64a)

الإصدار 1.2

الإصدار 1.2.1

‫6 مارس 2024

تم طرح androidx.compose.material3:material3-*:1.2.1. يحتوي الإصدار 1.2.1 على عمليات الدمج هذه.

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

  • اجعل حالات شريط التمرير ثابتة مرة أخرى. إعادة State.onValueChangeFinished إلى حالة صالحة تضمين onValueChangeFinished في rememberUpdatedState (Ie8fd0، b/322269951)
  • إزالة @Stable من حالات Slider لأنّنا سنغيّر state.onValueChangeFinished إلى var (I82ba1، b/322269951)
  • إصلاح ألوان NavigationBar المخصّصة لنسخها من الألوان التلقائية (80a779، b/326894020)
  • إصلاح مشكلة تراجع في ExposedDropdownMenu لجعلها قابلة للتركيز مرة أخرى (3fcec1، b/323694447)
  • إصلاح مشكلة التخزين المؤقت للون زرّ الإصلاح (3e5bbcb/327371655)

الإصدار 1.2.0

‫7 فبراير 2024

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

مشكلة معروفة

  • تم طرح خطأ في عرض التوافق بين View وCompose في الإصدار PrimaryTabRow كجزء من تغيير يهدف إلى تحسين الأداء. الحل البديل هو استخدام TabRow مع TabRowDefaults.PrimaryIndicator

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

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

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

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

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

الإصدار 1.2.0-rc01

‫24 يناير 2024

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

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

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

الإصدار 1.2.0-beta02

‫10 يناير 2024

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

خطأ معروف

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

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

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

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

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

الإصدار 1.2.0-beta01

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

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

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

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

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

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

الإصدار 1.2.0-alpha12

‫29 نوفمبر 2023

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

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

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

الإصدار 1.2.0-alpha11

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

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

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

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

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

  • ضَع علامة "تجريبي" على SwipeToDismissBox وDismissDirection وDismissValue. (I517b0)
  • أعِد تسمية SwipeToDismiss إلى SwipeToDismissBox. أعِد تسمية background إلى backgroundContent وdismissContent إلى دالة lambda content اللاحقة. (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 مباشرةً. يمكن استخدام هذه الدوال كبديل للدالتَين Composable 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)
  • تم إصلاح الخطأ الذي لم يتم فيه استدعاء ModalBottomSheet إلى onDismissedRequest عند إغلاقه من خلال التمرير سريعًا للأسفل على الورقة. (Idfdd8)

الإصدار 1.2.0-alpha07

‫6 سبتمبر 2023

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

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

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

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

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

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

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

الإصدار 1.2.0-alpha06

‫23 أغسطس 2023

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

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

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

الإصدار 1.2.0-alpha05

‫9 أغسطس 2023

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

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

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

الإصدار 1.2.0-alpha04

‫26 يوليو 2023

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

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

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

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

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

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

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

الإصدار 1.2.0-alpha03

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

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

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

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

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

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

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

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

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

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

الإصدار 1.2.0-alpha02

‫24 مايو 2023

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

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

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

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

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

الإصدار 1.2.0-alpha01

‫10 مايو 2023

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

الإصدار 1.1

الإصدار 1.1.2

‫20 سبتمبر 2023

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

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

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

الإصدار 1.1.1

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

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

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

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

الإصدار 1.1.0

‫10 مايو 2023

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

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

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

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

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

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

الإصدار 1.1.0-rc01

‫19 أبريل 2023

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

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

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

الإصدار 1.1.0-beta02

‫5 أبريل 2023

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

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

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

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

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

الإصدار 1.1.0-beta01

‫22 مارس 2023

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

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

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

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

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

الإصدار 1.1.0-alpha08

‫8 مارس 2023

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

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

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

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

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

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

  • تم إصلاح المشكلة المتمثّلة في احتساب حالة ModalBottomSheet بشكل غير صحيح وظهور الورقة على أنّها عائمة.HalfExpanded (I45e84، b/268411386)
  • أضِف علامة confirmValueChange إلى النقر على طبقة التعتيم من أجل ModalBottomSheet. (I2311a، b/270425759)
  • نقل إجراءات BottomSheet الدلالية إلى مقبض السحب (I158ba)
  • تتولّى ModalBottomSheet الآن التركيز عند التشغيل، وتتعامل مع زر الرجوع. (I4d2ab)
  • يتم الآن أيضًا التعامل مع ModalBottomSheet onDismissRequest أثناء عمليات التمرير السريع المتداخلة. (I655c5، b/268433166)

الإصدار 1.1.0-alpha07

‫22 فبراير 2023

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

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

  • أضِف عنصر Time Input قابل للإنشاء يعمل مع rememberTimePickerState()، ويتّبع مواصفات M3 لإدخال الوقت (Ia4fab)
  • تمت إضافة واجهة برمجة تطبيقات DateRangePicker Material 3 لاختيار نطاق من التواريخ. (I7a6c3، b/267194809)
  • تمت إضافة إمكانية استخدام وضع الإدخال Material 3 لاختيار النطاقات الزمنية من خلال واجهة برمجة التطبيقات DateRangePicker. (Ifdbc4)
  • تتيح ألوان حقول النص الآن تخصيص ما يلي:
    • ألوان حقل الإدخال ونص العنصر النائب استنادًا إلى حالة التركيز وحالة الخطأ تمت إعادة تسمية المَعلمة textColor إلى unfocusedTextColor، كما تمت إعادة تسمية placeholderColor إلى unfocusedPlaceholderColor.
    • لون الحاوية لحقول النص المملوءة استنادًا إلى حالة الخطأ باستخدام المَعلمة errorContainerColor الجديدة
  • تم تعديل ألوان حقل النص في القائمة المنسدلة المكشوفة باستخدام مَعلمات لتتوافق مع واجهة برمجة التطبيقات الجديدة الخاصة بالبادئة واللاحقة. (I9c8b4، b/254284181، b/264766350)

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

  • التراجع عن بعض إصدارات Slider API وإزالة عمليات التحميل الزائد المتكرّرة في Slider التي يغطيها Slider التجريبي الجديد مع شريط تمرير وإبهام مخصّصَين الترويج لـ RangeSlider ليكون مستقرًا (Ie8fbd)
  • تمت إعادة تسمية defaultElevation إلى elevation في دوال مستوى ارتفاع الشريحة. (I0f872)
  • لم تعُد واجهات برمجة التطبيقات التالية لحقول النص في Material 3 تجريبية: TextField وOutlinedTextField وtextFieldWithLabelPadding وtextFieldWithoutLabelPadding وoutlinedTextFieldPadding. (Ieb5c0، b/261561819)
  • TimePickers is24Hour تستخدم إعدادات النظام (I18856)
  • تمت إزالة التعليق التوضيحي التجريبي من واجهات برمجة التطبيقات الخاصة بإنشاء الرموز. (Ibb51e وb/261565765 وb/261436953)

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

  • أصبح الشكل التلقائي ModalBottomSheet هو SheetDefaults.ExpandedShape دائمًا. (I0dfca)
  • تحسينات على تسهيل الاستخدام في Material 3 DatePicker و DateRangePicker (I5087e)
  • تم إصلاح الخطأ الذي يتم فيه نشر قيد الحد الأقصى للارتفاع وقد يؤدي إلى تعطُّل التطبيق. (I30d8c)
  • إزالة الأدوار الدلالية من المساحات القابلة للنقر والتحديد، وتعديل المكوّنات التي كانت تستخدمها لضبط الأدوار باستخدام modifier.semantics (I793d9)

الإصدار 1.1.0-alpha06

‫8 شباط (فبراير) 2023

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

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

  • تتيح حقول النص الآن استخدام نص البادئة واللاحقة (Ia8578، b/179884561)
  • تمت إضافة الدالة TimePicker لعرض أداة اختيار الوقت وفقًا لمواصفات Material 3، ويتم استخدامها مع TimePickerState وطريقة الاستخدام السهل rememberTimePickerState (I71910)
  • أصبح إدخال التاريخ الآن وضع عرض في DatePicker. تمت إضافة إمكانية التبديل بين وضعَي "أداة اختيار التاريخ" و"إدخال التاريخ". (Ieeff7)
  • تمت إضافة واجهة برمجة التطبيقات لـ RichTextTooltips. (I58ef3)
  • تنفيذ البطاقة السفلية المقيِّدة في Material 3، بما في ذلك ModalBottomSheet وModalBottomSheetDefaults يقدّم هذا الإصدار أيضًا SheetState وrememberSheetState اللذين يمكن استخدامهما لمكوّنات ورقة الملصقات المستقبلية. (I0853a، b/244189383)

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

  • تثبيت واجهة برمجة التطبيقات showSnackbar (I195c2، b/261424370)
  • تثبيت واجهات برمجة التطبيقات لشريحة المساعدة وشريحة الاقتراحات (Ibb67b وb/261424370)
  • ترقية واجهات برمجة التطبيقات ListItem وListItemDefaults وListItemColors إلى إصدار غير تجريبي (I7e7fa وb/261438882)
  • ترقية SliderPositions وSliderDefaults.Thumb وSliderDefaults.Track إلى إصدار ثابت وإضافة واجهتَي برمجة التطبيقات Slider وRangeSlider غير التجريبيتين اللتين تتضمّنان صورًا مصغّرة ومسارات مخصّصة سيتم أيضًا إيقاف واجهتَي برمجة التطبيقات السابقتَين Slider وRangeSlider نهائيًا. (Ie5ea6، b/261566890)
  • تمت إتاحة Modifier.tooltipAnchor() للجميع، ما يتيح للمطوّرين تمريرها إلى العنصر الأساسي للإشارة إلى أنّه يجب عرض تلميح عند الضغط مع الاستمرار. تم تعديل واجهة برمجة التطبيقات PlainTooltipBox لكي لا تكون TooltipState قابلة للقيم الخالية، وأصبحت تتضمّن قيمة تلقائية. (Ie2fb7)
  • تم وضع العلامة @Composable على ProgressIndicatorDefaults.circularTrackColor لضمان الاتساق. (Id29cc)
  • تمت استعادة دالة جلب السمة LocalMinimuTouchTargetEnforcement ووضع علامة عليها على أنّها متوقّفة نهائيًا وإعادة التوجيه إلى LocalMinimumInteractiveComponentEnforcement. (I60dd5)

الإصدار 1.1.0-alpha05

‫26 يناير 2023

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

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

  • DatePickerDialog وأدوات تسهيل الاستخدام
  • تمت إضافة صورة مصغّرة مخصّصة ومسار إلى RangeSlider.

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

  • يعتمد كل من Compose UI وCompose Material الآن على Lifecycle 2.6.0.

الإصدار 1.1.0-alpha04

‫11 يناير 2023

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

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

  • DatePicker API الأوّلي لاختيار تاريخ واحد من خلال واجهة مستخدم التقويم لا تزال هذه الواجهة تخضع لتغييرات. (I722b9)
  • تمت إضافة إمكانية استخدام تلميحات الأدوات العادية من خلال PlainTooltipBox. (I0cdfb)
  • شريط البحث (Iad128)
  • SwipeToDismiss (I458a8، b/242889540)

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

  • تمت إضافة السمة الدلالية IsContainer على "المنصات". سيتم استخدام هذه السمة في تغيير لاحق يحدّد ترتيب الانتقال استنادًا إلى المعنى الدلالي للعناصر، مثل المساحات. (I63379)
  • وضع علامة "ثابتة" على واجهات برمجة التطبيقات ذات الصلة بلوحة التنقّل (Iab01e، b/261439597)
  • تمت إضافة مَعلمة لون المسار لمؤشرات التقدم الدائرية، ومَعلمة غطاء نهاية الخط لكلّ من مؤشرات التقدم الدائرية والخطية. (Ie668c، b/216325962، b/222964817)
  • المزيد من إمكانية قبول القيمة الخالية لأنواع الإرجاع للدوال المتوقفة نهائيًا والمخفية (Ibf7b0)
  • أضِف Modifier.minimumInteractiveComponentSize. يمكن استخدامها لحجز مساحة لا تقل عن 48 وحدة بكسل مستقلة الكثافة (dp) لتوضيح التفاعلات باللمس إذا كان قياس العنصر أصغر. (I33f58، b/258495559)
  • تمت إضافة واجهة برمجة تطبيقات تجريبية للعنصر القابل للإنشاء AlertDialog الذي يتضمّن موضعًا للمحتوى. (Iec4a2)

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

  • تم الآن ربط مستوى التقدّم في مؤشرات التقدّم بالنطاق المتوقّع بشكل صحيح. (I8a7eb، b/262262727)

مشكلة معروفة

  • عند التحديث من androidx.compose.foundation:1.4.0-alpha03 إلى androidx.compose.foundation:1.4.0-alpha04، قد يظهر لك الخطأ java.lang.NoSuchFieldError. هنا تم الإبلاغ عن المشكلة في الأصل. تم إرسال إصلاح، وسيتوفّر في تحديث Compose التالي. كحلّ بديل، يمكنك تحديث مكتبتَي androidx.compose.material وandroidx.compose.material3 إلى أحدث إصدار(1.1.0-alpha04) أو الرجوع إلى الإصدار 1.4.0-alpha03 من androidx.compose.foundation.

الإصدار 1.1.0-alpha03

‫7 كانون الأول (ديسمبر) 2022

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

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

  • تمت إعادة تسمية consumedWindowInsets() إلى consumeWindowInsets() وwithConsumedWindowInsets() إلى onConsumedWindowInsetsChanged()، وأصبحت "المعدّلات" متاحة للجميع. (Ie44e1)
  • إضافة مساحة جديدة تلقائية لترك مسافة بين المحتوى وزر النص مع الرمز المراد استخدامه (I8f662)
  • تمت إضافة ألوان غير متاحة لشريط التنقّل وشريط التطبيقات. (Ia7892، b/258867034)
  • تمت إضافة Modifier API للاستعلام عن معلومات التمرير الخاصة بالعناصر الرئيسية. (I2ba9d، b/203141462)
  • يُستخدَم في Clickable لتأخير تفاعلات الضغط بشكل صحيح، عندما يمكن أن تصبح الإيماءات أحداث تمرير.
  • تم إصلاح المشكلة المتمثلة في عدم تأخير Clickables التموجات بشكلٍ صحيح عند استخدامها داخل Scrollable ViewGroup.
  • تم تعديل الأدراج وأوراق البيانات لتأخير الضغطات بشكل صحيح في حال إمكانية تحوّل الإيماءات إلى أحداث تمرير.

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

  • يعتمد كل من Compose UI وCompose Material الآن على الإصدار 2.5.1 من Lifecycle. (I05ab0، b/258038814)

الإصدار 1.1.0-alpha02

‫9 نوفمبر 2022

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

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

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

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

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

الإصدار 1.1.0-alpha01

‫24 أكتوبر 2022

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

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

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

الإصدار 1.0

الإصدار 1.0.1

‫9 نوفمبر 2022

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

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

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

الإصدار 1.0.0

‫24 أكتوبر 2022

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

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

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

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

مكوّنات Material Design 3

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

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

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

الإصدار 1.0.0-rc01

‫5 أكتوبر 2022

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

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

  • تمت إضافة مَعلمة للخانة من أجل إتاحة واجهة برمجة التطبيقات الخاصة بحقل النص إلى النص (Iaac0d، b/227146125)

الإصدار 1.0.0-beta03

‫21 سبتمبر 2022

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

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

  • تعرض السمة ExposedDropdownMenuDefaults الآن قيمة مساحة متروكة لعناصر القائمة. (I34ee1)
  • يتضمّن ExposedDropdownMenuBoxScope الآن المعدِّل Modifier.menuAnchor() الذي يجب تمريره إلى حقل النص لضمان سلوك تسهيل الاستخدام السليم. (I27fa3)
  • إضافة طريقتَين محمّلتَين بشكل زائد إلى واجهة برمجة التطبيقات الحالية الخاصة بشريط التمرير للسماح للمستخدمين بتمرير صورة مصغّرة أو مسار لتعبئة شريط التمرير (I21c00)

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

  • تم تعديل عملية ربط ألوان المظهر الداكن لعنصر On Error Container إلى درجة اللون 90 (Ic5612)
  • تم إصلاح مشكلة عدم إمكانية ضبط خلفية شفافة لأشرطة التطبيقات العلوية الصغيرة في Material 3. (I645e2، b/245575782)

الإصدار 1.0.0-beta02

‫7 أيلول (سبتمبر) 2022

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

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

  • لم تعُد عمليات إدراج المكوّنات التلقائية في مكوّنات m3 في الإصدار beta01 تراعي عمليات إدراج IME.
  • يحتوي مكوّن Material3 Scaffold الآن على المَعلمة contentWindowInsets، ما يتيح تحديد مقدار الهوامش الداخلية التي يجب التعامل معها في موضع المحتوى. (Icf11a، b/243713323)
  • إيقاف الدالة التجريبية SmallTopAppBar في Material 3 وإتاحة الدالة المكافئة TopAppBar يُرجى نقل استخدامك إلى الإصدار الجديد. (I74404، b/226918634)
  • تضيف هذه السمة إمكانية التحكّم في سلوكَي "التحريك السريع" و"المحاذاة" لشريط التطبيق العلوي. (I15c81)
  • تزيل هذه السمة startIndent من Divider، وتنقل اللون إلى المَعلمة الأخيرة. (If7be2)

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

  • يجب أن تعرّف مربّعات الحوار عن نفسها لمستخدمي TalkBack من خلال الإعلان عن كلمة "مربّع حوار" عند عرضها. (I857ef)

الإصدار 1.0.0-beta01

‫24 أغسطس 2022

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

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

للاطّلاع على أحدث ميزات تغيير المظهر والمكوّنات وغيرها من العناصر القابلة للإنشاء المتوفّرة، يمكنك الاطّلاع على نظرة عامة على مرجع واجهة برمجة التطبيقات Compose Material 3.

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

  • تم تعديل شريط التطبيق العلوي في Material 3 ليتم تثبيته في حالة مصغّرة بالكامل أو موسّعة بالكامل. تم أيضًا تعديل دالة السلوك TopAppBarDefaults لتكون قابلة للإنشاء وتوفير قيم تلقائية لحالة شريط التطبيق العلوي ومواصفات الحركة. (I642b3)
  • تم تعديل تواقيع مكوّن زر الإجراء العائم لتتطابق مع واجهة برمجة التطبيقات الخاصة بالسطح (I3afaa)
  • تمت إضافة إمكانية استخدام الحواف الداخلية المضمّنة في "شريط التطبيق العلوي" و"الأدراج" و"شريط التنقّل" و"الشريط الجانبي". عند استخدام هذه المكوّنات بشكل منفصل أو مع Scaffold، ستتعامل تلقائيًا مع الحواف الداخلية للمطوّرين. ملاحظة: لا يضيف هذا التغيير معالجة تلقائية لرموز شريط الحالة وشفافية شريطَي الحالة والتنقّل. يُرجى مواصلة إجراء ذلك يدويًا لضمان الحصول على أفضل تجربة من الحافة إلى الحافة. (I7e4e6، b/183161866)
  • تم تعديل الإعدادات التلقائية للمكوّنات لتقليل مساحة واجهة برمجة التطبيقات من أجل توفير مرونة وتحسينات في الأداء في المستقبل. (I31820)
  • إعادة ترتيب مَعلمات شريحة الفلتر وورقة لوحة التنقّل للحفاظ على الاتساق داخل واجهة برمجة التطبيقات (I45d0b)
  • تمت إزالة startIndent من "الفاصل" ونقل اللون ليكون المَعلمة الأخيرة.(If7be2)

الإصدار 1.0.0-alpha16

‫10 أغسطس 2022

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

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

  • إتاحة تحديد عرض مخصّص للوحة التنقّل (Ia7f10)

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

  • إعادة ترتيب مَعلمات علامة التبويب وعلامة التبويب الرئيسية للحفاظ على الاتساق داخل واجهة برمجة التطبيقات (Ie2637)
  • تم وضع علامة BadgeDefaults على أنّه تجريبي. (I98ef3)
  • إزالة وظيفة درج التنقّل التي تم إيقافها نهائيًا (I4f2db)
  • إعادة ترتيب مَعلمات شريط التمرير في Material 3 للحفاظ على الاتساق داخل واجهة برمجة التطبيقات (I0aee7)
  • إعادة ترتيب المَعلمتَين NavigationBar وNavigationRail للحفاظ على الاتّساق داخل واجهة برمجة التطبيقات (I51cda)
  • إعادة ترتيب المَعلمات في Material 3 للحفاظ على الاتساق في جميع أنحاء واجهة برمجة التطبيقات (If4ae1)
  • إعادة ترتيب مَعلمات شريط التمرير في Material 3 للحفاظ على الاتساق داخل واجهة برمجة التطبيقات (I62673)
  • تمت إعادة تسمية مَعلمة الرموز إلى الإجراءات لتكون متوافقة مع شريط التطبيق العلوي (Id75be)
  • ضَع علامة "تجريبي" على Badge وBadgedBox لأنّ محاذاة العنصر الثابت لا تزال قيد التغيير. (I1712e، b/236524516)
  • تغيير التعليقات التوضيحية @ExperimentalMaterial3Api في أشكال زر الرمز إلى @OptIn (I070b5)
  • تم فصل محتوى لوحة التنقّل إلى عنصر قابل للإنشاء خاص به لإتاحة تحديد عرض مخصّص له. (Ia7f10)
  • إزالة Divider من MenuDefaults وTabDefaults (I4e33c)

الإصدار 1.0.0-alpha15

‫27 يوليو 2022

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

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

  • السماح بسحب شريط التطبيق العلوي من الشريط نفسه (I65c00، b/205873416)

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

  • تعديلات على واجهتَي برمجة التطبيقات FilterChip وElevatedFilterChip لإزالة الخانة selectedIcon وتشجيع إعادة استخدام leadingIcon لعرض الحالة المحدّدة (Ie5dc2)
  • أضِف أدوار ألوان مختلفة للطبقة الشفافة والمخطط التفصيلي. (Id6d54)
  • إصلاح اصطلاحات التسمية للإعدادات التلقائية القابلة للإنشاء (I62b27)
  • وضع علامة "تجريبي" على ListItemDefaults وListItemColors (I1f3ec)
  • تغييرات على واجهة برمجة التطبيقات الخاصة بشريط التطبيق العلوي لتعكس بشكل أفضل معنى خصائص الحالة. ضَع أيضًا علامة على واجهة برمجة التطبيقات الخاصة بشريط التطبيقات العلوي للإشارة إلى أنّها تجريبية. (Ic0ad8)
  • تمت إضافة ألوان تحديد النص إلى TextFieldColors لتسهيل العثور عليها. (Iba1b8)
  • إضافة ButtonDefault.ButtonWithIconContentPadding لاستخدامه مع الأزرار التي تحتوي على رمز (I2bf9c)
  • تم وضع علامة "تجريبي" على حقول النص للسماح بمزيد من المرونة في التغييرات المستقبلية على واجهة برمجة التطبيقات. (I127b5)
  • تمت إزالة التعليق التوضيحي @ExperimentalMaterial3Api من الدالة Checkbox. (I5eefc)
  • تمت إزالة التعليق التوضيحي @ExperimentalMaterial3Api من الدالة RadioButton. (I17e2a)
  • تمت إزالة التعليق التوضيحي @ExperimentalMaterial3Api من البطاقات غير التفاعلية. (I9bd49)
  • تعديل مختلف الكائنات التلقائية للمكوّنات لتضمين الألوان والأشكال وما إلى ذلك (I96e11)

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

  • تمت إزالة الرموز اللاحقة غير العاملة من عيّنات شرائح الإدخال لتجنُّب إرباك المستخدم في تطبيق الكتالوج. (I9846a)

الإصدار 1.0.0-alpha14

‫29 يونيو 2022

تم طرح androidx.compose.material3:material3:1.0.0-alpha14 وandroidx.compose.material3:material3-window-size-class:1.0.0-alpha14. يحتوي الإصدار 1.0.0-alpha14 على عمليات الإيداع التالية.

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

  • تمت إضافة تنفيذ قائمة M3، راجِع المستندات لمعرفة كيفية الاستخدام النموذجي (Id7a20)

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

  • تغيير اسم المَعلمة من "القيم" إلى "القيمة" في RangeSlider (I3b79a)
  • تغييرات في واجهة برمجة التطبيقات على تنفيذ InputChip لتوفير حالة قابلة للتحديد وفقًا لمواصفات Material Design دعم إضافي في ألوان FilterChip للحالة المحدّدة غير المفعّلة (I55244، b/235792432)
  • إضافة زر إجراء عائم تلقائي BottomAppBar (Ida4c8)
  • تمت إضافة ColorScheme.surfaceColorAtElevation (Id41af)
  • أصبحت الواجهات في مكتبات Compose الآن تستخدم طرق الواجهة التلقائية في الإصدار 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)
  • إضافة توافق مع Material3 AssistChip وInputChip (I0d25a)
  • إضافة توافق FilterChip وSuggestionChip مع Material3 (I9fdf3)

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

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

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

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

الإصدار 1.0.0-alpha10

‫20 أبريل 2022

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

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

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

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

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

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

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

الإصدار 1.0.0-alpha09

‫6 أبريل 2022

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

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

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

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

  • تمت إضافة إمكانية استخدام القوائم المنسدلة مع حقول النص (المعروفة أيضًا باسم "القوائم المنسدلة المكشوفة" أو "مربّعات التحرير والسرد"). (I1b832)
  • تمت إضافة مَعلمة الشكل إلى MaterialTheme ونظام Shape الفرعي. (I37426)
  • تمت إضافة مَعلمة موسّعة إلى ExtendedFloatingActionButton للتحكّم في ما إذا كان زر الإجراء العائم موسّعًا أو مصغّرًا، مع إضافة رسوم متحركة بين كل حالة. تمت إضافة تحميل زائد لزر الإجراء العائم الموسّع من أجل أزرار الإجراء العائم الموسّعة التي تتضمّن نصًا لاحقًا لأزرار الإجراء العائم الموسّعة بدون رمز. (Iba7f1)

الإصدار 1.0.0-alpha08

‫23 مارس 2022

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

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

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

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

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

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

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

الإصدار 1.0.0-alpha07

‫9 مارس 2022

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

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

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

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

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

الإصدار 1.0.0-alpha06

‫23 فبراير 2022

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

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

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

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

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

الإصدار 1.0.0-alpha05

‫9 فبراير 2022

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

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

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

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

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

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

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

الإصدار 1.0.0-alpha04

‫26 يناير 2022

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

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

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

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

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

الإصدار 1.0.0-alpha03

‫12 يناير 2022

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

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

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

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

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

الإصدار 1.0.0-alpha02

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

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

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

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

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

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

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

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

الإصدار 1.0.0-alpha01

‫27 أكتوبر 2021

تم طرح androidx.compose.material3:material3:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على عمليات الدمج التالية.

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

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

مكوّنات Material Design 3

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