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

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';
}

결과

명세

명세 상태 비고
HTML Living Standard
The definition of 'getData()' in that specification.
Living Standard  
HTML 5.1
The definition of 'getData()' in that specification.
Recommendation 첫 정의

브라우저 호환성

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

특성 크롬 파이어폭스 (게코) 인터넷 익스플로러 오페라 사파리 (웹킷)
기본지원 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 에 없으면 이 메소드는 항상 빈 목록을 반환하였다. 

함께 보기

문서 태그 및 공헌자

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