DragAndDrop

  
يمكنك قبول بيانات السحب والإفلات من تطبيق آخر أو من داخل تطبيق، وعرض ميزة متّسقة للهدف الذي يتم الإفلات فيه.
آخر خبر الإصدار المستقر إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫11 مايو 2022 1.0.0 - - -

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

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

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

Groovy

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 هذه التعديلات.

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

  • لن تؤدي أحداث السحب التي تتضمّن `localState` غير فارغ إلى التمييز تلقائيًا. يتوفّر خيار ضبط لتغيير هذا السلوك. (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.

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