DIV CSS 佈局教程網

用 JavaScript 打造自製模態對話框:完整元件實作
編輯:JavaScript綜合知識     

瀏覽器原生的 alert 與 confirm 有兩個難以忍受的限制:樣式無法客製,且在部分情境下會被瀏覽器主動封鎖。以下實作一個通用的模態視窗元件,支援自訂標題、內容、按鈕與回調,並附遮罩層。

模態視窗(ModeWindow)

construct(){
  setting = {
    ID: 'window ID',
    TitleText: '',
    Content: 'content Text',
    Parent: null,            // 視窗的父元素,預設掛到 body
    boxCss: 'class03_tank ',
    TitleCss: 'class03_tank_top',  // 標題 CSS
    ContentCss: 'padtb10',        // 內容 CSS
    width: 280,
    height: 'auto',
    button: 'submit,cancel',    // 按鈕類型
    submitcall: null,           // 點擊確定的回調
    cancelcall: null           // 點擊取消的回調
  }

  function _createWindow(opt){
    var windowID = opt.ID, top, left;
    if (windowID == null) return null;
    if ($('#' + opt.ID).length > 0) $('#' + opt.ID).remove();
    if (!opt.left) opt.left = ($(window).width() - opt.width) / 2;
    if (!opt.top) opt.top = ($(window).height()) / 3 + $(document).scrollTop();
    var parent = (opt.Parent == null || opt.parent.length == 0) ? $('body') : $(opt.Parent);
    var box = $('<div>').attr('id', windowID).addClass(opt.boxCss)
      .width(opt.width).height(opt.height)
      .css({'left': opt.left, 'top': opt.top, 'z-index': 1111, 'position': 'absolute'});
    parent.append(box);
    return $('#' + opt.ID);
  }

  function _setWindowConstruct(w, opt){  // 建立視窗內部結構
    w.subobj = w.obj;
    // 標題列
    w.subobj.append($('<div>').addClass('class03_tank_top').append(
      $('<div>').addClass('class03_tank_topc').append(
        w.close = $('<a>').attr('title','關閉').addClass('btnax fr bgcfff mart04').html('×')
      ).append(
        $('<span>').addClass('disin_bl lineh30 marl10').html(opt.TitleText)
      )
    ))
    // 內容區
    w.subobj.append(
      $('<div>').addClass('class03_tank_con bgcfff').css({'text-align':'center'}).append(
        $('<div>').attr('id','content_ui_' + opt.ID).addClass(opt.ContentCss)
      )
    );
    // 底部裝飾
    w.subobj.append('<div style="margin-top:0;"><b class="yz_b01"></b><b class="yz_b02"></b><b class="yz_b03 yz_b00"></b></div>');
    return w;
  }

  function _setWindowSubmitButton(w, opt){  // 設定按鈕
    var p = $('<p>').addClass('class03_tank_p');
    var submit = $('<a>'), cancel = $('<a>');
    btn = opt.button.split(',');
    if (ST.Base.inArray(btn, 'submit') > -1){
      p.append(submit.addClass('btnqx01').html('確定').bind('click', function(){
        if ((opt.submitcall && opt.submitcall() !== false) || opt.submitcall == null){
          $('#' + opt.ID).remove();
          $('#MW_BACKOVER').hide();
        }
        if (ST.UI.timeId != null) window.clearTimeout(ST.UI.timeId);
      }))
    }
    if (ST.Base.inArray(btn, 'cancel') > -1){
      p.append(cancel.addClass('btnqx01 marlr06').html('關閉').bind('click', function(){
        if ((opt.cancelcall && opt.cancelcall() !== false) || opt.cancelcall == null){
          $('#' + opt.ID).remove();
          $('#MW_BACKOVER').hide();
        }
        if (ST.UI.timeId != null) window.clearTimeout(ST.UI.timeId);
      }))
    }
    w.close.bind('click', function(){
      $('#' + opt.ID).remove();
      $('#MW_BACKOVER').hide();
    })
    w.obj.children('.class03_tank_con').append(p);
  }

  function _setBackover(w){  // 建立遮罩層
    if ($('#MW_BACKOVER').length > 0){ $('#MW_BACKOVER').show(); return; }
    $("body").append(
      $("<div>").attr("id", "MW_BACKOVER").css({
        "background-color": "#ddd", "position": "fixed",
        "top": "0", "left": "0", "width": "100%", "height": "100%",
        "display": "block", "opacity": 0.5, 'z-index': 10
      })
    );
  }

  return function(opt){
    opt = ST.extend(setting, opt);
    var w = _createWindow(opt);   // 建立視窗外殼
    if (!w) return false;
    windowObj = {'obj': w, 'subobj': null};
    windowObj = _setWindowConstruct(windowObj, opt);
    _setBackover(windowObj, opt);
    _setWindowSubmitButton(windowObj, opt);
    return {
      getObject: function(){ return windowObj; },
      close: function(){
        $(windowObj['obj']).remove();
        $('#MW_BACKOVER').hide();
        return this;
      },
      setContent: function(content){
        $('#content_ui_' + opt.ID).html(content);
        return this;
      },
      load: function(url, callback){
        $('#content_ui_' + opt.ID).load(url + '&r=' + Math.random(), callback);
        return this;
      }
    }
  }
}

