DIV CSS 佈局教程網

用 jQuery 打造自訂對話框插件 messageBox
編輯:JQuery特效代碼     

瀏覽器原生的 alert() 與 confirm() 無法客製外觀,也無法塞入 HTML。這個 messageBox 插件把頁面上任何一段元素「搬」進彈出視窗裡顯示,並附上遮罩、拖曳、置中與自適應,全部靠 HTML 屬性宣告即可啟用。

功能特色

  • 外觀完全由 CSS 控制,插件不硬編排樣式。
  • 可把頁面上任一元素作為對話框內容顯示。
  • 對話框啟動期間,外部元素無法接受滑鼠操作(以遮罩層阻擋)。
  • 可在工作區範圍內自由拖曳,並依視窗大小自動居中;拖曳時有虛線框預覽落點。
  • 不需撰寫複雜 JavaScript,透過 HTML 屬性描述即可。
  • 實測可於 Firefox 與 IE 正常運作。

使用方式

先引入 jQuery 與插件:

<script src="jquery-latest.js"></script>
<script src="messageBox.js"></script>

接著在觸發按鈕上用 showoption 屬性描述參數:

<input id="Button4" type="button" value="提問對話框"
       showoption="control:test2;width:220;height:120;title:對話框" />

再把要顯示的內容放在頁面上,先隱藏起來:

<div id="test2" style="display:none">
  <table style="width: 200px">
    <tr>
      <td>JQuery模式對話框插件好用嗎?</td>
    </tr>
    <tr>
      <td align="right">
        <input id="Button2" onclick="CloseMessageBox()" type="button" value="是" />
        <input id="Button6" onclick="CloseMessageBox()" type="button" value="否" />
      </td>
    </tr>
  </table>
</div>

showoption 的值以分號分隔多組「鍵:值」,支援 control(要顯示的元素 ID)、width、height、title 與 parent(對話框掛在哪個容器下,留空則掛到 body)。

核心程式碼

/* JQuery 模式對話框插件
 * writer: FanJianHan (henryfan@msn.com)
 * License: GPL
 */

var MessageOninit = false;
// 記錄 body 滾動條偏移量、顯示內容元素及其父元素
var MessageBox_scrolltop, MessageBox_scrollleft, Messagebox_AC, MessageBox_PC;
var MessageBox_win, MessageBox_width, MessageBox_height;
var MessageBox_Moving = false;

// 顯示對話框
function ShowMessageBox(option){
  var container, iframe, enabled, enabledframe;
  var height = 400, width = 400;
  MessageBox_scrolltop = 0;
  MessageBox_scrollleft = 0;

  if(!MessageOninit){
    CreateContainer(option);
    MessageOninit = true;

    $('#messagebox_close').click(function(){ CloseMessageBox(); });

    $(window).resize(function(){
      SetStyle(option);
      SetEnabledStyle();
    });

    // 滾動時重新對齊遮罩,避免內容跑到遮罩外
    $(window).scroll(function(e){
      MessageBox_scrolltop  = document.documentElement.scrollTop;
      MessageBox_scrollleft = document.documentElement.scrollLeft;
      SetEnabledStyle();
    });

    MessageBox_win = $("#messagebox_win");
    $('#messagebox_title').mousedown(handleMouseDown);
    $('#messagebox_title').mouseup(handleMouseUp);
    $('#messagebox_title').mousemove(handleMouseMove);
    document.onmouseup = handleMouseUp;
  }

  if(option.height) height = parseInt(option.height);
  if(option.width)  width  = parseInt(option.width);
  MessageBox_height = height;
  MessageBox_width  = width;

  Messagebox_AC = $('#' + option.control);
  MessageBox_PC = Messagebox_AC.parent();
  Messagebox_AC.css('display', '');

  enabled = '<div id="messagebox_enabled"
    style="background-color: lightgrey; width:100%; height:100%;
           position:absolute; z-index:99998;"></div>';
  // iframe 遮罩用來擋住 IE6 的 select 元素穿透
  enabledframe = '<iframe id="messagebox_enabledframe" frameborder=0 scrolling=no
    style="position:absolute; visibility:inherit; top:0px; left:0px;
           width:100%; height:100%; z-index:99997;"></iframe>';

  $('#messagebox_enabledframe').remove();
  $('#messagebox_enabled').remove();
  $('#messagebox_title').html(option.title);
  $('#messagebox_from').append(Messagebox_AC);

  SetStyle(option);
  $(document.body).append(enabledframe);
  $(document.body).append(enabled);
  SetEnabledStyle();
  $('#messagebox_win').fadeIn("slow");
}

容器建立與樣式計算

// 建立對話框容器(僅首次呼叫時執行)
function CreateContainer(option){
  var html = '<div id="messagebox_win" style="position:absolute; z-index:99999;">
    <table cellpadding="0" cellspacing="0" id="messagebox_table">
      <tr>
        <td id="messagebox_title_td">
          <table id="messagebox_title_table">
            <tr>
              <td style="width:99%;">
                <div id="messagebox_title" style="width:100%; cursor: default;"></div>
              </td>
              <td><button id="messagebox_close"></button></td>
            </tr>
          </table>
        </td>
      </tr>
      <tr id="messagebox_body_td">
        <td valign="top">
          <div id="messagebox_from" style="text-align: center;"></div>
        </td>
      </tr>
    </table>
  </div>';

  if(option.parent){ $('#' + option.parent).append(html); }
  else{ $(document.body).append(html); }
}

// 取得工作區尺寸,兼顧多種盒模型
function GetDocumentRegion(){
  var w, h, de = document.documentElement;
  w = self.innerWidth || (de && de.clientWidth) || document.body.clientWidth;
  h = self.innerHeight || (de && de.clientHeight) || document.body.clientHeight;
  return {height:h, width:w};
}

