DIV CSS 佈局教程網

JavaScript 教學:打造靈活的浮動定位提示(Tooltips)效果
編輯:關於JavaScript     

本文要實作的是一個浮動定位的 tooltips 效果。原本想把它與滑鼠跟隨合併,但實作後發現,定位與滑鼠跟隨在幾個關鍵環節上仍有差異,於是決定分開處理。這個效果本身難度不大,主要功夫下在程式結構與擴充性上,力求更易用、能應用在更多場景。

程式特點

  1. 同一個提示框用於多個觸發元素時,只需一個實例;
  2. 顯示與隱藏分別支援「點擊方式」與「觸發方式」兩種選擇;
  3. 可設定延遲顯示與延遲隱藏;
  4. 內建 25 種預設定位位置;
  5. 可在預設定位基礎上再做自訂定位;
  6. 可設定自適應視窗定位。

完整實例下載(點擊下載)

程式說明

Tip 物件

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。

觸發原理流程

以觸發方式為例,完整流程如下:

  1. 等待觸發顯示;
  2. 進入觸發元素,若設定延時則跳到 3,否則跳到 4;
  3. 延時時間內離開到外部元素則清除定時器返回 1,超過延時則跳到 4;
  4. 執行顯示程式;
  5. 顯示 Tip;
  6. 離開觸發元素,若進入 Tip 跳到 7,若離開到外部元素跳到 9;
  7. 保持顯示狀態;
  8. 離開 Tip,若進入觸發元素返回 5,若離開到外部元素跳到 9;
  9. 若設定延時跳到 10,否則跳到 11;
  10. 延時內進入 Tip 或觸發元素則清除定時器返回相應步驟,超過延時跳到 11;
  11. 執行隱藏程式,返回 1。

對照程式便能理解整個流程。這只是單例的情況,多例時還需多加一些判斷。流程看似不難,但若想做到最優化,要權衡的細節會相當繁多。

元素定位

完成顯示隱藏後,就來到本程式的另一重點——元素定位,包含預設定位、自定義定位與自適應定位。

預設定位使用程式內建的 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

又是 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 應用於表單提示、圖片說明、連結浮動描述等各種場景。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved