DIV CSS 佈局教程網

用原生 JavaScript 手刻彈窗組件:配置、拖曳、遮罩一次講完
編輯:JavaScript綜合知識     

網路上的彈窗插件多到數不完,但真正要把它塞進自己的專案,往往會發現樣式綁得太死、行為又改不動。與其硬套別人的庫,不如自己動手刻一個。本文記錄了一套以原生 JavaScript(搭配 jQuery 做 DOM 操作)實作的彈窗組件,目前測試可正常運作於 IE6+、Firefox、Chrome 等瀏覽器。

先定義清楚:這個彈窗要具備哪些能力

動工之前先盤點需求,實作起來才不會越寫越亂。這套組件涵蓋了幾個常見場景會用到的功能:

  • 標題、內容、寬高、標題列高度皆可自訂。
  • 視窗可拖曳,也能關掉拖曳行為。
  • 可設定自動關閉的延遲毫秒數,不設就不自動關。
  • 遮罩層可開可關,顏色與透明度自訂。
  • 支援四種內容型態:純文字 HTML、圖片、既有節點 id、iframe。
  • 提供開啟後的回呼函數,方便接自己的業務邏輯。

配置項一覽

所有可調參數集中在 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 的捲軸會更穩妥。

HTML 與 CSS 骨架

觸發端只要掛上共用的 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;}

JS 的關鍵設計

只渲染一次,之後只做顯示與隱藏

內部用 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;
}

置中計算與 IE6 的位移陷阱

置中位置由視窗尺寸扣掉容器尺寸再除以二,並加上目前的捲動量:

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 關閉」「焦點鎖定」這些方向優化。

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