‫Compose Material 3

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

البنية

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

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

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

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

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

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

أنيق

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

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

الملاحظات

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

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

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

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

الإصدار ‎1.0.0-alpha01

‫23 سبتمبر 2026

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

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

يوفّر عارض Agent-to-UI (A2UI) في Jetpack Compose عملية تنفيذ بروتوكول A2UI، ما يتيح لوكلاء الذكاء الاصطناعي إنشاء واجهات مستخدم تفاعلية وغنية تعرض مكوّنات Compose الأصلية بدون تنفيذ أي رموز برمجية عشوائية. توفّر هذه المكتبة تنفيذًا جاهزًا للاستخدام لمواصفات "الكتالوج الأساسي لواجهة المستخدم التلقائية للسيارة" (A2UI) العادية، تم إنشاؤه باستخدام مكوّنات التصميم المتعدد الأبعاد 3.

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

  • عدِّل ترتيب المكوّنات في A2uiBasicCatalogV ليتطابق تمامًا مع مواصفات الفهرس الأساسية. (I23093، b/547851648)
  • تمت إضافة ChecksProperty إلى جميع واجهات المكوّنات ذات الصلة ضمن A2uiBasicCatalogV1 وإتاحة قيمة السمة من خلال مَعلمة تم تمريرها إلى TypedContent لكل مكوّن. (I9f393، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.ChoicePicker وMaterialA2uiBasicCatalogV1Defaults.choicePicker. (I875a6، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.Modal وMaterialA2uiBasicCatalogV1Defaults.modal. (Icd553، b/547851648)
  • تمت إضافة AccessibilityProperty إلى جميع واجهات المكوّنات ضمن A2uiBasicCatalogV1 وإتاحة قيمة السمة من خلال مَعلمة تم تمريرها إلى TypedContent لكل مكوّن. (I76b80، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.TextField وMaterialA2uiBasicCatalogV1Defaults.textField. (Ifdaec، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.Video وMaterialA2uiBasicCatalogV1Defaults.video. (I8595c، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.AudioPlayer وMaterialA2uiBasicCatalogV1Defaults.audioPlayer. (Ida509، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.Slider وMaterialA2uiBasicCatalogV1Defaults.slider. (Ieb72d، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.CheckBox وMaterialA2uiBasicCatalogV1Defaults.checkBox. (I84525، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.Divider وMaterialA2uiBasicCatalogV1Defaults.divider. (I91208، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.Tabs وMaterialA2uiBasicCatalogV1Defaults.tabs. (Ic33d3، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.List وMaterialA2uiBasicCatalogV1Defaults.list. (I89f73، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.Icon وMaterialA2uiBasicCatalogV1Defaults.icon. (I65524، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.Image وMaterialA2uiBasicCatalogV1Defaults.image. (I673b3، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.Button وMaterialA2uiBasicCatalogV1Defaults.button. (I5215f، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.Row/A2uiBasicCatalogV1.Column وMaterialA2uiBasicCatalogV1Defaults.row/ MaterialA2uiBasicCatalogV1Defaults.column. (Ibcbe7، b/547851648)
  • تمت إضافة MaterialImageComponent لدعم عرض الصور في كتالوج A2UI. اختبار: MaterialImageComponentTest في androidx-main
  • تمت إضافة MaterialImageComponent لدعم عرض الصور في كتالوج A2UI. (I868fe)
  • تمت إضافة A2uiBasicCatalogV1.Card وMaterialA2uiBasicCatalogV1Defaults.card. (Icf604، b/547851648)
  • تم إيقاف التحميل الزائد غير المرتبط بحالة Slider وRangeSlider نهائيًا لصالح الإصدارات المرتبطة بحالة. تم تغيير اسم activeRangeStart وactiveRangeEnd في RangeSliderState إلى startValue وendValue، وتم إيقاف واجهات برمجة التطبيقات القديمة غير الترويجية والتجريبية الخاصة بأداة "شريط التمرير" نهائيًا باستخدام DeprecationLevel.HIDDEN. (If8995)
  • تمت إضافة الدالة المركّبة A2uiSurface والعنصر A2uiSurfaceDefaults لعرض مساحات عرض A2UI. (I6e276، b/544713825)
  • تمت إضافة دالة مركّبة A2uiTestSurface لتثبيت واختبار مساحات عرض ومركّبات A2UI بشكل منفصل. (I03c8a، b/527415570)

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

  • تم تعديل compileSdk لمكتبات Compose إلى الإصدار 37.1. سيتطلّب ذلك تعديل compileSdk بشكل متعدٍّ لجميع التطبيقات والمكتبات التي تستخدم Compose. (I05b0f)

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

الإصدار ‎1.0.0-alpha01

‫17 أبريل 2024

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

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

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

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

الإصدار ‎1.0.0-alpha07

‫1 مايو 2024

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

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

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

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

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

الإصدار ‎1.0.0-alpha06

‫17 أبريل 2024

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

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

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

الإصدار ‎1.0.0-alpha05

‫6 آذار (مارس) 2024

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

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

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

الإصدار ‎1.0.0-alpha04

‫21 فبراير 2024

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

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

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

الإصدار ‎1.0.0-alpha03

‫7 فبراير 2024

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

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

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

الإصدار ‎1.0.0-alpha02

‫13 ديسمبر 2023

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

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

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

  • إصلاح مشكلة ملء مكوّن التنقّل للشاشة بالكامل عندما يحتوي سطح العرض الأساسي على modifier.fillMaxSize (c9cf250، b/312664933)

الإصدار ‎1.0.0-alpha01

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

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

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

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

الإصدار ‎1.0.0-alpha06

‫7 فبراير 2024

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

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

  • تمت إضافة خيارات سلوك إضافية ThreePaneScaffoldNavigator للتنقّل للخلف. (I858aa)
  • تمت إضافة محتوى الوجهة الاختياري إلى سجلّ التنقّل. (Ibd7e6)

الإصدار ‎1.0.0-alpha05

‫24 يناير 2024

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

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

  • إتاحة استخدام سجلّ التنقّل في إنشاء بنية التطبيق وحساب القيم (I71d46)

الإصدار ‎1.0.0-alpha04

‫10 يناير 2024

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

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

  • تمت إضافة إمكانية عرض المحتوى من الحافة إلى الحافة في هياكل الألواح (I1b462)

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

  • نقل خصائص حدود المفصلة في Posture إلى قائمة بمعلومات المفصلة (I24f90)

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

  • عدم إعادة إنشاء إصلاح AnimatedPane (c3f573d)

الإصدار ‎1.0.0-alpha03

‫13 ديسمبر 2023

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

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

  • تغيير أدوار الهيكل إلى أسماء مستعارة لـ ThreePaneScaffoldRole (I65bd1)
  • إنشاء صنف أساسي لأدوار السقالات (I4784d)
  • إزالة المَعلمة غير الضرورية من محتوى AnimatedPane (Ibc73b)
  • إعادة تسمية collectWindowSizeAsState وعرض القيم الأولية بدلاً من ذلك (I480f4)

الإصدار ‎1.0.0-alpha02

‫29 نوفمبر 2023

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

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

  • فصل واجهات برمجة تطبيقات التنقّل عن واجهات برمجة تطبيقات الهيكل المتكيّف (Ic4045)
  • إزالة صف GutterSize (I785b3)

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

  • عدم تبديل اللوحات الثابتة عند عدم استخدام AnimatedPane (d88f181)

الإصدار ‎1.0.0-alpha01

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

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

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

واجهات برمجة التطبيقات الخاصة بالظروف التكيّفية في Material3:

واجهات برمجة التطبيقات لتوجيهات Material3 adaptive pane scaffold:

واجهات برمجة التطبيقات الخاصة بهيكل اللوحة التكيّفية في Material3:

‫Compose Material3 الإصدار 1.5

الإصدار ‎1.5.0-alpha29

‫23 سبتمبر 2026

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

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

  • تغيير غير متوافق في المصدر: أصبحت onValueChange الآن مَعلمة مطلوبة في Slider وRangeSlider، وتم تغيير ترتيبها في قائمة المَعلمات

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

  • يتم الآن حلّ DatePicker في إطار واحد من خلال احتساب مدى توفّر التنقّل بين الأشهر مباشرةً من فهرس الأشهر المعروض. (I08db7)
  • تستخدم TimeInput الآن داخليًا واجهات برمجة التطبيقات الجديدة لحقل النص TextFieldState. (Ia7492، b/353692863)
  • تستخدم DateInput الآن داخليًا واجهات برمجة التطبيقات الجديدة لحقل النص TextFieldState. (I5ad3d، b/353692863)
  • تتعامل الآن Slider وRangeSlider مع onValueChange وonValueChangeFinished مباشرةً في عمليات التنفيذ بدلاً من تمريرها إلى SliderState وRangeSliderState. (I959ac)

الإصدار ‎1.5.0-alpha28

‫9 سبتمبر 2026

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

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

  • تمت إعادة تسمية واجهة برمجة التطبيقات الخاصة بمنصّة العرض الدوّارة المتعددة الجوانب وتبسيطها لتصبح معدِّلاً عامًا carouselParallaxScrollEffect (I46b17)
  • تمت إزالة عمليات التحميل الزائد التي تم إيقافها نهائيًا في ToggleButton. تمت إضافة دوال مساعدة (contentPaddingFor وshapesFor) وثوابت تلقائية (بما في ذلك size) إلى ToggleButtonDefaults وElevatedToggleButtonDefaults وFilledTonalToggleButtonDefaults وOutlinedToggleButtonDefaults. (I998cf)

  • تم إيقاف التحميل الزائد غير المرتبط بحالة Slider وRangeSlider نهائيًا لصالح الإصدارات المرتبطة بحالة. تم تغيير اسم activeRangeStart وactiveRangeEnd في RangeSliderState إلى startValue وendValue، وتم إيقاف واجهات برمجة التطبيقات القديمة غير الترويجية والتجريبية الخاصة بأداة "شريط التمرير" نهائيًا باستخدام DeprecationLevel.HIDDEN. (If8995)

    لنقل بيانات Slider، من: kotlin var value by remember { mutableFloatStateOf(0.5f) } Slider(value = value, onValueChange = { value = it }) إلى: kotlin val state = remember { SliderState(value = 0.5f) } Slider(state = state)

    لنقل بيانات RangeSlider، من: kotlin var range by remember { mutableStateOf(0.2f..0.8f) } RangeSlider(value = range, onValueChange = { range = it }) إلى: kotlin val state = remember { RangeSliderState(startValue = 0.2f, endValue = 0.8f) } RangeSlider(state = state)

  • إضافة مَعلمتَي boolean المفعّلة واللون غير المفعّل إلى ScrollField (Iab612)

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

  • إضافة إمكانية استخدام حلقة التركيز مع ScrollField (If21d6)
  • إجراء تعديلات على ملاحظات التصميم من أجل TimePicker التعبيري في وضع الاتصال (I8795e)
  • إجراء تعديلات على المساحة المتروكة في الوضع "معبِّر" TimePicker في وضعَي التمرير والإدخال (Iddb33)
  • تعدّل هذه السمة حساب ارتفاع/تنسيق زر التبديل استنادًا إلى عدد العناصر في TimePicker.kt التعبيري في الوضع غير المضمّن. (I30700)
  • تم إصلاح مشكلة اقتطاع عناصر التحكّم في التنسيق صباحًا/مساءً في TimePicker عند تفعيل ميزة "النص الكبير" أو "تحجيم الخط". (Iaca60)
  • تم تعديل المكوّنين SecureTextField وOutlinedSecureTextField (بالإضافة إلى عمليات التحميل الزائد BasicSecureTextField المتوقّفة نهائيًا) لاستخدام TextObfuscationMode.System كوضع التعتيم التلقائي بدلاً من TextObfuscationMode.RevealLastTyped. (I76c7e)

الإصدار 1.5.0-alpha27

‫26 أغسطس 2026

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

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

  • تمت إعادة تسمية RichTimePickerDialog إلى VibrantTimePickerDialog، وإعادة تسمية richColors إلى vibrantColors في TimePickerDefaults وTimeInputDefaults، وإعادة تسمية richContainerColor وrichShape إلى vibrantContainerColor وvibrantShape في TimePickerDialogDefaults، وإعادة تسمية خصائص الألوان غير المحدّدة إلى periodSelectorContainerColor وperiodSelectorContentColor وtimeSelectorContainerColor وtimeSelectorContentColor وclockDialContentColor. (Iea5aa)
  • تعديل واجهة برمجة التطبيقات Rich TimePicker API للسماح بعرض مربّع حوار غير مضمّن للتمرير/الإدخال (I2b3b6)
  • تمت إضافة SelectableDropdownMenuItem وCheckableDropdownMenuItem لعناصر القائمة التعبيرية القابلة للاختيار والتي يمكن وضع علامة فيها. تم تعديل DropdownMenuItem باستخدام شكل MenuItemColors، وتمت إضافة MenuDefaults.itemVibrantColors() لتوفير MenuItemColors نابض بالحياة. (I160ca)
  • تمت إضافة عمليات تحميل زائدة ToggleButton وElevatedToggleButton وFilledTonalToggleButton وOutlinedToggleButton تعبّر عن آراء معينة باستخدام الفتحتين ButtonSize وicon. تم تبسيط أسماء طرق ToggleButtonDefaults وElevatedToggleButtonDefaults وFilledTonalToggleButtonDefaults وOutlinedToggleButtonDefaults إلى colors() وborder(). (Iab484)
  • تمت إزالة عمليات التحميل الزائد المتوقّفة نهائيًا لكلّ من pinnedScrollBehavior وenterAlwaysScrollBehavior من TopAppBarDefaults. استخدِم عمليات التحميل الزائد التي تستخدم ScrollableState بدلاً من ذلك. (Idef9d)
  • تمت إزالة واجهة برمجة التطبيقات التجريبية المتوقّفة نهائيًا LocalMotionScheme من MaterialTheme. يمكنك استخدام MaterialTheme.motionScheme كبديل. (I4b61d)
  • تمت إضافة TimeInputDefaults وTimeInputColors إلى TimeInput. (I7534e)

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

  • تم إصلاح مشكلة كانت تتسبّب في أن تعلن ScrollDisplayModeToggle عن "التبديل إلى وضع الانتقال" أثناء استخدام وضع الانتقال. (I2d588)
  • تم إصلاح مشكلة عدم محاذاة الرموز اللاحقة إلى نهاية عنصر القائمة عند استخدام DropdownMenuItem بدون رمز رئيسي. (Ia24ff، b/542873381)

الإصدار 1.5.0-alpha26

‫12 أغسطس 2026

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

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

  • تمت إضافة ElevatedToggleButtonDefaults وFilledTonalToggleButtonDefaults وOutlinedToggleButtonDefaults، وتمت إزالة خصائص الأشكال غير الدلالية في ToggleButtonDefaults. (Ia0a85)
  • تم إصلاح مشكلة التباين المتعلقة بإمكانية الوصول في تصنيف NavigationItem الأفقي في المظاهر العالية التباين. يتم الآن تحديد لون التصنيف من خلال selectedTextColorTopIconPosition (لون تصنيف العنصر العمودي الذي لم يتغير) وselectedTextColorStartIconPosition (لون تصنيف العنصر الأفقي الذي تم ضبطه الآن ليتطابق مع selectedIconColor). للرجوع عن هذا التعديل، مرِّر ShortNavigationBarItemDefaults/WideNavigationRailItemDefaults.colors().copy(selectedTextColorStartIconPosition = MaterialTheme.colorScheme.secondary) (I85855، b/490910896).
  • تمت إزالة متغيّرات إزاحة التمرير من SearchBarScrollBehavior، ويجب الآن الوصول إليها من خلال الفئة الجديدة SearchBarScrollState. (Ib24e4)
  • تمت ترقية قناة BottomAppBar وطُرقها المرتبطة إلى إصدار ثابت. لم تعُد واجهات برمجة التطبيقات هذه تتطلّب الموافقة على استخدام @ExperimentalMaterial3Api. (I42c61)
  • تم حفظ وضع التحديد النشط في TimePickerState عند استعادة الحالة، وتمت إضافة المَعلمة initialSelection إلى دالة المصنع TimePickerState. (Iad905)
  • أصبحت ExposedDropdownMenu الآن دالة إضافة في ExposedDropdownMenuBoxScope بدلاً من أن تكون عضوًا. قد تحتاج إلى تعديل الرمز باستخدام عملية استيراد جديدة. (Ie8a65، b/356452026)

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

  • تم إصلاح المشكلة التي كانت تؤدي إلى استبدال الألوان غير المتوفّرة في MenuDefaults.itemColors باللون Color.Unspecified عند تخصيص الألوان جزئيًا. (Iea847)
  • تم إصلاح إشعارات TalkBack لقراءة قيم الوقت المنسَّقة في TimePicker القابلة للتمرير. (Ice981)
  • تم إصلاح عُطل في ExposedDropdownMenu عندما يكون ارتفاع الشاشة أصغر من ارتفاع القائمة. (I6adf1)
  • تم إصلاح مشكلة المساحة المتروكة غير الصحيحة في شريط التنقّل العريض. تبلغ المساحة المتروكة لأسفل الآن 0. للتراجع عن هذا التحديث، يمكنك ضبط contentPadding = PaddingValues(0.dp,44.dp,0.dp,44.dp). (I572bb)
  • تم تعديل مساحة واجهة برمجة التطبيقات العامة لتتوافق مع الملاحظات التي تم تلقّيها مؤخرًا بشأن مراجعة واجهة برمجة التطبيقات. (I71aff، b/532657001)

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

  • تم إصلاح مشكلة عدم ظهور Slider Label في Material3 أثناء سحب شريط التمرير باستخدام الماوس. (I97a6d، b/533483487)

الإصدار 1.5.0-alpha25

‫29 يوليو 2026

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

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

  • تمت إعادة تسمية المَعلمة trailingIcon إلى trailingContent في الشكل، وتم وضع علامة في المربّع واختيار عمليات التحميل الزائد DropdownMenuItem مع الحفاظ على التوافق الثنائي. (I2ecbd)
  • تمت إضافة سمات جديدة لاختيار الألوان وألوان الحاويات إلى MenuItemColors، وتمت إعادة تسمية trailingIcon إلى trailingContent في أداة إنشاء الألوان الجديدة مع الحفاظ على التوافق الثنائي. (I20b92)
  • تم تحسين إمكانية الوصول إلى ScrollField ودعم التنقّل باستخدام لوحة المفاتيح. (If7477)
  • إزالة واجهات برمجة التطبيقات ComponentOverride (I3784b)
  • تم إيقاف المَعلمتَين SliderState.Saver وRangeSliderState.Saver نهائيًا واستبدالهما بعمليات تحميل جديدة تتضمّن خطوات. لم يعُد SliderState ينفّذ DraggableState بشكل علني. (I7c91b)
  • إيقاف واجهة برمجة التطبيقات BasicAlertDialog التجريبية (If157c)
  • تم تغيير ButtonGroupScope في ButtonGroup إلى sealed interface. تم تقسيم Modifier.animateWidth إلى حمولتين زائدتين للسماح بحذف compressionLimit وحل اتجاه التنسيق ديناميكيًا، وتم تغيير نوع المَعلمة compressionLimit من PaddingValues إلى Dp. (I8ef39)
  • تمت إعادة تسمية TonalToggleButton إلى FilledTonalToggleButton. تمت إضافة رسوم متحركة سلسة لحدود الأشكال إلى OutlinedToggleButton. تم إيقاف ToggleButtonDefaults.shapes نهائيًا واستخدام shapesFor بدلاً منه. (Icb433)
  • ترقية LinearTrackStopIndicatorSize وLinearIndicatorTrackGapSize وCircularIndicatorTrackGapSize إلى الإصدار الثابت (I794d0)
  • تم إيقاف واجهة برمجة التطبيقات SplitButtonLayout نهائيًا، ويمكنك استخدام SplitButton بدلاً منها (Ic9840)

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

  • تعديل تبديل التركيز في حال حدوث خطأ في إدخال TimePickerTextField في TimePicker.kt (Ieceec)
  • تم إصلاح شكل عنصر القائمة المقسّمة عندما تحتوي القائمة على عنصر واحد فقط. (I2ea1c، b/479721696)
  • تعديل مستندات KDocs الخاصة بـ "TimePickerDialog.kt" (Ia5fb8)

الإصدار ‎1.5.0-alpha24

‫15 يوليو 2026

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

الميزات

  • إضافة صيغة جديدة للتمرير في TimePicker التعبيري (I46f6b)
  • تمت إضافة مكتبة material3-ripple جديدة (I1b3a3)، تتيح رسم تموّجات تعرض التركيز بصريًا باستخدام حلقات تركيز داخلية بدلاً من طبقة التعتيم. تعمل هذه المكتبة الجديدة كبديل عن material-ripple، والاستخدام المتوقّع مشابه:
    • إذا كنت تستخدم material3 نفسه، استخدِم إعدادات التموج المضمّنة في material3 التي تتكامل مع المظهر وتستخدِم material3-ripple داخليًا كتفصيل تنفيذي.
    • إذا كنت تستخدم material-ripple مباشرةً أو تريد إتاحة حلقات التركيز الداخلية بدون الاعتماد على material3، استخدِم مكتبة material3-ripple الجديدة مباشرةً.

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

  • تم تغيير مَعلمة شريط التمرير ScrollIndicatorState لتصبح غير قابلة للقيم الفارغة. (Iab7c7، b/529445739)
  • أعِد إضافة التعليق التوضيحي @ExperimentalMaterial3Api إلى واجهات برمجة التطبيقات AppBarWithSearch. (I0b61a)
  • تمت ترقية واجهات برمجة التطبيقات SearchBarState التي يتم الترويج لها وواجهات برمجة التطبيقات المستندة إلى الفتحات SearchBar إلى إصدار ثابت. تم إيقاف نهائيًا لواجهات برمجة التطبيقات القديمة SearchBar باستخدام expanded/onExpandedChange. (Ia3793)

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

  • تم إصلاح مشكلة تأخّر العرض حيث يظهر مؤشرا الكتابة RichTooltip وPlainTooltip متأخرًا أثناء حركة الدخول. (I874b6، b/395753083)
  • عدِّل قيم الهامش لمتغير "الإدخال/التمرير" في TimePicker. (I83f00)
  • SplitButton قياس الزر الأخير أولاً لضمان توفّر مساحة (Id3a1e)
  • تم إصلاح مشكلة متعلّقة بأدوات تسهيل الاستخدام، وهي عدم قدرة مستخدمي "الوصول عبر مفتاح تحكّم" على تفعيل حقول النص القابلة للتعديل داخل ExposedDropdownMenuBox. (I0ea17)
  • تم إصلاح ترتيب الإشعارات في TalkBack في TextField وOutlinedTextField عند توفّر بادئة أو لاحقة. (Ie79e7)
  • تعديل هوامش TimePicker وموضع النقطتين الرأسيتين (I6bfeb)
  • إصلاح ترتيب التركيز في TalkBack للعنصر ScrollField (I4ca9f، b/526870141)
  • تم تعديل تبعيات Compose في Material 3 إلى الإصدار 1.12.0-beta01. (Ie9417)
  • يتم الآن حصر تلميحات الأدوات في حدود النافذة لمنع قطعها على الشاشات الصغيرة أو في حال استخدام إعدادات الخطوط الكبيرة. (I421ff)
  • تعديل ScrollField باستخدام انتقالات أرقام أكثر تعبيرًا وضبط الحجم/الكتابة (Ic1614)

الإصدار ‎1.5.0-alpha23

‫01 يوليو 2026

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

الميزات - مكوّن expressive timepicker (Iaa45f) - تمت إضافة أنواع جديدة غير تفاعلية من عناصر القائمة العادية وعناصر القائمة المقسّمة التي تتوافق مع مواصفات Material Expressive. تم إيقاف الإصدار غير التعبيري نهائيًا. (Ide4de، b/491994186)

تغيير في السلوك - تم إصلاح المشكلة التي لم يتغيّر فيها الحدّ الأدنى لارتفاع عناصر القائمة التعبيرية استنادًا إلى أسطر المحتوى. تم تقديم علامة الميزة isExpressiveListItemHeightBasedOnTextLinesFixEnabled للمساعدة في عملية نقل البيانات. (Ibbb91، b/484693233)

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

  • لم تعُد واجهات برمجة التطبيقات الخاصة بعناصر القوائم التعبيرية تجريبية. (I2836a)
  • إزالة واجهات برمجة التطبيقات ComponentOverride (I820c4)
  • أزِل مَعلمة الإزاحة غير المستخدَمة من DropdownMenuPopup. تمت إضافة خصائص القائمة التلقائية إلى إعدادات القائمة التلقائية. تم تعديل تسمية تصنيف المجموعات من MenuDefaults.Label إلى MenuDefaults.DropdownMenuGroupLabel. تمت إضافة disabledContainerColor إلى MenuDefaults.selectableItemColors وMenuDefaults.selectableItemVibrantColors. تمت إضافة المَعلمة Modifier إلى الدوال القابلة للإنشاء في MenuDefaults التي تعرض تخطيطًا. (I3d2b1)
  • تمت إضافة دالة جلب عامة flingAnimationSpec إلى TopAppBarDefaults لعرض مواصفات الرسوم المتحركة التلقائية للتحريك السريع. (Ic1daa)
  • الترقية من TopAppBar أو MediumFlexibleTopAppBar أوLargeTopAppBar أوLargeFlexibleTopAppBar أوTwoRowsTopAppBar أوFlexibleBottomAppBar أوFlexibleContentPadding أوFlexibleBottomAppBarHeight أوFlexibleHorizontalArrangement أوFlexibleFixedHorizontalArrangement إلى غير تجريبي لم تعُد واجهات برمجة التطبيقات والمتغيّرات هذه تتطلّب الموافقة على استخدام @ExperimentalMaterial3ExpressiveApi. (Ia4af6)
  • تحويل ExpandedDockedSearchBarWithGap وExpandedFullScreenContainedSearchBar إلى إصدار غير تجريبي (Ie152d)

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

  • تنظيف معلومات واجهة برمجة التطبيقات (Ia8066)
  • إصلاح ترتيب التنقّل باستخدام لوحة المفاتيح في Scaffold (I77194، b/462577176)
  • إزالة شرط compileSdk 37 (If78b4)
  • إضافة إمكانية استخدام مكوّن ScrollField مع أدوات تسهيل الاستخدام وبشكل أكثر تحديدًا، تنفّذ ScrollField الآن وظيفة التحديد وتتحرّك إلى العنصر المحدّد عند النقر مع إشعارات محدّدة/غير محدّدة في TalkBack. (I7bdb7)
  • إصلاح الخطأ الذي يتسبب في ظهور مساحة إضافية في أسفل الصفحة إذا تم ضبط مساحة IME في هيكل مجموعة أدوات التنقّل. (I86d9d، b/389467593)

الإصدار 1.5.0-alpha22

‫17 يونيو 2026

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

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

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

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

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

الإصدار 1.5.0-alpha21

‫3 يونيو 2026

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

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

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

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

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

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

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

الإصدار ‎1.5.0-alpha20

‫19 مايو 2026

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

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

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

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

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

الإصدار 1.5.0-alpha19

‫6 مايو 2026

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

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

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

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

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

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

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

الإصدار ‎1.5.0-alpha18

‫22 أبريل 2026

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

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

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

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

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

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

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

الإصدار ‎1.5.0-alpha17

‫8 أبريل 2026

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

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

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

الإصدار ‎1.5.0-alpha16

‫25 مارس 2026

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

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

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

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

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

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

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

الإصدار 1.5.0-alpha15

‫25 فبراير 2026

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

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

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

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

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

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

الإصدار ‎1.5.0-alpha14

‫11 فبراير 2026

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

الحل البديل

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

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

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

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

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

الإصدار ‎1.5.0-alpha13

‫28 يناير 2026

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

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

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

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

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

الإصدار 1.5.0-alpha12

‫14 يناير 2026

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

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

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

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

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

الإصدار 1.5.0-alpha11

‫17 ديسمبر 2025

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

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

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

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

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

الإصدار ‎1.5.0-alpha10

‫3 ديسمبر 2025

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

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

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

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

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

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

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

الإصدار ‎1.5.0-alpha09

‫19 نوفمبر 2025

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

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

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

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

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

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

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

الإصدار ‎1.5.0-alpha08

‫5 نوفمبر 2025

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

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

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

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

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

الإصدار ‎1.5.0-alpha07

‫22 أكتوبر 2025

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

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

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

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

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

الإصدار ‎1.5.0-alpha06

‫8 أكتوبر 2025

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

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

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

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

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

الإصدار ‎1.5.0-alpha04

‫10 سبتمبر 2025

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

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

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

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

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

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

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

الإصدار ‎1.5.0-alpha03

‫27 أغسطس 2025

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

تغيير السلوك

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

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

  • تمّت إضافة المَعلمة contentPadding إلى TopAppBar (Ia5fea)
  • إضافة تجاوز مكوِّن لإطار مجموعة التنقّل (I85312)

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

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

الإصدار ‎1.5.0-alpha02

‫13 أغسطس 2025

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

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

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

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

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

الإصدار ‎1.5.0-alpha01

‫30 يوليو 2025

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

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

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

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

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

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

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

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

الإصدار 1.4.0

‫24 سبتمبر 2025

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الإصدار 1.4.0-rc01

‫10 سبتمبر 2025

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

الإصدار 1.4.0-beta03

‫27 أغسطس 2025

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

الإصدار 1.4.0-beta02

‫13 أغسطس 2025

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

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

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

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

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

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

الإصدار 1.4.0-beta01

‫30 يوليو 2025

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

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

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

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

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

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

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

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

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

الإصدار 1.4.0-alpha18

‫16 يوليو 2025

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

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

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

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

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

الإصدار ‎1.4.0-alpha17

‫2 يوليو 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 API onDismissed. (Iee780)
  • تمت إضافة المَعلمة userScrollEnabled إلى عناصر Carousel القابلة للإنشاء. (I1d4d2)
  • يمكن الآن مراقبة currentItem في لوحة العرض الدوّارة من CarouselState. (Ie87e9)

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

  • تم إصلاح مشكلة عدم تطبيق الظل بشكلٍ صحيح على شكل عشوائي في زر الإجراء الرئيسي (FAB) تم تمريره إلى 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 الآن مع 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)
  • إصلاح عُطل Bottom 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)
  • تتم إعادة تسمية الإعدادات التلقائية لمكوّن IconButton xSmall- وxLarge- لتوضيح 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 تمت إزالة المَعلمة expanded lambda وإضافة مَعلمتَين منفصلتَين للارتفاعَين الموسّع والمصغّر. (Idd677، b/306697446، b/229134133، b/268068946)

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

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

الإصدار 1.4.0-alpha08

‫12 فبراير 2025

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

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

  • تمت إضافة واجهة برمجة تطبيقات TimePickerDialog يمكن استخدامها في TimePicker أو TimeInput أو للحصول على إصدار قابل للتبديل. (Id2d83)

  • واجهات برمجة التطبيقات الجديدة لشريط البحث:

    • أصبحت أشرطة البحث المصغّرة و "طرق العرض" الموسّعة للبحث عناصر قابلة للإنشاء منفصلة.
    • يمثّل الرمز SearchBar شريط بحث في الحالة المصغّرة.
    • يمثّل الرمز ExpandedFullScreenSearchBar والرمز ExpandedDockedSearchBar شريط البحث في حالته الموسّعة. يتم فتحها في نافذة جديدة.
    • SearchBarState للتحكّم في حالة شريط البحث
    • TopSearchBar لإضافة معالجة الحواف الداخلية وسلوك التمرير
    • إضافة حمولة زائدة جديدة إلى InputField تستخدم SearchBarState (Ie0723، b/261496232، b/283311462، b/350916229، b/352872248)

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

  • إتاحة تغيير شكل زوايا أزرار الرموز عند الضغط عليها (I21843)
  • لم تعُد واجهات برمجة التطبيقات الخاصة بمربّع التزيين/أداة تزيين حقل النص تجريبية. (I31d95)
  • تمت إضافة عيّنات وإعدادات تلقائية لخيارات المنتج المرتبطة في ButtonGroup. (I5c8ce)
  • اجعل مَعلمة الحالة هي الأخيرة في NavigationSuiteScaffold وNavigationSuiteScaffoldLayout. (I9cc7b)

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

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

الإصدار 1.4.0-alpha07

‫29 يناير 2025

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

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

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

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

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

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

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

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

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

الإصدار ‎1.4.0-alpha06

‫15 يناير 2025

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

تغيير السلوك

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

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

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

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

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

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

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

الإصدار 1.4.0-alpha05

‫12 ديسمبر 2024

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

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

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

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

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

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

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

الإصدار 1.4.0-alpha04

‫13 نوفمبر 2024

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

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

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

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

  • مقدّمة عن المكوّن VerticalDragHandle (I6c770)

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

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

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

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

الإصدار ‎1.4.0-alpha03

‫30 أكتوبر 2024

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

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

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

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

  • تحسين سلوك contentPadding Scaffold لتجنُّب إعادة إنشاء محتوى النص الأساسي دائمًا عند تغيير contentPadding (I8c8e2، b/373904168)
  • تمت إعادة تسمية "TextFieldLabelScope progress" إلى "labelMinimizedProgress"
  • تمت إعادة تسمية TextFieldLabelPosition Default إلى Attached. تمت إزالة أعضاء الواجهة. (If75c6)
  • تم إصلاح مشكلة في DatePicker في وضع الإدخال حيث يمكن أن تؤدي أخطاء التحقّق من الصحة إلى تغيير ارتفاع المكوّن. (I2e229، b/280462363)
  • اجعل شريط التمرير الخاص بـ Material يغيّر قيمته عند الضغط على مفاتيح التحكّم. (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)
  • تمت إضافة عمليات تحميل زائدة جديدة للرمزين 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)
  • دمج رموز مكوّنات زر الإجراء العائم وقائمة زر الإجراء العائم (تعديلات مرئية بسيطة على المساحات المتروكة والنص) (Ib57f3)
  • يأتي ModalBottomSheet الآن في المقدّمة في ترتيب التنقّل الدلالي، يليه لوحة التعتيم. (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

مكوّنات جديدة في التصميم المتعدد الأبعاد 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 الآن في المقدّمة في ترتيب التنقّل الدلالي، يليه لوحة التعتيم. (I436f9، b/358594665)

الإصدار ‎1.3.0-beta05

‫24 يوليو 2024

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

  • تم إصلاح المشكلة التي يتضمّنها الإصداران Android N وO (a10a2d) والتي تؤدي إلى عدم ظهور محتوى BottomSheet أو ظهوره بشكل غير مكتمل
  • تمت زيادة حدود دلالات شريط التمرير لكي يعرض 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) ليتوافق مع ميزة "الرجوع التوقّعي" في الإصدارات الأحدث من Android كخيار متاح (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 في Carousel. (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. لا توجد تغييرات دلالية هنا: يعني تمرير القيمة null أنّك لا تريد رفع MutableInteractionSource، وسيتم إنشاؤه داخل المكوّن إذا لزم الأمر. يسمح التغيير إلى قيمة فارغة لبعض المكوّنات بعدم تخصيص MutableInteractionSource مطلقًا، ويسمح لمكوّنات أخرى بإنشاء مثيل عند الحاجة فقط، ما يؤدي إلى تحسين الأداء في جميع هذه المكوّنات. إذا كنت لا تستخدم MutableInteractionSource الذي تمرّره إلى هذه المكوّنات، ننصحك بتمرير قيمة فارغة بدلاً من ذلك. ننصحك أيضًا بإجراء تغييرات مماثلة في مكوّناتك. (I41abb، b/298048146)
  • تتم إضافة RippleConfiguration وLocalRippleConfiguration للسماح بتخصيص التموجات على مستوى كل مكوّن أو شجرة فرعية باستخدام قيم ثابتة. على سبيل المثال، لتغيير لون أحد المكوّنات التي لا تتحكّم فيها، أو لإيقاف تأثير التموج لأحد المكوّنات. في معظم الحالات، يجب استخدام القيم التلقائية: تمثّل واجهات برمجة التطبيقات هذه وسيلة للهروب من التخصيص المفرط للمكوّنات الفردية أو الأجزاء الفرعية المحدودة. بالنسبة إلى التغييرات الأوسع وأنظمة التصميم المخصّصة، عليك بدلاً من ذلك إنشاء تموج خاص بك باستخدام createRippleModifierNode. (I7b5d6، b/298048146)
  • تضيف هذه السمة واجهة برمجة تطبيقات جديدة لتأثير التموّج في Material3 تحلّ محل السمة rememberRipple التي تم إيقافها نهائيًا. تضيف أيضًا CompositionLocal وLocalUseFallbackRippleImplementation مؤقتًا للعودة إلى استخدام واجهات برمجة التطبيقات rememberRipple / RippleTheme المتوقّفة نهائيًا في مكوّنات Material3. ستتم إزالة هذه السمة في الإصدار الثابت التالي، وهي تهدف فقط إلى تقديم مساعدة مؤقتة في نقل البيانات في الحالات التي تقدّم فيها RippleTheme مخصّصة. (I34cbc، b/298048146)

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

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

الإصدار 1.2

الإصدار 1.2.1

‫6 آذار (مارس) 2024

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

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

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

الإصدار 1.2.0

‫7 فبراير 2024

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

مشكلة معروفة

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

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

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

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

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

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

الإصدار 1.2.0-rc01

‫24 يناير 2024

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

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

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

الإصدار ‎1.2.0-beta02

‫10 يناير 2024

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

خطأ معروف

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

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

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

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

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

الإصدار 1.2.0-beta01

‫13 ديسمبر 2023

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

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

  • وضع علامة "تجريبي" على TabIndicatorScope (I45c88)
  • إزالة واجهات برمجة التطبيقات التجريبية المتوقّفة نهائيًا الخاصة بتلميحات الأدوات (I438cb)
  • تغيير عمليات التحميل الزائد الجديدة في TabRow لعدم استخدام التركيبات الفرعية يؤدي ذلك إلى طريقة مختلفة لإنشاء مؤشرات TabRow باستخدام المعدِّلات المخصّصة المقدَّمة. (Ife741)
  • إيقاف واجهتَي برمجة التطبيقات DismissDirection وDismissValue نهائيًا تم دمجها في SwipeToDismissValue، وتشير قيمه إلى كل من موضع SwipeToDismissBox واتجاهه. تم الآن تمييز DismissState.progress كـ FloatRange بين 0.0 و1.0. تمت الآن إزالة الدالتَين المتوقّفتَين نهائيًا Saver وConstructor في DismissState. تمت إعادة تصنيف المكوّن 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 APIs الآن @ExperimentalFoundationApi. (I30b0b)
  • لم يعُد TabRow وScrollableTabRow متوقّفَين نهائيًا. تم تصنيف الصيغتين الأساسية والثانوية الجديدتين على أنّهما تجريبيتان. (I0def6)
  • تستخدم شرائح الفلترة والإدخال الآن BorderStroke مباشرةً. (I07a8d)
  • يستخدم SegmentedButton الآن BorderStroke مباشرةً. (I89b9b)
  • تمت إعادة تسمية الدالة العامة AlertDialog إلى BasicAlertDialog، وإيقاف الدالة السابقة نهائيًا. (Idbe52)
  • إعادة تسمية واجهات برمجة التطبيقات SwipeToDismiss إلى SwipeDismiss، وترقية واجهات برمجة التطبيقات الجديدة SwipeDismiss إلى إصدار ثابت (I14cbe)
  • إضافة tonalElevation وshadowElevation إلى واجهات برمجة التطبيقات الخاصة بتلميحات الأدوات بالإضافة إلى ذلك، سنعيد واجهات برمجة التطبيقات TooltipBox وPlainTooltip وRichTooltip إلى الإصدار التجريبي لأنّها صدرت عن طريق الخطأ كإصدار ثابت. (If0f66، b/293939035)
  • ترقية واجهات برمجة التطبيقات التجريبية الخاصة بالشرائح إلى إصدار ثابت (Iea2c3)
  • تمت إزالة التعليق التوضيحي @ExperimentalMaterial3Api من البطاقات القابلة للنقر في Material3. (I88dbf)

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

  • تم إصلاح المشكلة التي كان يتوقّف فيها SwipeToDismiss عن العمل في سيناريوهات معيّنة تتضمّن تخطيطات Lookahead وLazy متداخلة. (Ica8d1، b/297226562)

الإصدار 1.2.0-alpha10

‫18 أكتوبر 2023

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

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

  • ترقية Badge وBadgedBox إلى الإصدار الثابت (I67f16، b/261565132)
  • إضافة securePolicy كمَعلمة إلى ModalBottomSheet، ليتمكّن المستخدمون من تحديد سلوك WindowManager.LayoutParams.FLAG_SECURE (Icdac8، b/296250262)
  • تمت إضافة عمليات تحميل زائدة جديدة للدالتَين LinearProgressIndicator وCircularProgressIndicator التي تستخدم progress كدالة lambda. ويجب أن تكون هذه الإصدارات أفضل أداءً من الإصدارات السابقة. (I824e6، b/295616656)
  • تتم إعادة تسمية StandardSizeClasses إلى AllSizeClasses. (I8cb07)
  • يمكنك الجمع بين دوال حساب فئات حجم النافذة. (Iad935)

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

  • تم إصلاح عُطل DatePicker يحدث عند النقر بسرعة على أزرار أسهم التنقّل عندما يكون الشهر المعروض على حافة النطاق المسموح به من السنوات. (I46f36 وb/290954897 وb/297002119)
  • [شريط التنقّل الجانبي/شريط التنقّل] إتاحة لون شفاف للمؤشر (Ie0a9b، b/267289987)

الإصدار ‎1.2.0-alpha09

‫4 أكتوبر 2023

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

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

  • تم نقل ModalNavigationDrawer وDismissibleNavigationDrawer لاستخدام واجهات برمجة التطبيقات الجديدة AnchoredDraggable. تم استبدال animateTo في DrawerState بطريقتَي الفتح والإغلاق، وأصبح الإزاحة الآن معروضة كقيمة عددية ذات فاصلة عشرية بدلاً من كائن حالة. يمكنك الوصول إلى الإزاحة مباشرةً من خلال currentOffset. (I0a72c)
  • تمت إضافة دوال غير قابلة للإنشاء لإنشاء DatePickerState وDateRangePickerState مباشرةً. يمكن استخدام هاتين الدالتين كبديل للدالتين القابلتين للإنشاء rememberDatePickerState وrememberDateRangePickerState عند الحاجة. (I70326، b/291524052)
  • يتضمّن النوعان "ثابت" و"قابل للتمرير" TabRows الآن صيغًا أساسية وثانوية. يتم ربط هذه القيم بشكل صحيح بسلوك اللون والمؤشر كما هو محدّد في Material3.
  • تعرض الآن PrimaryScrollableTabRow وSecondaryScrollableTabRow حالة التمرير. (Iec8f5، b/260572337)
  • إضافة المَعلمة sheetMaxWidth الجديدة التي يمكن للمطوّرين ضبطها لتحديد الحد الأقصى للعرض الذي ستغطّيه الورقة يمكن تمرير Dp.Unspecified إلى المَعلمة إذا كنت تريد ورقة تمتد على عرض الشاشة بالكامل. (Ifb7c9، b/266697696)
  • إعادة إضافة واجهتَي برمجة التطبيقات PlainTooltipBox وRichTooltipBox كطُرق تم إيقافها نهائيًا (I246fa)

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

  • تم إصلاح عُطل عند تهيئة DatePicker باستخدام DatePickerFormatter يحتوي على بعض نماذج التاريخ التي تظل كما هي عند تحويلها إلى أنماط التاريخ (مثل YY). (I01f29)

الإصدار ‎1.2.0-alpha08

‫20 سبتمبر 2023

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

تغيير في السلوك يؤدي إلى حدوث خطأ

  • أصبحت السمة ColorScheme غير قابلة للتغيير، ما يجعل تعديل الألوان الفردية أقل فعالية، ولكنّه يجعل الاستخدام الأكثر شيوعًا للألوان أكثر فعالية. ويعود سبب هذا التغيير إلى أنّ معظم التطبيقات لن تستخدم تعديل الألوان الفردية كحالة استخدام رئيسية. لا يزال ذلك ممكنًا، ولكن سيتم إعادة التركيب أكثر من ذي قبل، وبالتالي سنقلّل بشكل كبير من عدد عمليات الاشتراك في الحالة من خلال جميع رموز Material، وسيؤثر ذلك في تكلفة التهيئة ووقت التشغيل لحالات الاستخدام الأكثر شيوعًا. (Ic447d، b/297212873)
  • لم يعُد "الارتفاع النغمي" يتحرّك في حالات التفاعل المختلفة ليتوافق مع المواصفات. (Icdd12)

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

  • تمت إضافة BottomAppBar جديد يأخذ BottomAppBarScrollBehavior كمَعلمة من أجل إخفائه تلقائيًا عند الانتقال إلى محتوى آخر. تمت أيضًا إضافة FabPosition.EndOverlay للسماح لزر الإجراء الرئيسي (FAB) بتراكب شريط التطبيق السفلي في الهيكل بدلاً من تثبيته فوقه. (Iecb47)
  • تمت إضافة مكوّن 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)
  • إعادة تسمية السمة Semantics من isContainer إلى isTraversalGroup (I121f6)
  • تمّت إضافة TextStyle.merge(...) محسَّن مع قائمة المَعلمات الكاملة. (Iad234، b/246961787)
  • تم إنشاء واجهات عامة لـ "TooltipState" و"RichTooltipState" و"PlainTooltipState". تمت إضافة RichTooltipStateImpl وPlainTooltipStateImpl للحالات التلقائية. تمت إضافة وظائف remember*State للحصول على هذه الحالات التي تم تنفيذها. تمّت إزالة TooltipSync واستخدام TooltipDefault.GlobalMutatorMutex بدلاً منه. (I7813d)
  • تم تعديل DatePickerColors لتضمين خيارات تخصيص إضافية لألوان فاصل أداة اختيار التاريخ وعناصر التنقّل وحقول إدخال النص. (I1a685، b/274626815)
  • أصبح كل من DatePickerState وDateRangePickerState الآن واجهتَي برمجة تطبيقات عامتَين تتضمّنان عمليات تنفيذ تلقائية يمكن استردادها من خلال rememberDatePickerState وrememberDateRangePickerState. (I71c52)
  • تمت إزالة dateValidator من DatePicker وDateRangePicker وتم تقديم واجهة SelectableDates يمكن ضبطها على الحالة للتحكّم في التواريخ أو السنوات التي يمكن اختيارها في واجهة المستخدم. (Ic2fc6)
  • تمت إزالة TimePicker من واجهة برمجة التطبيقات الثابتة، ومن المتوقّع إجراء المزيد من التغييرات في واجهة برمجة التطبيقات الخاصة بالحالة (I3f39a)
  • تم نقل "ModalBottomSheet" إلى Android فقط. لا ننصح باستخدام ModalBottomSheet على الكمبيوتر، ولن تتم صيانة هذه الوظيفة بشكل نشط. (Ib3778)

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

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

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

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

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

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

الإصدار 1.1.0-rc01

‫19 أبريل 2023

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

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

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

الإصدار 1.1.0-beta02

‫5 أبريل 2023

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

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

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

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

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

الإصدار 1.1.0-beta01

‫22 مارس 2023

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

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

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

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

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

الإصدار ‎1.1.0-alpha08

‫8 مارس 2023

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

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

  • تمت إضافة دعم لـ BottomSheetScaffold وBottomSheetScaffoldState. (I063d4)

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

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

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

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

الإصدار ‎1.1.0-alpha07

‫22 فبراير 2023

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

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

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

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

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

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

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

الإصدار ‎1.1.0-alpha06

‫8 فبراير 2023

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

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

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

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

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

الإصدار ‎1.1.0-alpha05

‫26 كانون الثاني (يناير) 2023

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

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

  • DatePickerDialog والدعم المتعلّق بأدوات تمكين الوصول
  • تمت إضافة صورة مصغّرة مخصّصة ومسار إلى RangeSlider.

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

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

الإصدار 1.1.0-alpha04

‫11 يناير 2023

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

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

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

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

  • تمت إضافة السمة الدلالية IsContainer في Surfaces. سيتم استخدام هذه السمة في تغيير لاحق يحدّد ترتيب الانتقال استنادًا إلى المعنى الدلالي للعناصر، مثل المساحات. (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.

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

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

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

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

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

الإصدار ‎1.0.0-rc01

‫5 أكتوبر 2022

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

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

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

الإصدار ‎1.0.0-beta03

‫21 سبتمبر 2022

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

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

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

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

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

الإصدار ‎1.0.0-beta02

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

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

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

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

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

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

الإصدار ‎1.0.0-alpha13

‫1 يونيو 2022

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

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

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

الإصدار ‎1.0.0-alpha12

‫18 مايو 2022

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

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

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

الإصدار ‎1.0.0-alpha11

‫11 مايو 2022

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

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

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

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

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

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

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

الإصدار ‎1.0.0-alpha10

‫20 أبريل 2022

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

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

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

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

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

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

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

الإصدار ‎1.0.0-alpha09

‫6 أبريل 2022

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

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

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

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

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

الإصدار ‎1.0.0-alpha08

‫23 مارس 2022

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

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

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

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

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

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

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

الإصدار ‎1.0.0-alpha07

‫9 مارس 2022

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

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

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

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

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

الإصدار ‎1.0.0-alpha06

‫23 فبراير 2022

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

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

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

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

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

الإصدار ‎1.0.0-alpha05

‫9 فبراير 2022

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

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

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

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

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

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

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

الإصدار ‎1.0.0-alpha02

‫1 ديسمبر 2021

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

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

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

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

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

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

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

الإصدار ‎1.0.0-alpha01

‫27 أكتوبر 2021

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

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

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

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

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