除了自動掛載,也可以直接 new 出一個 Boxy 物件,以便完整掌控參數:
<script type="text/javascript">
$(function() {
$("#a1").click(function() {
var box1 = new Boxy("<h3>這個參數是顯示的內容</h3>", {
title: "標題", // 對話框標題
modal: false, // 是否為強制模式視窗
afterHide: function(e) { alert("dialog hide"); }, // 隱藏後回呼
afterShow: function(e) { alert("dialog show"); }, // 顯示後回呼
closeText: "X", // 關閉按鈕的提示文字
draggable: true // 是否可拖曳
});
box1.resize(300, 100); // 設定對話框尺寸
});
});
</script>
<a href="#" id="a1">手動建立一個實例</a>

實測發現:當 modal 設為 true 時背景會被遮罩,此時即使 draggable 為 true 也無法拖動視窗。若希望使用者能自由移動對話框,請把 modal 設為 false。
$("#a2").click(function() {
Boxy.ask("請選擇一個選項:",
["選項一", "選項二", "選項三"], // 可選項
function(val) { alert(val); }, // 回呼,收到被選取的值
{ title: "測試", modal: false } // 對話框屬性
);
});

四個參數分別是:question 提問內容、answers 選項陣列、callback 回呼、options 屬性設定。回呼收到的值形式取決於 answers 是純陣列還是「值—文字」對應的數列。
$("#a3").click(function() {
Boxy.alert("這是警告訊息",
function(val) { alert(val); },
{ title: "提示" }
);
});

$("#a4").click(function() {
Boxy.confirm("你確定要繼續嗎?",
function() { alert("已確認"); }, // 只在按下確定時執行
{ title: "測試", modal: false }
);
});

需要特別留意:Boxy.alert 與 Boxy.confirm 並非用來取代瀏覽器原生的 window.alert/window.confirm。原生版本會同步阻斷程式執行,而 Boxy 是非同步的,程式不會停下來等使用者回應。
Boxy.load(url, options):以指定 URL 載入內容並以對話框呈現。支援類型(HTTP 方法,預設 GET)、緩存(預設 false)、過濾(以 jQuery 表達式篩選遠端內容)等選項,其餘設定會直接傳入建構函數。
Boxy.get(element):取得與該元素關聯的 Boxy 實例,例如 onclick="Boxy.get(this).hide();"。
Boxy.ask(question, answers, callback, options):顯示可選擇的提問框。
Boxy.alert(message, callback, options):顯示訊息框。
Boxy.confirm(message, callback, options):顯示含確定與取消的確認框,回呼僅在按下確定時執行。
Boxy.linkedTo(ele):回傳透過建構選項關聯到該 DOM 元素的實例。
Boxy.isModalVisible():若有強制模式對話框正在顯示則回傳 true。
new Boxy(element, options):建構函數。element 為對話框內容,任何 $() 可接受的形式皆可。
estimateSize():在對話框不可見時估算尺寸;若已可見請改用 getSize()。
getSize():以 [width, height] 陣列回傳尺寸。
getContentSize():回傳內容區尺寸,不含標題欄。
getPosition():以 [x, y] 回傳左上角座標。
getCenter():以 [x, y] 回傳中心點座標。
moveTo(x, y):移動到左上角為 (x, y) 的位置。
centerAt(x, y):移動到中心為 (x, y) 的位置。
center(axis):置中於視野,axis 可為 "x"、"y" 或省略。
resize(w, h, after):立即調整尺寸,完成後執行回呼。
tween(w, h, after):以動畫補間方式調整尺寸。
getInner():回傳包含標題欄的內部區域。
getContent():回傳不含標題欄的內容區域。
setContent(newContent):設定內容,可接受任何 $() 支援的形式。
isVisible()/show()/hide(after)/toggle():查詢與切換可見狀態。
hideAndUnload(after):隱藏後立即卸載。
unload():從 DOM 移除對話框並中斷與觸發器的關聯;卸載後再操作該實例屬未定義行為。
toTop():移到所有對話框的最上層。
getTitle()/setTitle(t):讀取與設定標題 HTML。

| 選擇器 | 對應元素 |
|---|---|
| .boxy-wrapper .title-bar | 自動產生的標題欄 div |
| .boxy-wrapper .title-bar h2 | 標題欄的內容 |
| .boxy-wrapper .title-bar.dragging | 拖曳中的標題欄 |
| .boxy-wrapper .title-bar .close | 預設的關閉按鈕 |
| .boxy-inner | 內部區域,含標題欄 |
| .boxy-content | 內部區域,不含標題欄;此類別會自動加到傳入建構函數的元素上 |
| .boxy-wrapper .question | Boxy.ask() 產生的問題文字區 |
| .boxy-wrapper .answers | Boxy.ask() 產生的答案按鈕區 |
| .close | 加上此類別的元素,點擊後即關閉對話框 |
外框的圓角是以 PNG 圖片拼出的,若想調整透明度可用圖片編輯軟體修改;若專案已不需相容 IE6,也可改用純 CSS 的圓角寫法,省去四張圖片與額外篩選器。
官方網站:https://onehackoranother.com/projects/jquery/boxy/