Mouse Interaction
Categories: Interactions | Utilities
Description: 底层的交互组件
QuickNav
Options
Methods
- _mouseCapture
- _mouseDelayMet
- _mouseDestroy
- _mouseDistanceMet
- _mouseDown
- _mouseDrag
- _mouseInit
- _mouseMove
- _mouseStart
- _mouseStop
- _mouseUp
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
参数初始化一个:
$( ".selector" ).mouse({ cancel: ".title" });
在初始化后设置或者获取cancel
参数:
// getter
var cancel = $( ".selector" ).mouse( "option", "cancel" );
// setter
$( ".selector" ).mouse( "option", "cancel", ".title" );
delayType: Number
Default: 0
时间(以毫秒为单位),当鼠标按下后直到的互动(interactions)激活。此选项可用来阻止当点击一个元素时可能发生的非期望互动(interactions)行为。Code examples:
使用指定的 delay
参数初始化一个:
$( ".selector" ).mouse({ delay: 300 });
在初始化后设置或者获取delay
参数:
// getter
var delay = $( ".selector" ).mouse( "option", "delay" );
// setter
$( ".selector" ).mouse( "option", "delay", 300 );
distanceType: Number
Default: 1
当鼠标点下后,只有移动指定像素后才开始激活互动(interactions)动作,单位为像素。此选项可用来阻止当点击一个元素时可能发生的非期望拖动行为。Code examples:
使用指定的 distance
参数初始化一个:
$( ".selector" ).mouse({ distance: 10 });
在初始化后设置或者获取distance
参数:
// getter
var distance = $( ".selector" ).mouse( "option", "distance" );
// setter
$( ".selector" ).mouse( "option", "distance", 10 );
Methods
_mouseCapture()Returns: Boolean
确定一个互动(interaction)是否基于事件目标元素。默认总是返回 true
。
- 这个方法不接受任何参数。
Code examples:
调用 _mouseCapture 方法:
$( ".selector" ).mouse( "_mouseCapture" );
_mouseDelayMet()Returns: Boolean
确定delay
选项是否满足当前的互动(interaction)。
- 这个方法不接受任何参数。
Code examples:
调用 _mouseDelayMet 方法:
$( ".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 方法:
$( ".selector" ).mouse( "_mouseDestroy" );
_mouseDistanceMet()Returns: Boolean
确认distance
选项是否已满足当前的互动(interaction)
- 这个方法不接受任何参数。
Code examples:
调用 _mouseDistanceMet 方法:
$( ".selector" ).mouse( "_mouseDistanceMet" );
_mouseDown()
互动(interaction)开始处理。验证该事件原先相关的鼠标按钮键 并确保delay
和distance
选项符合之前激活的互动(interaction)。当互动(interaction)准备开始时,调用 _mouseStart()
方法来处理扩展部件。
- 这个方法不接受任何参数。
Code examples:
调用 _mouseDown 方法:
$( ".selector" ).mouse( "_mouseDown" );
_mouseDrag()
扩展部件需要执行一个 _mouseDrag()
方法来处理互动(interaction)的每次移动。此方法将接收鼠标移动相关事件。
- 这个方法不接受任何参数。
Code examples:
调用 _mouseDrag 方法:
$( ".selector" ).mouse( "_mouseDrag" );
_mouseInit()
初始化的互动(interaction)事件处理程序。这必须调用扩展部件的_create()
方法。
- 这个方法不接受任何参数。
Code examples:
调用 _mouseInit 方法:
$( ".selector" ).mouse( "_mouseInit" );
_mouseMove()
处理互动(interaction)的每次移动。为扩展部件处理器调用mouseDrag()
方法。
- 这个方法不接受任何参数。
Code examples:
调用 _mouseMove 方法:
$( ".selector" ).mouse( "_mouseMove" );
_mouseStart()
扩展部件需要执行一个 _mouseStart()
方法来处理互动(interaction)的开始激活。此方法将接收互动(interaction)开始激活的相关鼠标事件。
- 这个方法不接受任何参数。
Code examples:
调用 _mouseStart 方法:
$( ".selector" ).mouse( "_mouseStart" );
_mouseStop()
扩展部件需要执行一个 _mouseStop()
方法来处理互动(interaction)的结束。此方法将接收互动(interaction)结束的相关鼠标事件。
- 这个方法不接受任何参数。
Code examples:
调用 _mouseStop 方法:
$( ".selector" ).mouse( "_mouseStop" );
_mouseUp()
互动(interaction)结束的处理程序。调用 mouseStop()
方法来处理扩展部件。
- 这个方法不接受任何参数。
Code examples:
调用 _mouseUp 方法:
$( ".selector" ).mouse( "_mouseUp" );