JS 参考手册

JS 参考手册(类别排序) JS 参考手册(字母排序)

JavaScript

JS Array JS Boolean JS Classes JS Date JS Error JS Global JS JSON JS Math JS Number JS 运算符 JS RegExp JS 语句 JS String

HTML DOM

DOM Attributes DOM Document DOM Element DOM Events DOM Event 对象 DOM HTMLCollection DOM Location DOM Navigator DOM Screen DOM Style
alignContent alignItems alignSelf animation animationDelay animationDirection animationDuration animationFillMode animationIterationCount animationName animationTimingFunction animationPlayState background backgroundAttachment backgroundColor backgroundImage backgroundPosition backgroundRepeat backgroundClip backgroundOrigin backgroundSize backfaceVisibility border borderBottom borderBottomColor borderBottomLeftRadius borderBottomRightRadius borderBottomStyle borderBottomWidth borderCollapse borderColor borderImage borderImageOutset borderImageRepeat borderImageSlice borderImageSource borderImageWidth borderLeft borderLeftColor borderLeftStyle borderLeftWidth borderRadius borderRight borderRightColor borderRightStyle borderRightWidth borderSpacing borderStyle borderTop borderTopColor borderTopLeftRadius borderTopRightRadius borderTopStyle borderTopWidth borderWidth bottom boxShadow boxSizing captionSide caretColor clear clip color columnCount columnFill columnGap columnRule columnRuleColor columnRuleStyle columnRuleWidth columns columnSpan columnWidth counterIncrement counterReset cursor direction display emptyCells filter flex flexBasis flexDirection flexFlow flexGrow flexShrink flexWrap cssFloat font fontFamily fontSize fontStyle fontVariant fontWeight fontSizeAdjust height isolation justifyContent left letterSpacing lineHeight listStyle listStyleImage listStylePosition listStyleType margin marginBottom marginLeft marginRight marginTop maxHeight maxWidth minHeight minWidth objectFit objectPosition opacity order orphans outline outlineColor outlineOffset outlineStyle outlineWidth overflow overflowX overflowY padding paddingBottom paddingLeft paddingRight paddingTop pageBreakAfter pageBreakBefore pageBreakInside perspective perspectiveOrigin position quotes resize right scrollBehavior tableLayout tabSize textAlign textAlignLast textDecoration textDecorationColor textDecorationLine textDecorationStyle textIndent textOverflow textShadow textTransform top transform transformOrigin transformStyle transition transitionProperty transitionDuration transitionTimingFunction transitionDelay unicodeBidi userSelect verticalAlign visibility width wordBreak wordSpacing wordWrap widows zIndex
DOM Window

Web APIs

API Console API Geolocation API History API Storage

HTML 对象

<a> <abbr> <address> <area> <article> <aside> <audio> <b> <base> <bdo> <blockquote> <body> <br> <button> <canvas> <caption> <cite> <code> <col> <colgroup> <datalist> <dd> <del> <details> <dfn> <dialog> <div> <dl> <dt> <em> <embed> <fieldset> <figcaption> <figure> <footer> <form> <head> <header> <h1> - <h6> <hr> <html> <i> <iframe> <img> <ins> <input> button <input> checkbox <input> color <input> date <input> datetime <input> datetime-local <input> email <input> file <input> hidden <input> image <input> month <input> number <input> password <input> radio <input> range <input> reset <input> search <input> submit <input> text <input> time <input> url <input> week <kbd> <label> <legend> <li> <link> <map> <mark> <menu> <menuitem> <meta> <meter> <nav> <object> <ol> <optgroup> <option> <output> <p> <param> <pre> <progress> <q> <s> <samp> <script> <section> <select> <small> <source> <span> <strong> <style> <sub> <summary> <sup> <table> <tbody> <td> <tfoot> <th> <thead> <tr> <textarea> <time> <title> <track> <u> <ul> <var> <video>

其他参考手册

CSSStyleDeclaration JS 类型转换


ondragstart 事件

❮ DOM 事件 ❮ DragEvent

实例

当用户开始拖动 <p> 元素时执行 JavaScript:

<p draggable="true" ondragstart="myFunction(event)">Drag me!</p>
亲自试一试 »

页面下方有更多实例。


定义和用法

ondragstart 事件在用户开始拖动元素或文本选择时发生。

拖放是 HTML5 中非常常见的功能。就是当您"抓取"一个对象并将其拖动到不同位置时。如需学习更多知识,请阅读我们关于 HTML5 拖放的 HTML 教程。

注释:如需使元素可拖动,请使用全局 HTML5 draggable 属性

提示:默认情况下,链接和图像是可拖动的,不需要 draggable 属性。

在拖放操作的不同阶段,有许多事件被使用,并且可能发生:

在可拖动目标(源元素)上触发的事件:

  • ondragstart - 当用户开始拖动元素时发生
  • ondrag - 当元素被拖动时发生
  • ondragend - 当用户完成拖动元素时发生

在放置目标上触发的事件:

  • ondragenter - 当被拖动的元素进入放置目标时发生
  • ondragover - 当被拖动的元素在放置目标上时发生
  • ondragleave - 当被拖动的元素离开放置目标时发生
  • ondrop - 当被拖动的元素被放在放置目标上时发生

浏览器支持

表中的数字表示支持该事件的第一个浏览器版本。

事件
ondragstart 4.0 9.0 3.5 6.0 12.0


语法

在 HTML 中:

<element ondragstart="myScript">
亲自试一试 »

在 JavaScript 中:

object.ondragstart = function(){myScript};
亲自试一试 »

在 JavaScript 中,使用 addEventListener() 方法:

object.addEventListener("dragstart", myScript);
亲自试一试 »

注释:Internet Explorer 8 或更早的版本不支持 addEventListener() 方法


技术细节

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

更多实例

实例

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

<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";
});


/* ----------------- 在放置目标上触发的事件 ----------------- */

// 当可拖动p元素进入droptarget时,改变DIVS的边框样式
document.addEventListener("dragenter", function(event) {
  if ( event.target.className == "droptarget" ) {
    event.target.style.border = "3px dotted red";
  }
});

// 默认情况下,数据/元素不能放在其他元素中。 为了允许放置,我们必须防止元素的默认处理
document.addEventListener("dragover", function(event) {
  event.preventDefault();
});

// 当可拖动的 p 元素离开 droptarget 时,重置 DIVS 的边框样式
document.addEventListener("dragleave", function(event) {
  if ( event.target.className == "droptarget" ) {
    event.target.style.border = "";
  }
});

/* On drop - 防止浏览器默认处理数据(默认在放置时作为链接打开)
重置输出文本的颜色和 DIV 的边框颜色
使用 dataTransfer.getData() 方法获取拖动的数据
拖拽数据是被拖拽元素的id ("drag1")
将拖拽元素追加到放置元素中
*/
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>
亲自试一试 »

相关页面

HTML 教程: HTML5 拖放

HTML 参考手册: HTML draggable 属性


❮ DOM 事件 ❮ DragEvent