‫Coordinatorlayout

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

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

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

dependencies {
    implementation "androidx.coordinatorlayout:coordinatorlayout:1.3.0"
}

dependencies {
    implementation("androidx.coordinatorlayout:coordinatorlayout:1.3.0")
}

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

الملاحظات

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على مستندات أداة تتبُّع المشاكل.

الإصدار 1.3

الإصدار 1.3.0

‫26 فبراير 2025

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

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

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

• تمت إضافة دعم لأحداث المفاتيح "الانتقال إلى الصفحة السابقة" و"الانتقال إلى الصفحة التالية" و"الانتقال إلى الصفحة الرئيسية" و"الانتقال إلى نهاية الصفحة" (14719d3)
• تمت إضافة عروض توضيحية لـ RecyclerView في CoordinatorLayout مع شريط تطبيق قابل للطي وPreferenceScreen في CoordinatorLayout مع شريط تطبيق قابل للطي. (fca56e0, I4c679)

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

• تم إصلاح الإجراءات على لوحة المفاتيح باستخدام المفاتيح "للأعلى" و"للأسفل" و"المسافة" وتغييرات المفاتيح مع NestedScrollView في CoordinatorLayout. (I216f4)
• تم إصلاح مشكلة عدم طي شريط التطبيق بشكل صحيح عند استخدام `recyclerview` داخل CoordinatorLayout عند الضغط على مفتاح "للأسفل" في لوحة المفاتيح. (I7eac4)

الإصدار 1.3.0-rc01

‫12 فبراير 2025

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

الإصدار 1.3.0-beta01

‫29 يناير 2025

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

الإصدار 1.3.0-alpha03

‫15 يناير 2025

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

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

• تستخدم هذه المكتبة الآن تعليقات JSpecify التوضيحية بشأن إمكانية القيم الخالية، وهي تعليقات توضيحية بشأن استخدام النوع. على مطوّري Kotlin استخدام وسيط المحول البرمجي التالي لفرض الاستخدام الصحيح: ‎-Xjspecify-annotations=strict (هذا هو الإعداد التلقائي بدءًا من الإصدار 2.1.0 من المحول البرمجي Kotlin). (I9ab25, b/326456246)
• يطوي شريط التطبيق الآن بشكل صحيح عند الضغط على مفتاح "للأسفل" في لوحة المفاتيح عند استخدام recyclerview داخل CoordinatorLayout.

الإصدار 1.3.0-alpha02

‫4 أكتوبر 2023

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

• هذا الإصدار هو زيادة في رقم الإصدار، ولم يطرأ أي تغيير منذ 1.3.0-alpha01.

الإصدار 1.3.0-alpha01

‫20 سبتمبر 2023

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

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

• تمت إضافة دعم لأحداث المفاتيح "الانتقال إلى الصفحة السابقة" و"الانتقال إلى الصفحة التالية" و"الانتقال إلى الصفحة الرئيسية" و"الانتقال إلى نهاية الصفحة". (14719d3)

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

• تمت إضافة تعليقات توضيحية بشأن إمكانية القيم الخالية في CoordinatorLayout.java. (Ieb647, b/236474453)

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

• تم إصلاح الإجراءات على لوحة المفاتيح باستخدام المفاتيح "للأعلى" و"للأسفل" و"المسافة" وتغييرات المفاتيح مع NestedScrollView وCoordinatorLayout. (bdd72e6)

الإصدار 1.2

الإصدار 1.2.0

‫12 يناير 2022

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

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

• الاحتفاظ فقط بالتعليقات التوضيحية المرئية في وقت التشغيل في قواعد CoordinatorLayout (9ec7cb)

الإصدار 1.2.0-rc01

‫15 ديسمبر 2021

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

الإصدار 1.2.0-beta01

‫17 تشرين الثاني (نوفمبر) 2021

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

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

• تمت إتاحة واجهات برمجة التطبيقات بشكل نهائي للإصدار التجريبي.

الإصدار ‎1.2.0-alpha01

‫3 نوفمبر 2021

