Mouse Interaction鼠标交互


Mouse Interaction

Description: 底层的交互组件

QuickNav

Events

jQuery.Widget, Mouse Interaction(鼠标交互)的目的不是直接使用。这纯粹是一个让其他部件(widget)继承基础组件。这个页面只文档被添加到jQuery.Widget,但它包括不打算被重写的内部方法。对外公开的API 是_mouseStart(), _mouseDrag(), _mouseStop(), 和 _mouseCapture().

Dependencies

Options

cancelType: Selector

Default: "input,textarea,button,select,option"
防止在指定的元素上相互作用。
Code examples:

使用指定的 cancel 参数初始化一个:

1
$( ".selector" ).mouse({ cancel: ".title" });

在初始化后设置或者获取cancel 参数:

1
2
3
4
5
6
// getter
var cancel = $( ".selector" ).mouse( "option", "cancel" );
// setter
$( ".selector" ).mouse( "option", "cancel", ".title" );

delayType: Number

Default: 0
时间(以毫秒为单位),当鼠标按下后直到的互动(interactions)激活。此选项可用来阻止当点击一个元素时可能发生的非期望互动(interactions)行为。
Code examples:

使用指定的 delay 参数初始化一个:

1
$( ".selector" ).mouse({ delay: 300 });

在初始化后设置或者获取delay 参数:

1
2
3
4
5
6
// getter
var delay = $( ".selector" ).mouse( "option", "delay" );
// setter
$( ".selector" ).mouse( "option", "delay", 300 );

distanceType: Number

Default: 1
当鼠标点下后,只有移动指定像素后才开始激活互动(interactions)动作,单位为像素。此选项可用来阻止当点击一个元素时可能发生的非期望拖动行为。
Code examples:

使用指定的 distance 参数初始化一个:

1
$( ".selector" ).mouse({ distance: 10 });

在初始化后设置或者获取distance 参数:

1
2
3
4
5
6
// getter
var distance = $( ".selector" ).mouse( "option", "distance" );
// setter
$( ".selector" ).mouse( "option", "distance", 10 );

Methods

_mouseCapture()Returns: Boolean

确定一个互动(interaction)是否基于事件目标元素。默认总是返回 true
  • 这个方法不接受任何参数。
Code examples:

调用 _mouseCapture 方法:

1
$( ".selector" ).mouse( "_mouseCapture" );

_mouseDelayMet()Returns: Boolean

确定delay选项是否满足当前的互动(interaction)。
  • 这个方法不接受任何参数。
Code examples:

调用 _mouseDelayMet 方法:

1
$( ".selector" ).mouse( "_mouseDelayMet" );

_mouseDestroy()

破坏互动(interaction)的事件处理程序。这个必须调用从widget的_destroy()方法。 Destroys the interaction event handlers. This must be called from the extending widget's _destroy() method.
  • 这个方法不接受任何参数。
Code examples:

调用 _mouseDestroy 方法:

1
$( ".selector" ).mouse( "_mouseDestroy" );

_mouseDistanceMet()Returns: Boolean

确认distance选项是否已满足当前的互动(interaction)
  • 这个方法不接受任何参数。
Code examples:

调用 _mouseDistanceMet 方法:

1
$( ".selector" ).mouse( "_mouseDistanceMet" );

_mouseDown()

互动(interaction)开始处理。验证该事件原先相关的鼠标按钮键 并确保delaydistance选项符合之前激活的互动(interaction)。当互动(interaction)准备开始时,调用 _mouseStart() 方法来处理扩展部件。
  • 这个方法不接受任何参数。
Code examples:

调用 _mouseDown 方法:

1
$( ".selector" ).mouse( "_mouseDown" );

_mouseDrag()

扩展部件需要执行一个 _mouseDrag()方法来处理互动(interaction)的每次移动。此方法将接收鼠标移动相关事件。
  • 这个方法不接受任何参数。
Code examples:

调用 _mouseDrag 方法:

1
$( ".selector" ).mouse( "_mouseDrag" );

_mouseInit()

初始化的互动(interaction)事件处理程序。这必须调用扩展部件的_create() 方法。
  • 这个方法不接受任何参数。
Code examples:

调用 _mouseInit 方法:

1
$( ".selector" ).mouse( "_mouseInit" );

_mouseMove()

处理互动(interaction)的每次移动。为扩展部件处理器调用mouseDrag()方法。
  • 这个方法不接受任何参数。
Code examples:

调用 _mouseMove 方法:

1
$( ".selector" ).mouse( "_mouseMove" );

_mouseStart()

扩展部件需要执行一个 _mouseStart()方法来处理互动(interaction)的开始激活。此方法将接收互动(interaction)开始激活的相关鼠标事件。
  • 这个方法不接受任何参数。
Code examples:

调用 _mouseStart 方法:

1
$( ".selector" ).mouse( "_mouseStart" );

_mouseStop()

扩展部件需要执行一个 _mouseStop()方法来处理互动(interaction)的结束。此方法将接收互动(interaction)结束的相关鼠标事件。
  • 这个方法不接受任何参数。
Code examples:

调用 _mouseStop 方法:

1
$( ".selector" ).mouse( "_mouseStop" );

_mouseUp()

互动(interaction)结束的处理程序。调用 mouseStop() 方法来处理扩展部件。
  • 这个方法不接受任何参数。
Code examples:

调用 _mouseUp 方法:

1
$( ".selector" ).mouse( "_mouseUp" );