jQuery UI API - 鼠標(biāo)交互（Mouse Interaction）

所屬類別

交互（Interactions） | 實用工具（Utilities）

用法

描述：基本交互層。

依賴：

注釋：與 jQuery.Widget 相似，鼠標(biāo)交互的目的不是直接使用。這是一個純粹給其他小部件繼承用的基礎(chǔ)層。該頁面有添加到 jQuery.Widget 的文檔，但是它包含了不能被覆蓋的內(nèi)部方法。公共的 API 是 _mouseStart()、_mouseDrag()、_mouseStop() 和 _mouseCapture()。

快速導(dǎo)航

選項 方法 事件

選項 類型 描述 默認(rèn)值
cancel Selector 防止從指定的元素上開始交互。

代碼實例：

初始化帶有指定 cancel 選項的 mouse：

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

在初始化后，獲取或設(shè)置 cancel 選項：

// getter
var cancel = $( ".selector" ).mouse( "option", "cancel" );
 
// setter
$( ".selector" ).mouse( "option", "cancel", ".title" );
"input, textarea, button, select, option"
delay Number 鼠標(biāo)按下后直至交互開始的事件，以毫秒計。該選項可用于防止點擊在一個元素上時不必要的交互。

代碼實例：

初始化帶有指定 delay 選項的 mouse：

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

在初始化后，獲取或設(shè)置 delay 選項：

// getter
var delay = $( ".selector" ).mouse( "option", "delay" );
 
// setter
$( ".selector" ).mouse( "option", "delay", 300 );
0
distance Number 鼠標(biāo)按下后交互開始前鼠標(biāo)必須移動的距離，以像素計。該選項可用于防止點擊在一個元素上時不必要的交互。

代碼實例：

初始化帶有指定 distance 選項的 mouse：

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

在初始化后，獲取或設(shè)置 distance 選項：

// getter
var distance = $( ".selector" ).mouse( "option", "distance" );
 
// setter
$( ".selector" ).mouse( "option", "distance", 10 );
1

方法 返回 描述
_mouseCapture() Boolean 決定交互是否應(yīng)該基于交互的事件目標(biāo)開始。默認(rèn)的實現(xiàn)總是返回 true。
  • 該方法不接受任何參數(shù)。

代碼實例：

調(diào)用 _mouseCapture 方法：

$( ".selector" ).mouse( "_mouseCapture" );
_mouseDelayMet() Boolean 決定 delay 選項是否滿足當(dāng)前交互。
  • 該方法不接受任何參數(shù)。

代碼實例：

調(diào)用 _mouseDelayMet 方法：

$( ".selector" ).mouse( "_mouseDelayMet" );
_mouseDestroy() jQuery (plugin only) 銷毀交互事件處理程序。這必須調(diào)用來自擴(kuò)展的小部件的 _destroy() 方法。
  • 該方法不接受任何參數(shù)。

代碼實例：

調(diào)用 _mouseDestroy 方法：

$( ".selector" ).mouse( "_mouseDestroy" );
_mouseDistanceMet() Boolean 決定 distance 選項是否滿足當(dāng)前交互。
  • 該方法不接受任何參數(shù)。

代碼實例：

調(diào)用 _mouseDistanceMet 方法：

$( ".selector" ).mouse( "_mouseDistanceMet" );
_mouseDown() jQuery (plugin only) 處理交互的開始。確認(rèn)與主要的鼠標(biāo)按鈕關(guān)聯(lián)的事件，確保 delay 與 distance 在交互啟動之前得到滿足。當(dāng)交互已經(jīng)準(zhǔn)備開始，為要處理的擴(kuò)展小部件調(diào)用 _mouseStart 方法。
  • 該方法不接受任何參數(shù)。

代碼實例：

調(diào)用 _mouseDown 方法：

$( ".selector" ).mouse( "_mouseDown" );
_mouseDrag() jQuery (plugin only) 擴(kuò)展小部件應(yīng)實現(xiàn)一個 _mouseDrag() 方法，來處理交互的每個移動。該方法將接收與鼠標(biāo)移動相關(guān)聯(lián)的鼠標(biāo)事件。
  • 該方法不接受任何參數(shù)。

代碼實例：

調(diào)用 _mouseDrag 方法：

$( ".selector" ).mouse( "_mouseDrag" );
_mouseInit() jQuery (plugin only) 初始化交互事件處理程序。這必須調(diào)用來自擴(kuò)展的小部件的 _create() 方法。
  • 該方法不接受任何參數(shù)。

代碼實例：

調(diào)用 _mouseInit 方法：

$( ".selector" ).mouse( "_mouseInit" );
_mouseMove() jQuery (plugin only) 處理交互的每個移動。為要處理的擴(kuò)展小部件調(diào)用 _mouseDrag 方法。
  • 該方法不接受任何參數(shù)。

代碼實例：

調(diào)用 _mouseMove 方法：

$( ".selector" ).mouse( "_mouseMove" );
_mouseStart() jQuery (plugin only) 擴(kuò)展小部件應(yīng)實現(xiàn)一個 _mouseStart() 方法，來處理交互的開始。該方法將接收與交互開始相關(guān)聯(lián)的鼠標(biāo)事件。
  • 該方法不接受任何參數(shù)。

代碼實例：

調(diào)用 _mouseStart 方法：

$( ".selector" ).mouse( "_mouseStart" );
_mouseStop() jQuery (plugin only) 擴(kuò)展小部件應(yīng)實現(xiàn)一個 _mouseStop() 方法，來處理交互的結(jié)束。該方法將接收與交互結(jié)束相關(guān)聯(lián)的鼠標(biāo)事件。
  • 該方法不接受任何參數(shù)。

代碼實例：

調(diào)用 _mouseStop 方法：

$( ".selector" ).mouse( "_mouseStop" );
_mouseUp() jQuery (plugin only) 處理交互結(jié)束。對擴(kuò)展小部件的處理調(diào)用 _mouseStop 方法。
  • 該方法不接受任何參數(shù)。

代碼實例：

調(diào)用 _mouseUp 方法：

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