DIV CSS 佈局教程網

jQuery Dialog 常用屬性與方法完整整理
編輯:JQuery特效代碼     

jQuery UI 的 Dialog 元件是製作彈跳視窗的利器,但初學者往往被琳瑯滿目的屬性搞得眼花撩亂。本文把實務上最常碰到的屬性、事件與方法系統性地梳理一遍,讓你查閱時一目了然。

一個實用的初始化範例

先從實際案例下手,認識最典型的用法:

$('#dialogDiv').dialog({
  hide: true,        // 點擊關閉時隱藏,若不加上此行,關閉後再開可能出錯
  autoOpen: false,
  height: 380,
  width: 800,
  modal: true,       // 開啟蒙層,會遮罩並影響頁面操作
  title: '開標人',
  overlay: { opacity: 0.5, background: "black", overflow: 'auto' },
  buttons: {
    '確定': function(){ /* 處理方法 addUser(); */ },
    '取消': function(){ $(this).dialog("close"); }
  }
});
$('#addItems').click(function(){
  loadPage('buildOpeningGroupAddOpering.htm', '#dialogDiv');
  $('#dialogDiv').data('title.dialog', '新增開標人').dialog('open'); // 動態修改標題
  return false;
});

搭配一個能載入外部頁面的辅助函式,並在載入前清掉不需要的 html、body、link 等標籤:

function loadPage(path, id) {
  $.get(path, function(data) {
    data = data.replace(/<\/?link.*>/ig,"");
    data = data.replace(/<\/?html.*>/ig,"");
    data = data.replace(/<\/?body.*>/ig,"");
    data = data.replace(/<\/?head.*>/ig,"");
    data = data.replace(/<\/?!doctype.*>/ig,"");
    data = data.replace(/<title.*>.*<\/title>/ig,"");
    $(id).empty().html(data);
  });
}

如果想讓彈窗能拖曳、能縮放,記得另外引入 ui.draggable.js 與 ui.resizable.js。最精簡的啟動寫法如下:

$("#dialog").dialog({
  autoOpen: false,
  buttons: { "確定": function(){ $(this).dialog("close"); } },
  closeOnEscape: true,
  hide: "slide",
  modal: true,
  title: "對話框"
}).dialog("open");

常用屬性一覽

autoOpen:設為 true 時建立即自動彈出,設為 false 則需呼叫 .dialog("open") 才顯示,預設 true。

bgiframe:預設 false。開啟後會啟用 bgiframe 外掛,用來解決 IE6 的下拉選單蓋在遮罩之上的老問題。

buttons:定義視窗按鈕及其點擊回呼,預設為空物件。

closeOnEscape:是否允許按 ESC 關閉視窗,預設 true。

dialogClass:為視窗額外加上自訂 class,方便客製樣式。

draggable / resizable:分別控制能否拖曳標題移動、能否縮放視窗,預設皆為 true。

width / height:視窗寬高,預設 auto 自動。

maxWidth / maxHeight / minWidth / minHeight:縮放的最大最小限制,寬高的最大預設 false(不限),最小預設 150,需 resizable 支援。

hide / show:關閉與開啟時的動畫效果,預設 null 無效果。

modal:是否為模式視窗,開啟後頁面其他元素無法點擊,預設 false。

title:視窗標題文字。

position:顯示位置,可用 'center'、'left'、'right'、'top'、'bottom',也可用偏移量或字串陣列如 ['right','top']。

zIndex:層級值,預設 1000。

stack:預設 true,取得焦點時視窗會浮到最上層。

常用事件

Dialog 提供了 beforeclose(關閉前觸發,回傳 false 可阻止關閉)、close(關閉後觸發)、open(開啟時觸發)與 focus(取得焦點時觸發)等事件。此外拖曳與縮放過程中也有 dragStart、drag、dragStop、resizeStart、resize、resizeStop 等事件可供響應。

常用方法

除了開關用的 open 與 close,還有 destroy(銷毀視窗)、disable / enable(停用與啟用)、option(取得或設定屬性)、isOpen(判斷是否開啟)以及 moveToTop(移到最上層)等方法。

掌握這些屬性、事件與方法,幾乎就能應付日常九成以上的彈窗需求了。

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