網路上的彈窗插件多到數不完,但真正要把它塞進自己的專案,往往會發現樣式綁得太死、行為又改不動。與其硬套別人的庫,不如自己動手刻一個。本文記錄了一套以原生 JavaScript(搭配 jQuery 做 DOM 操作)實作的彈窗組件,目前測試可正常運作於 IE6+、Firefox、Chrome 等瀏覽器。
動工之前先盤點需求,實作起來才不會越寫越亂。這套組件涵蓋了幾個常見場景會用到的功能:
所有可調參數集中在 this.config,初始化時用 $.extend 與外部傳入的 options 合併,呼叫端只需覆寫想改的欄位:
this.config = {
targetCls : '.clickElem', // 觸發點擊的元素
title : '我是龍恩', // 視窗標題
content : 'text:<p>我是龍恩</p>', // text | id | img | iframe
width : 400, // 內容寬度
height : 300, // 內容高度
theight : 30, // 標題列高度,預設 30
drag : true, // 是否可拖曳
time : 3000, // 自動關閉毫秒數,空值則不關
showBg : true, // 是否顯示遮罩
closable : '#window-close', // 關閉按鈕
bgColor : '#000', // 遮罩顏色
opacity : 0.5, // 遮罩透明度
position : { x: 0, y: 0 }, // 兩者皆為 0 時視窗置中
zIndex : 10000,
isScroll : true, // 是否隨捲軸移動
isResize : true, // 是否隨視窗縮放重新定位
callback : null // 彈出後的回呼
};
這裡有個實務上的提醒:內容的寬高最好不要超過一屏的可視範圍。早期用過某些插件,內容過大導致出現捲軸,按下關閉鈕時反而觸發了捲動事件,視窗關不掉。若內容真的比較長,讓 #window-content-border 自己撐出 overflow:auto 的捲軸會更穩妥。
觸發端只要掛上共用的 class 即可,同一頁可以放多個:
<div class="clickElem" style="margin-top:10px;">我是龍恩 請點擊我</div>
<div class="clickElem" style="margin-top:10px;">我是龍恩 請點擊我</div>
彈窗本體的節點由 JavaScript 動態產生,樣式則完全交給 CSS,JS 裡沒有寫死任何視覺風格,換設計稿時只要重寫樣式表:
#window-box{border:5px solid #E9F3FD;background:#FFF;}
.windown-title{position:relative;height:30px;border:1px solid #A6C9E1;
overflow:hidden;background:url(images/tipbg.png) 0 0 repeat-x;}
.window-title h2{padding-left:5px;font-size:14px;color:#666;}
#window-close{position:absolute;right:10px;top:8px;width:10px;height:16px;
text-indent:-10em;overflow:hidden;cursor:pointer;}
#window-content-border{padding:5px 0 5px 5px;}
內部用 this.cache 記錄三個狀態:isrender 表示 HTML 結構是否尚未建立、isshow 表示目前是否顯示中、moveable 則是拖曳狀態旗標。第一次點擊才把節點 append 到 body,之後再點擊就只是把既有節點 show 出來,避免重複建立 DOM。
內容字串以「型別:值」的形式傳入,用冒號切一刀再分派:
switch (contentType) {
case 'text': $('#window-content').html(content); break;
case 'id': $('#window-content').html($('#'+content).html()); break;
case 'img': $('#window-content').html("<img src='"+content+"' />"); break;
case 'iframe': $('#window-content').html('<iframe src="'+content+'" width="100%" height="100%" scrolling="yes" frameborder="0"></iframe>');
$('#window-content-border').css({'overflow':'visible'}); break;
}
置中位置由視窗尺寸扣掉容器尺寸再除以二,並加上目前的捲動量:
var offsetTop = Math.floor(($(window).height() - $(container).height())/2) + $(document).scrollTop(),
offsetLeft = Math.floor(($(window).width() - $(container).width())/2) + $(document).scrollLeft();
若 position.x 與 position.y 同時為 0 就走置中,否則改用自訂座標。要注意的是這組座標是相對定位父元素的,如果沒有指定父層 position:relative,實際上會以 document 為基準。
拖曳靠 mousedown 記下滑鼠與標題列的位移差,再在 mousemove 時更新 left/top,mouseup 收工。resize 與 scroll 兩個事件都加了 200ms 的 debounce,避免高頻觸發造成卡頓。IE6 因為不支援 position:fixed,遮罩改用整份文件的寬高鋪滿,並在 userAgent 判斷到 MSIE 6.0 時切換成純色背景。
var overlay = new Overlay({
title : '提示',
content : 'iframe:https://www.example.com',
width : 600,
height : 400,
time : '', // 不自動關閉
callback: function(){ console.log('彈窗已顯示'); }
});
這版實作只處理了彈窗的核心業務邏輯,樣式與進場動畫都留白,接進專案時依設計稿補上即可。後續若要更完善,可以再往「多實例並存」「ESC 關閉」「焦點鎖定」這些方向優化。