Zdarzenie ondragstart

Zdarzenia DOM DragEvent

Definicja i użycie

Wydarzenie ondragstart występuje, gdy użytkownik zaczyna przeciągać element lub wybór tekstu.

Przeciąganie i upuszczanie to bardzo powszechna funkcja w HTML5. Oznacza to, że gdy przeciągasz obiekt i przeciągasz go w różne miejsca. Aby dowiedzieć się więcej, przeczytaj nasze informacje o Przenoszenie HTML5HTML tutorial.

Uwaga：Aby uczynić element przeciągalnym, użyj globalnego Atrybut draggable HTML5。

Wskazówka：Domyślnie, linki i obrazy są przeciągane, nie wymaga się atrybutu draggable.

W różnych fazach operacji przeciągania i upuszczania używane jest wiele wydarzeń, które mogą się zdarzyć:

Wydarzenia wywoływane na elemencie źródłowym (celu przeciągania):

  • ondragstart - gdy użytkownik zaczyna przeciągać element
  • ondrag - gdy element jest przeciągany
  • ondragend - gdy użytkownik kończy przeciągać element

Wydarzenia wywoływane na celu umieszczenia:

  • ondragenter - gdy przeciągany element wchodzi na cel umieszczenia
  • ondragover - gdy przeciągany element znajduje się na celu umieszczenia
  • ondragleave - gdy przeciągany element odchodzi od celu umieszczenia
  • ondrop - gdy przeciągany element jest umieszczany na celu umieszczenia

Przykład

Kiedy użytkownik zaczyna przeciągać element <p>, wykonuje się JavaScript:

<p draggable="true" ondragstart="myFunction(event)">Przeciągnij mnie!</p>

Spróbuj sam

Poniżej znajdują się więcej przykładów TIY.

Gramatyka

W HTML:

<element ondragstart="myScript">

Spróbuj sam

W JavaScript:

obiekt.ondragstart = function(){myScript};

Spróbuj sam

W JavaScript, używając metody addEventListener():

obiekt.addEventListener("dragstart", myScript);

Spróbuj sam

Uwaga：Internet Explorer 8 lub wcześniejsze wersje nie obsługują addEventListener() 方法。

技术细节

冒泡： 支持
可取消： 支持
事件类型： DragEvent
支持的 HTML 标签： 所有 HTML 元素
DOM 版本： Level 3 Events

浏览器支持

表中的数字注明了完全支持该事件的首个浏览器版本。

事件 Chrome IE Firefox Safari Opera
ondragstart 4.0 9.0 3.5 6.0 12.0

更多实例

对所有可能的拖放事件的演示：

<p draggable="true" id="dragtarget">Drag me!</p>
<div class="droptarget">Drop here!</div>
<script>
/* ----------------- 在拖动目标上触发的事件 ----------------- */
document.addEventListener("dragstart", function(event) {
  // dataTransfer.setData()方法设置被拖拽数据的数据类型和值
  event.dataTransfer.setData("Text", event.target.id);
  // 开始拖动 p 元素时输出一些文本
  document.getElementById("demo").innerHTML = "Started to drag the p element.";
  // 更改可拖动元素的不透明度
  event.target.style.opacity = "0.4";
});
// 拖动 p 元素时，更改输出文本的颜色
document.addEventListener("drag", function(event) {
  document.getElementById("demo").style.color = "red";
});
// 完成拖动 p 元素后输出一些文本并重置不透明度
document.addEventListener("dragend", function(event) {
  document.getElementById("demo").innerHTML = "Finished dragging the p element.";
  event.target.style.opacity = "1";
});
/* ----------------- Wydarzenia wywoływane na celu umieszczenia ----------------- */
// Kiedy element p, który można przeciągnąć, wchodzi do droptarget, zmień styl ramki DIV
document.addEventListener("dragenter", function(event) {
  if ( event.target.className == "droptarget" ) {
    event.target.style.border = "3px dotted red";
  }
});
// Domyślnie nie można umieszczać danych/elementów w innych elementach. Aby umożliwić umieszczanie, musimy zablokować domyślne przetwarzanie elementu
document.addEventListener("dragover", function(event) {
  event.preventDefault();
});
// Kiedy element p, który można przeciągnąć, opuszcza droptarget, zresetuj styl ramki DIV
document.addEventListener("dragleave", function(event) {
  if ( event.target.className == "droptarget" ) {
    event.target.style.border = "";
  }
});
/* Na upuszczenie - zapobiegaj domyślnemu przetwarzaniu danych przeglądarki (domyślne umieszczanie jako link) */
Resetuj kolor tekstu wyjściowego i kolor ramki DIV
Użyj metody dataTransfer.getData() do uzyskania danych przeciągniętych
Dane przeciągnięte to identyfikator elementu ("drag1")
Dołącz element, który można przeciągnąć, do elementu docelowego
*/
document.addEventListener("drop", function(event) {
  event.preventDefault();
  if ( event.target.className == "droptarget" ) {
    document.getElementById("demo").style.color = "";
    event.target.style.border = "";
    var data = event.dataTransfer.getData("Text");
    event.target.appendChild(document.getElementById(data));
  }
});
</script>

Spróbuj sam

Strony związane

Tutorial HTML: Przenoszenie w HTML5

Przeglądarka HTML: Atrybut draggable HTML

Zdarzenia DOM DragEvent