DragAndDrop

  
接受來自其他應用程式或應用程式之中的拖曳資料,並顯示一致的放置目標預設用途。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2022 年 4 月 20 日 - 1.0.0-rc01 - -

宣告依附元件

如果要為 DragAndDrop 新增依附元件,您必須將 Google Maven 存放區新增至專案。詳情請參閱「Google 的 Maven 存放區」。

在應用程式或模組的 build.gradle 檔案中,新增您需要的構件依附元件:

Groovy

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

Kotlin

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

如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。發現新的問題或有改善這個程式庫的想法時,請告訴我們。請先查看此程式庫中的現有問題,再建立新的程式庫。只要點選星號按鈕,即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件

1.0 版本

1.0.0-rc01 版本

2022 年 4 月 20 日

發布 androidx.draganddrop:draganddrop:1.0.0-rc011.0.0-rc01 版包含這些修訂版本

  • 自上次 Beta 版發布後沒有任何異動。

1.0.0-beta01 版本

2022 年 3 月 23 日

發布 androidx.draganddrop:draganddrop:1.0.0-beta011.0.0-beta01 版本包含這些修訂版本

  • 自上次 Alpha 版發布後沒有任何異動。

1.0.0-alpha04 版本

2022 年 2 月 23 日

androidx.draganddrop:draganddrop:1.0.0-alpha04 發布。1.0.0-alpha04 版本包含這些修訂版本。

API 相關異動

  • 根據預設,包含非空值 localState 的 DragEvents 不會觸發醒目顯示。有一個設定選項可以變更這項行為 (I55792)。

1.0.0-alpha03 版本

2022 年 1 月 26 日

androidx.draganddrop:draganddrop:1.0.0-alpha03 發布。1.0.0-alpha03 版本包含這些修訂版本。

新功能

  • 在搭載 Android S 以上版本的裝置上,DropHelper 現在委派給 OnReceiveContentListener 的系統實作,會自動支援拖曳以外的輸入方法。

1.0.0-alpha02 版本

2021 年 12 月 15 日

androidx.draganddrop:draganddrop:1.0.0-alpha02 發布。1.0.0-alpha02 版本包含這些修訂版本。

初始版本中的功能

DropHelperdraganddrop 程式庫的第一個成員,這是一個公用程式類別,可簡化拖曳功能的實作。使用 DropHelper 來指定放置目標、自訂放置目標醒目顯示,以及定義系統如何處理放置的資料。

DropHelper 運用 Jetpack 的 OnReceiveContentListener 提供拖曳 ClipData 的目標專屬處理功能。DropHelper 會在使用者拖曳內容經過目標時,設定醒目顯示放置目標,藉此提升使用者體驗。DropHelper.Options 巢狀類別可讓您自訂預設醒目顯示的色彩和圓角半徑。

此外,DropHelper.Options 還會提供相關功能,讓您列出複合式放置目標檢視區塊階層中收納的所有 EditText 元素。DropHelper 會禁止 EditText 元素在使用者拖曳資料經過目標時,將焦點從放置目標上取走。如果拖曳 ClipData 含有文字和 URI 資料,DropHelper 會選取放置目標的其中一個 EditText 元素,在放下 ClipData 時處理文字資料。

如需詳細資訊,請參閱拖曳開發人員指南。