jquery.ui.draggable中文文档(原创翻译)

{原文翻译}
jQuery UI插件是用来允许拖动选定的元素被鼠标拖。
在拖动的元素用CSS的影响:UI可拖动,和CSS:UI拖动拖动。在拖动过程中
如果您需要的不仅仅是拖动,这是一个完整的拖放功能。请查阅jQuery UI的可删除的插件,它提供了一个可拖动释放目标。
所有回调函数(启动、停止、拖动和其他事件)接受两个参数:
事件:浏览器本地事件
UI:具有以下主要属性的jQuery UI对象
Ui.helper:是拖动元素的jQuery对象包装,并ui.helper.context可以原生DOM元素。
ui.position:ui.helper(就是我们要拖动元素)相对于父元素(包括他们自己的元素,如果它是最高的,相应的身体)偏移值是一个对象{顶,左} ----或ui.position.top可以用来获得与父元素的元素的顶部偏移
Ui.offset:同意ui.position。这里是对浏览器内容区域左上角的偏移(请注意它是内容区域,而不是HTML的正文区域。默认情况下HTML的主体将被抵消以抵消所有浏览器)。
{选项}
AddClasses:
{布尔(布尔)
{默认值}真的
{冲击}
设置是否可拖动元素通过UI可拖动式装饰它。为了主要通过。拖动()多(数百个)初始化性能考虑,优化时间元但这个选项,界面拖动拖动不会影响拖风格变化过程。
事实表明,界面拖动样式添加到元素。
False表示UI可拖动的风格是不添加到元素。
{例子代码}拖动其他选项初始化,获取属性值,设置属性值部分除特殊功能,不再重复,只粘贴代码。
{初始化}
$('选择')。Draggable({ addclasses:假});
选定元素的。选择器选择器呈现为拖动控制,和UI可拖动的风格是不是增加了
{获取属性值}
addclasses = $(var的#拖动)。Draggable('option','addclasses);
获取选定的拖动控制addclasses选项的值选择器选择器。
{设置属性值}
$('选择')。Draggable('option','addclasses,假);
设置选定的拖动控制addclasses选择器选择器错误选项的值。
AppendTo:
{ }元素、选择器(HTML元素对象或选择器)
{默认值} 'parent'parent元
{冲击}
该容器用于指定在拖动控件的ui.helper。默认情况下,ui.helper使用相同的容器作为初始定义可拖动,即它的父元素。
{代码示例}
{初始化}
$('选择')。Draggable({ appendto:'body});
{获取属性值}
/吸气器
无功appendto = $('选择')。Draggable('option','appendto);
{设置属性值}

$('选择')。Draggable('option','appendto ','body);。
Axis:
{类型}字符串、布尔(理想值are'x,Y,假)
x:只有水平拖动
y:只有垂直拖动
既可以是水平的也可以是垂直的。
{默认值} false,不限制拖动方向。
{冲击}
约束阻力过程中的方向。
{代码示例}
{初始化}
$('选择')。Draggable({ x轴:});
{获取属性值}
VaR轴=美元('选择')。Draggable('option','axis);
{设置属性值}
$('选择')。Draggable('option','axis'、‘X');
取消:
{选择}
默认值:输入,选项
{冲击}
选择器指定这些元素不能被渲染成一个可拖动控制。
{代码示例}
{初始化}
$('选择')。Draggable({取消按钮});
{获取属性值}
VaR取消=美元('选择')。Draggable('option','cancel);
{设置属性值}
$('选择')。Draggable('option','cancel '按钮');
此选项要求connecttosortable:和排序工作在一起,再。
{选择}
默认值:输入,选项
{冲击}
选择器指定这些元素不能被渲染成一个可拖动控制。
{代码示例}
{初始化}
$('选择')。Draggable({取消按钮});
{获取属性值}
VaR取消=美元('选择')。Draggable('option','cancel);
{设置属性值}
$('选择')。Draggable('option','cancel '按钮');
遏制:
{类型}选择器、元素、字符串、数组。
选择器:只能在由选择器约束的元素中拖动。
元素:只能在给定的元素中拖动。
字符串:
父:只能在父容器中拖。
文档:可以在当前HTML文档的文档下拖动,当超出浏览器窗口范围时自动显示为滚动条。
只能在当前浏览器窗口的内容区域拖动,拖动超出当前窗口范围,并不会导致滚动条出现。
{x1, Y1, X2 array, y2} began to start {horizontal coordinate, vertical coordinate, the end of the horizontal coordinate, vertical coordinate end way} designate an area, only in this area. 以这种方式拖动指定的值,该值相对于浏览器窗口内容区域值左上角的当前偏移量。
不限制拖动范围。
{默认值} false
{冲击}
影响指定可以拖动控件的活动区域。
{代码示例}
{初始化}
$('选择')。Draggable({遏制:'parent});
{获取属性值}
无功控制= $('选择')。Draggable('option','containment);
{设置属性值}
$('选择')。Draggable('option','containment ','parent);
光标:
{类型}字符串。
{默认值}汽车
{冲击}
在拖动控件指定鼠标样式的过程中,样式设置后,原控件需要支持指定的光标样式,如果原元素的指定值不支持原来的元素,默认的光标样式即可使用。例如,$(输入{类型=按钮})。Draggable({光标:'crosshair});按钮十字线不支持鼠标的风格,因此,将在默认的形式显示。
{代码示例}
{初始化}
$('选择')。Draggable({光标:'crosshair});
{获取属性值}
VaR光标=美元('选择')。Draggable('option','cursor);
{设置属性值}
$('选择')。Draggable('option','cursor ','crosshair);
CursorAt:
{ }对象
通过设置对象的顶部、左侧、右侧和底部的一个或两个属性值来确定位置。
{默认值} false
{冲击}
在控制鼠标显示位置拖动控件的过程中,值为false(默认值),在单击拖动,鼠标所在的位置,如果设置,将在一个相对偏移位置的控制,左上角为例:$('选择')Draggable('option','cursorat{左上:,8, 8 });然后拖动过程中,鼠标会在其左上角到右偏移8个像素。
{代码示例}
{初始化}
$('选择')。Draggable({光标:'crosshair});
{获取属性值}
VaR光标=美元('选择')。Draggable('option','cursor);
{设置属性值}
$('选择')。Draggable('option','cursor ','crosshair);
Delay:
{ }整数,单位为毫秒。
{默认值} 0
{冲击}
从鼠标左键拖动控件开始,拖动效果延迟。此选项可用于防止无效拖动或某些不正确的单击带来。具体结果:一个拖动,按下鼠标左键从延时,到指定时间,如果鼠标左键不松动,这样有效拖动,否则,认为这个拖动是无效的。
{代码示例}
{初始化}
$('选择')。Draggable({延迟:500 });
{获取属性值}
变量延迟= $('选择')。Draggable('option','delay);
{设置属性值}
$('选择')。Draggable('option','delay ',500);
距离:
{ }整数,单位是像素
{默认值} 1
{冲击}
从鼠标左键拖动控件,拖动鼠标产生的位移效果必须产生。此选项可用于防止无效拖动或某些不正确的单击带来。具体结果:一个拖动,从鼠标按下鼠标左键,只有当位移达到指定的距离值时,才是有效的拖动。
{代码示例}
{初始化}
$('选择')。Draggable({距离:30 });
{获取属性值}
VaR的距离= $('选择')。Draggable('option','distance);
{设置属性值}
$('选择')。Draggable('option','distance ',30);
网格:
{数组} x,y,x,x表示水平大小,y表示垂直大小,单位为像素。
{默认值} false
{冲击}
拖动拖动控件时拖动网格是拖动的,也就是说,拖动过程中的单元与由GUID选项指定的数组描述的格一样大。
{代码示例}
{初始化}
$('选择')。Draggable({网格:{ 50, 20 } });
{获取属性值}
无功网=美元('选择')。Draggable('option','grid);
{设置属性值}
$('选择')。Draggable('option','grid,{ 50, 20 });
手柄:
{选择符或元素
{默认值} false
{冲击}
指定的元素触发器拖动。用法:为驱动器控件设置一个id窗口div,设置它的句柄是div跨度中的id =标题,然后单击id =标题跨度驱动器可用。注意:这个元素必须是拖动控制子元素。
{代码示例}
{初始化}
$('选择')。Draggable({处理:'h2});
{获取属性值}
VAR处理=美元('选择')。Draggable('option','handle);
{设置属性值}
$('选择')。Draggable('option','handle ','h2);
帮手:
{ }字符串或函数
字符串值:
原始:可以拖动控件本身移动
克隆:拖动控件本身被克隆,以将其自身移动到原来的位置。
函数必须返回一个DOM元素:函数返回的DOM元素来移动拖动过程。
{ } 'original的默认值
{冲击}
在拖动过程中帮助用户了解当前拖动位置的元素。
{代码示例}
{初始化}
$('选择')。Draggable({帮手:'clone});
{获取属性值}
无功辅助= $('选择')。Draggable('option','helper);
{设置属性值}
$('选择')。Draggable('option','helper ','clone);
IframeFix:
{类型}布尔值或选择器,选择器的选择结果需要iframe元素
{默认值} false
{冲击}
默认响应拖动过程中鼠标移动由于在iframe区域移动鼠标指针拖动过程中。
如果设置为true,这将阻止所有iframe MouseMove事件在当前页面中拖动。如果一个选择集,它将防止指定iframe MouseMove事件。
{代码示例}
{初始化}
$('选择')。Draggable({ iframefix:true});
{获取属性值}
无功iframefix = $('选择')。Draggable('option','iframefix);
{设置属性值}
$('选择')。Draggable('option','iframefix ',真的);
Opacity:
{ }浮点值
{默认值} false
{冲击}
在拖动过程中助手的不透明性(拖动时鼠标拖动的控件)。
{代码示例}
{初始化}
$('选择')。Draggable({不透明度:0.35 });
{获取属性值}
不透明度:$(var '选择')。Draggable('option','opacity);
{设置属性值}
$('选择')。Draggable('option','opacity ',0.35);
RefreshPositions:
{布尔类型
{默认值} false
{冲击}
如果设置为true,所有可删除的位置是在每个MouseMove事件计算。
注意:此选项主要用于解决高动态页面显示问题。
{代码示例}
{初始化}
$('选择')。Draggable({ refreshpositions:true});
{获取属性值}
无功refreshpositions = $('选择')。Draggable('option','refreshpositions);
{设置属性值}
$('选择')。Draggable('option','refreshpositions ',真的);
回复:
{布尔类型,字符串
{默认值} false
{冲击}
拖动后它是否会回到原来的位置。
正确:在每次拖动停止之后,元素自动返回到原来的位置。
无效:元素是不是回到原来的位置,除非它是一个可删除已成功的下降。
有效:除无效以外的其他事项。
{代码示例}
{初始化}
$('选择')。Draggable({回复:真});
{获取属性值}
VaR回复=美元('选择')。Draggable('option','revert);
{设置属性值}
$('选择')。Draggable('option','revert ',真的);
revertduration:
{ }整数
{默认值} 500
{冲击}
还原的整个过程(到初始位置)所需的时间为毫秒。如果还原选项的设置设置为false,则忽略此属性。
{代码示例}
{初始化}
$('选择'),Draggable(revertduration:{ 1000 });
{获取属性值}
无功revertduration = $('选择')。Draggable('option','revertduration);
{设置属性值}
$('选择')。Draggable('option','revertduration ',1000);
范围:
{类型}字符串
{ } 'default的默认值
{冲击}
一系列选项的描述,并结合可删除与可删除的选项设置,接受接受拖动控制选项,同时,在范围选项约束drggable控制可接受的范围,必须在拖动和投掷可以拖放彼此是相同的。
例如:
$(# draggable_a)。Draggable({范围:'a' });
$(# draggable_b)。Draggable({范围:B });
$(# droppable_a)。Droppable({范围:'a' });
$(# droppable_b)。Droppable({范围:B });
可删除控件接受默认值是*,看draggable_a,draggable_b可以自由进入droppable_a和droppable_b,然而,由于范围的限制,为droppable_a只有draggable_a,draggable_b只droppable_b。
注意:这个选项类似于变量的命名空间。默认值is'default ',这意味着如果你不指定,你将仍然有范围,名称为默认。
{代码示例}
{初始化}
$('选择')。Draggable({范围:工具栏});
{获取属性值}
VAR范围= $('选择')。Draggable('option','scope);
{设置属性值}
$('选择')。Draggable('option','scope'工具栏);
纸卷:
{布尔类型
{默认值}真的
{冲击}
如果将其设置为true,则在拖动过程中拖动控件容器超过容器时,容器会自动增加滚动条。
{代码示例}
{初始化}
$('选择')。Draggable({滚动:假});
{获取属性值}
VAR范围= $('选择')。Draggable('option','scope);
{设置属性值}
$('选择')。Draggable('option','scroll,假);
ScrollSensitivity:
{类型}整数值
{默认值} 20
{冲击}
滚动条的灵敏度。
在鼠标指针所指的位置拖动鼠标的控制运动过程中。
滚动条开始滚动时,鼠标指针从容器中的拖动控制距离的边缘。
{代码示例}
{初始化}
$('选择'),Draggable(scrollsensitivity:{ 40 });
{获取属性值}
无功scrollsensitivity = $('选择')。Draggable('option','scrollsensitivity);
{设置属性值}
$('选择')。Draggable('option','scrollsensitivity ',40);
ScrollSpeed:
{类型}整数值
{默认值} 20
{冲击}
多少像素值滚动通过一次滚动条由于scrollsensitivity滚动。
{代码示例}
{初始化}
$('选择'),Draggable(scrollspeed:{ 40 });
{获取属性值}
无功scrollspeed = $('选择')。Draggable('option','scrollspeed);
{设置属性值}
$('选择')。Draggable('option','scrollspeed ',40);
Snap:
{类型}选择器
{默认值} false
{冲击}
吸附功能,设置为true,selector.ui-draggable等价集合,在所有指定选择器的元素的具体结果,目前可拖动控制可以达到吸附作用,吸附是拖动的过程中,还没有接近目标组件,组件将自动拖吸过去。
{代码示例}
{初始化}
$('选择')。Draggable({卡:真});
{获取属性值}
VaR卡=美元('选择')。Draggable('option','snap);
{设置属性值}
$('选择')。Draggable('option','snap ',真的);
SnapMode:
{类型}字符串,可选值如下所示
内部:可以被吸附在指定的元素中。
外:可以吸附在指定元素之外。
二者:内外都可以被吸附。
{ } 'both的默认值
{冲击}
设置吸附模式。
{代码示例}
{初始化}
$('选择')。Draggable({ SnapMode:'outer});
{获取属性值}
VaR SnapMode = $('选择')。Draggable('option','snapmode);
{设置属性值}
$('选择')。Draggable('option','snapmode ','outer);
SnapTolerance:
{ }整数
{默认值} 20
{冲击}
当目标对象设置为像素数时,它被吸附。
{代码示例}
{初始化}
$('选择')。Draggable({卡:真});
{获取属性值}
VaR卡=美元('选择')。Draggable('option','snap);
{设置属性值}
$('选择')。Draggable('option','snap ',真的);
堆栈:
{对象}:选择器,min:50 }
{默认值} false
{冲击}
初始化一组拖动控件时,可拖动控制选择的一些特定的选择,作为一个群体,然后拖动控制组可以由电流驱动的实现总是在前面,最小的是用来指定该组的z-index值最小。
{代码示例}
{初始化}
$('选择')。Draggable({栈:{组:等级产品,最小:50 } }));
{获取属性值}
VaR栈=美元('选择')。Draggable('option','stack);
{设置属性值}
$('选择')。Draggable('option','stack,{组:等级产品,最小:50 });
ZIndex:
{ }整数
{默认值} false
{冲击}
辅助z-index值(用鼠标移动控制)拖动时。Z指数是在CSS层的数量,该值越大,更上一层。
{代码示例}
{初始化}
$('选择')。Draggable({在}:2700);
{获取属性值}
VaR在= $('选择')。Draggable('option','zindex);
{设置属性值}
$('选择')。Draggable('option','zindex ',2700);
{事件}
开始:拖动开始,指鼠标按下并开始移动。
{类型}拖曳开始
{回调函数接受的参数}
事件:本地浏览器事件。
UI的对象:jQuery
这是控制DOM对象的当前拖动
拖动:鼠标移动过程中拖动。
{类型}拖动
{回调函数接受的参数}
事件:本地浏览器事件。
UI的对象:jQuery
这是控制DOM对象的当前拖动
停止:拖完。
{类型} dragstop
{回调函数接受的参数}
事件:本地浏览器事件。
UI的对象:jQuery
这是控制DOM对象的当前拖动
{代码示例}
初始化时设置事件。
$('选择')。Draggable({
开始:函数(事件,用户界面){警报(这个);},
拖动:函数(事件,用户界面){警报(此);},
停止:函数(事件,用户界面){警报(此);}
});
动态绑定事件。当动态绑定时,所使用的事件名称是事件的类型。
$(,选择),Bind('dragstart功能(事件,UI){)
警戒(此);
});
$(,选择)。Bind(拖功能(事件,UI){)
警戒(此);
});
$(,选择),Bind('dragstop功能(事件,UI){)
警戒(此);
});
{一}
销毁:完全删除拖动控件,以在控件拖动之前重新初始化元素初始化的状态。
{代码示例}
$(,选择),Progressbar('destroy);
先前初始化的拖动控件指定的选择器被销毁,以返回到初始化之前的状态。
禁用:未能更改拖动控件的样式,并对应于启用。
启用:更改拖动控件的样式,并允许其与禁用符对应。
选项:获取或设置拖动控件的选项。第二个参数是选项名。第三个参数是值。如果没有指定值,则是获取指定的值,即。

{摘要}
addclasses:用来设置是否添加界面拖动方式。
appendto:设置附加到哪里
轴:设置拖动方向
取消,处理:设置控制整个控件拖动移动的区域,取消指定区域不能被拖动,句柄指定区域控件拖动。
connecttosortable:需要综合与分类。
遏制:设置控制拖动范围
光标,cursorat:设置鼠标拖动过程中的相对空间本身的风格定位。
Delay,距离:设置拖动延迟,延迟设置延迟时间,距离设置延迟距离,目的是防止误点击引起的不想要的拖动。
网格:设置拖动过程的运动单元(在一个小格子中移动)
帮助:设置拖动过程中鼠标移动的组件。
IframeFix:解决问题的事件后在拖动过程iframe级联。
不透明性:拖动进程助手。
在下降的过程后,refreshpositions:设置鼠标移动每次计算位置。
回复,revertduration:设置撤销流动性相关。
经营范围:集的可拖动的域,它是用来识别,可以放置结合使用时,可删除的对象。
滚动,scrollsensitivity,和scrollspeed:设置在拖动过程中的滚动条的相关问题。
Snap, snapMode, and snapTolerance: set the related properties of adsorption.
栈,在:设置控件的水平。