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")
}

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

משוב

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

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גירסה 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 ליעדי השחרור ומגדיר את יעדי השחרור להאזנה לאירועי גרירה ושחרור. כשמשתמשים ב-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

  • כברירת מחדל, אירועי DragEvent עם 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 nested class מאפשר לכם להתאים אישית את הצבע ואת רדיוס הפינות של ההדגשה שמוגדרת כברירת מחדל.

ב-DropHelper.Options יש גם אפשרות להציג רשימה של כל רכיבי EditText שכלולים בהיררכיית התצוגה של אזורי יעד מורכבים לגרירה ושחרור. DropHelper מונע מרכיבי EditText לגנוב את המיקוד ממטרה של גרירה ושחרור כשמשתמשים גוררים נתונים מעל המטרה. אם הפעולה של גרירה ושחרור ClipData כוללת נתוני טקסט ו-URI, ‏ DropHelper בוחר באחד מרכיבי EditText ביעד השחרור כדי לטפל בנתוני הטקסט כשמשחררים את ClipData.

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