DragAndDrop

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

宣告依附元件

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

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

Groovy

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

Kotlin

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

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

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題,或是有改進這個程式庫的建議,請告訴我們。回報新問題前,請先查看這個程式庫的現有問題。只要按一下星號按鈕,即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件

1.0 版

1.0.0 版本

2022 年 5 月 11 日

發布 androidx.draganddrop:draganddrop:1.0.01.0.0 版包含此連結所列的修訂項目。

1.0.0 的主要功能

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

  • DropHelper 運用 Jetpack 的 OnReceiveContentListener 提供拖曳 ClipData 的目標專屬處理功能。DropHelper 會在使用者拖曳內容經過目標時,設定醒目顯示的放置目標,藉此提升使用者體驗。DropHelper.Options 巢狀類別可讓您自訂預設醒目顯示的外觀。
  • DropHelper 會將 OnReceiveContentListener 附加至放置目標,並設定放置目標來監聽拖曳事件。使用 DropHelper 時,請不要將 OnDragListener 或其他 OnReceiveContentListener 附加至放置目標。
  • 此外,DropHelper.Options 還會提供相關功能,讓您列出複合式放置目標檢視區塊階層中包含的所有 EditText 元素。如果有的話,則必須以這種方式指明。DropHelper 可防止 EditText 元素在使用者將資料拖曳到目標上時,從放置目標竊取焦點。如果拖曳 ClipData 含有文字和 URI 資料,DropHelper 會選取放置目標的其中一個 EditText 元素,在放下 ClipData 時處理文字資料。

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

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-alpha031.0.0-alpha03 版包含以下修訂項目。

新功能

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

1.0.0-alpha02 版本

2021 年 12 月 15 日

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

初始版本中的功能

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

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

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

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