سحب وإفلات

  
اقبل البيانات التي يتم سحبها وإفلاتها من تطبيق آخر أو داخل تطبيق، واعرض قدرة ثابتة على استهداف الانخفاض المفاجئ.
آخر تعديل الإصدار المستقر إصدار مرشح الإصدار التجريبي الإصدار الأولي
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 في Jetpack. يحسّن 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 في Jetpack. يحسّن DropHelper تجربة المستخدم من خلال ضبط أهداف الإفلات لعرض نص مميّز بينما يسحب المستخدمون المحتوى فوق الأهداف. تتيح لك الفئة DropHelper.Options المدمجة تخصيص اللون ونصف قطر الزاوية للتمييز التلقائي.

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

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