jQuery UI 的 draggable 方法可讓指定元素變成可用滑鼠拖動的物件,常用於浮動視窗、可移動面板或互動式元件。
基本用法
$("#draggable").draggable();
常用選項
- addClasses:是否加入 ui-draggable 樣式。
- appendTo:指定拖曳時 helper 的容器。
- axis:限制拖曳方向,可設為 x 或 y。
- cancel:指定不可拖曳的區域。
- containment:限制可拖曳範圍。
- cursor:拖曳時的滑鼠樣式。
- cursorAt:滑鼠在元素上的偏移位置。
- delay:延遲多久才開始拖曳。
- distance:移動多少像素才判定為拖曳。
- grid:以格線方式移動。
- handle:指定可觸發拖曳的把手。
- helper:拖曳時顯示的原始元素或複製元素。
- iframeFix:處理 iframe 造成的滑鼠事件問題。
- opacity:拖曳時 helper 的透明度。
- revert:拖曳結束後是否回到原位置。
- revertDuration:回到原位置的動畫時間。
- scope:與 droppable 搭配使用的作用域。
- scroll:拖曳時是否自動捲動。
- scrollSensitivity:觸發捲動的靈敏度。
- scrollSpeed:捲動速度。
- snap:是否吸附到其他元素。
- snapMode:吸附模式,可為 inner、outer、both。
- snapTolerance:吸附的像素容差。
- stack:控制多個元素拖曳時的層級。
- zIndex:拖曳時的 z-index。
事件與方法
常見事件包含 start、drag、stop,可用來處理拖曳開始、進行中與結束。常用方法則有 destroy、disable、enable 與 option。