// 遮罩樣式:鋪滿整個可視區並保持半透明
function SetEnabledStyle(){
  var region = GetDocumentRegion();
  var css = {
    width:  region.width  + "px",
    height: region.height + "px",
    left:  MessageBox_scrollleft + 'px',
    top:   MessageBox_scrolltop  + 'px'
  };
  GetOpacity(css);
  $("#messagebox_enabled").css(css);
  $("#messagebox_enabledframe").css(css);
}

// 透明度需分瀏覽器處理
function GetOpacity(css){
  if(window.navigator.userAgent.indexOf('MSIE') >= 1){
    css.filter = 'progid:DXImageTransform.Microsoft.Alpha(opacity=30)';
  }else{
    css.opacity = '0.3';
  }
}

// 對話框本體:依工作區大小水平垂直居中
function SetStyle(option){
  var region = GetDocumentRegion();
  var css = {
    width:  MessageBox_width  + 'px',
    height: MessageBox_height + 'px',
    left:  ((region.width  - MessageBox_width)  / 2) + 'px',
    top:   ((region.height - MessageBox_height) / 2) + 'px'
  };
  // 若工作區比對話框還矮,就貼近頂端顯示
  css.top = (region.height < MessageBox_height) ? '10px' : css.top;
  $('#messagebox_win').css(css);

  css.top = '0px'; css.left = '0px';
  $('#messagebox_table').css(css);
  css.width = '100%'; css.height = '16px';
  $('#messagebox_title_td').css(css);
  css.height = (height - 46) + 'px';
  $('#messagebox_body_td').css(css);
}

拖曳實作

var down_x, down_y, cx, cy;

function handleMouseDown(e){
  var evt = e || event;
  down_x = evt.clientX;
  down_y = evt.clientY;
  cx = (parseInt(MessageBox_win.css('left')) | 0);
  cy = (parseInt(MessageBox_win.css('top'))  | 0);
  MessageBox_Moving = true;

  // 拖曳期間禁止選字與拖放,避免手忙腳亂
  document.documentElement.onselectstart = function(){ return false };
  document.documentElement.ondrag = function(){ return false };
  document.onmousemove = handleMouseMove;

  // 虛線框預覽落點
  $(document.body).append('<div id="messagebox_move" style="position: absolute;
    z-index:100000; border: midnightblue 1px dashed;"></div>');
  $('#messagebox_move').css('width',  MessageBox_win.css('width'));
  $('#messagebox_move').css('height', MessageBox_win.css('height'));
  $('#messagebox_move').css('left',   MessageBox_win.css('left'));
  $('#messagebox_move').css('top',    MessageBox_win.css('top'));
}

function handleMouseMove(e){
  if (!MessageBox_Moving) return;
  var evt = e || event;
  var left = evt.clientX + cx - down_x;
  var top  = evt.clientY + cy - down_y;
  var region = GetDocumentRegion();

  // 邊界夾制:右、下不出界,左、上不低於 10px
  if(left + MessageBox_width  > region.width)  left = region.width  - 10 - MessageBox_width;
  if(top  + MessageBox_height > region.height) top  = region.height - 10 - MessageBox_height;
  if(left < 10) left = 10;
  if(top  < 10) top  = 10;

  $('#messagebox_move').css({left: left + 'px', top: top + 'px'});
}

function handleMouseUp(){
  if(MessageBox_Moving){
    MessageBox_win.css('width',  $('#messagebox_move').css('width'));
    MessageBox_win.css('height', $('#messagebox_move').css('height'));
    MessageBox_win.css('left',   $('#messagebox_move').css('left'));
    MessageBox_win.css('top',    $('#messagebox_move').css('top'));
  }
  MessageBox_Moving = false;
  document.onmousemove = null;
  $('#messagebox_move').remove();
}

關閉與自動綁定

function CloseMessageBox(){
  if(MessageOninit){
    $('#messagebox_win').hide();
    $('#messagebox_enabled').remove();
    $('#messagebox_enabledframe').remove();
    Messagebox_AC.css('display', 'none');   // 把內容元素藏回去
    MessageBox_PC.append(Messagebox_AC);    // 歸還到原本的父節點
  }
  document.documentElement.onselectstart = null;
  document.documentElement.ondrag = null;
}

// 掃描所有帶 showoption 屬性的元素,自動掛上點擊事件
$(document).ready(function(){
  $(document).find('[showoption]').each(function(){
    var option = { control:'', width:'400', height:'400', title:'', parent:null };
    var properties = $(this).attr('showoption').split(';');
    for(var i = 0; i < properties.length; i++){
      var namevalue = properties[i].split(':');
      if(namevalue.length > 1){
        eval("option." + namevalue[0] + "='" + namevalue[1] + "';");
      }
    }
    $(this).click(function(){
      ShowMessageBox(option);
      document.body.focus();
    });
  });
});

幾個值得借鑑的設計

遮罩用雙層。除了 div 之外還多鋪一個 iframe,這是為了封堵舊版 IE 中 <select> 會穿透任何 z-index 的老問題。雖然現在已無必要,但仍是理解歷史包袱的好案例。

滾動時重新對齊遮罩。遮罩以 position:absolute 定位,頁面捲動時若不重新設定 top,遮罩就會與可視區脫節。監聽 scroll 事件即為了解決這點。

關閉時把內容元素歸還原位。MessageBox_PC.append(Messagebox_AC) 把元素搬回原本的父節點並隱藏,而不是直接砍掉——這樣下次開啟時 DOM 結構仍然完整。

拖曳時用虛線框預覽。移動過程中只動 #messagebox_move 這個空框,放開滑鼠才把座標套回真正的對話框,視覺上更清爽,也少了对內容回流造成的閃爍。

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