DataTransfer.getData()

현재 번역은 완벽하지 않습니다. 한국어로 문서 번역에 동참해주세요.

DataTransfer.getData() 메소드는 특정 형태를 위해 (DOMString로) 끌어낸 데이터를 회수한다. 가령, 끌어내는 동작이 데이터를 포함하지 않는다면, 이 메소드는 빈 문자열을 반환한다.

예시 데이터 형식으로는 text/plain 와 text/uri-list 이 있다.

구문

DOMString dataTransfer.getData(format);

인수

format
회수할 데이터 형식을 나타내는 DOMString

반환값

DOMString
특정 format을 위해 끌어낸 데이터를 나타내는 DOMString. 만약 끌어내는 동작이 데이터를 가지고 있지 않거나 동작이 특정 format 에 대한 데이터를 가지고 있지 않다면, 이 메소드는 빈 문자열을 반환한다.

예시

이 예시는 DataTransfer 객체의 getData()setData() 메소드의 사용을 보여준다.

HTML 내용

<div id="div1" ondrop="drop(event)" ondragover="allowDrop(event)">
    <span id="drag" draggable="true" ondragstart="drag(event)">drag me to the other box</span>
</div>
<div id="div2" ondrop="drop(event)" ondragover="allowDrop(event)"></div>

CSS 내용

#div1, #div2 {
    width:100px;
    height:50px;
    padding:10px;
    border:1px solid #aaaaaa;
}

JavaScript 내용

function allowDrop(allowdropevent) {
    allowdropevent.target.style.color = 'blue';
    allowdropevent.preventDefault();
}

function drag(dragevent) {
    dragevent.dataTransfer.setData("text", dragevent.target.id);
    dragevent.target.style.color = 'green';
}

function drop(dropevent) {
    dropevent.preventDefault();
    var data = dropevent.dataTransfer.getData("text");
    dropevent.target.appendChild(document.getElementById(data));
    document.getElementById("drag").style.color = 'black';
}

결과

명세

명세 상태 비고
WHATWG HTML Living Standard
The definition of 'getData()' in that specification.
Living Standard  
HTML5.1
The definition of 'getData()' in that specification.
Working Draft 첫 정의

브라우저 호환성

특성 크롬 파이어폭스 (게코) 인터넷 익스플로러 오페라 사파리 (웹킷)
기본지원 4 3.5 [1] 10 (10) 12 3.1
특성 안드로이드 안드로이드 웹뷰 안드로이드 크롬 모바일 파이어폭스(게코) 파이어폭스 운영체제 모바일 인터넷 익스플로러 모바일 오페라 모바일 사파리
기본지원 No support No support No support 10.0 (10)[1] No support 10 No support No support

[1] 파이어폭스 버전48 이전에는, MIME 타입이 white list 에 없으면 이 메소드는 항상 빈 목록을 반환하였다. 

함께 보기

문서 태그 및 공헌자

 이 페이지의 공헌자: whitetofu
 최종 변경: whitetofu,