做過圖表或資料視覺化的人都知道,滑鼠移近某個資料點時彈出的提示框最麻煩的不是內容,而是「該出現在哪裡」。位置算錯就會超出容器被裁切,甚至蓋住滑鼠。以下用 jQuery 實作一個能自動判斷八個方位的提示彈窗,並把判斷邏輯拆開講清楚。
依滑鼠在目標容器中的位置不同,箭頭指向可分為八種:左上(left-top,預設)、左下(left-bottom)、右上(right-top)、右下(right-bottom)、上左(top-left)、上右(top-right)、下左(bottom-left)、下右(bottom-right)。這八種的優先級依序遞減,也就是說程式會盡量找出符合優先序的第一個可行方案。
前提條件:先確認目標容器的寬或高至少是彈窗對應尺寸加上箭頭尺寸之後的兩倍。之所以是兩倍,因為臨界點是目標容器各邊的中點——只有當容器足夠大,才有餘裕在四個方位之間切換。
/*
* 先判斷目標容器的高度或寬度,是否為「容器對應尺寸 + 箭頭尺寸」的兩倍;
* 否則報錯。之所以是兩倍,因為臨界點是目標容器的各邊中點。
*/
接著依優先級逐一嘗試,順序是:先看左側,再看右側,左右都放不下就改看頂部,最後才考慮底部。檢測左右側時,要順便判斷頂部能否容納箭頭的偏移量;檢測上下時,則比較左右兩側哪一邊空間較大。
/*
* 1. 檢測左側時,判斷上下距離能否放下箭頭偏移量;
* 只要有一邊放不下(例如 top),即為 ['top', 'left'],右側同理。
* 2. 檢測上下時,判斷左右距離能否放下箭頭偏移量(預設為 top);
* 有一側放不下,即為滑鼠偏向的那側(若 left < right 則為 left),
* 此時箭頭偏移量為 0 並隨滑鼠移動,left 增大則增大,最大至偏移量。
* 預設為左側、頂部。
*/
判斷的骨架其實就是一棵決策樹:
先問「滑鼠右側放得下彈窗嗎」。若放得下,再問「還能多放一個箭頭嗎」。若能,進一步看頂部是否放得下箭頭含偏移量且不超過容器高度——可以則為 left-top;否則若頂部大於彈窗高度且底部能放下箭頭與偏移量,則為 left-bottom;再否則若能放下箭頭與彈窗則為 top-left;以上皆不合,依前提條件就是 bottom-left。若右側連箭頭都放不下,就改看底部能否容納彈窗與箭頭,能則 top-left,否則 bottom-left。右側整條路都不通,就換左側,邏輯完全對稱。
case 'top-left' :
// top 加上箭頭尺寸
this.conObj.css('top', top + tarTop);
// 判斷 left 距離
if ( left < arrOffset ) {
// 緊貼左邊
this.conObj.css('left', tarLeft);
} else if (right < (conWidth - arrOffset)) {
// 右側撐不下自身在右邊的距離(conWidth - arrOffset),
// 則 left 值減小,箭頭跟隨滑鼠,讓自己右邊與容器對齊。
// 另一種算法:緊貼右邊,即左邊距離為「目標容器寬 - 自身寬」
this.conObj.css('left', tarWidth - conWidth + tarLeft);
} else {
// 正常顯示的 left
this.conObj.css('left', left - arrOffset + tarLeft);
}
break;
三個分支分別對應:空間不足時貼齊左緣、右側不夠時貼齊右緣、其餘情況則以滑鼠位置減去箭頭偏移量定位。
case 'top-left' :
this.arrowObj.prependTo(this.conObj);
// 如果彈窗緊貼右邊,此時箭頭隨滑鼠移動
if (conLeft === 0 && (conWidth > (right + arrOffset))) {
this.arrowObj.css('left', conWidth - right - arrowPos);
} else {
this.arrowObj.css('left', arrowPos);
}
break;
箭頭的 left 值必須扣掉自身寬度的一半(arrowPos)才能對準滑鼠,這是最容易算錯的一步。另外當彈窗被推到容器邊緣時,箭頭要改用「彈窗寬度減去滑鼠距右緣距離」來計算,才能繼續指著正確的位置。
這個元件來回重構了很多次,寫到補滿註解時有個體會:無論寫程式還是處事,我們都依賴一些預設前提或約定俗成的規範;一旦這個前提被打破,往往就得推倒重來。這裡的「容器必須是彈窗兩倍大」就是典型例子——把它當成明確的契約寫在註解裡,後續維護的人(包括三個月後的自己)才不會在不明所以的情況下踩坑。