靜態對話框(StaticWindow)

靜態視窗沒有標題列,位置可指定或依觸發元素定位,適合做 tooltip 式的提示:

StaticWindow: (function(){
  var Controller = null;
  function _construct(opt){
    setting = {
      ID: '', left: 0, top: 0, width: 200, height: 100,
      css: 'bgcfff', parent: '',
      buttonCss: 'class03_tank_p', buttonCssRep: null,
      button: 'sure,cancle', buttonText: null, layer: null
    }
    function _createWindow(opt){
      if ($('#' + opt.ID).length > 0) $('#' + opt.ID).remove();
      if (opt.layer != null){
        opt.left = opt.layer.pageX;
        opt.top = opt.layer.pageY + $(opt.layer.target).height();
      }
      var box = $('<div>').addClass(opt.css).css({
        'position':'absolute', 'height':opt.height, 'width':opt.width,
        'border':'1px solid #ccc', 'z-index':100, 'left':opt.left, 'top':opt.top
      }).attr('id', opt.ID);
      var parent = opt.parent != '' ? $(opt.parent) : $('body');
      parent.append(box);
      return $('#' + opt.ID);
    };
    function _setWindowConstruct(obj, opt){
      obj.html('');
      obj.append($('<div>').attr('id','static_content_' + opt.ID));
    }
    function _setButton(obj, opt){
      btn = opt.button.split(',');
      p = $('<p>').addClass(opt.buttonCss).css({'position':'absolute','bottom':0,'width':(opt.width-13)});
      if (opt.buttonCssRep != null) p.css(opt.buttonCssRep);
      if (ST.Base.inArray(btn,'sure') > -1){
        var sure = $('<a>').addClass('btnqx01').html('確認').click(function(e){
          if ((opt.surebtn && opt.surebtn(e) !== false) || opt.surebtn == null) obj.remove();
        })
        p.append(sure);
      }
      if (ST.Base.inArray(btn,'cancle') > -1){
        cancel = $('<a>').addClass('btnqx01 marlr06').html('取消').click(function(e){
          if ((opt.cancelbtn && opt.cancelbtn(e) !== false) || opt.cancelbtn == null) obj.remove();
        })
        p.append(cancel);
      }
      if (opt.buttonText != null) p.append(opt.buttonText);
      obj.append(p);
    }
    return function(opt){
      opt = ST.extend(setting, opt);
      var w = _createWindow(opt);
      if (!w) return false;
      _setWindowConstruct(w, opt);
      _setButton(w, opt);
      return {
        close: function(){ w.remove() },
        setContent: function(content){ $('#static_content_' + opt.ID).html(content) },
        append: function(obj){ $('#static_content_' + opt.ID).append(obj) },
        load: function(url, callback){ $('#static_content_' + opt.ID).load(url, callback) }
      }
    }
  }
  return function(option){ Controller = _construct(); return Controller(option); }
})()

使用方式

var w = ST.UI.ModeWindow({
  'ID': '窗口ID',
  'TitleText': '標題',
  'submitcall': function(){ /* 確認按鈕執行的方法 */ },
  'cancelcall': function(){ /* 取消按鈕執行的方法 */ },
  'width': '寬',
  'height': '高',
  'boxCss': '視窗樣式',
  'TitleCss': '標題樣式',
  'ContentCss': '內容樣式',
  'button': 'submit,cancel'  // 預設兩個按鈕,也可只設其中一個
});

參數全部可選。w 即視窗物件,可用下列方法操作:

w.close();                // 關閉視窗
w.setContent('內容');      // 設定內容
w.getObject();            // 取得視窗物件
w.load('載入連結', '回調函式');  // 載入一個 url

靜態對話框的用法與模態對話框相同。

設計上值得學習與需要修正的地方

這個元件有幾個不錯的思路。_setBackover 會先檢查遮罩層是否已存在,有的話就 show 而非重建,避免重複節點堆積。ST.extend(setting, opt) 把預設值與傳入值合併,讓所有參數都可選。回調的判斷寫成 opt.submitcall() !== false,意味著回調若明確回傳 false 就不關閉視窗,這讓「驗證未通過時留在原地」的行為得以實作,是個很實用的約定。

但這份程式碼有幾處值得修正。setting 在函式內被赋值時前面沒有 var,會成為全域變數;windowObj、btn、cancel 同樣如此。多個視窗同時存在時,這些共用變數會互相干擾。load 方法在網址後附加 Math.random() 來避免快取,但也讓後端無法利用快取,建議改為明確的 cache 參數控制。另外 opt.Parent 與 opt.parent 大小寫不一致,會導致判斷失靈。

最後要提醒的是,這個元件用 .html(content) 寫入內容,若 content 可能來自使用者輸入,會形成 XSS 風險。另外它沒有做焦點管理與 ARIA 屬性,鍵盤使用者與螢幕閱讀器使用者無法正常操作。在今日的專案中,<dialog> 元素已內建了 these 能力——包含焦點鎖定、ESC 關閉、backdrop 樣式與適當的無障礙語意,除非需要高度客製,否則是更好的選擇。

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