转载自:http://www.runoob.com/jqueryui/example-draggable.html
- 在拖动目标上触发事件 (源元素):
- ondragstart - 用户开始拖动元素时触发
- ondrag - 元素正在拖动时触发
- ondragend - 用户完成元素拖动后触发
- 释放目标时触发的事件:
- ondragenter - 当被鼠标拖动的对象进入其容器范围内时触发此事件
- ondragover - 当某被拖动的对象在另一对象容器范围内拖动时触发此事件
- ondragleave - 当被鼠标拖动的对象离开其容器范围内时触发此事件
- ondrop - 在一个拖动过程中,释放鼠标键时触发此事件
默认功能
在任意的 DOM 元素上启用 draggable 功能。通过鼠标点击并在视区中拖动来移动 draggable 对象。
lang="en"> charset="utf-8">jQuery UI 拖动(Draggable) - 默认功能 rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
rel="stylesheet" href="http://jqueryui.com/resources/demos/style.css">
#draggable { width: 150px; height: 150px; padding: 0.5em; }
$(function() { $( "#draggable" ).draggable(); });
id="draggable" class="ui-widget-content"> 请拖动我!
查看演示
自动滚动
当 draggable 移动到视区外时自动滚动文档。设置 scroll
选项为 true 来启用自动滚动,当滚动触发时进行微调,滚动速度是通过scrollSensitivity
和 scrollSpeed
选项设置的。
lang="en"> charset="utf-8">jQuery UI 拖动(Draggable) - 自动滚动 rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css"> rel="stylesheet" href="http://jqueryui.com/resources/demos/style.css"> #draggable, #draggable2, #draggable3 { width: 100px; height: 100px; padding: 0.5em; float: left; margin: 0 10px 10px 0; } $(function() { $( "#draggable" ).draggable({ scroll: true }); $( "#draggable2" ).draggable({ scroll: true, scrollSensitivity: 100 }); $( "#draggable3" ).draggable({ scroll: true, scrollSpeed: 100 }); }); id="draggable" class="ui-widget-content"> Scroll 设置为 true,默认设置id="draggable2" class="ui-widget-content"> scrollSensitivity 设置为 100id="draggable3" class="ui-widget-content"> scrollSpeed 设置为 100style="height: 5000px; width: 1px;">
查看演示
约束运动
通过定义 draggable 区域的边界来约束每个 draggable 的运动。设置 axis
选项来限制 draggable 的路径为 x 轴或者 y 轴,或者使用containment
选项来指定一个父级的 DOM 元素或者一个 jQuery 选择器,比如 'document.'。
lang="en"> charset="utf-8">jQuery UI 拖动(Draggable) - 约束运动 rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css"> rel="stylesheet" href="http://jqueryui.com/resources/demos/style.css"> .draggable { width: 90px; height: 90px; padding: 0.5em; float: left; margin: 0 10px 10px 0; } #draggable, #draggable2 { margin-bottom:20px; } #draggable { cursor: n-resize; } #draggable2 { cursor: e-resize; } #containment-wrapper { width: 95%; height:150px; border:2px solid #ccc; padding: 10px; } h3 { clear: left; } $(function() { $( "#draggable" ).draggable({ axis: "y" }); $( "#draggable2" ).draggable({ axis: "x" }); $( "#draggable3" ).draggable({ containment: "#containment-wrapper", scroll: false }); $( "#draggable5" ).draggable({ containment: "parent" }); }); 沿着轴约束运动: id="draggable" class="draggable ui-widget-content"> 只能垂直拖拽id="draggable2" class="draggable ui-widget-content"> 只能水平拖拽或者在另一个 DOM 元素中约束运动:id="containment-wrapper">id="draggable3" class="draggable ui-widget-content"> 我被约束在盒子里class="draggable ui-widget-content">id="draggable5" class="ui-widget-header">我被约束在父元素内
查看演示
光标样式
当拖拽对象时定位光标。默认情况下,光标是出现在被拖拽对象的中间。使用 cursorAt
选项来指定相对于 draggable 的另一个位置(指定一个相对于 top、right、bottom、left 的像素值)。通过提供一个带有有效的 CSS 光标值的 cursor
选项,来自定义光标的外观。有效的 CSS 光标值包括:default、move、pointer、crosshair,等等。
lang="en"> charset="utf-8">jQuery UI 拖动(Draggable) - 光标样式 rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css"> rel="stylesheet" href="http://jqueryui.com/resources/demos/style.css"> #draggable, #draggable2, #draggable3 { width: 100px; height: 100px; padding: 0.5em; float: left; margin: 0 10px 10px 0; } $(function() { $( "#draggable" ).draggable({ cursor: "move", cursorAt: { top: 56, left: 56 } }); $( "#draggable2" ).draggable({ cursor: "crosshair", cursorAt: { top: -5, left: -5 } }); $( "#draggable3" ).draggable({ cursorAt: { bottom: 0 } }); }); id="draggable" class="ui-widget-content"> 我总是在中间(相对于鼠标)id="draggable2" class="ui-widget-content"> 我的光标是在 left -5 和 top -5id="draggable3" class="ui-widget-content"> 我的光标位置只控制了 'bottom' 值
查看演示
延迟开始
通过 delay
选项设置延迟开始拖拽的毫秒数。通过 distance
选项设置光标被按下且拖拽指定像素后才允许拖拽。
lang="en"> charset="utf-8">jQuery UI 拖动(Draggable) - 延迟开始 rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css"> rel="stylesheet" href="http://jqueryui.com/resources/demos/style.css"> #draggable, #draggable2 { width: 120px; height: 120px; padding: 0.5em; float: left; margin: 0 10px 10px 0; } $(function() { $( "#draggable" ).draggable({ distance: 20 }); $( "#draggable2" ).draggable({ delay: 1000 }); $( ".ui-draggable" ).disableSelection(); }); id="draggable" class="ui-widget-content"> 只有把我拖拽了 20 像素后,拖拽才开始id="draggable2" class="ui-widget-content"> 不管 distance 是多少,您都必须拖拽并等待 1000ms 后拖拽才开始
查看演示
事件
draggable 上的 start
、drag
和 stop
事件。拖拽开始时触发 start
事件,拖拽期间触发 drag
事件,拖拽停止时触发 stop
事件。
lang="en"> charset="utf-8">jQuery UI 拖动(Draggable) - 事件 rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css"> rel="stylesheet" href="http://jqueryui.com/resources/demos/style.css"> #draggable { width: 16em; padding: 0 1em; } #draggable ul li { margin: 1em 0; padding: 0.5em 0; } * html #draggable ul li { height: 1%; } #draggable ul li span.ui-icon { float: left; } #draggable ul li span.count { font-weight: bold; } $(function() { var $start_counter = $( "#event-start" ), $drag_counter = $( "#event-drag" ), $stop_counter = $( "#event-stop" ), counts = [ 0, 0, 0 ]; $( "#draggable" ).draggable({ start: function() { counts[ 0 ]++; updateCounterStatus( $start_counter, counts[ 0 ] ); }, drag: function() { counts[ 1 ]++; updateCounterStatus( $drag_counter, counts[ 1 ] ); }, stop: function() { counts[ 2 ]++; updateCounterStatus( $stop_counter, counts[ 2 ] ); } }); function updateCounterStatus( $event_counter, new_count ) { // 首先更新视觉状态... if ( !$event_counter.hasClass( "ui-state-hover" ) ) { $event_counter.addClass( "ui-state-hover" ) .siblings().removeClass( "ui-state-hover" ); } // ...然后更新数字 $( "span.count", $event_counter ).text( new_count ); } }); id="draggable" class="ui-widget ui-widget-content"> 请拖拽我,触发一连串的事件。class="ui-helper-reset">
- id="event-start" class="ui-state-default ui-corner-all"> class="ui-icon ui-icon-play">"start" 被调用 class="count">0x
- id="event-drag" class="ui-state-default ui-corner-all"> class="ui-icon ui-icon-arrow-4">"drag" 被调用 class="count">0x
- id="event-stop" class="ui-state-default ui-corner-all"> class="ui-icon ui-icon-stop">"stop" 被调用 class="count">0x
查看演示
Handles
只有当光标在 draggable 上指定部分时才允许拖拽。使用 handle
选项来指定用于拖拽对象的元素(或元素组)的 jQuery 选择器。
或者当光标在 draggable 内指定元素(或元素组)上时不允许拖拽。使用 handle
选项来指定取消拖拽功能的 jQuery 选择器。
lang="en"> charset="utf-8">jQuery UI 拖动(Draggable) - Handles rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css"> rel="stylesheet" href="http://jqueryui.com/resources/demos/style.css"> #draggable, #draggable2 { width: 100px; height: 100px; padding: 0.5em; float: left; margin: 0 10px 10px 0; } #draggable p { cursor: move; } $(function() { $( "#draggable" ).draggable({ handle: "p" }); $( "#draggable2" ).draggable({ cancel: "p.ui-widget-header" }); $( "div, p" ).disableSelection(); }); id="draggable" class="ui-widget-content">class="ui-widget-header">您只可以在这个范围内拖拽我
id="draggable2" class="ui-widget-content"> 您可以把我向四周拖拽…class="ui-widget-header">…但是您不可以在这个范围内拖拽我
查看演示
还原位置
当带有布尔值 revert
选项的 draggable 停止拖拽时,返回 draggable(或它的助手)到原始位置。
lang="en"> charset="utf-8">jQuery UI 拖动(Draggable) - 还原位置 rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css"> rel="stylesheet" href="http://jqueryui.com/resources/demos/style.css"> #draggable, #draggable2 { width: 100px; height: 100px; padding: 0.5em; float: left; margin: 0 10px 10px 0; } $(function() { $( "#draggable" ).draggable({ revert: true }); $( "#draggable2" ).draggable({ revert: true, helper: "clone" }); }); id="draggable" class="ui-widget-content"> 还原id="draggable2" class="ui-widget-content"> 还原助手
查看演示
对齐到元素或网格
对齐 draggable 到 DOM 元素的内部或外部边界。使用 snap
、snapMode
(inner, outer, both)和 snapTolerance
(当调用对齐时,draggable 与元素之间的距离,以像素为单位)选项。
或者对齐 draggable 到网格。通过 grid
选项设置网格单元的尺寸(以像素为单位的高度或宽度)。
lang="en"> charset="utf-8">jQuery UI 拖动(Draggable) - 对齐到元素或网格 rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css"> rel="stylesheet" href="http://jqueryui.com/resources/demos/style.css"> .draggable { width: 90px; height: 80px; padding: 5px; float: left; margin: 0 10px 10px 0; font-size: .9em; } .ui-widget-header p, .ui-widget-content p { margin: 0; } #snaptarget { height: 140px; } $(function() { $( "#draggable" ).draggable({ snap: true }); $( "#draggable2" ).draggable({ snap: ".ui-widget-header" }); $( "#draggable3" ).draggable({ snap: ".ui-widget-header", snapMode: "outer" }); $( "#draggable4" ).draggable({ grid: [ 20, 20 ] }); $( "#draggable5" ).draggable({ grid: [ 80, 80 ] }); }); id="snaptarget" class="ui-widget-header"> 我是对齐目标
style="clear:both">id="draggable" class="draggable ui-widget-content"> 默认(snap: true),对齐到所有其他的 draggable 元素id="draggable2" class="draggable ui-widget-content"> 我只对齐到大盒子id="draggable3" class="draggable ui-widget-content"> 我只对齐到大盒子的外边缘id="draggable4" class="draggable ui-widget-content"> 我对齐到一个 20 x 20 网格id="draggable5" class="draggable ui-widget-content"> 我对齐到一个 80 x 80 网格
查看演示
视觉反馈
给用户提供反馈,就像以助手方式拖拽对象一样。helper
选项接受值 'original'(用光标移动 draggable 对象),'clone'(用光标移动 draggable 的副本),或者一个返回 DOM 元素的函数(该元素在拖拽期间显示在光标附近)。通过 opacity
选项控制助手的透明度。
为了区别哪一个 draggable 正在被拖拽,让在运动中的 draggable 保持最前。如果正在拖拽,使用 zIndex
选项来设置助手的高度 z-index,或者使用 stack
选项来确保当停止拖拽时,最后一个被拖拽的项目总是出现在同组其他项目的上面。
lang="en"> charset="utf-8">jQuery UI 拖动(Draggable) - 视觉反馈 rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css"> rel="stylesheet" href="http://jqueryui.com/resources/demos/style.css"> #draggable, #draggable2, #draggable3, #set div { width: 90px; height: 90px; padding: 0.5em; float: left; margin: 0 10px 10px 0; } #draggable, #draggable2, #draggable3 { margin-bottom:20px; } #set { clear:both; float:left; width: 368px; height: 120px; } p { clear:both; margin:0; padding:1em 0; } $(function() { $( "#draggable" ).draggable({ helper: "original" }); $( "#draggable2" ).draggable({ opacity: 0.7, helper: "clone" }); $( "#draggable3" ).draggable({ cursor: "move", cursorAt: { top: -12, left: -20 }, helper: function( event ) { return $( " " ); } }); $( "#set div" ).draggable({ stack: "#set div" }); }); class="docs">助手:
id="draggable" class="ui-widget-content"> 原始的id="draggable2" class="ui-widget-content"> 半透明的克隆id="draggable3" class="ui-widget-content"> 自定义助手(与 cursorAt 结合)class="docs">堆叠:
id="set">class="ui-widget-content"> 我们是 draggables..class="ui-widget-content"> ..它的 z-index 是自动控制的..class="ui-widget-content"> ..带有 stack 选项。
查看演示
jQuery UI Draggable + Sortable
Draggable 与 Sortable 的无缝交互。
lang="en"> charset="utf-8">jQuery UI 拖动(Draggable) + 排序(Sortable) rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css"> rel="stylesheet" href="http://jqueryui.com/resources/demos/style.css"> ul { list-style-type: none; margin: 0; padding: 0; margin-bottom: 10px; } li { margin: 5px; padding: 5px; width: 150px; } $(function() { $( "#sortable" ).sortable({ revert: true }); $( "#draggable" ).draggable({ connectToSortable: "#sortable", helper: "clone", revert: "invalid" }); $( "ul, li" ).disableSelection(); });
id="draggable" class="ui-state-highlight">请拖拽我 id="sortable">
- class="ui-state-default">Item 1
- class="ui-state-default">Item 2
- class="ui-state-default">Item 3
- class="ui-state-default">Item 4
- class="ui-state-default">Item 5
查看演示