DataTransfer
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
DateTransfer 객체는 드래그 앤 드롭 작업 중에 드래그되고 있는 데이터를 보관하기 위해 사용됩니다. 각각의 데이터 타입들에 해당하는 하나 이상의 데이터 항목을 포함할 수 있습니다. 드래그 앤 드롭에 대한 자세한 정보는 HTML Drag and Drop API을 확인하시길 바랍니다.
이 객체는 모든 drag events의 dataTransfer 속성에서 사용할 수 있습니다.
생성자
DataTransfer()-
새로운
DataTransfer객체를 생성하고 반환합니다.
인스턴스 속성
표준 속성
DataTransfer.dropEffect-
현재 선택된 드래그 앤 드롭 작업의 타입을 가져오거나 작업을 새로운 타입으로 설정합니다. 값은
none,copy,link또는move이어야 합니다. DataTransfer.effectAllowed-
가능한 작업의 모든 타입을 제공합니다.
none,copy,copyLink,copyMove,link,linkMove,move,all또는uninitialized중 하나이어야 합니다. DataTransfer.files-
데이터 전송에서 사용할 수 있는 모든 로컬 파일의 목록을 포함합니다. 드래그 작업에 드래그하고 있는 파일이 포함되지 않으면 이 속성은 빈 목록입니다.
DataTransfer.items읽기 전용-
모든 드래그 데이터의 목록인
DataTransferItemList객체를 받습니다. DataTransfer.types읽기 전용-
dragstart이벤트에 설정된 형식을 제공하는 문자열 배열입니다.
Gecko 속성
Experimental: 이 기능은 실험적인 기능입니다.
프로덕션 환경에서 사용하기 전에 브라우저 호환성 표를 주의 깊게 확인하세요.
인스턴스 메서드
표준 메서드
DataTransfer.clearData()-
지정된 타입과 연결된 데이터를 제거합니다. 타입 전달인자는 선택 사항입니다. 타입이 비어있거나 지정되지 않은 경우 모든 타입과 연결된 데이터가 제거됩니다. 지정된 타입의 데이터가 없거나 데이터 전송에 데이터가 포함되어 있지 않으면 이 메서드는 아무런 효과가 없습니다.
DataTransfer.getData()-
지정된 타입의 데이터를 검색합니다. 혹은 해당 타입의 데이터가 없거나 데이터 전송에 데이터가 없는 경우에는 빈 문자열을 검색합니다.
DataTransfer.setData()-
지정된 타입의 데이터를 설정합니다. 타입의 데이터가 없으면 타입 목록의 마지막 항목이 새로운 형식이 되도록 타입이 마지막에 추가됩니다. 타입의 데이터가 이미 존재하면 기존 데이터가 동일한 위치에서 교체됩니다.
DataTransfer.setDragImage()-
사용자 지정 이미지를 원하는 경우 드래그에 사용될 이미지를 설정합니다.
Gecko 메서드
비표준: 이 기능은 비표준이므로 실제 프로덕션에서 사용하지 마세요. 모든 사용자 환경에서 작동하지 않을 수 도 있으며, 미래에 호환성 문제가 생길 수 있습니다.
예제
문서에 나열된 모든 메서드와 속성은 고유한 참조 페이지가 있으며 각 참조 페이지에는 인터페이스의 예제가 직접 포함되어 있거나 예제에 대한 링크가 있습니다.
명세서
| Specification |
|---|
| HTML Standard # the-datatransfer-interface |
브라우저 호환성
BCD tables only load in the browser