本文要實作的是一個浮動定位的 tooltips 效果。原本想把它與滑鼠跟隨合併,但實作後發現,定位與滑鼠跟隨在幾個關鍵環節上仍有差異,於是決定分開處理。這個效果本身難度不大,主要功夫下在程式結構與擴充性上,力求更易用、能應用在更多場景。
完整實例下載(點擊下載)
Tip 物件就是用來顯示提示資訊的容器,程式以 Tip 屬性表示,初始化時會對它做一些基礎設定:
this._cssTip.margin = 0; // 避免定位問題 this._cssTip.position = "absolute"; this._cssTip.visibility = "hidden"; this._cssTip.display = "block"; this._cssTip.zIndex = 99; this._cssTip.left = this._cssTip.top = "-9999px"; // 避免佔位出現滾動條
其中 margin 設為 0 是為了避免定位問題;用 visibility 而非 display 隱藏,是因為程式需要取得 Tip 的 offsetWidth、offsetHeight;把 left 與 top 設為 -9999px,則是避免 Tip 佔位而產生滾動條。由於 Tip 可能位於其他定位元素內部,還需計算兩個 offset 修正參數:
var iLeft = iTop = 0, p = this.Tip;
while (p.offsetParent) {
p = p.offsetParent;
iLeft += p.offsetLeft;
iTop += p.offsetTop;
};
this._offsetleft = iLeft;
this._offsettop = iTop;
由於實務上常常是「一個 Tip 對應多處提示」,程式借鑑了 Table 排序的思路,加入了一個 Add 方法。Tip 實例化後,透過 Add 方法就能為多個觸發元素分別加上觸發物件,程式以 _trigger 屬性表示當前觸發物件。Add 方法的必要參數是觸發元素,也就是觸發顯示 Tip 的元素;此外還可用 options 參數自訂該觸發物件的屬性,例如:
ClickShow: true, // 是否點擊方式顯示
ClickShowDelay: false, // 是否點擊顯示延時
ClickHide: true, // 是否點擊方式隱藏
ClickHideDelay: false, // 是否點擊隱藏延時
TouchShow: true, // 是否觸發方式顯示
TouchShowDelay: true, // 是否觸發顯示延時
TouchHide: true, // 是否觸發方式隱藏
TouchHideDelay: true, // 是否觸發隱藏延時
ShowDelay: 300, // 顯示延時時間
HideDelay: 300, // 隱藏延時時間
Align: "left", // 水平方向定位
vAlign: "clienttop", // 垂直方向定位
Custom: { left: 0, top: 0 }, // 自定義定位
Percent:{ left: 0, top: 0 }, // 自定義百分比定位
Adaptive: true, // 是否自適應定位
onShow: function(){}, // 顯示時執行
onHide: function(){} // 隱藏時執行
一個經典應用,是在 onShow 中把 Tip 修改為各觸發物件對應的內容。此外還有 Elem 屬性保存觸發元素本身。
提示效果的重點在於顯示與隱藏。程式透過設置 Tip 的 visibility 是否為 hidden 來控制,分別由 Show 與 Hide 負責,另有 ReadyShow 與 ReadyHide 專門處理延時。這種效果的一個特點是:滑鼠移到 Tip 上時會保持顯示狀態。為此,為 Tip 的 mouseover 寫入:
this.Check(e.relatedTarget) && clearTimeout(this._timer);
其中 Check 用來判斷 relatedTarget 是否為外部元素(即滑鼠離開的元素是不是外部元素)。若是外部元素,說明當前處於隱藏延時階段,只要清除定時器即可取消隱藏。「外部元素」指的是觸發元素與 Tip 物件本身及其內部元素以外的元素。Check 的判斷如下:
return !this._trigger || !(
this.Tip === elem || this._trigger.Elem === elem ||
Contains(this.Tip, elem) || Contains(this._trigger.Elem, elem)
);
先判斷 _trigger 是否存在(不存在則視為剛開始觸發,當作外部觸發),存在則再判斷傳入元素是否為 Tip 或觸發元素本身,最後用 Contains 判斷是否在其內部,取反即為「是否外部元素」。
點擊方式顯示,是指點擊觸發元素時顯示 Tip。Add 程式中會為觸發元素的 click 事件綁定:
addEvent(elem, "click", BindAsEventListener(this, function(e){
if (trigger.ClickShow) {
if (this.CheckShow(trigger)) {
this.ReadyShow(trigger.ClickShowDelay);
} else {
clearTimeout(this._timer);
};
};
}));
先根據 ClickShow 判斷是否進行點擊顯示,再用 CheckShow 檢測是否為同一個觸發物件。若不同,會先執行 Hide 清理前一個觸發物件以防衝突,再 ReadyShow 顯示;若相同,說明當前處於延時隱藏階段,清除定時器保持顯示即可。對應的,點擊方式隱藏是指點擊外部元素時隱藏 Tip,當 ClickHide 為 true 時,ReadyShow 會把 _fCH 綁定到 document 的 click 事件上(注意要放在 ReadyShow 而非 Show,因為延時期間可能還沒顯示就觸發了隱藏)。
觸發方式針對的是 mouseover 與 mouseout,流程與點擊方式類似。觸發方式顯示,是指滑鼠從外部元素進入觸發元素時顯示 Tip:
addEvent(elem, "mouseover", BindAsEventListener(this, function(e){
if (trigger.TouchShow) {
if (this.CheckShow(trigger)) {
this.ReadyShow(trigger.TouchShowDelay);
} else if (this.Check(e.relatedTarget)) {
clearTimeout(this._timer);
};
};
}));
與點擊方式不同的是,還會用 Check 判斷 e.relatedTarget 是否為外部物件——因為 mouseover 可能是從觸發元素的內部元素進入或冒泡觸發,這些情況無需任何操作。觸發方式隱藏則是滑鼠離開觸發元素或 Tip 時隱藏 Tip,當 TouchHide 為 true 時,ReadyShow 會把 _fTH 綁定到觸發元素的 mouseout,Show 時再綁定到 Tip 的 mouseout。
以觸發方式為例,完整流程如下:
對照程式便能理解整個流程。這只是單例的情況,多例時還需多加一些判斷。流程看似不難,但若想做到最優化,要權衡的細節會相當繁多。
完成顯示隱藏後,就來到本程式的另一重點——元素定位,包含預設定位、自定義定位與自適應定位。
預設定位使用程式內建的 25 個位置。這 25 個位置其實是由 5 個水平座標與 5 個垂直座標組合而成,只要算好這 10 個座標,就能組合出全部位置。其中水平座標分別以 left、clientleft、center、clientright、right 標識,垂直座標則以 top、clienttop、center、clientbottom、bottom 標識。使用時把水平與垂直標識分別賦給觸發物件的 Align 與 vAlign 屬性即可,例如要設為位置 14,就讓 Align 為 "clientright"、vAlign 為 "center"。
程式先透過 getBoundingClientRect 取得觸發元素的座標物件,再用 GetLeft 與 GetTop 取得水平與垂直座標。至於自定義定位,是在預設定位得到的座標基礎上,根據 Custom(如 { left: 50, top: -10 })再進行 left 與 top 修正;自定義百分比定位則以觸發元素的寬高為基準取百分比:
if (trigger.Percent.left) { iLeft += .01 * trigger.Percent.left * trigger.Elem.offsetWidth; };
if (trigger.Percent.top) { iTop += .01 * trigger.Percent.top * trigger.Elem.offsetHeight; };
自適應定位的作用,是在 Tip 顯示範圍超過瀏覽器可視範圍時,自動修正回可視範圍內。由於定位以視窗為準,可直接用 clientWidth/clientHeight 判斷是否超界,先取得最大 left 與 top 值:
var maxLeft = this._doc.clientWidth - this.Tip.offsetWidth,
maxTop = this._doc.clientHeight - this.Tip.offsetHeight;
若 Reset 屬性為 true,會使用重新定位的方法(在超界時切換到相反的對齊方向);若不使用 Reset,則直接把座標夾在合法範圍內:
iLeft = Math.max(Math.min(iLeft, maxLeft), 0); iTop = Math.max(Math.min(iTop, maxTop), 0);
又是 IE6 的經典 select 穿透問題,這裡採用 iframe 遮蓋法。初始化時插入 iframe:
this._iframe = document.createElement("<iframe style='position:absolute;filter:alpha(opacity=0);display:none;'>");
document.body.insertBefore(this._iframe, document.body.childNodes[0]);
Show 時參照 Tip 設定好樣式並顯示,Hide 時隱藏即可,本質就是墊在 Tip 的下方。
實例化時,第一個必要參數是 Tip 物件,第二個可選參數用來設置觸發物件屬性的統一預設值:
var ft = new FixedTips("idTip");
接著用 Add 方法添加觸發物件,第二個可選參數用來設置該觸發物件的屬性;要添加多個觸發物件時,只需繼續調用 Add 即可:
var trigger1 = ft.Add("idTrigger1");
以下為程式的核心源碼:
掌握以上要點後,你就能靈活地把這套 FixedTips 應用於表單提示、圖片說明、連結浮動描述等各種場景。