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 الذي يتم سحبه وإفلاته يتضمّن بيانات نص وعنوان URL، يختار 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 الذي يحتوي على قيمة غير صفرية في 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 الذي يتم سحبه وإفلاته يتضمّن بيانات نص وعنوان URL، يختار DropHelper أحد عناصر EditText في الهدف الذي يتم إسقاط العنصر عليه لمعالجة البيانات النصية عند إسقاط ClipData.

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