السحب والإفلات

  
قبول بيانات السحب والإفلات من تطبيق آخر أو داخل تطبيق، وإظهار القدرة على الانخفاض في الاستهداف المتسق
آخر تعديل الإصدار المستقر إصدار المرشح الإصدار التجريبي إصدار أولي
11 أيار (مايو) 2022 1.0.0 - - -

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

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

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

رائع

dependencies {
    implementation "androidx.draganddrop:draganddrop:1.0.0"
}

Kotlin

dependencies {
    implementation("androidx.draganddrop:draganddrop:1.0.0")
}

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

ملاحظات

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

إنشاء عدد جديد

راجع وثائق "أداة تتبُّع المشاكل" للحصول على مزيد من المعلومات.

الإصدار 1.0

الإصدار 1.0.0

11 أيار (مايو) 2022

تم إطلاق "androidx.draganddrop:draganddrop:1.0.0". يحتوي الإصدار 1.0.0 على هذه الالتزامات.

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

"DropHelper"، وهو أول عضو في مكتبة "draganddrop"، هي فئة تطبيقات تبسّط تنفيذ إمكانات السحب والإفلات. يمكنك استخدام DropHelper لتحديد أهداف الانخفاض وتخصيص تمييز هدف الإفلات، وتحديد كيفية التعامل مع البيانات التي لم يتم إسقاطها.

  • يستفيد DropHelper من OnReceiveContentListener من Jetpack لتوفير معالجة خاصة بالاستهداف لعمليات السحب والإفلات ClipData. يحسِّن DropHelper تجربة المستخدم من خلال ضبط أهداف الإفلات لعرض تمييز عندما يسحب المستخدمون المحتوى فوق الأهداف. تتيح لك الفئة DropHelper.Options المدمَجة تخصيص مظهر التمييز التلقائي.
  • يعمل DropHelper على إرفاق OnReceiveContentListener لإفلات الأهداف وإعداد أهداف الإفلات للاستماع إلى أحداث السحب والإفلات. لا تُرفِق OnDragListener أو OnReceiveContentListener إضافية لخفض الاستهدافات عند استخدام DropHelper.
  • تتيح لك DropHelper.Options إمكانية عرض جميع عناصر EditText المضمّنة في العرض الهرمي لاستهدافات الانخفاض المعقدة. في حالة وجود أيٍّ منها، يجب تحديدها بهذه الطريقة. تمنع DropHelper عناصر EditText من سرقة التركيز من هدف الإفلات عندما يسحب المستخدمون البيانات فوق الهدف. إذا كانت عملية السحب والإفلات ClipData تتضمن نصًا وبيانات معرّف موارد منتظم (URI)، يختار DropHelper أحد عناصر EditText في هدف الإفلات لمعالجة البيانات النصية عند إسقاط ClipData.

وللحصول على مزيد من المعلومات، يُرجى الاطّلاع على دليل المطوِّر من خلال السحب والإفلات.

الإصدار 1.0.0-rc01

20 نيسان (أبريل) 2022

تم إطلاق "androidx.draganddrop:draganddrop:1.0.0-rc01". يحتوي الإصدار 1.0.0-rc01 على هذه الالتزامات.

  • لم تطرأ أي تغييرات منذ آخر إصدار تجريبي.

الإصدار 1.0.0-beta01

23 آذار (مارس) 2022

تم إطلاق "androidx.draganddrop:draganddrop:1.0.0-beta01". يحتوي الإصدار 1.0.0-beta01 على هذه الالتزامات.

  • لم تطرأ أي تغييرات منذ آخر إصدار أولي.

الإصدار 1.0.0-alpha04

23 شباط (فبراير) 2022

تم إطلاق "androidx.draganddrop:draganddrop:1.0.0-alpha04". يحتوي الإصدار 1.0.0-alpha04 على هذه الالتزامات.

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

  • لن تؤدي ميزة DragEvents التي تتضمّن حالة محلية غير فارغة إلى تشغيل التمييز تلقائيًا. يتوفّر خيار ضبط لتغيير هذا السلوك. (I55792)

الإصدار 1.0.0-alpha03

26 كانون الثاني (يناير) 2022

تم إطلاق "androidx.draganddrop:draganddrop:1.0.0-alpha03". يحتوي الإصدار 1.0.0-alpha03 على هذه الالتزامات.

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

  • على الأجهزة التي تعمل بنظام التشغيل Android S أو الإصدارات الأحدث، يفوض DropHelper الآن تنفيذ النظام OnReceiveContentListener، ما يوفّر تلقائيًا الدعم لطرق الإدخال بخلاف السحب والإفلات.

الإصدار 1.0.0-alpha02

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

تم إطلاق "androidx.draganddrop:draganddrop:1.0.0-alpha02". يحتوي الإصدار 1.0.0-alpha02 على هذه الالتزامات.

الميزات في الإصدار الأولي

"DropHelper"، وهو أول عضو في مكتبة "draganddrop"، هي فئة تطبيقات تبسّط تنفيذ إمكانات السحب والإفلات. يمكنك استخدام DropHelper لتحديد أهداف الانخفاض وتخصيص تمييز هدف الإفلات، وتحديد كيفية التعامل مع البيانات التي لم يتم إسقاطها.

يستفيد DropHelper من OnReceiveContentListener من Jetpack لتوفير معالجة خاصة بالاستهداف لعمليات السحب والإفلات ClipData. يحسِّن DropHelper تجربة المستخدم من خلال ضبط أهداف الإفلات لعرض تمييز عندما يسحب المستخدمون المحتوى فوق الأهداف. تتيح لك الفئة DropHelper.Options المدمَجة تخصيص اللون ونصف قطر الزاوية للتمييز التلقائي.

ويتيح لك DropHelper.Options أيضًا إدراج جميع عناصر EditText المضمّنة في التسلسل الهرمي لطريقة العرض لاستهدافات الانخفاض المعقدة. تمنع DropHelper عناصر EditText من سرقة التركيز من هدف الإفلات عندما يسحب المستخدمون البيانات فوق الهدف. إذا كانت عملية السحب والإفلات ClipData تتضمن نصًا وبيانات معرّف موارد منتظم (URI)، يختار DropHelper أحد عناصر EditText في هدف الإفلات لمعالجة البيانات النصية عند إسقاط ClipData.

وللحصول على مزيد من المعلومات، يُرجى الاطّلاع على دليل المطوِّر من خلال السحب والإفلات.