如果你曾用原生 JavaScript 手寫過拖拽,應該對那種痛苦記憶猶新:要處理 mousedown、mousemove、mouseup 三段事件,要計算滑鼠坐標與元素偏移的差值,還得防著選中文字、滑鼠移出視窗、拖放邊界等一系列邊角問題。YUI3 把這些瑣事全都封裝好了,幾行程式碼就能跑起來。
把 YUI 的種子腳本放進 head 即可,後續需要的模組會按需載入:
<script src="https://yui.yahooapis.com/3.0.0pr2/build/yui/yui-min.js" type="text/javascript"></script>
準備一個待拖動的方塊,裡面放一個 h2 當作拖動把手:
<div id="demo"><h2>x</h2>Drag Me</div>
<script type="text/javascript">
YUI().use('dd', function(Y) {
var node = Y.get('#demo'); // 取得 id 為 demo 的節點,類似原生 document.getElementById,但能力更強
node.plug(Y.plugin.Drag); // 為該節點掛上拖動插件,確定被拖動的對象
node.dd.addHandle('h2'); // 指定拖動把手:滑鼠按在 h2 上時才能拖動
node.dd.addHandle(''); // 傳入空字串則代表整個 demo 區域都可以拖動
});
</script>YUI3 的核心思想是模組化:先呼叫 YUI().use() 聲明需要哪些模組,回呼函數裡拿到的 Y 就是這些能力的入口。這裡我們只用了 dd(Drag & Drop)模組。
plug 是 YUI3 的插件機制,把額外行為「插」到節點上;插入之後,對應的實例會出現在 node.dd 上。addHandle 則用來限定哪些子元素充當拖動把手,這是實務中很實用的小設計——想想那些需要保留文字選取能力的面板,把標題欄設為把手就剛剛好。
以上關於 plug 與 addHandle 的解讀屬於個人理解,未必字字精準,但確實足以把拖動跑起來。若你有更權威的說法,歡迎交流指正。