Coordinatorlayout

Coordinatorlayout

  

مرجع واجهة برمجة التطبيقات
androidx.coordinatorlayout.widget

حدِّد موضع التطبيقات المصغّرة ذات المستوى الأعلى، مثل AppBarLayout وFloatingActionButton.

آخر تعديل	الإصدار الثابت	إصدار محتمل	الإصدار التجريبي	الإصدار التجريبي
26 شباط (فبراير) 2025	1.3.0	-	-	-

الإعلان عن التبعيات

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

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

GroovyKotlin

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

dependencies {
    implementation("androidx.coordinatorlayout:coordinatorlayout:1.2.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 و-Xtype-enhancement-improvements-strict-mode (I9ab25 وb/326456246).
• يتم الآن تصغير "شريط التطبيقات" بشكل صحيح باستخدام لوحة المفاتيح في وضع "الإغلاق" عند استخدام recyclerview داخل CoordinatorLayout.

الإصدار 1.3.0-alpha02

‫4 أكتوبر 2023

تم إصدار androidx.coordinatorlayout:coordinatorlayout:1.3.0-alpha02. يحتوي الإصدار 1.3.0-alpha02 على هذه المراجعات.

• إصدار جديد بتعديل رقم الإصدار، بدون تغييرات عن الإصدار 1.3.0-alpha01

الإصدار 1.3.0-alpha01

20 أيلول (سبتمبر) 2023

تم إصدار androidx.coordinatorlayout:coordinatorlayout:1.3.0-alpha01. يحتوي الإصدار 1.3.0-alpha01 على هذه المراجعات.

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

• إتاحة استخدام أحداث مفاتيح Page Up وPage Down وMove Home وMove End (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 التعليق التوضيحي DefaultBehavior الذي تم إيقافه نهائيًا. بدِّل جميع استخدامات التعليق التوضيحي هذا إلى واجهة AttachedBehavior بدلاً من ذلك.

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

• إتاحة 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[]) بدلاً منه.