# Mouse Interaction # Mouse Interaction Categories: [Interactions](http://www.css88.com/jquery-ui-api/category/interactions/ "View all posts in Interactions") | [Utilities](http://www.css88.com/jquery-ui-api/category/utilities/ "View all posts in Utilities") **Description:** 底层的交互组件 ## QuickNav ### Options - [cancel](#option-cancel) - [delay](#option-delay) - [distance](#option-distance) ### Methods - [\_mouseCapture](#method-_mouseCapture) - [\_mouseDelayMet](#method-_mouseDelayMet) - [\_mouseDestroy](#method-_mouseDestroy) - [\_mouseDistanceMet](#method-_mouseDistanceMet) - [\_mouseDown](#method-_mouseDown) - [\_mouseDrag](#method-_mouseDrag) - [\_mouseInit](#method-_mouseInit) - [\_mouseMove](#method-_mouseMove) - [\_mouseStart](#method-_mouseStart) - [\_mouseStop](#method-_mouseStop) - [\_mouseUp](#method-_mouseUp) ### Events 像 [`jQuery.Widget`](jQuery.Widget#jQuery-Widget2), Mouse Interaction（鼠标交互）的目的不是直接使用。这纯粹是一个让其他部件（widget）继承基础组件。这个页面只文档被添加到`jQuery.Widget`，但它包括不打算被重写的内部方法。对外公开的API 是[`_mouseStart()`](#method-_mouseStart), [`_mouseDrag()`](#method-_mouseDrag), [`_mouseStop()`](#method-_mouseStop), 和 [`_mouseCapture()`](#method-_mouseCapture). ### Dependencies - [Widget Factory](jQuery.widget) ## Options ### cancel**Type:** [Selector](http://api.jquery.com/Types/#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" ); ``` ### delay**Type:** [Number](http://api.jquery.com/Types/#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 ); ``` ### distance**Type:** [Number](http://api.jquery.com/Types/#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](http://api.jquery.com/Types/#Boolean) 确定一个互动（interaction）是否基于事件目标元素。默认总是返回 `true`。 - 这个方法不接受任何参数。 **Code examples:** 调用 \_mouseCapture 方法: ``` $( ".selector" ).mouse( "_mouseCapture" ); ``` ### \_mouseDelayMet()Returns: [Boolean](http://api.jquery.com/Types/#Boolean) 确定[`delay`](#option-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](http://api.jquery.com/Types/#Boolean) 确认[`distance`](#option-distance)选项是否已满足当前的互动（interaction） - 这个方法不接受任何参数。 **Code examples:** 调用 \_mouseDistanceMet 方法: ``` $( ".selector" ).mouse( "_mouseDistanceMet" ); ``` ### \_mouseDown() 互动（interaction）开始处理。验证该事件原先相关的鼠标按钮键 并确保[`delay`](#option-delay)和[`distance`](#option-distance)选项符合之前激活的互动（interaction）。当互动（interaction）准备开始时，调用 [`_mouseStart()`](#method-_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()`](#method-_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()`](#method-_mouseStop) 方法来处理扩展部件。 - 这个方法不接受任何参数。 **Code examples:** 调用 \_mouseUp 方法: ``` $( ".selector" ).mouse( "_mouseUp" ); ```