DragAndDrop

  
לאפשר גרירה ושחרור של נתונים מאפליקציה אחרת או בתוך האפליקציה, ולהציג תכונה עקבית של יעד השחרור.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסה אלפא
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")
}

מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ל-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. אם נתקלתם בבעיות חדשות או שיש לכם רעיונות לשיפור הספרייה הזו, נשמח לשמוע מכם. לפני שיוצרים בעיה חדשה, כדאי לעיין בבעיות הקיימות בספרייה הזו. כדי להצביע על בעיה קיימת, לוחצים על לחצן הכוכב.

דיווח על בעיה חדשה

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

גירסה 1.0

גרסה 1.0.0

11 במאי 2022

androidx.draganddrop:draganddrop:1.0.0 משוחרר. גרסה 1.0.0 כוללת את ההצהרות האלה על ביצוע שינויים (commits).

תכונות עיקריות בגרסה 1.0.0

DropHelper, המשתנה הראשון בספרייה draganddrop, הוא מחלקת שירות שמפשטת את ההטמעה של יכולות גרירה ושחרור. אפשר להשתמש ב-DropHelper כדי לציין יעדי השמטה, להתאים אישית את ההדגשה של יעדי ההשמטה ולהגדיר את האופן שבו נתונים שמוחרגים מטופלים.

  • DropHelper משתמש ב-OnReceiveContentListener של Jetpack כדי לספק עיבוד ספציפי ליעד של גרירה ושחרור ClipData. DropHelper משפרת את חוויית המשתמש על ידי הגדרת יעדי השמטה כך שיוצג בהם הדגשה כשמשתמשים גוררים תוכן מעל היעדים. הכיתה המשולבת DropHelper.Options מאפשרת להתאים אישית את המראה של הדגשה שמוגדרת כברירת מחדל.
  • DropHelper מחבר OnReceiveContentListener ליעדי השמטה ומגדיר את יעדי ההשמטה להאזנה לאירועי גרירה ושחרור. כשמשתמשים ב-DropHelper, אין לצרף OnDragListener או OnReceiveContentListener נוסף ליעדים להשלכת נתונים.
  • בעזרת 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 מכילה את ההצהרות האלה.

שינויים ב-API

  • אירועי Drag עם localState שאינו null לא יפעילו הדגשה כברירת מחדל. יש אפשרות הגדרה לשינוי ההתנהגות הזו. (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 מושלכים.

מידע נוסף זמין במדריך למפתחים בנושא גרירה ושחרור.