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

2020-05-19 07:33:11易采站长站整理

   $(‘.selector’).draggable({ delay: 500 });
   [获取属性值]
   var delay = $(‘.selector’).draggable(‘option’, ‘delay’);
   [设置属性值]
   $(‘.selector’).draggable(‘option’, ‘delay’, 500);
distance:
[类型]整数, 单位是像素
[默认值]1
[产生影响]
   可拖动控件从鼠标左键按下开始, 到拖动效果产生的时鼠标必须产生的位移. 该选项可以被用来阻止一些不期望的点击带来的无效拖动. 具体效果是: 一次拖动, 从鼠标左键按下, 只有当鼠标产生的位移达到distance指定的值时, 才认为是有效的拖动.
[代码示例]
   [初始化]
   $(‘.selector’).draggable({ distance: 30 });
   [获取属性值]
   var distance = $(‘.selector’).draggable(‘option’, ‘distance’);
   [设置属性值]
   $(‘.selector’).draggable(‘option’, ‘distance’, 30);
grid:
[类型]数组[x, y], x代表水平大小, y代表垂直大小, 单位是像素
[默认值]false
[产生影响]
   可拖动控件拖动时采用grid的方式拖动, 也就是说拖动过程中的单位是guid选项指定的数组描述的格子那么大.
[代码示例]
   [初始化]
   $(‘.selector’).draggable({ grid: [50, 20] });
   [获取属性值]
   var grid = $(‘.selector’).draggable(‘option’, ‘grid’);
   [设置属性值]
   $(‘.selector’).draggable(‘option’, ‘grid’, [50, 20]);
handle:
[类型]选择器或元素
[默认值]false
[产生影响]
   指定触发拖动的元素. 用法: 将一个id=window的div设置为可拖动控件, 设置它的handle是该div中的一个id=title的span, 那么, 就只有在id=title的span上点击拖动才是有效的.   注意: 该元素一定要是可拖动控件的子元素.
[代码示例]
   [初始化]
   $(‘.selector’).draggable({ handle: ‘h2’ });
   [获取属性值]
   var handle = $(‘.selector’).draggable(‘option’, ‘handle’);
   [设置属性值]
   $(‘.selector’).draggable(‘option’, ‘handle’, ‘h2’);
helper:
[类型]字符串或函数
   字符串取值:
    ‘original’: 可拖动控件本身移动
    ‘clone’: 将可拖动控件自身克隆一个移动, 自身在原始位置不变
   函数则必须返回一个DOM元素: 以函数返回的DOM元素移动展现拖动的过程.
[默认值]’original’