تم طرح androidx.coordinatorlayout:coordinatorlayout:1.2.0-alpha01. يتضمّن الإصدار ‎1.2.0-alpha01 هذه التعديلات.

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

• الاحتفاظ فقط بالتعليقات التوضيحية المرئية في وقت التشغيل في قواعد CoordinatorLayout (9ec7cb)

الإصدار 1.1.0

الإصدار 1.1.0

‫4 ديسمبر 2019

تم طرح androidx.coordinatorlayout:coordinatorlayout:1.1.0. يتضمّن الإصدار 1.1.0 هذه التعديلات.

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

• aosp/737190: تنفّذ الآن السمة CoordinatorLayout واجهة NestedScrollingParent3، وتنفّذ CoordinatorLayout.Behavior عملية تحميل زائدة جديدة للسمة onNestedScroll لتمكين Behaviors من الإبلاغ عن مقدار مسافة الانتقال التي تستهلكها العناصر الفرعية التي يمكن الانتقال فيها (أثناء عملية dispatchNestedScroll()/onNestedScroll()). تم إيقاف السمة onNestedScroll(CoordinatorLayout, V, View, int, int, int, int, int) التي كانت متوفّرة سابقًا نهائيًا لصالح السمتَين الجديدتَين onNestedScroll(CoordinatorLayout, V, View, int, int, int, int, int, int[]) ويجب تعديل عمليات تنفيذ Behavior وفقًا لذلك. إذا كان رمز المطوّرين يضبط حاليًا السمة CoordinatorLayout#onNestedScroll(View, int, int, int, int, int)، فمن المحتمل ألا يتم استدعاؤها بعد ذلك، ويجب بدلاً من ذلك ضبط السمة CoordinatorLayout#onNestedScroll(View, int, int, int, int, int, int[]).
• تم عرض CoordinatorLayout على خدمات تسهيل الاستخدام (aosp/1056175)
• تم إيقاف التعليق التوضيحي CoordinatorLayout.DefaultBehavior نهائيًا. استخدِم واجهة CoordinatorLayout.AttachedBehavior بدلاً من ذلك.

الإصدار 1.1.0-rc01

‫23 أكتوبر 2019

تم طرح androidx.coordinatorlayout:coordinatorlayout:1.1.0-rc01. يتضمّن الإصدار 1.1.0-rc01 هذه التعديلات.

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

• تم عرض CoordinatorLayout على خدمات تسهيل الاستخدام (aosp/1056175)

الإصدار ‎1.1.0-beta01

‫5 يونيو 2019

تم طرح androidx.coordinatorlayout:coordinatorlayout:1.1.0-beta01. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.

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

• تمت إزالة الفئات الاختبارية التي تم إيقافها نهائيًا (aosp/853955)

الإصدار ‎1.1.0-alpha01

‫3 ديسمبر 2018

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

• aosp/737190: تنفّذ الآن السمة CoordinatorLayout واجهة NestedScrollingParent3، وتنفّذ CoordinatorLayout.Behavior عملية تحميل زائدة جديدة للسمة onNestedScroll لتمكين Behaviors من الإبلاغ عن مقدار مسافة الانتقال التي تستهلكها العناصر الفرعية التي يمكن الانتقال فيها (أثناء عملية dispatchNestedScroll()/onNestedScroll()). تم إيقاف السمة onNestedScroll(CoordinatorLayout, V, View, int, int, int, int, int) التي كانت متوفّرة سابقًا نهائيًا لصالح السمتَين الجديدتَين onNestedScroll(CoordinatorLayout, V, View, int, int, int, int, int, int[]) ويجب تعديل عمليات تنفيذ Behavior وفقًا لذلك.

  إذا كان رمز المطوّرين يضبط حاليًا السمة CoordinatorLayout#onNestedScroll(View, int, int, int, int, int)، فمن المحتمل ألا يتم استدعاؤها بعد ذلك، ويجب بدلاً من ذلك ضبط السمة CoordinatorLayout#onNestedScroll(View, int, int, int, int, int, int[]).