کشیدن و رها کردن

داده‌های کشیدن و رها کردن را از برنامه‌ی دیگر یا درون یک برنامه بپذیرید و یک هدف رها کردن ثابت را نشان دهید.
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۱۱ مه ۲۰۲۲ ۱.۰.۰ - - -

اعلام وابستگی‌ها

برای افزودن وابستگی به DragAndDrop، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Google's Maven را مطالعه کنید.

وابستگی‌های مربوط به مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار 

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

کاتلین 

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

برای اطلاعات بیشتر در مورد وابستگی‌ها، به «افزودن وابستگی‌های ساخت» مراجعه کنید.

بازخورد

بازخورد شما به بهبود Jetpack کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه ۱.۰

نسخه ۱.۰.۰

۱۱ مه ۲۰۲۲

androidx.draganddrop:draganddrop:1.0.0 منتشر شد. نسخه ۱.۰.۰ شامل این کامیت‌ها است.

ویژگی‌های اصلی نسخه ۱.۰.۰

DropHelper ، اولین عضو کتابخانه draganddrop ، یک کلاس کاربردی است که پیاده‌سازی قابلیت‌های کشیدن و رها کردن را ساده می‌کند. از DropHelper برای تعیین اهداف رها کردن، سفارشی‌سازی هایلایت کردن هدف رها کردن و تعریف نحوه مدیریت داده‌های رها شده استفاده کنید.

  • DropHelper از OnReceiveContentListener جت‌پک برای ارائه پردازش خاص هدف از کشیدن و رها کردن ClipData استفاده می‌کند. DropHelper با پیکربندی اهداف رها کردن برای نمایش یک هایلایت هنگام کشیدن محتوا توسط کاربران روی اهداف، تجربه کاربری را بهبود می‌بخشد. کلاس تودرتو DropHelper.Options به شما امکان می‌دهد ظاهر هایلایت پیش‌فرض را سفارشی کنید.
  • DropHelper یک OnReceiveContentListener به رها کردن اهداف متصل می‌کند و اهداف رها کردن را طوری پیکربندی می‌کند که به رویدادهای کشیدن و رها کردن گوش دهند. هنگام استفاده از DropHelper یک OnDragListener یا OnReceiveContentListener اضافی به اهداف رها کردن متصل نکنید.
  • DropHelper.Options به شما این امکان را می‌دهد که تمام عناصر EditText موجود در سلسله مراتب نمای اهداف رهاسازی پیچیده را فهرست کنید. در صورت وجود، باید به این روش مشخص شوند. DropHelper از اینکه عناصر EditText هنگام کشیدن و رها کردن داده‌ها روی هدف، فوکوس را از هدف رهاسازی بدزدند، جلوگیری می‌کند. اگر ClipData شامل متن و داده‌های URI باشد، DropHelper یکی از عناصر EditText را در هدف رهاسازی انتخاب می‌کند تا داده‌های متنی را هنگام رها کردن ClipData مدیریت کند.

برای اطلاعات بیشتر، به راهنمای توسعه‌دهندگان با قابلیت کشیدن و رها کردن مراجعه کنید.

نسخه ۱.۰.۰-rc01

۲۰ آوریل ۲۰۲۲

androidx.draganddrop:draganddrop:1.0.0-rc01 منتشر شد. نسخه 1.0.0-rc01 شامل این کامیت‌ها است.

  • از آخرین نسخه بتا تغییری نکرده است.

نسخه ۱.۰.۰-بتا۰۱

۲۳ مارس ۲۰۲۲

androidx.draganddrop:draganddrop:1.0.0-beta01 منتشر شد. نسخه 1.0.0-beta01 شامل این کامیت‌ها است.

  • از آخرین نسخه آلفا هیچ تغییری نکرده است.

نسخه ۱.۰.۰-آلفا۰۴

۲۳ فوریه ۲۰۲۲

androidx.draganddrop:draganddrop:1.0.0-alpha04 منتشر شد. نسخه 1.0.0-alpha04 شامل این کامیت‌ها است.

تغییرات API

  • DragEvents با localState غیر تهی به طور پیش‌فرض برجسته‌سازی را فعال نمی‌کند. یک گزینه پیکربندی برای تغییر این رفتار وجود دارد. ( I55792 )

نسخه ۱.۰.۰-آلفا۰۳

۲۶ ژانویه ۲۰۲۲

androidx.draganddrop:draganddrop:1.0.0-alpha03 منتشر شد. نسخه 1.0.0-alpha03 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • در دستگاه‌هایی که اندروید S یا بالاتر را اجرا می‌کنند، DropHelper اکنون پیاده‌سازی سیستمی OnReceiveContentListener را به عهده می‌گیرد و به طور خودکار از روش‌های ورودی غیر از کشیدن و رها کردن پشتیبانی می‌کند.

نسخه ۱.۰.۰-آلفا۰۲

۱۵ دسامبر ۲۰۲۱

androidx.draganddrop:draganddrop:1.0.0-alpha02 منتشر شد. نسخه 1.0.0-alpha02 شامل این کامیت‌ها است.

ویژگی‌های نسخه اولیه

DropHelper ، اولین عضو کتابخانه draganddrop ، یک کلاس کاربردی است که پیاده‌سازی قابلیت‌های کشیدن و رها کردن را ساده می‌کند. از DropHelper برای تعیین اهداف رها کردن، سفارشی‌سازی هایلایت کردن هدف رها کردن و تعریف نحوه مدیریت داده‌های رها شده استفاده کنید.

DropHelper از OnReceiveContentListener جت‌پک برای ارائه پردازش خاص هدف از کشیدن و رها کردن ClipData استفاده می‌کند. DropHelper با پیکربندی اهداف رها کردن برای نمایش یک هایلایت هنگام کشیدن محتوا توسط کاربران روی اهداف، تجربه کاربری را بهبود می‌بخشد. کلاس تودرتو DropHelper.Options به شما امکان می‌دهد رنگ و شعاع گوشه هایلایت پیش‌فرض را سفارشی کنید.

DropHelper.Options همچنین به شما این امکان را می‌دهد که تمام عناصر EditText موجود در سلسله مراتب نمای اهداف رهاسازی پیچیده را فهرست کنید. DropHelper از سرقت فوکوس عناصر EditText از هدف رهاسازی هنگام کشیدن و رها کردن داده‌ها توسط کاربران روی هدف جلوگیری می‌کند. اگر ClipData کشیدن و رها کردن شامل متن و داده‌های URI باشد، DropHelper یکی از عناصر EditText را در هدف رهاسازی انتخاب می‌کند تا داده‌های متنی را هنگام رها کردن ClipData مدیریت کند.

برای اطلاعات بیشتر، به راهنمای توسعه‌دهندگان با قابلیت کشیدن و رها کردن مراجعه کنید.