이 페이지는 Cloud Translation API를 통해 번역되었습니다.

DragAndDrop

다른 앱 또는 앱 내에서 드래그 앤 드롭 데이터를 허용하고 일관된 드롭 타겟 어포던스를 표시합니다.

최근 업데이트	안정화 버전	출시 후보 버전	베타 버전	알파 버전
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을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

버전 1.0

버전 1.0.0

2022년 5월 11일

androidx.draganddrop:draganddrop:1.0.0가 출시되었습니다. 버전 1.0.0에 포함된 커밋을 확인하세요.

1.0.0의 주요 기능

draganddrop 라이브러리의 첫 번째 구성요소인 DropHelper는 드래그 앤 드롭 기능의 구현을 간소화하는 유틸리티 클래스입니다. DropHelper를 사용하면 드롭 타겟을 지정하고 드롭 타겟 강조표시를 맞춤설정하며 드롭된 데이터의 처리 방법을 정의할 수 있습니다.

DropHelper는 Jetpack의 OnReceiveContentListener를 활용하여 드래그 및 드롭 ClipData를 타겟별로 처리합니다. DropHelper는 사용자가 타겟 위로 콘텐츠를 드래그할 때 강조표시되도록 드롭 타겟을 구성하여 사용자 환경을 향상합니다. DropHelper.Options 중첩 클래스를 사용하면 기본 강조표시의 모양을 맞춤설정할 수 있습니다.
DropHelper는 타겟을 드롭하는 OnReceiveContentListener를 추가하고 드롭 타겟이 드래그 앤 드롭 이벤트를 수신 대기하도록 구성합니다. DropHelper를 사용할 때 타겟을 드롭하기 위해 OnDragListener 또는 추가적인 OnReceiveContentListener를 추가하지 마세요.
DropHelper.Options는 복잡한 드롭 타겟의 뷰 계층 구조에 포함된 모든 EditText 요소를 나열할 수 있습니다. 이러한 요소가 있으면 이 방식으로 지정해야 합니다. DropHelper는 사용자가 타겟 위로 데이터를 드래그할 때 드롭 타겟에 있는 포커스가 EditText 요소로 바뀌지 않도록 방지합니다. 드래그 앤 드롭 ClipData에 텍스트와 URI 데이터가 포함된 경우 DropHelper는 ClipData가 드롭될 때 텍스트 데이터를 처리할 드롭 타겟의 EditText 요소 중 하나를 선택합니다.

자세한 내용은 드래그 앤 드롭 개발자 가이드를 참고하세요.

버전 1.0.0-rc01

2022년 4월 20일

androidx.draganddrop:draganddrop:1.0.0-rc01이 출시되었습니다. 버전 1.0.0-rc01에 포함된 커밋을 확인하세요.

마지막 베타 출시 이후 변경사항이 없습니다.

버전 1.0.0-beta01

2022년 3월 23일

androidx.draganddrop:draganddrop:1.0.0-beta01가 출시되었습니다. 버전 1.0.0-beta01에 포함된 커밋을 확인하세요.

마지막 알파 출시 이후 변경사항이 없습니다.

버전 1.0.0-alpha04

2022년 2월 23일

androidx.draganddrop:draganddrop:1.0.0-alpha04가 출시되었습니다. 버전 1.0.0-alpha04에 포함된 커밋을 확인하세요.

API 변경사항

null이 아닌 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는 Jetpack의 OnReceiveContentListener를 활용하여 드래그 및 드롭 ClipData를 타겟별로 처리합니다. DropHelper는 사용자가 타겟 위로 콘텐츠를 드래그할 때 강조표시되도록 드롭 타겟을 구성하여 사용자 환경을 향상합니다. DropHelper.Options 중첩 클래스를 사용하면 기본 강조표시의 색상과 모서리 반지름을 맞춤설정할 수 있습니다.

또한 DropHelper.Options는 복잡한 드롭 타겟의 뷰 계층 구조에 포함된 모든 EditText 요소를 나열할 수 있습니다. DropHelper는 사용자가 타겟 위로 데이터를 드래그할 때 드롭 타겟에 있는 포커스가 EditText 요소로 바뀌지 않도록 방지합니다. 드래그 앤 드롭 ClipData에 텍스트와 URI 데이터가 포함된 경우 DropHelper는 ClipData가 드롭될 때 텍스트 데이터를 처리할 드롭 타겟의 EditText 요소 중 하나를 선택합니다.

자세한 내용은 드래그 앤 드롭 개발자 가이드를 참고하세요.