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.0。1.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-rc01。1.0.0-rc01 版包含以下修訂項目。

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

1.0.0-beta01 版本

2022 年 3 月 23 日

發布 androidx.draganddrop:draganddrop:1.0.0-beta01。1.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 版本包含這些修訂版本。

初始版本中的功能

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

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

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

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